CHM 帮助文件翻译器
将以下提示词粘贴到你的 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 编译报错,需要掌握编码与二进制补丁流程来批量处理归档手册。