Agent Skills
返回列表
CHM反编译与再编译压缩

CHM反编译与再编译压缩

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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内部二进制配置以恢复被隐藏的界面组件