问 【开源项目介绍】Word AI

仓库地址：https://github.com/flyfish-dev/word-ai/blob/main/

介绍文章：AI 改 Word，最怕格式崩：Word AI 开源，63 个 MCP 工具守住结构

技能：word-ai/skills/word-ai at main · flyfish-dev/word-ai

适用场景

1. 你有一份已经排好版的合同、标书、需求文档、项目方案或审计报告，希望 AI 只编辑指定位置。

2. 你希望 Codex 能读取 Word 结构，找到标题、表格、内容控件、批注、字段和图片，然后生成可审查的编辑计划。

3. 你希望正式写入前先做 dry-run，写入后能看到 diff、audit JSON 和结构验证结果。

4. 你希望既能处理磁盘上的 .docx，也能编辑当前 Microsoft Word 窗口里打开的文档。

5. 你希望接入 OfficeCLI 的渲染、截图、query、validate 能力，又不希望正式写入绕过审计链路。

核心能力

• 63 个 MCP tools，覆盖 DOCX 检查、锚点、标题、段落、表格、字段、图片、批注、修订、PatchSet 规划、dry-run、正式写入、验证、回滚、diff、Word 打开会话内编辑，以及可选 OfficeCLI 只读证据能力。

• 所有正式写入收口到 PatchSet，默认不覆盖源文件。

• Agent 友好的 PatchSet 归一化，兼容 operation、target_tag、new_text、text_sha256 和 camelCase 操作名等常见字段，但不绕过正式安全门禁。

• 优先使用内容控件 tag，例如 WORD-AI:SRS:1.0:overview。

• 并发安全前置条件：source_sha256、expected_old_sha256、expected_old_text。

• 结构验证：保护 package parts、内容控件、表格、段落、字段、图片、批注、修订痕迹和正文块顺序。

• Python MCP facade 与 bridge runtime，负责本地 Agent 集成、路径策略、session 队列和分发兼容。

• .NET 8 Open XML SDK 引擎，作为离线 DOCX 事务的权威后端；优先使用打包 native 二进制或 Release DLL。

• 单文件 standalone 二进制与 quickstart 包，离线 DOCX 编辑无需 clone 源码、创建 venv、安装 pip 依赖或本地 .NET SDK，并可一键安装 Agent Skill。

• Office.js taskpane，支持创建/列出锚点、构建 PatchSet、预览、dry-run、apply，以及对当前打开的 Word 文档进行 hash 校验后的内容控件写入。

• Word 会话 MCP 工具，Codex 可以通过 word_session_* 读取当前打开文档、预览 PatchSet、调用 Office.js 写入并获取审计和 rollback PatchSet。

设计原则

大模型擅长生成文本，但 Word 文档不是纯文本，而是复杂的 OOXML 包结构。直接把 DOCX 转成 Markdown/HTML 再转回 DOCX，容易破坏编号、样式、字段、交叉引用、图片关系和版式。因此，Word AI 的设计原则是：

• 模型只生成受约束的 PatchSet。

• 本地执行层对 OOXML / Open XML 做定点修改。

• 每次写入必须经过评估、dry-run、备份、验证、审计和 diff。

• Office.js 加载项负责 Word 端锚点治理和人工审批体验。