OfficeCLI:让 AI 亲手改 PPT 的 C# 开源命令行工具,半年 3 万 Star

❝

OfficeCLI 是 C#/.NET 编写的开源命令行工具，能让 AI Agent 渲染、预览并修改 PPT/Word/Excel。半年获 3 万 Star，本文解析其渲染闭环、Excel 引擎、三层架构与真实优缺点

最近折腾 AI 写周报这事儿有点上头。让 Claude 帮我整一份项目汇报 PPT，它哗哗输出一堆文本，看着挺像回事——打开一看，标题溢出文本框、两个色块叠在一起、字 号大的大小的小。它不是不会写，它是看不见。Agent 只能读到 XML 结构，渲染出来什么样，它压根不知道。

后来在 GitHub Trending 上刷到一个项目，正好治这个病：OfficeCLI。

❝

• 仓库：https://github.com/iOfficeAI/OfficeCLI
• 官网：https://officecli.ai

先报数据，都是 2026 年 9 月 20 号当天从 GitHub API 拉的：30,853 star，Apache-2.0 协议，仓库今年 3 月 15 号才建，半年多冲到 3 万+。最新版 v1.0.151 是 9 月 16 号发的，迭代非常猛。最关键的一点，很多人没注意到——它的代码库主体就是 C#（语言统计里 C# 占 14MB+，其他都是些脚本），发行版是内嵌了 .NET 运行时的自包含单文件二进制。换句话说，这是用 .NET 做出来的爆款 AI 工具，8 个平台每个就一个 32MB 左右的可执行文件，不装 Office、不带任何依赖。

它解决的不是"操作 Office"，是"AI 看不见自己写的东西"

市面上操作 Word/Excel/PPT 的库一大把，Python 的 python-docx、openpyxl，.NET 这边有 NPOI、ClosedXML、Open XML SDK。这些库都是让"人"写代码调用的，接口再友好，也只是改 XML。

OfficeCLI 的思路不太一样。它内置了一个从零写的 HTML 渲染引擎，能把 docx/xlsx/pptx 渲染成 HTML，再配合无头浏览器出逐页 PNG 截图。这一下就把"AI 盲写"变成了"写完能看，看完能改"：

官方 README 里有句话说得挺扎心：没有可视化，生成幻灯片的 Agent 就是在盲飞——它能读 DOM，但判断不了标题是不是溢出了、两个形状是不是叠了。渲染引擎塞进二进制之后，这个"渲染 → 看 → 修"的循环在 CI 里、Docker 里、没有显示器的服务器上都能转起来。

这个点我觉得是它半年攒 3 万 star 的核心原因。不是命令多好用，是它补上了 Agent 干文档活最缺的那双眼睛。

上手：三十秒看到东西

安装几条路任选：Windows 用 Scoop（scoop install officecli），macOS/Linux 用 Homebrew（brew install officecli），或者 npm 装个壳拉对应平台二进制。我这边直接下载 Release 里的 exe，也行。

跟着官方 README 走一遍，大致用法是这样（以仓库文档为准）：

# 建一个空 PPTofficecli create deck.pptx# 开实时预览，浏览器里开 http://localhost:26315officecli watch deck.pptx# 另开个终端加一页，浏览器秒刷officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2Eofficecli add deck.pptx '/slide' --type shape \  --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \  --prop font=Arial --prop size=24 --prop color=FFFFFF

这个 watch 模式我挺喜欢。你敲一条命令，浏览器立刻刷新，Excel 还支持在预览里直接改单元格、拖图表位置。写命令行工具能把反馈闭环做到这个份上的不多。

看文档也有好几种姿势：view outline 出大纲、view text 出纯文本、get 带 --json 出结构化数据，喂给 Agent 正合适：

officecli view deck.pptx outlineofficecli get deck.pptx '/slide/shape' --json

对 AI Agent 的接入做得很顺手。二进制装好后跑一句 officecli install，它会自动探测机器上的 Claude Code、Cursor、Copilot 这些工具，把 skill 文件塞进去，Agent 立刻就能使唤它。懒一点的，直接把 https://officecli.ai/SKILL.md 丢进 Agent 对话框也行。

不只是 PPT 玩具，Excel 引擎是认真的

我本来以为这就是个 PPT 生成器，翻了翻文档发现 Excel 这块做得相当深：

• 写入 =SUM(A1:A2) 这种公式，读回来直接是算好的值，350+ 内置函数
• 支持动态数组溢出：FILTER、SORT、UNIQUE、SEQUENCE、LET、甚至 LAMBDA 和 MAP
• XLOOKUP、INDEX/MATCH 这些常规的都有，金融函数连 XIRR、PRICE、YIELD、DURATION 都齐了，统计那边 T.TEST、LINEST 也在

还有个让我眼前一亮的 pivot 命令，直接命令行建数据透视表：

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

Word 那边有个 merge 命令做模板合并，批量生成合同、发票、通知单就是一行的事：

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

架构上想清楚了：三层设计

用下来感觉它对"够用"和"兜底"分得很清楚，官方叫 Three-Layer Architecture：

• L1 高层视图：view、validate 这类，看大纲、查问题，view report.docx issues 能直接列出排版毛病
• L2 元素操作：add/set/move/remove，用路径寻址，比如 /body/p[1]/r[1] 这种 XPath 风格
• L3 原始 XML：raw-set 直接上 XPath 改 OOXML，L2 搞不定的怪需求最后兜底用

# L2：把第一段加粗officecli set report.docx /body/p[1]/r[1] --prop bold=true# L3：L2 搞不定时直接怼 XMLofficecli raw-set report.docx document \  --xpath "//w:p[1]" --action append \  --xml '<w:r><w:t>Injected text</w:t></w:r>'

另外两个工程细节值得点名：batch 模式默认原子性，一批操作里任何一条失败，整批回滚，这对 CI 里跑文档管道太重要了；resident mode 用命名管道把文档驻留内存，连续操作时省掉反复开关文件的开销。

说说我的真实判断

优点很明显：单文件零依赖，扔进 Docker 就能跑；Apache-2.0 商用没负担；渲染闭环是真痛点；命令设计对人和对 AI 都算友好。而且它是 C# 写的，想研究怎么用 .NET 做这类工具的，代码就在那摆着，本身也是份学习材料。

坑也得泼点冷水：

一是迭代太快。半年 151 个 release，命令行为今天这样明天可能就调了，脚本里别把参数写死太深，升级前过一遍 changelog。

二是复杂文档的保真度别期待百分之百。SmartArt、OLE 对象这些复杂结构官方也是绕着做的（比如 SmartArt 走 add-part 加 raw-set 的路子）。拿来处理常规公文没问题，指望完美还原设计感拉满的 PPT，还早。

三是自动更新默认开着，后台会检查新版本。生产环境建议 officecli config autoUpdate false 关掉，不然哪天 CI 突然行为变了你都不知道为啥。

四是数据安全得自己掂量。让 Agent 读公司文档，敏感数据会不会外流，取决于你接的模型和部署方式，这锅 OfficeCLI 背不了。

最后，项目今年 3 月才建，背后是商业公司（iOfficeAI，还有配套的 AionUi 桌面端），长期维护策略、会不会改许可，都还没经过时间检验。重要流程上生产之前，留个心眼。

适合谁

搞文档自动化管道的（报表批量生成、模板填充、CI 里做文档质检），直接试。做 AI Agent 开发、想让你的 Agent 能交付 Office 交付物的，基本是必装。后端朋友被"导出个 Word 报告"这种需求折磨过的，也值得看看。

想找"Office 平替"的、重度依赖 VBA 宏的文档、或者需要像素级还原复杂设计稿的，先缓一缓，它不是干这个的。

你敢让 AI 直接改你的周报 PPT 吗？踩过 Office 自动化坑的朋友，评论区聊聊。

参考链接：

❝

• OfficeCLI 仓库： https://github.com/iOfficeAI/OfficeCLI
• 官网与 SKILL.md： https://officecli.ai
• GIGAZINE 报道（2026-07-08）： https://gigazine.net/gsc_news/en/20260708-officecli/