SuperAPI AI 工具集

doc-smith-localize

写作与研究

查看项目

更新于 10-15 19:53

技能介绍

用途:将 Doc-Smith 生成的文档本地化为多种语言,支持批量与增量翻译,并保持术语一致。

主要能力:按语言代码翻译全部或指定文档;基于源 HTML 的 SHA256 hash 判断是否需要翻译,未变化则跳过;支持 --force 强制重译、--skip-images 跳过图片;可扫描并翻译 assets 中的图片文字,同步到 dist 发布目录;翻译后更新 config.yaml 的 translateLanguages 并重建 nav.js 以启用语言切换。

用法示例: /doc-smith-localize --lang en /doc-smith-localize -l en -l ja /doc-smith-localize -l en -p /overview /doc-smith-localize -l en --force /doc-smith-localize -l en --skip-images

选项:--lang/-l 目标语言(可多次)、--path/-p 指定文档路径(可多次)、--force/-f 强制重译、--skip-images 跳过图片。

约束:需存在 .aigne/doc-smith/config.yaml 与 planning/document-structure.yaml,否则提示先用 /doc-smith 生成文档;目标语言不能与源语言相同;--path 必须存在于 document-structure.yaml。翻译在 HTML 层面完成,仅翻译 title、meta description、main[data-ds=content]、nav[data-ds=toc] 四个区域,不翻译资源引用、script、header/footer/sidebar、HTML 属性及代码块。每个文档到每种语言为一个独立 Task,后台运行,每批最多并行 5 个,通过 .status 文件轮询结果,单批超时 10 分钟。图片翻译前需检测后端(GEMINI_API_KEY 或 AFS CLI),不可用时须让用户选择,禁止默认跳过。翻译完成后必须重建 nav.js: node skills/doc-smith-build/scripts/build.mjs --nav --workspace .aigne/doc-smith --output .aigne/doc-smith/dist

适用场景:多语言技术文档站点本地化、批量文档翻译与图片文字翻译。限制:依赖 Doc-Smith 工作区结构;翻译失败不覆盖已有译文;具体收费与平台支持暂未提供。