核心用法
doc-format-gw 是一款专为中国党政机关及企事业单位设计的 Word 文档自动化排版工具。用户可通过命令行或 Python API 调用,将普通 Word 文档一键转换为符合《党政机关公文格式》(GB/T 9704-2012)国家标准的正式公文。
命令行调用:
python3 ~/.npm-global/lib/node_modules/openclaw/skills/doc-format-gw/format_gw.py <input.docx> <output.docx>
Python API 调用:
from format_gw import format_document
format_document('input.docx', 'output.docx')工具自动完成以下排版任务:
- 智能识别四级标题层级,自动应用对应字体、字号(如方正小标宋_GBK 二号用于一级标题)
- 正文统一设置为仿宋_GB2312 三号字,28 磅行距
- 页边距标准化(上 37mm、下 35mm、左 28mm、右 26mm)
- 自动格式化表格样式与页码设置
显著优点
1. 纯本地处理,零隐私风险:全程离线运行,文档内容不上传任何服务器,彻底解决敏感公文外泄隐患。
2. 国家标准合规:严格遵循 GB/T 9704-2012 公文格式规范,减少人工排版误差。
3. 轻量无依赖:仅依赖 python-docx 官方库,无复杂依赖链,部署简单。
4. 双模式调用:既支持命令行快速处理,也支持 Python 集成,便于嵌入办公自动化流程。
潜在缺点与局限性
1. 字体依赖问题:强制依赖特定中文字体(如方正小标宋_GBK、仿宋_GB2312),若系统未安装将触发异常,当前错误提示不够友好。
2. 输入验证不足:路径遍历防护较弱,极端情况下可能处理恶意构造的输入路径(如 ../../../etc/passwd)。
3. 格式覆盖有限:专注于公文场景,不支持学术论文、商业合同等其他排版需求;复杂表格、图文混排可能需人工微调。
4. 社区维护风险:发布者为 ClawHub 社区个人开发者(batduke),长期维护稳定性与功能更新存在不确定性。
适合人群
- 政府机关文秘人员:高频处理红头文件、通知、通报等标准公文。
- 国企/事业单位行政岗位:需批量生成格式统一的对外正式文档。
- 公文写作爱好者:希望快速掌握国标公文格式的非专业用户。
- 办公自动化开发者:需将公文排版能力集成至内部 OA 系统。
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 数据泄露 | 极低 | 纯本地处理,无网络通信 |
| 恶意代码 | 极低 | 无危险函数调用,无动态代码下载 |
| 依赖漏洞 | 低 | 依赖 python-docx 官方库,需保持更新 |
| 字体缺失 | 中 | 系统缺字体时排版失败,需预装字库 |
| 路径遍历 | 低 | 建议显式验证输入文件路径 |
安全认证摘要
- 安全等级:A(标准安全级别)
- 来源可信度:T3(社区发布者)
- 六维评分:静态分析 95、动态分析 90、依赖审计 100、网络流量 100、隐私合规 85、威胁情报 70
- 许可证:MIT-0(公共领域 dedication,使用最自由)
建议:当前版本可放心使用,但需预装所需中文字体;关注作者 batduke 后续更新动态。