智能批量翻译
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3b1665b6/smart-batch-translation。
技能介绍
要解决什么问题
批量翻译文档时,常见做法要么让 AI 在对话里一段段翻(文件一多就拖垮上下文),要么丢给 Google Translate / DeepL 等机翻 API——术语飘、Markdown 和代码块经常被弄坏。本技能把翻译质量优先写进流程:默认由 Agent 手译;只有文件数量或篇幅让手译不现实时,才切到 scripts/translate.py / scripts/translate.js 做 LLM API 并发翻译,并明确不推荐传统机翻 API。
技能如何工作
策略选择:单文件或少量文本走「读取 → 逐段理解 → 保留格式 → 写出」;批量手动时一次并行读 8~10 个文件、逐文件翻译、再并行写入,并汇报进度。超大批量(例如目录下上百个 .md / .txt 等)用脚本 -i / -o、-b 目录模式、-c 并发,默认模型 deepseek-v4-flash,密钥经环境变量 DEEPSEEK_API_KEY(配合 deepseek-api skill),也可用 DEEPSEEK_BASE_URL 切到任意 OpenAI 兼容端点。
质量与可恢复性:脚本内置低 temperature 的 system prompt 保术语一致;输出目录维护 translation_progress.json 记录完成/失败与时间戳,全部完成后才删除。Agent 在脚本跑批时必须用进度文件时间戳判断是否在推进,禁止「假等待」或凭感觉估总时长。DEEPSEEK_API_KEY 不可用时可尝试 zhipu-api 的 glm-4.7-flash,再不行则让用户选手译或停任务。
格式边界:按文件类型约定「翻什么、不翻什么」(如 HTML 标签名不翻、代码逻辑不翻、注释里的描述性文字可翻),并给出译后文件命名(PascalCase、保留序号等)。
适用边界与注意点
- 不确定用手译还是 API 时,技能要求先问用户偏好,而不是静默上机翻。
- 并发需对照模型上限(flash 脚本侧默认可到 100),遇 HTTP 429 会指数退避。
- 大批量任务完成前,应持续以进度文件或进程退出码为准,勿中途当「已完成」。
使用场景
- 开源仓库要把整个 `docs/` 下几十份 Markdown 翻成英文,还要保留代码块与标题层级
- 本地化团队收到上百个 `.md`/`.yaml` 产品说明,需要在一次任务里并发译出并保持术语统一
- 技术作者只有一份超长 README,希望在对话里逐段手译而不是破坏排版的机翻
- DeepSeek 付费 Key 临时失效,需要按技能降级到智谱 `glm-4.7-flash` 或改回手译方案
适合人员
- 维护多语言文档库的文档工程师,既要大批量产出又要守住 Markdown/HTML 结构
- 负责 SDK 参考手册本地化的工程师,需要在注释与 prose 之间划清「可译 / 不译」边界
- 在 Agent 工作流里编排长时翻译脚本的平台集成者,必须用 `translation_progress.json` 判断任务是否卡住
- 小团队创始人亲自改 README 与产品文案,文件少时坚持手译、规模上来再开并发脚本