用途:translate-docs 用于维护 Cherry Studio 仓库中英文与简体中文成对文档的一致性,覆盖翻译、补全、核对、重命名和删除等操作。
使用前准备:需要先阅读配对约定(pairing contract)、翻译规则、生成的术语表以及文档治理(docs-governance)说明,再开始翻译工作。
分诊策略:
- 已有文档对、仅一侧变更:利用 sidecar 哈希判断哪一侧是作者侧,只修补受影响的最小对应单元。
- 两侧均变更或记录的 blob 不可用:手动核对并整段处理受影响章节。
- 新建文档对:逐节翻译并保持结构不变。
- 重命名或删除:英文、中文与 sidecar 三者一起移动或删除。
翻译原则:翻译过程中不得静默修复不准确的技术内容;应报告源文档缺陷,或在任务授权下依据当前代码同时修正两种语言。
批量处理:当用户要求按领域或语料库补全时,将文件划分为互不重叠的领域归属集合。翻译工作者读取完整规则与术语表,只修改分配到的文档对,并返回待定术语。整合代理在 scripts/i18n-glossary.json 中解决术语问题,重新生成术语页与索引,检查链接与结构,记录 sidecar,并运行语料库门禁。
完成验证:核对条款、标识符、代码围栏、列表、表格、链接、frontmatter 与自然措辞,然后运行:
pnpm docs:check-pairing --write <pair> pnpm docs:check-pairing <pair>
在 PR 层面运行一次 pnpm docs:check。配对门禁通过并不代表语义保真。
限制:目前资料未提供该技能在仓库外的独立安装方式、收费模式或平台支持信息;其适用范围集中在 Cherry Studio 仓库文档治理流程内。