# Docx-CLI

Docx-CLI 是一款命令行工具，旨在让 AI Agent 在不重写整个文件的前提下，对 Microsoft Word .docx 文档进行读取、编辑、批注和修订。它专为重视格式完整性和 Word 人工复核权衡的智能体工作流而设计。

Canonical URL: https://aiidelist.com/zh/ide/docx-cli

Language: zh

更新日期: 2026-10-06

## 概览

- 分类: Developer Workflow Tools
- Docx-CLI 是一款本地优先的命令行文档自动化工具，适用于需要安全地检查、编辑、修订和批注 Microsoft Word .docx 文件的 AI Agent。
- 编辑器基础: CLI
- 平台: macOS, Linux, Windows, Claude Code, Codex, Pi, Agent Skills-compatible harnesses
- 开源: 是
- 本地模型支持: 否
- 自带 API 密钥: 否

## 简评

如果核心需求是让 AI Agent 在保留格式、批注和修订语意的基础上安全地处理现有 Word 文档，请选择 Docx-CLI。如果需要多格式支持、大规模数据提取或模板生成，请选择更通用的 Office 自动化工具或文档转换库。

## 适合场景

- 需要在不破坏格式的情况下编辑 Word 文档的 AI Agent
- 合同修订和法律文档审阅工作流
- 需要在 .docx 文件中添加批注的学术、评分和审阅工作流
- 围绕 Word 文件构建文档自动化流水线的开发团队
- 偏好使用命令行操作文档的本地优先用户

## 优点

- 专为 AI Agent 编辑 Word 文档而构建
- 比直接重写 OOXML 更好地保留格式
- 支持批注和修订功能，便于人工审阅
- 开源且免费使用
- 兼容多种 Agent Skill 环境

## 局限

- 需要托管协作式文档编辑器的团队
- 寻求通用型 AI 编程助手的用户
- 以 PDF、电子表格或演示文稿而非 Word 文档为中心的工作流
- 偏好仅使用图形界面进行 Word 自动化的非技术用户
- 专注于 .docx 而非全能的 Office 自动化
- 除非指定输出路径或使用副本流，否则变更命令会覆盖原文件
- 要求 Agent 或用户理解基于定位器的编辑逻辑
- 某些工作流仍需 Word 或 LibreOffice 进行最终视觉确认
- 项目较新，版本更新频繁

## 为什么选择 Docx-CLI？

Docx-CLI 解决了 AI 开发中一个虽小但却十分棘手的痛点：AI Agent 擅长文本推理，但 Word 文档并非纯文本。一个 .docx 文件实际上是一个包含 OOXML 部件、关系、样式、批注、修订记录、媒体和节元数据的 ZIP 压缩包。让 Agent 直接重写这种复杂结构非常容易出错。

Docx-CLI 为 Agent 提供了一个更安全的抽象层。Agent 无需编辑原始 XML，而是读取带有注释的文档表示，定位到稳定的文档定位器（locators），并调用明确的命令来执行替换、批注、修订、样式更改和结构编辑。当输出结果必须能在 Microsoft Word 中正常打开并由人工审阅时，这款工具显得尤为重要。

## 核心工作流

典型的工作流程始于复制源 Word 文件，读取特定区域，然后应用针对性编辑。Agent 可以搜索文本、格式、高亮、样式、批注、图像、超链接、页眉、页脚或修订记录。对于合同或审阅文档，Agent 可以开启修订模式、替换短语、在特定文本段添加批注，最后将最终决策权留给在 Word 中进行审阅的人工用户。

最核心的概念是**基于定位器的编辑**。Docx-CLI 不使用模糊的自然语言（如“修改第三段的第二句话”），而是公开段落和字符范围等引用。这使得 Agent 的操作更具可重复性且易于验证，但也意味着用户需要适应比图形界面编辑器略显技术化的工作流。

## 适用场景

Docx-CLI 在文档已存在且格式至关重要的工作流中表现最强。**合同审查**是天然的匹配场景，因为批注和修订需要完全符合 Word 用户的预期。它还可以辅助学生论文评测、基于量表的评分、简历改版、内部政策修订、模板填充以及文档质量检查（QA）。

如果任务仅仅是从头开始生成新文档，那么它的优势就不太明显。对于纯模板化需求，docxtemplater 或 docx.js 等库可能更简单。对于涉及 PDF、HTML、图像和多种 Office 格式的大规模文档解析，Docling 等转换工具包可能是更好的底层选择。

## 竞品对比

与通用文档库相比，Docx-CLI 更倾向于 **Agent 导向**。python-docx 和 docx.js 适合开发者编写应用程序代码来调用文档 API。而当终端 Agent 需要明确的命令契约、可预测的标准输出（stdout）、退出代码、稳定定位器以及便于人工复核的变更命令时，Docx-CLI 是更好的选择。

与 OfficeCLI 相比，主要在于**广度与深度**的权衡。OfficeCLI 定位于 Word、Excel 和 PowerPoint 的自动化，而 Docx-CLI 专精于 Word .docx 工作流。这种专注在文档审阅任务中可能是一个优势，因为批注、修订、定位器和 Word 格式保真度是该产品的设计核心。

## 最佳配置建议

对于 Agent 工作流，在使用 Claude Code、Codex、Pi 或其他兼容框架时，建议将其安装为 **Agent Skill（智能体技能）**。这能让 Agent 获得工具指令，并在运行时保持命令界面的可发现性。对于脚本编写和 CI 式用法，使用**独立二进制文件**路径更清爽，因为它可以避免依赖全局 Bun 环境。

为了确保编辑安全，请将 Word 文件视为源代码资产：在副本上操作，尽可能指定输出路径，渲染或打开结果进行验证，并将原始文件保留在版本控制或对象存储中。虽然 Docx-CLI 可以减少格式破损，但在处理具有法律、学术或商业重要性的文档时，人工最终审核依然不可或缺。

## 迁移建议

目前正在尝试让 Agent 解压 .docx 并直接修补 OOXML 的团队，应考虑将 Docx-CLI 作为更安全的替代层。迁移工作主要是调整 Agent 提示词和工具契约：使用 Docx-CLI 读取，针对定位器操作，应用显式命令，然后验证结果。

已拥有 Python 或 JavaScript 文档处理流水线的团队不一定需要替换现有系统。Docx-CLI 可以作为面向 Agent 的辅助工具，用于审阅、修订和针对性编辑，而原有代码继续处理批量生成或模板工作流。

## 功能

### Word 文档编辑

- 以带批注的 Markdown 或 JSON AST 格式读取 .docx 文件
- 查找、替换、插入、删除和编辑文档内容
- 通过原地变更 OOXML 保留现有 Word 格式

### 审阅工作流

- 在特定文本段落添加 Word 批注
- 开启并管理修订记录（Tracked Changes）
- 通过命令行接受或拒绝修订内容

### Agent 集成

- 作为 Agent Skill 支持 Claude Code、Codex、Pi 等兼容框架
- 使用段落和字符范围等稳定定位器
- 为非交互式 Agent 提供命令说明和 Schema 信息

### 文档保真度

- 支持样式、表格、页眉、页脚、图片、超链接、脚注和大纲
- 可通过 Word、LibreOffice 或自动检测的引擎渲染文档
- 提供适用于 Linux、macOS 和 Windows 的独立二进制文件

## 价格

open-source

- Open Source: $0 — one-time — 采用 MIT 许可证的 GitHub 开源项目，可通过 Bun、独立二进制文件或 Agent Skill 安装。

价格核对日期: 2026-07-09

## 隐私与数据处理

Docx-CLI 作为命令行工具在本地运行并编辑磁盘文件；隐私安全性取决于所使用的 AI Agent 或模型提供商，以及是否将文档发送至外部模型。

## 替代工具

- OfficeCLI
- Docling
- Python Docx
- docx.js
- docxtemplater

## 资料来源

- [官方网站](https://github.com/kklimuk/docx-cli)
- [GitHub 仓库](https://github.com/kklimuk/docx-cli)
- [Agent Skill 列表](https://www.claudepluginhub.com/plugins/kklimuk-docx-cli)
- [Hacker News 讨论](https://news.ycombinator.com/item?id=48821500)

最近核对日期: 2026-07-09

## 更新记录

- 2026-07-09: 基于官方 GitHub 仓库及公开插件/讨论资料创建的初始目录配置。