SuperAPI AI 工具集

hwpx

通用与其它

查看项目

更新于 10-15 17:31

技能介绍

用途:以编程方式创建、读取、编辑 HWPX 文档(韩文开放文档格式,ZIP+XML,基于 KS X 6101/OWPML),并做模板占位符替换,适合报告、公文、起案文等韩文文档场景。

主要能力:使用 python-hwpx 库;通过 ObjectFinder 检索文档内文本;对 HWPX 包内 Contents/ 下 XML 做 ZIP 级文本替换(含表格内部);对重复占位符做顺序替换;支持新建文档、添加表格、设置页眉页脚、合并单元格等。

使用方式:安装命令为 pip install python-hwpx --break-system-packages。模板选择顺序为:优先使用用户上传的 .hwpx 模板(位于 /mnt/user-data/uploads/),其次使用内置模板(如 assets/report-template.hwpx),HwpxDocument.new() 仅用于极简单文档。流程为:复制模板到工作目录、用 ObjectFinder 全量排查文本、编写替换映射、执行 ZIP 级替换、运行 fix_namespaces.py 后处理、再次用 ObjectFinder 校验、输出到 /mnt/user-data/outputs/。

限制:HwpxDocument.open() 对复杂模板可能解析失败,建议只用 ZIP 级替换;每次保存或替换后必须执行 fix_namespaces.py,否则韩文 Viewer 可能显示空白页;该库不是排版引擎,分页由韩文应用决定;生成文件不含字体嵌入;仅处理 HWPX,不支持旧版 .hwp;公文日期格式为 2026. 2. 13. 形式。调用 fix_namespaces.py 应使用 subprocess.run(),不要用 exec()。