adeu

Adeu：LLM 时代的修订追踪

LLM 使用 Markdown；审阅者使用“修订追踪”。

Adeu 是一个 docx ↔ LLM 转换器：它是一个模型上下文协议（MCP）服务（提供 Python 和 Node.js 实现）及配套 SDK，可充当 Microsoft Word 的虚拟 DOM。它提供双向抽象层，让 AI Agent 可以自由编辑文档文本，而不会破坏底层格式或复杂的 DOCX XML。

python-docx 等标准库擅长从头生成文档，却无法无损地标记修订。Adeu 通过将 .docx 文件转换为节省令牌的 Markdown 表示来解决这一问题。这让 AI Agent 可以专注于文档语义，而不必浪费令牌处理 OpenXML。

Adeu 充当一个智能代理，将 AI 的编辑作为安全、原子化的事务处理：

1. 读取：将文档（从磁盘或实时 Word）转换为适合 LLM 的 CriticMarkup，并附上包含术语定义、交叉引用和疑似拼写错误的语义附录。Agent 从语义结构而非原始数据开始处理。
2. **验证：**充当严格的安全关卡。在任何更改写入文件之前，自动拦截含糊的文本匹配或无效的结构变更，以保护文档完整性。
3. **应用：**将 AI 的文本编辑转换为 Word 原生修订。Adeu 在底层处理复杂的 XML，确保现有布局、字体和页边批注都得到完美保留。

由 Adeu 团队构建并维护。

---

安装

Adeu 可直接作为 MCP 服务安装到 AI 助手中，也可用作 Claude Code 插件或 Agent Skill、CLI 工具，或用作本地开发工具链。

Claude Code（插件）

Adeu 作为 Claude Code 插件发布，内置 Agent Skill，可教会 Claude 如何有效使用引擎。在 Claude Code 中：

/plugin marketplace add dealfluence/adeu
/plugin install adeu-redlining@adeu-skills

为获得最佳效果，还可连接 Node MCP 服务（npx -y @adeu/mcp-server）或 Python MCP 服务（uvx --from adeu adeu-server）。即使没有 MCP 服务，插件也能运行——它会回退到通过 Bash 调用 uvx adeu CLI。

其他兼容 Skills 的 Agent（Cursor、Windsurf、VS Code Copilot 等）

Adeu 的修订标记 Skill 遵循开放的 Agent Skills 规范，适用于任何兼容的 Agent：

npx skills add dealfluence/adeu

该 Skill 会安装到 Agent 的 skills 目录中；当你要求 Claude 对 .docx 文件标记修订、编辑或审阅时，它会自动启用。

Claude Desktop

你可以使用官方扩展包将 Adeu 直接安装到 Claude Desktop：

1. 从 GitHub Releases 页面下载最新的 Adeu.mcpb 文件。
2. 打开 Claude Desktop，进入 Settings > Extensions。
3. 点击 Advanced settings，找到 Extension Developer 部分。
4. 点击 Install Extension...，选择下载的 .mcpb 文件，然后按照提示操作。

Gemini CLI

Adeu 可作为原生的 Gemini CLI 扩展 使用。安装方法：

gemini extensions install https://github.com/dealfluence/adeu

其他 MCP 客户端（Cursor、Windsurf 等）

对于通过 JSON 配置 MCP 服务的 IDE 或客户端，你可以使用 Node.js 或 Python 后端：

Node.js

{
  "mcpServers": {
    "adeu": {
      "command": "npx",
      "args": ["-y", "@adeu/mcp-server"]
    }
  }
}

Python（在 Windows 上与 MS Word 实时集成时必需）

{
  "mcpServers": {
    "adeu": {
      "command": "uvx",
      "args": ["--from", "adeu", "adeu-server"]
    }
  }
}

Smithery

使用 Smithery 包管理器安装 Adeu：

npx -y @smithery/cli install adeu --client claude

---

Agent 工作流

Adeu 为 Agent 提供专用工具，用于安全地阅读、审阅和编辑文档。

MCP Apps UI：read_docx 工具支持 MCP Apps UI 协议。Agent 阅读文档时，Adeu 会在聊天窗口中直接动态呈现自定义的交互式 Markdown 视图。

推荐的 Agent 提示词： 将以下上下文添加到 Agent 的系统提示词或项目说明中，可确保获得最佳行为效果：

**角色：**文档专家 工具：

• read_docx(clean_view=True)：读取文本最终的“清稿”版本，以了解上下文。使用 search_query 和 page 筛选条件定位特定条款，无需通读全文。
• process_document_batch：**提交与协商模式。**应用统一的更改列表。使用 type: "modify" 执行特定的搜索并替换文本编辑（支持使用 match_mode="all" 和 regex=True 进行批量更新），并使用 type: "accept"、"reject" 或 "reply" 按 ID 管理现有修订和批注。
• finalize_document：**发送前清理。**清除危险元数据、作者姓名和内部跟踪 ID，锁定文档（protection_mode="read_only"），并做好分发准备。

MS Word 实时集成

如果你在安装了 Microsoft Word 的 Windows 上运行，Adeu 可以充当实时副驾驶，直接编辑当前打开的文档。这需要运行 Python MCP 服务后端（见下文“开发者工具”）。

---

开发者工具（Python 和 TypeScript）

如果你正在构建法律科技应用、自动化流水线，或想使用本地 CLI，请使用我们的 SDK。

Python CLI

Python 工具链通过 uv 管理。

pip install uv
uv tool install adeu

# Extract clean text for RAG or prompting
adeu extract contract.docx -o contract.md

# Generate a visual diff between two versions
adeu diff v1.docx v2.docx

# Apply edits to the DOCX
adeu apply contract.docx edits.json --author "Review Bot"

# Apply valid edits in salvage mode while reporting failing edits
adeu apply contract.docx edits.json --partial

# High-throughput JSON-Lines daemon
adeu serve

# Scrub author metadata and internal trackers
adeu sanitize redline.docx -o clean.docx --keep-markup --author "My Firm" --report

文本投影会原样保留哪些内容、会规范化哪些内容（列表、 样式、合成页面），以及哪些内容保持只读，详见 docs/FIDELITY.md。

Python SDK

from adeu import RedlineEngine, ModifyText
from io import BytesIO

with open("MSA.docx", "rb") as f:
    stream = BytesIO(f.read())

edit = ModifyText(
    target_text="State of New York",
    new_text="State of Delaware",
    comment="Standardizing governing law."
)

engine = RedlineEngine(stream, author="AI Copilot")
engine.apply_edits([edit])

with open("MSA_Redlined.docx", "wb") as f:
    f.write(engine.save_to_stream().getvalue())

TypeScript SDK

整个核心解析和差异比较引擎也提供纯 TypeScript 版本。

import { readFileSync, writeFileSync } from "fs";
import { DocumentObject, RedlineEngine } from "@adeu/core";

const buffer = readFileSync("MSA.docx");
const doc = await DocumentObject.load(buffer);

const engine = new RedlineEngine(doc, "AI Copilot");
engine.process_batch([{
  type: "modify",
  target_text: "State of New York",
  new_text: "State of Delaware",
  comment: "Standardizing governing law."
}]);

const outBuffer = await doc.save();
writeFileSync("MSA_Redlined.docx", outBuffer);

完整的安装和使用详情，请参阅 @adeu/core 文档。

n8n 社区节点

Adeu 提供 n8n 社区节点（n8n-nodes-adeu），适合偏好使用可视化工作流自动化而非代码的团队。它将完整引擎（提取 Markdown、应用修订、生成差异以及定稿文档）作为即插即用节点提供，可用于确定性流水线和 AI Agent 工具调用。

# In n8n: Settings → Community Nodes → Install: n8n-nodes-adeu

有关安装、$fromAI 用法和工作流示例，请参阅 n8n-nodes-adeu README。

---

LangChain 集成

langchain-adeu 是一个官方集成包，可将 Adeu 本地且支持离线使用的文档处理工具直接接入 LangChain 生态系统。

pip install langchain-adeu

将其功能作为工具集成到 Agent 工作流中：

from langchain_adeu import AdeuToolkit

# Instantiate and retrieve all document tools
tools = AdeuToolkit().get_tools()

完整的开发说明和详细参数，请参阅 LangChain 工作区指南。

---

生态系统与集成

Adeu 专为 DOCX 的虚拟 DOM 而设计。由于我们严格专注于 OpenXML 安全性，因此专门维护了 ecosystem/ 目录，用于第三方集成。

生态系统文件夹包含第三方贡献的政策和指南，例如法律验证工作流、CLM 同步脚本和专用的多 Agent 架构。

你是供应商或构建者吗？ 欢迎向生态系统文件夹提交 PR！请参阅我们的供应商与集成政策以开始。

---

Adeu Cloud

默认情况下，Adeu 核心修订引擎和本地文件工具完全开源，并且完全在你的机器上运行。Adeu 绝不会将你的本地文档发送回服务器（不过，你选择的大模型提供商自然会处理 Agent 读取的文本）。

不过，对于需要端到端工作流的团队，你可以连接到 Adeu Cloud，以使用以下功能：

• 邮件处理与获取： 我们提供扩展的 MCP 服务，支持安全地获取邮件线程、提取文档和自动起草内容，帮助你直接从收件箱处理合同。

详细了解 Adeu Cloud。

---

贡献

我们欢迎社区贡献！无论是修复错误、添加功能还是改进文档，请参阅我们的贡献指南，了解如何设置本地 uv 环境、运行测试，以及理解项目严格的 XML 安全准则。

---

许可证

MIT 许可证。开源，可免费用于商业应用。