Agent Skills
返回列表
CHM 帮助文件翻译器

CHM 帮助文件翻译器

内容创作 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3b1665b6/chm-translate。

技能介绍

CHM 编译的 Microsoft HTML 帮助文档常因编码不兼容而在跨语言场景下出现乱码、导航丢失或编译失败。这个技能提供一条完整流水线:decompile → translate → fix encoding → recompile,把 .chm 文件拆解、翻译、修复并重新打包。

核心能力与步骤

  • 解包与结构分析:通过 7-Zip 解压 .chm,区分 .html、.hhc、.hhk、.css、.js 与图片资源,统计文本体量以决定翻译策略。
  • 切块翻译:scripts/translate_chm.py 自动检测编码,把 20KB 以上的大文件按标题或段落切成 chunk,并发调用 DeepSeek API 后重组。
  • 编码清洗:统一将 charset 修正为 utf-8、lang 更新为 zh-CN,并剥离 API 可能注入的 Markdown 代码块包裹。
  • 重编译与补丁:重建 HHC/HHK 后用 hhc.exe 编译,再对 #WINDOWS 做二进制补丁,恢复导航面板与工具栏。

必须注意的坑

  • HHC/HHK 要保存为 GBK,不要用 HTML Entities,否则目录面板会显示乱码。
  • HHP 文件必须保持 纯 ASCII,连 Title 字段写入中文都会静默编译失败。
  • [WINDOWS] 行中 default topic 与 toolbar flags 之间必须 精确 6 个逗号,数量不对会导致工具栏消失。
  • 即使 HHP 正确,hhc.exe 仍会把 fsWinProperties 写成 0x6E,所以 每次编译后都必须做二进制补丁。
  • 图片必须在 [FILES] 段列出完整相对路径,否则路径会被扁平化导致引用失效。

适用边界

整条流程依赖旧版 hhc.exe,补丁步骤还需要原始 CHM 作为对照;它处理的是桌面帮助文档的本地化,不适用于实时在线站点翻译。

使用场景

  • 接手外部软件英文 CHM 手册,需要把目录、正文翻成中文并重新打包成可直接双击打开的离线帮助文档。
  • 从老文档光盘拆出 .chm 想在中文系统用,发现目录和工具栏消失,需要重新编译并做二进制补丁修复导航。
  • 开源项目只有英文 CHM 帮助,希望产出带中文目录和索引的离线文档,让用户能按关键词检索并跳转。
  • 内部工具说明书是 .chm 格式,不想改版做网页,需要保持双击打开的形式完成全文翻译并保留导航结构。

适合人员

  • 软件本地化译员:手上有一批英文 CHM 产品手册,需要产出能正常编译的中文版离线帮助并交付测试验证。
  • 开源项目维护者:想为中文用户提供可离线检索的 CHM 文档,不愿为了翻译重写整套帮助站结构。
  • 企业 IT 支持:需要把老版英文软件的 CHM 帮助快速转成中文版,让现场操作者双击就能按目录查阅。
  • 技术文档工程师:负责监控 HHC/HHP 编译报错,需要掌握编码与二进制补丁流程来批量处理归档手册。