CHM反编译与再编译压缩
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3b1665b6/chm-decompile-compile。
技能介绍
为什么需要完整的重构工作流?
直接把 .chm 当成普通的压缩包解压修改,往往会遇到各种各样难以排查的玄学问题:图片路径突然失效、左侧目录面板消失、工具栏完全空白,甚至出现乱码。这是因为 CHM(Compiled HTML Help)本质上是一种基于 LZX 压缩算法的复合文档,内部不仅包含 HTML,还有一套高度耦合的二进制控制文件。本技能面向需要深度修改 CHM 文档的开发者和本地化工程师,提供了一套严谨的解包与回编译标准流程。
核心能力与关键步骤
技能遵循标准的 CHM 逆向工程工作流构建:
- 完整提取与元数据解析:利用
7-Zip深层破解 CHM,除了标准的 HTML、CSS、JS 与图片资源,还会精准分离.hhc(目录结构)和.hhk(索引)文件,并处理#SYSTEM、$FIftiMain等内部的二进制元数据。 - HHP 项目文件生成与对齐:如果原文件包含
.hhp则直接复用;否则自动生成。在[WINDOWS]配置行中,严格对齐逗号字段,确保工具栏和导航面板的十六进制标志位(如0x77F3E)精确落位。在[FILES]段中强制注入包括子文件夹在内的所有静态资源的相对路径,彻底杜绝图片路径被拍平导致链接断裂的问题。 - 历史编码转换与内容清洗:支持处理老旧 windows-1252 编码的 HTML,将其平滑转换为 UTF-8。对于 HHC/HHK 文件,绝对避免使用 UTF-8,转而采用 GBK 编码确保中文目录在官方查看器中正常渲染。
- 重编译与强制二进制修补:调用
hhc.exe完成编译。编译后,强制要求从原文件提取#WINDOWS数据的非字符串字段,将原始窗口属性(如fsWinProperties=0x516)直接覆盖注入新文件,重新唤回导航面板和所有工具栏按钮。
适用边界与技术注意点
该技能极度依赖 Windows 环境和特定的遗留工具链。除了 7-Zip,编译过程必须使用 hhc.exe 及其相关的依赖 DLL(如 hha.dll)。由于微软早已停止分发 HTML Help Workshop,开发者往往需要去寻找归档的安装包。
在内容编辑层面有几个致命坑点:.hhp 文件必须保持纯 ASCII 编码,任何非英文字符(哪怕只是一个中文字符)都会导致编译器静默失败;itircl.dll 未注册虽然会报 HHC6003 警告,但不影响最终的 CHM 生成。此外,在修改 HHC 和 HHK 时,只能动条目的 Name 属性值,绝不可改动内部的 Local 锚点链接,否则会导致文档内部死链。
使用场景
- 修改现有CHM帮助文档的UI布局,调整目录层级,并强制恢复丢失的工具栏按钮
- 翻译CHM文件中的英文内容为中文,严格保留原HTML标签结构及所有内部导航锚点链接
- 修复因图片子目录路径被压缩器拍平导致方框不显示的CHM文件,重新打包并保留完整目录树
- 逆向工程编译后的CHM内部二进制配置,找回被强制覆盖的错误窗口标志位以恢复左侧导航面板
适合人员
- 负责维护Windows桌面软件文档的开发者,诉求是深度修改现有CHM文件的结构而不破坏原有导航
- 从事技术本地化的工程师,诉求是将英文CHM帮助系统翻译成中文并保持所有内部链接有效
- 处理旧版软件帮助文档的技术支持,诉求是修复因编辑工具错误导致的工具栏或图片不显示的问题
- 逆向工程遗留Windows软件的技术人员,诉求是修改CHM内部二进制配置以恢复被隐藏的界面组件