核心功能
docx-md 是一套低层级 Word 文档处理工具,专为 AI 文档审阅设计。它提供三个核心操作:读取(docx → Markdown/JSON)、修改(应用 AI 返回的修订)、定稿(接受修订并移除批注)。工具直接操作 OOXML 格式(ZIP + XML),不依赖 Microsoft Word 或商业库如 python-docx,确保跨平台可用性与格式兼容性。
显著优势
- Token 高效:默认输出 Markdown 格式,含
<!-- b:N -->块索引标记,显著降低 LLM 上下文长度;JSON 模式提供完整结构可选 - 原生 OOXML 支持:直接解析
word/document.xml和word/comments.xml,支持修订痕迹(w:ins/w:del)与批注锚点 - 完整工作流闭环:读取 → AI 编辑 → 应用修订 → 定稿输出,支持 tracked changes 和 comments 的商业级协作需求
- 轻量无依赖:除
docx-revisions(定稿阶段可选)外,核心功能纯标准库实现
潜在局限
- 仅解析
w:body内容,页眉/页脚、脚注、尾注、图表、复杂表格样式可能丢失或简化 - Markdown 格式为自定义方言,需配合特定 JSON 编辑格式(
blockIndex,originalContent,content,basis)使用 - 复杂格式(如修订嵌套、跨段落修订、样式继承)的还原精度取决于 OOXML 实现覆盖度
- 无可视化界面,纯命令行工具,需技术用户操作
适用人群
- 构建合同审查、法律文书、学术论文 AI 审阅系统的开发者
- 需在 CI/CD 流程中自动化 Word 文档处理的技术团队
- 追求 token 效率、希望替代昂贵商业 Office 自动化的场景
常规风险
- 格式丢失风险:非正文元素(文本框、嵌入式对象、复杂域代码)可能无法保留
- 修订冲突:并发编辑或复杂修订历史可能导致 apply 阶段推断错误
- 编码与国际化:OOXML 编码处理需验证多语言文档(CJK、RTL 语言)兼容性
- 依赖风险:定稿阶段依赖第三方库
docx-revisions,需审计其维护状态
认证状态
⚠️ 本技能未执行实际安全扫描,安全等级为基于架构的预评估。