OfficeCLI：面向 AI 智能体的 Office 套件命令行工具

1. 项目概述

OfficeCLI 是一款单文件命令行工具，让 AI 智能体和开发者无需安装 Microsoft Office，即可创建、读取、分析和修改 Word、Excel 及 PowerPoint 文档，并支持高保真可视化渲染。

2. 背景与定位

OfficeCLI 自称为“全球首款也是最好的专为 AI 智能体设计的 Office 套件”。其核心使命是为自主 AI 系统提供一种可靠、结构化且可检查的方式来生成真实的 Office 文件，弥合 LLM 文本输出与人类可直接打开并信任的 .docx/.xlsx/.pptx 交付物之间的差距。

与传统方法（通过 COM/UNO 自动化驱动 Microsoft Office/LibreOffice，或使用 python-docx 和 openpyxl 等 Python 库编写脚本）相比，OfficeCLI 从底层构建即为 AI 原生：它作为一个包含嵌入式 .NET 运行时的独立二进制文件发布（无需安装 Office，无外部依赖），采用基于路径的寻址模型（例如 /slide[1]/shape[2]），完美契合 LLM 对文档的推理方式，并内置渲染引擎，使智能体在交付前能够直观地验证自身输出。

3. 功能分类

📄 文档操作 — 20 条命令（create、view、get、set、add、remove、move、swap、batch、validate）— 通过一致且支持路径寻址的命令集，实现 .docx、.xlsx 和 .pptx 文件的完整增删改查生命周期管理。
🎨 渲染与预览 — 支持 HTML、PNG、PDF 和 SVG 输出 — 将文档转换为高保真视觉内容，便于智能体（及人类）检查结果，并提供实时刷新的 watch 命令。
📊 Excel 引擎 — 350+ 内置函数 — 支持公式计算、动态数组以及直接基于数据区域的原生数据透视表生成，无需电子表格引擎。
🔁 数据与模板 — merge、dump — 支持 {{key}} 占位符模板合并以批量生成文档，并提供双向 JSON 序列化以实现可重放的文档蓝图。
🤖 AI 智能体集成 — MCP 服务器、自动安装技能包 — 可作为 Model Context Protocol 服务器注册（officecli mcp claude），并能自动检测并将技能文件安装到 Claude Code、Cursor 和 GitHub Copilot 等工具中。

4. 核心亮点

零依赖单二进制文件 — 内嵌 .NET 运行时，无需安装 Office，无需 COM 自动化，也没有脆弱的系统依赖链。
三层架构 — L1 语义视图（文本、大纲、统计信息）、L2 结构化 DOM 操作（通过路径进行 get/set/add/remove）以及 L3 原始 XPath 访问（用于边缘情况）— 兼顾高层便捷性与底层控制力。
内置可视化渲染 — 可按需将文档渲染为 HTML/PNG/PDF/SVG，让 AI 智能体能够“看到”其生成的内容，而非仅凭原始 XML 猜测。
驻留模式 — officecli open 可将文档保留在内存中以供多条命令连续使用，实现近乎零延迟的多步编辑工作流。
原子化批量操作 — 可通过 batch 将多次编辑归入单个事务，降低部分应用更改的风险。
原生 MCP 支持 — 开箱即用，兼容 Claude Code、Cursor、VS Code 及其他支持 MCP 的 AI 工具，并提供 Python 和 Node.js SDK 以实现更深度的编程集成。

5. 角色应用场景

通用开发者 — 在 CI 流水线或后端服务中自动生成报告、发票或幻灯片，无需捆绑 Office 或 LibreOffice。
AI 智能体构建者 — 通过内置 MCP 服务器，为编码/办公智能体提供可靠工具，使其能在智能体工作流中生成并验证真实的 Office 交付物。
数据/研究科学家 — 直接从数据管道生成包含计算公式和数据透视表的 Excel 工作簿，或基于结构化数据生成模板化的 Word/PowerPoint 报告。
项目经理 — 结合数据文件使用 merge 命令，从单一模板批量生成状态报告、提案或演示文稿。

6. 快速入门

查找所需内容 — 浏览命令参考和 Wiki 获取特定格式指南：

officecli --help
officecli view <file> outline

安装与集成：

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex
# 注册为 Claude Code 的 MCP 服务器
officecli mcp claude

参与贡献：

git clone https://github.com/iOfficeAI/OfficeCLI.git
# 构建需要 .NET 10 SDK；输出为独立的原生二进制文件

向 main 分支提交拉取请求，或加入社区 Discord 先行讨论想法。

7. 项目结构

OfficeCLI/
├── src/officecli/     # 核心 CLI 源代码
├── sdk/                # Python 和 Node.js SDK
├── skills/             # AI 智能体技能定义（Claude Code、Cursor 等）
├── plugins/            # 扩展性框架
├── schemas/            # OpenXML 验证模式
├── examples/           # 可运行的示例脚本
├── npm/                # Node.js 包分发
├── assets/             # 可视化演示与展示素材
└── .github/workflows/  # CI/CD 自动化

src/officecli 包含三层文档引擎；skills/ 中的内容会被自动安装到检测到的 AI 编码工具中；sdk/ 则是希望以编程方式访问而非调用 CLI 的团队入口点。

8. 相关生态

上游/运行时： .NET 10 SDK（构建时）、OpenXML 格式规范（OfficeCLI 依据此进行模式验证）。
AI 工具集成： Model Context Protocol (MCP)、Claude Code、Cursor、VS Code、GitHub Copilot — OfficeCLI 作为文档操作后端接入这些工具。
互补/替代工具： 通过 Microsoft Office/LibreOffice COM/UNO 进行的传统自动化，以及 python-docx 和 openpyxl 等 Python 库 — OfficeCLI 以 AI 原生、无依赖的 CLI 形式解决相同领域的问题。

9. 许可证

基于 Apache License 2.0 授权。

✅ 可免费使用、修改和分发，包括用于商业和闭源产品。
✅ 包含贡献者的明确专利授权。
❌ 不提供任何担保；软件按“原样”提供。
ℹ️ 修改后的版本必须保留版权、许可和归属声明，并清楚说明所做的任何更改。

10. 常见问题

问：使用 OfficeCLI 需要安装 Microsoft Office 吗？
答：不需要。OfficeCLI 作为包含嵌入式 .NET 运行时的独立二进制文件发布，直接操作 OpenXML 文件。

问：支持哪些文件格式？
答：.docx (Word)、.xlsx (Excel) 和 .pptx (PowerPoint)，包括 Excel 公式计算和数据透视表。

问：OfficeCLI 如何与 AI 编码助手集成？
答：它作为 MCP 服务器运行（officecli mcp claude），并可自动将技能文件安装到 Claude Code、Cursor、VS Code 和 GitHub Copilot 等支持的工具中。

问：能否在不使用 Office 打开的情况下预览文档？
答：可以 — 使用 officecli watch <file> 进行实时刷新的浏览器预览，或使用 officecli view <file> 渲染 HTML/PNG/PDF/SVG 输出。

问：是否有编程 SDK，还是仅有 CLI？
答：两者皆有 — 安装 officecli-sdk (Python) 或 @officecli/sdk (Node.js) 即可直接从代码调用 OfficeCLI 功能。

11. 快速链接

代码仓库：https://github.com/iOfficeAI/OfficeCLI
官方网站：https://officecli.ai
文档/Wiki：https://github.com/iOfficeAI/OfficeCLI/wiki
社区 (Discord)：https://discord.gg/2QAwJn7Egx

12. 总结

OfficeCLI 填补了 AI 工具生态中的一个特定空白：为智能体提供了一种无依赖、支持路径寻址且可视觉验证的方式来生成真实 Office 文档。其主要受众是构建文档生成管道的开发者，以及需要输出可信 Word/Excel/PowerPoint 文件的 AI 智能体团队 — 内置渲染和 MCP 集成使其特别适用于 AI 需要自查工作的智能体工作流。