SuperAPI AI 工具集

translate-docs

写作与研究

查看项目

更新于 10-16 08:49

技能介绍

用途:把 VMark 文档(website/guide/**/*.md)和应用界面字符串翻译到 9 种语言:zh-CN、zh-TW、ja、ko、de、fr、es、it、pt-BR。文档模式为默认模式,应用字符串模式需加 --app,用于同步 React(i18next)src/locales 与 Rust(rust-i18n)src-tauri/locales 中缺失的键。

主要能力:文档模式下按“翻译→审核→文化润色”流程运行,最多并行 9 个翻译子代理,随后并行审核,仅对 CJK 语言做文化润色;每个页面最多 22 次子代理调用。翻译规则要求保留 Markdown 结构、链接 URL、代码块、表格、front matter 与 VitePress 容器标签,技术术语如 VMark、Tauri、ProseMirror、Tiptap、CodeMirror、Mermaid、Vitest、API、MCP 等保持英文;CJK 需中英间距、全角标点,zh-TW 用台湾用语与「」,ja 用「」与适当假名混合,ko 用韩文并保持术语英文。应用字符串模式采用增量同步:只翻译英文存在而目标语言缺失的键,绝不重翻已有键;键路径、YAML 注释、插值占位符(i18next 的 {{name}} 与 rust-i18n 的 %{name})、复数后缀 _one/_plural 均须原样保留。

使用方式:先运行 pnpm lint:i18n 检查缺失键;文档模式读取英文源文件、并行翻译、审核、CJK 文化润色,再写入 website/{locale}/guide/ 并更新 website/.vitepress/config/{locale}.ts 侧边栏,最后 cd website && pnpm build。应用字符串模式先检测缺失键,再并行翻译、审核、CJK 润色,然后合并到目标文件,运行 pnpm lint:i18n 与(Rust 侧)cd src-tauri && cargo check -q,最后 9 种语言一次性提交。仓库内另有 scripts/propagate-i18n-keys.mjs 和 scripts/propagate-rust-errors.mjs 两个预填充脚本,但它们只负责写入,不审核也不润色。

适用场景:新增或更新 website/guide 页面;lint:i18n 报告缺失键;需要同步 i18n 新键。限制:文化润色仅用于 CJK;审核不通过最多重试 2 次;现有键不得修改,翻译更新时应先读取旧译文以保留人工术语选择。