核心用法
DOCX Skill 专为需要格式保真的 Word 文档处理场景设计,覆盖读取、创建、编辑及视觉校验全流程。
显著优点
- 可视化校验机制:通过 DOCX→PDF→PNG 渲染链路,确保表格、图表、分页布局符合预期,避免纯文本提取导致的格式失真
- 专业级排版控制:基于
python-docx实现样式化创建(标题层级、表格、列表),输出符合商业交付标准的文档 - 工具链完备:提供
soffice/pdftoppm原生方案及scripts/render_docx.py辅助脚本,适配不同环境 - 质量门禁严格:明确要求 100% 缩放逐页检查、清除临时文件、禁止工具令牌残留
潜在缺点与局限性
- 环境依赖较重:需 LibreOffice、Poppler 等系统工具,容器化/受限环境可能无法渲染
- 无环境变量配置:缺乏动态配置入口,依赖硬编码路径和约定式目录结构
- 回退方案降级:工具缺失时仅能以文本提取作为 fallback,布局风险需人工确认
适合人群
- 需要交付客户级排版质量的文档工程师、法务/财务自动化、行政办公自动化开发者
- 对表格对齐、分页、视觉层次有硬性要求的场景
常规风险
- 渲染工具链缺失导致无法验证最终视觉效果
- Unicode 连字符(如 U+2011)引发排版异常
- 临时文件未清理造成信息泄露或磁盘冗余
- 跨平台字体差异导致换行/分页不一致