一、用途 Adeu 被定位为“LLM 时代的修订追踪（Track Changes）”工具。大语言模型擅长处理 Markdown，而评审人员习惯使用 Word 的“修订”功能，Adeu 负责在这两者之间架桥。它是一个 docx ↔ LLM 翻译器：将 .docx 办公文件投影为便于编辑的 Markdown，再把编辑结果以 OOXML 修订（redlines）的形式写回文档。它同时是一个 Model Context Protocol（MCP）服务器（提供 Python 与 Node.js 两种实现）及配套 SDK，相当于 Microsoft Word 的“虚拟 DOM”，提供一个双向抽象层，让 AI 代理自由编辑文档文本而不破坏底层格式或复杂的 DOCX XML。
二、主要能力 Adeu 作为智能代理，将 AI 的编辑作为安全、原子化的事务处理，分为三个阶段：
- 读取（Read）：将文档（来自磁盘或实时 Word）翻译为对 LLM 友好的 CriticMarkup，并附带“语义附录”，包含已定义术语、交叉引用和可能的拼写错误，让代理从语义结构而非原始数据出发。
- 校验（Validate）：充当严格的安全闸门，自动阻止模糊的文本匹配或无效的结构更改，在改动触及文件之前保护文档完整性。
- 应用（Apply）：将 AI 的文本编辑转换为 Word 原生修订，由 Adeu 在底层处理复杂 XML，确保现有布局、字体和边距批注得到完整保留。
代理可用的具体工具包括：
- read_docx(clean_view=True)：读取最终“干净”版本文本以理解上下文，可用 search_query 和分页过滤定位特定条款而无需通读整篇文档。该工具支持 MCP Apps UI 协议，读取文档时会直接在聊天窗口内渲染自定义的可交互 Markdown 视图。
- process_document_batch：提交与协商模式（Commit & Negotiate Mode），可应用统一变更列表。类型 "modify" 用于具体的查找替换文本编辑（支持 match_mode="all" 与 regex=True 批量更新），类型 "accept"、"reject"、"reply" 用于按 ID 管理已有的修订和批注。
- finalize_document：发送前清理（Pre-Send Scrub），剥离危险元数据、作者姓名和内部跟踪 ID，锁定文档（protection_mode="read_only"）并准备分发。
三、使用方式 Adeu 可作为 MCP 服务器安装进 AI 助手，也可作为 Claude Code 插件或 Agent Skill、CLI 工具，或本地开发者工具链使用。
- Claude Code 插件：内置 Agent Skill，教 Claude 如何有效使用该引擎。为取得最佳效果，可同时连接 Node MCP 服务器（npx -y @adeu/mcp-server）或 Python MCP 服务器（uvx --from adeu adeu-server）；插件在没有 MCP 服务器时也可工作，会退回通过 Bash 驱动 uvx adeu CLI。
- 其他兼容 Skills 的代理（Cursor、Windsurf、VS Code Copilot 等）：其 redlining 技能遵循开放 Agent Skills 规范，可安装到代理的 skills 目录，并在要求对 .docx 文件进行 redline、编辑或审阅时自动激活。
- Claude Desktop：可下载 GitHub Releases 页面上的 Adeu.mcpb 文件，在 Settings > Extensions 中通过 Advanced settings 的 Extension Developer 区域选择 Install Extension... 安装。
- Gemini CLI：提供原生 Gemini CLI 扩展。
- 其他 MCP 客户端（Cursor、Windsurf 等）：可通过 JSON 配置，使用 Node.js 或 Python 后端。Windows 上的实时 MS Word 集成需要 Python 后端。
- Smithery 包管理器：可使用 Smithery 安装 Adeu。
- 实时 MS Word 集成：在 Windows 且安装 Microsoft Word 时，Adeu 可作为实时副驾，在你面前编辑当前活动文档，需运行 Python MCP 服务器后端。
四、开发者工具
- Python 工具链通过 uv 管理。
- TypeScript SDK：整个核心解析与 diff 引擎也以纯 TypeScript 提供，见 @adeu/core 文档。
- n8n 社区节点（n8n-nodes-adeu）：将完整引擎（提取 Markdown、应用修订、生成 diff、定稿文档）暴露为可直接使用的节点，适用于确定型流水线和 AI Agent 工具调用。
- LangChain 集成：langchain-adeu 是官方集成包，将 Adeu 本地、可离线的文档操作工具暴露给 LangChain 生态，可打包为代理工作流中的工具。
- 生态与集成：核心严格聚焦 OpenXML 安全，第三方集成放在 ecosystem/ 目录，托管法律校验工作流、CLM 同步脚本、专用多代理架构等贡献的政策与指南。
- 保真度说明：文本投影精确保留什么、规范化什么（列表、样式、合成分页）、什么是只读，在 docs/FIDELITY.md 中有详细规格。
五、适用场景与限制 适用场景：需要让 AI 代理对 Word 文档进行非破坏性修订的法律、合规或文档审阅类工作流；从空白生成文档之外的标准库（如 python-docx）难以完成的无损红线编辑；希望通过 MCP、CLI、n8n 或 LangChain 接入自动化的团队。 隐私与许可：默认核心 Adeu redlining 引擎与本地文件工具完全开源，全部在你的机器上执行，Adeu 不会把本地文档回传（不过你选择的 LLM 提供方自然会处理代理读取的文本）。对于需要端到端工作流的团队，可连接 Adeu Cloud 解锁邮件处理与获取等能力，包括提供扩展 MCP 服务器，支持安全获取邮件线索、提取文档和自动起草，以便直接在收件箱中处理合同。项目采用 MIT 许可证，开源且可免费用于商业应用。 说明：以上内容依据所提供的公开资料整理，关于具体价格、平台支持范围及其他未提及功能，资料中暂未提供。
