Markdown 术语表翻译助手 Skill 技能

技能简介

fuhehe12-translate（Markdown 本地化翻译） 针对的是长文档翻译的老问题：分段丢给模型直译，术语前后不一致、语气漂移、代码块被改坏。这个 Skill 的做法是先建"术语表 + 翻译简报"，再按规则分段翻译、合并校验，把翻译从一次性动作变成有约束的流程。它以中文为默认目标语言，覆盖 zh-CN、zh-TW、zh-HK、zh-SG、zh-MY 五种中文 locale 引用，任意语言对之间也可互译。技能在 Skillstore 质量评分 81 分（silver 档），riskLevel 为 safe，已完成安全审计，支持 Claude、Codex、Claude Code，采用 MIT 许可，累计下载 117 次。

核心能力

• 语言对全覆盖：任意语言互译，默认目标语言为中文，内置五种中文 locale 的用词参考。
• 先建术语表：翻译前生成临时术语表与翻译简报，把关键术语的译法先定下来。
• 长文件分段：超过 1000 行的文件自动拆成符合 Markdown 结构的分段，支持并行翻译。
• 结构无损合并：合并分段后自动检查标题、代码围栏、链接是否完整。
• 格式保护：代码块、链接、YAML frontmatter、Markdown 表格等结构一律保留原样。
• locale 感知：面向台湾、香港、新加坡、马来西亚等市场的繁简体与地区用词差异有专门引用。

安装配置

1. 在项目目录执行 npx skillstore add fuhehe12/translate 完成安装。
2. 适用工具为 Claude、Codex、Claude Code；分段与合并依赖技能自带的本地 Python 辅助脚本，运行环境需允许执行本地脚本。
3. 开始前明确目标语言与 locale（例如"台湾繁体、用台湾术语"），这是术语表生成的输入。
4. 输入须为 Markdown 或纯文本，PDF、图片等其他格式要先转换再交给它。

使用步骤

1. 短文件直译：下达"把这个 Markdown 文件译成简体中文，保留标题、链接、表格和代码块"即可。
2. 指定 locale：明确目标地区（如 zh-TW），技能按对应 locale 术语库出稿。
3. 文档集统一术语：对一组文档先建一份共享术语表，再逐篇翻译，保证跨文件术语一致。
4. 大文件四步流程：先确认拆分计划，再分段并行翻译，然后合并，最后跑一遍质量复查。
5. 人工校对：重点复核术语表选词与长文件合并结果，确认后再交付。

适用场景

• 技术文档中文化：把英文开发者文档译成中文，同时保住代码块、链接与 Markdown 结构。
• 产品内容本地化：README、产品文案面向特定中文市场改写，用词全篇统一。
• 长研究笔记处理：超长 Markdown 笔记分段并行翻译后合并成完整文档。
• 多文件批量翻译：文档集共享一份术语表，避免同一术语出现三种译法。

适用人群

本地化与出海工程师、技术文档写作者、维护多语言 README 的开源项目作者、需要批量处理翻译的内容团队，以及对术语一致性有要求的翻译校对人员。

工作原理

技能把翻译拆成四段流水线：准备阶段读取源文档并生成术语表与翻译简报，把关键术语、语气、目标 locale 固定下来；分段阶段按行数阈值把长文件切成不破坏 Markdown 结构的片段；翻译阶段各片段并行处理，按术语表约束用词；合并阶段拼回全文并校验标题层级、代码围栏、链接完整性。安全审计未发现提示注入、编码载荷或凭证外传，仅提示三处 Bash 片段会运行本地辅助脚本或清理临时文件，需要用户授权后执行。

官方链接

• 技能主页：https://skillstore.io/skills/fuhehe12-translate
• 源码仓库：https://github.com/FuHehe12/Nitro-Engine/tree/main/translate
• 技能清单：https://skillstore.io/api/skills/fuhehe12-translate/manifest