什么是Gonggong Hwpxskills Main
Gonggong Hwpxskills Main 是一个专为处理韩文 HWPX 格式文档而设计的技能工具，支持创建、读取、编辑以及基于模板的文档生成。该工具通过 ZIP 级别的模板替换机制，实现了高度自动化的文档输出流程，尤其适用于需要批量生成标准化报告或表单类文件的场景。其核心能力在于将动态数据与预定义模板结合，快速生成结构完整、内容准确的 HWPX 文件，显著提升文档处理的效率与一致性。
该技能默认提供基础模板 `assets/report-template.hwpx`，用户也可上传自定义模板至 `uploads/` 目录进行使用。所有生成的最终文档将统一保存于 `outputs/` 文件夹中，便于后续管理与分发。整个工作流以命令行接口驱动，支持对模板中的文本占位符进行智能提取和映射替换，确保数据注入的精准性和灵活性。
此外，为增强对复杂 HWPX 结构的解析能力，系统推荐安装 python-hwpx 库；若环境不支持，则内置轻量级代理 `lib/hwpx_shim.py` 作为替代方案，保障功能在多种环境下稳定运行。整体设计兼顾易用性与扩展性，是面向韩语办公自动化、企业报表生成等需求的实用解决方案。
核心功能特点
- 支持 ZIP 级别模板替换，实现高效的文档批量生成
- 内置默认模板 `report-template.hwpx`，同时允许用户上传自定义模板
- 提供命令行工具分析模板中的文本占位符并执行数据映射替换
- 自动生成输出文件至 `outputs/` 目录，便于集中管理结果文档
- 兼容 python-hwpx 库，内置轻量级 shim 保障无依赖环境下的基本功能
适用场景
Gonggong Hwpxskills Main 特别适用于需要频繁生成结构化韩文文档的业务场景，例如企业内部定期发布的月度/季度报告、客户合同模板填充、员工信息登记表自动化生成等。由于 HWPX 是韩国广泛使用的办公软件格式，该工具可无缝集成进韩语本地化办公流程中，避免手动重复录入带来的错误与低效。
在数据驱动型任务中，如将数据库查询结果或 API 返回的数据批量填入固定格式的 HWPX 模板，该技能能大幅缩短开发周期并降低人工干预风险。例如财务部门每月导出销售汇总报告时，只需配置好字段映射关系，即可一键生成数百份个性化文档，极大提升运营效率。
此外，对于需要定制化模板但缺乏编程能力的非技术人员，该工具提供了直观的操作路径——上传模板后通过 JSON 映射文件指定数据对应关系，无需编写代码即可完成复杂文档组装。无论是系统集成商、外包服务商还是企业内部 IT 团队，都能借此技能快速构建文档自动化流水线，实现从数据到专业格式文档的无缝转换。