用途:处理韩文(Hancom Office)HWPX 文档,支持生成、读取和编辑。HWPX 是基于 ZIP 的 XML 容器(OWPML 标准),在需要保留格式的编辑中可直接操作 OWPML XML,精细控制 charPr、paraPr 和表格结构。
主要能力:提供分析模板、提取可编辑槽位、按槽位填充、替换文本、填写表格单元格、重写正文段落、验证结构、修正命名空间、去除行布局缓存、检查页面漂移、检查内容完整性、公文档格式检查、文本提取等脚本。默认工作模式为:分析附件 HWPX → 高保真恢复 XML → 按请求重写。
使用方式:在已有参考文件时,先运行 analyze_template.py 分析并提取 XML,再用 hwpx_slots.py 导出槽位 JSON,映射新值后通过 edit_hwpx.py --slot-json 进行结构保留编辑,最后用 validate.py、fix_namespaces.py、finalize_hwpx.py 验证与收尾,并必须通过 page_guard.py 与 content_guard.py。无参考文件时,可用 build_hwpx.py 基于模板(base/gonmun/report/minutes/proposal)从 section0.xml 构建,或直接编写 XML 并用 build_hwpx.py 组装。
适用场景:需要保留原有版式、页数、表格结构和字体样式的 HWPX 文档生成与编辑,如公文、报告、会议纪要、提案等。
限制:仅支持 HWPX,明确拒绝 .hwp 二进制文件的创建、保存、编辑、填充或转换结果生成;.hwp 仅可读取参考。不修改用户未明确要求的结构元素(如 hp:p、hp:tbl、rowCnt、colCnt、pageBreak、secPr)。禁止使用普通 ZIP 重新打包。若参考文件存在,最终页数须与参考一致。所有 Python 脚本需在已安装 lxml 的虚拟环境中运行。具体价格、平台支持范围等资料暂未提供。