这是开源写的第42篇文章。
让 AI 帮你写文档，最后卡点往往不是「文案写不出来」。
而是 Word、Excel、PowerPoint 这些文件，Agent 不好碰。
要么装一整套 Microsoft Office，要么拼 python-docx、openpyxl、python-pptx 三套库。
写到一半还看不见版面，标题溢出、形状重叠，全靠猜。
OfficeCLI 想解决的，就是这件事：
给 AI Agent 一条命令行，直接读写改 .docx / .xlsx / .pptx。
不用装 Office，单文件二进制就能跑。
01 项目简介
OfficeCLI 是一套面向 AI Agent 的办公文档 CLI。
官方定位很明确：让 Agent 用一行命令控制 Word、Excel、PowerPoint。
它不做「又一个聊天插件」。
而是把文档当成可编程对象：创建、读取、修改、校验、预览，都能走命令行，而且支持稳定的 --json 输出。
更关键的是，它自带渲染能力。
Agent 可以把文档渲成 HTML 或 PNG，自己「看一眼」再改。
这就是官方常说的 render → look → fix 闭环。
不想折腾命令行的话，还有配套 GUI AionUi：自然语言描述需求，底层还是 OfficeCLI。
也难怪截至 2026-07-13，GitHub 上已经大约有 15,640 Star。
官网：https://officecli.ai
开源地址：https://github.com/iOfficeAI/OfficeCLI
02 核心亮点
三种格式，一套工具
Word、Excel、PowerPoint 都能 Create / Read / Modify。
不用再为三种文件装三套库、记三套 API。
对 Agent 更友好的是路径寻址。
比如 /slide[1]/shape[2]，直接指向某一页某个形状。
不用先啃 OOXML 命名空间，也能精确定位元素。
不用装 Office，也能「看见」文档
很多人一听自动化 Office，第一反应是：本机得有 Office 吧？
OfficeCLI 不是这条路。
它发的是自包含单二进制，运行时不要求你安装 Microsoft Office。
更狠的是内置渲染引擎：
- •
view screenshot：按页出 PNG，方便多模态模型看图 - •
watch：本地实时预览，默认 http://localhost:26315
你改一刀，浏览器跟着刷新。
这意味着 Agent 不用「盲写幻灯片」。
标题会不会溢出、两个形状会不会叠在一起，它可以先看再修。
CI、Docker、无显示器的服务器，只要二进制能跑，这套闭环就能用。
为 Agent 准备的输出和自愈
每个命令都能加 --json。
返回结构稳定，少做正则刮文本，也少猜 stdout。
出错时也不是一句含糊报错。
会带结构化错误码，比如 not_found，并附带 suggestion、合法范围。
Agent 可以先 get 一层子节点，再自己改路径重试。
另外还有：
- •
validate：按 OpenXML schema 校验 - •
view … issues：枚举溢出、缺 alt text、公式错误等问题
这套东西合在一起，才像「给机器用的 Office API」，而不是给人类演示的玩具 CLI。
自动化三件套：常驻、批处理、模板
多步改同一个文件时，可以 open 进 Resident 模式，把文档留在内存里。
改完再 close / save 刷盘。
一批操作也能走 batch，一次喂多条命令。
模板场景更实用：
用 merge 把 {{key}} 替换成 JSON 数据。
Agent 或设计师先定版式，生产侧只负责填数。
避免每次从零生成报告，版式漂来漂去，还浪费 Token。
还有 dump：把现有文档（或某一子树）序列化成可回放的 batch JSON。
想模仿一份人写好的样例，就 dump → 改 → batch，比直接啃原始 XML 轻松。
Excel 不只是改格子
内置 350+ 公式函数，写入后就能算。
get 时已经能拿到结果，不必先绕一圈打开 Excel 重算。
数据透视也能一条命令生成原生 OOXML pivot。
文件拿去 Excel 打开，聚合结果已经在。
对做报表流水线的人来说，这比「只能写字符串公式、自己不会算」实用得多。
AI 工具几乎开箱即用
装完后执行 officecli install，它会尝试检测本机的 Claude Code、Cursor、Copilot 等，并写入 skill。
也可以直接：
curl -fsSL https://officecli.ai/SKILL.md
把技能文件喂给 Agent。
还内置 MCP：
officecli mcp cursorofficecli mcp claudeofficecli mcp vscode
不走 shell，也能把文档能力暴露成工具。
Python / Node 另有薄 SDK（officecli-sdk / @officecli/sdk），适合常驻管道，避免每次拉起进程。
03 快速上手
Windows 一键装
PowerShell：
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
也可以：
brew install officecliscoop install officeclinpm install -g @officecli/officecli
或从 GitHub Releases 下载对应平台二进制，再跑 officecli install。
验证：
officecli --version
30 秒看实时预览
officecli create deck.pptxofficecli watch deck.pptx
另开一个终端：
officecli add deck.pptx / --type slide --prop title="Hello, World!"
浏览器里应能立刻看到新页。
最小可用流程
officecli create deck.pptxofficecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2Eofficecli add deck.pptx '/slide[1]' --type shape \ --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \ --prop font=Arial --prop size=24 --prop color=FFFFFFofficecli view deck.pptx outlineofficecli view deck.pptx htmlofficecli get deck.pptx '/slide[1]/shape[1]' --jsonofficecli close deck.pptx
小提示：Resident 模式下，如果要用 python-docx、Word 或其他外部程序读同一个文件，先 save 或 close 刷盘。
也可以设 OFFICECLI_RESIDENT_FLUSH=each，让每次改动立刻落盘。
04 适用人群
比较适合：
- • 做 Agent / 编程助手，需要稳定产出 Office 文件的人
- • 要在 Docker、CI、无头服务器里批量出报告的开发者
- • 不想碰命令行、只想自然语言出文档的人（优先看 AionUi）
不太适合把它当成：
- • Microsoft Office 的完整替代品（复杂桌面排版、插件生态另说）
能力面非常宽，Word/Excel/PPT 细节在 Wiki 里很长。
上手时建议先抓住主线：安装 → create → watch → add/set → view/validate。
需要时再下钻到具体元素属性。
最后
OfficeCLI 的价值，不在于又多了一个改 pptx 的脚本。
而在于它把三件事捆在一起了：
Agent 能调用的 CLI + 不用装 Office 的单二进制 + 能看见版面的渲染闭环。
再配上 JSON 输出、MCP、模板 merge，它更像给 AI 时代准备的办公自动化底座。
想试的话，先装二进制，跑一遍 watch；
要给 Agent 用，丢一句 curl -fsSL https://officecli.ai/SKILL.md 就够起手。
如果觉得内容对你有帮助，欢迎点赞、转发支持！
长期更新，想第一时间收到消息，记得点点关注！！！
谢谢观看我的文章，我们下次见。
