OfficeCLI：专为AI Agent设计的命令行Office套件

OfficeCLI 是一款专为 AI Agent 设计的开源 Office 套件。它只需要一个二进制文件，无需安装 Microsoft Office，就能创建和编辑 Word、Excel、PowerPoint 文档。该项目于今年 3 月开源，4 个月收获超过 15000 Star，并内置了渲染、公式、模板三大引擎，让 AI 能够真正“看着”文档完成报告、透视表和 PPT 的生成。

一句话：它是什么？

官方定位是“世界上第一个专为 AI Agent 设计的 Office 套件”。传统自动化方案（VBA、python-docx、openpyxl、LibreOffice UNO）需要写大量代码、理解复杂 API，而 OfficeCLI 的核心思路是：让 AI 像人一样，用最简单的命令行操作文档。

创建一份 PPT 只需要几条命令：

officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 报告"
officecli add deck.pptx '/slide[1]' --type shape \
--prop text="收入增长 25%" --prop x=2cm --prop y=5cm

如果用 python-pptx 实现同样功能，往往需要 50 行以上代码。

三大核心引擎

OfficeCLI 不是简单的文件格式转换器，它内置三个真正意义上的引擎，这是与竞品的本质区别。

1. 渲染引擎——让 AI“看见”文档

传统工具只给 AI 提供 XML 结构，AI 无法判断标题是否溢出、形状是否重叠、排版是否美观。OfficeCLI 从零实现了 HTML 渲染引擎，可将文档渲染为网页或截图。AI 通过 view html 查看渲染结果，通过 view screenshot 截图分析，甚至用 watch 命令在浏览器里实时预览。渲染→观察→修正的闭环，让 AI 能够“看着改”。整个过程不需要安装 Office，也不依赖 GUI 环境，在 Docker 和 CI 中也能运行。

2. 公式引擎——Excel 不是纯数据

写入 =SUM(A1:A2) 后，用 get 命令读取单元格，数值已经计算完成。OfficeCLI 内置 350+ Excel 函数的完整实现，包括：

• 动态数组：FILTER / SORT / UNIQUE / SEQUENCE / LAMBDA
• 财务函数：XIRR / PRICE / YIELD / DURATION
• 统计函数：NORM.DIST / T.TEST / LINEST
• 查询函数：VLOOKUP / XLOOKUP / INDEX / MATCH

写入公式即刻计算出结果，不需要打开 Excel 刷新。数据透视表也只需一条命令：

officecli add sales.xlsx '/Sheet1' --type pivottable \
--prop source='Data!A1:E10000' \
--prop rows='Region,Category' \
--prop values='Revenue:sum,Units:avg'

3. 模板引擎——一次设计，批量生成

先用 AI 设计一份排版精美的模板，再用 merge 命令以 JSON 数据填充 {{key}} 占位符：

officecli merge invoice-template.docx out-001.docx \
'{"client":"Acme","total":"$5,200"}'

模板设计消耗一次 token，批量填充则零 token 消耗，非常适合生成 100 份合同、1000 张发票的场景，能显著控制成本。

为 AI Agent 而生

OfficeCLI 从设计初衷就不是给人手动敲命令，而是给 AI Agent 调用，因此具备许多“AI 友好”特性。

三层架构：渐进式复杂度

• L1（Read）：通过 view 查看文档结构、统计信息、问题列表。
• L2（DOM）：用 CSS 选择器风格的 query 查找元素，用 set / add / remove / move 操作。
• L3（Raw XML）：极少数特殊需求下直接操作底层 XML。

结构化 JSON 输出

所有命令支持 --json，输出格式一致且可预测，无需通过正则解析 stdout。

自愈工作流

操作失败时，错误消息会附带建议和合法值范围。例如查询不存在的 Slide 50，它会提示“总共只有 8 页，有效范围 1-8”。AI 可以据此自行纠错，减少人工干预。

MCP 服务器

内置 MCP（Model Context Protocol）服务器，一行命令即可注册到 Claude Code、Cursor、VS Code 等工具：

officecli mcp claude
officecli mcp cursor

之后 Agent 可直接通过工具调用操作文档，连 shell 都不需要。

快速上手

安装命令只需一行：

# macOS / Linux
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

也支持 Homebrew、Scoop、npm 安装：

brew install officecli
npm install -g @officecli/officecli

安装后运行 officecli --version 验证。让 AI Agent 读取 SKILL.md 即可了解用法：

curl -fsSL https://officecli.ai/SKILL.md

与竞品相比如何？

• Microsoft Office：功能最全，但需付费授权，没有 AI 友好的 CLI/JSON 接口，不能无头运行。
• LibreOffice：开源免费，但 UNO API 学习曲线陡峭，同样不是为 AI 设计。
• python-docx / openpyxl：Python 生态常用，但需要 Python 环境，三种格式要分别使用不同库，且不支持渲染、动态公式计算。
• OfficeCLI：开源（Apache 2.0）、单二进制、跨平台、无依赖，Word/Excel/PPT 一套搞定，内置渲染引擎和公式引擎，支持 MCP，专为 AI 设计。

写在最后

OfficeCLI 的出现，把文档自动化从“手写 VBA 或拼 XML”推进到了“描述意图，Agent 执行”的阶段。15000+ Star 反映了这个需求的真实性和迫切性。项目仍在快速迭代（撰写时最新版 v1.0.135），如果你正在用 AI Agent 处理文档，值得一试。

• GitHub: https://github.com/iOfficeAI/OfficeCLI
• 官网: https://officecli.ai