| name | chinese-polish |
| description | 调用 DeepSeek API 进行中文润色和多语言翻译。润色支持通用/学术/商务/口语四种风格；翻译支持任意语言互译，并对 .tex（LaTeX）和 .md（Markdown）文件做专项处理，保留所有命令/代码/数学公式，只翻译自然语言文本。 |
中文润色 & 多语言翻译
通过 DeepSeek API（deepseek-chat 模型）提供两大功能：文本润色和多语言翻译。
触发场景
润色：
- 用户说"润色"、"改写"、"优化这段文字"、"polish"、"帮我改一下措辞"
- 用户提供一段文字并希望提升表达质量
- 用户要求润色某个文件
翻译：
文件类型专项处理
translate_file.sh 根据文件扩展名自动路由：
| 扩展名 | 处理脚本 | 保留内容 | 翻译内容 |
|---|
.tex / .latex | translate_latex.py | LaTeX 命令、数学公式、\texttt{}、tabular/tikzpicture/thebibliography 环境体 | 章节标题、段落文本、\abstract{}、\keywords{}、\title{}、图表说明 |
.md / .markdown | translate_markdown.py | 代码块（```）、行内代码、数学公式、链接 URL、图片 URL、HTML 标签、YAML front matter | 正文、标题文字、链接文字、图片 alt 文字 |
| 其他 | 原有通用分段逻辑 | — | 全文分段翻译 |
调用示例
export DEEPSEEK_API_KEY="sk-..."
bash ~/.claude/skills/chinese-polish/scripts/translate_file.sh \
--target 中文 --source 英文 \
--input paper.tex --output paper.zh.tex
bash ~/.claude/skills/chinese-polish/scripts/translate_file.sh \
--target 中文 \
--input README.md --output README.zh.md
LaTeX 专项物理术语映射
| 英文 | 中文 |
|---|
| photoelectron(s) | 光电子 |
| dark count rate | 暗计数率 |
| liquid scintillator | 液体闪烁体 |
| calibration | 刻度 |
| simulation | 模拟 |
| PMT | 光电倍增管(PMT) |
| neutrino | 中微子 |
| readout window | 读出窗口 |
| transit-time spread | 渡越时间弥散 |
| baseline | 基准线 |
| campaign | 调优活动 |
技术标识符（不翻译）：CDCalib, detsim, elec, rec, uproot, iminuit, SNiPER, LS_FULL, ACU_DCR_FIX, codearmy, EOS
润色模式
| 模式 | 触发关键词 | 说明 |
|---|
default | 默认/通用/不指定 | 保持原意，提升流畅度和可读性 |
academic | 学术/论文/严谨/正式 | 严谨客观，符合中文学术规范 |
business | 商务/商业/邮件/报告 | 专业简洁，适合商务沟通 |
casual | 口语/日常/轻松/亲切 | 自然亲切，接地气 |
前提检查
执行前先校验 API Key：
test -n "$DEEPSEEK_API_KEY" && echo "OK" || echo "MISSING"
如果输出 MISSING，告知用户需要设置环境变量：
export DEEPSEEK_API_KEY="sk-..."
并停止执行。
工作流 A：润色文本片段
用户直接粘贴文字时使用此流程。
- 从用户消息中提取待润色文本和模式（未指定则用
default）
- 将文本写入临时文件（避免 shell 转义问题）：
TMPFILE=$(mktemp /tmp/polish_input.XXXXXX.txt)
cat > "$TMPFILE" << 'TEXTEOF'
（待润色文本）
TEXTEOF
- 调用核心脚本：
bash ~/.agents/skills/chinese-polish/scripts/polish.sh <mode> --file "$TMPFILE"
rm -f "$TMPFILE"
- 脚本输出 JSON：
{"polished": "...", "changes": ["...", ...]}
- 按以下格式呈现结果：
## 润色结果（<模式>风格）
### 原文
> （原文，保留段落结构）
### 润色后
（润色后的文本）
### 主要修改
- 修改要点1
- 修改要点2
- ...
长文本处理（超过 2000 字）：按自然段落拆分，每段独立调用，最后合并拼接。
工作流 B：润色文件
用户要求润色某个文件时使用此流程（使用 polish_file.sh 完整工作流脚本）。
- 确认文件路径（要求用户提供绝对路径）
- 确认润色模式（未指定则询问或默认
default）
- 调用文件润色脚本：
bash ~/.agents/skills/chinese-polish/scripts/polish_file.sh \
--mode <mode> \
--input <input_file> \
[--output <output_file>]
- 脚本完成后告知用户：
- 润色后文件路径
- 处理的段落数
- 主要修改摘要（汇总各段的 changes）
工作流 C：翻译文本片段
用户要求翻译一段文字时使用此流程。
- 从用户消息中提取待翻译文本、源语言（可不指定，自动识别）、目标语言
- 将文本写入临时文件：
TMPFILE=$(mktemp /tmp/translate_input.XXXXXX.txt)
cat > "$TMPFILE" << 'TEXTEOF'
（待翻译文本）
TEXTEOF
- 调用翻译脚本：
bash ~/.agents/skills/chinese-polish/scripts/translate.sh \
--target <目标语言> \
[--source <源语言>] \
--file "$TMPFILE"
rm -f "$TMPFILE"
- 脚本输出 JSON：
{"translated": "...", "source_lang": "...", "target_lang": "..."}
- 按以下格式呈现：
## 翻译结果（<源语言> → <目标语言>）
### 原文
> （原文）
### 译文
（翻译后的文本）
语言参数说明：使用自然语言名称即可，如 中文、英文、English、日语、韩语、French 等，脚本直接透传给模型。
长文本处理（超过 2000 字）：按自然段落拆分，每段独立调用，最后合并。
工作流 D：翻译文件
用户要求翻译某个文件时使用此流程（使用 translate_file.sh）。
- 确认文件路径（要求绝对路径）
- 确认目标语言（必须指定），源语言可选
- 调用文件翻译脚本：
bash ~/.agents/skills/chinese-polish/scripts/translate_file.sh \
--target <目标语言> \
[--source <源语言>] \
--input <input_file> \
[--output <output_file>]
- 完成后告知用户：
错误处理
- API 返回非 200：展示 HTTP 状态码和错误信息，建议检查 API Key 或网络
- JSON 解析失败：直接输出原始响应，让用户判断
- 文件不可读：提示用户检查路径和权限
- 超时（> 60s）：建议缩短文本或分段提交
脚本说明
| 脚本 | 功能 |
|---|
scripts/polish.sh | 核心润色，接受模式和文本（文件方式），输出 JSON |
scripts/polish_file.sh | 文件润色完整工作流，分段处理，写入输出文件 |
scripts/translate.sh | 核心翻译，接受目标语言和文本（文件方式），输出 JSON |
scripts/translate_file.sh | 文件翻译完整工作流，分段处理，写入输出文件 |
