不用装 Office,一行命令就能让 AI 读写 Word、Excel、PPT?这个开源 CLI 还给了 AI 一双＂眼睛＂

点击下方【IT开源项目精选】

「关注」、选择「设为星标」

每天三分钟、打卡阅读

最快获取全网学习干货、行业资讯

前言

大家好，这里是 IT开源项目精选！

让 AI 帮你写汇报、做表格、出 PPT，最难受的是什么？不是内容，是"看不见"——AI 给你一段大纲、一堆数据，最后还得你自己打开 Word 调格式、在 Excel 里改表格、去 PPT 里挪位置。因为 AI 大多只能"读文字"，看不到文档最终长什么样。

本期拆解 OfficeCLI——一个专为 AI Agent 设计的 Office 命令行套件，GitHub 上 31.5k Star。它用单一可执行文件、零依赖、无需安装 Office，就能让任何 AI Agent 创建、读取、修改 Word / Excel / PowerPoint；更关键的是它内置了一套 HTML 渲染引擎，能把文档渲染成图，让 AI 第一次真正"看见"自己的产出。本期配图全部来自项目官方 README 真实素材。

▲ 公众号封面

简介

OfficeCLI 仓库：github.com/iOfficeAI/OfficeCLI。截至 2026 年 10 月 4 日，31546 Star，2146 Fork。协议 Apache-2.0，语言 C#（单一可执行文件、内置 .NET 运行时，无需安装任何依赖），2026 年 3 月创建，最新版本 v1.0.153（2026-09-30）。

官方定位是"全球首个、专为 AI Agent 设计的 Office 套件"：给任何 AI Agent 一行代码，就能完全掌控 Word、Excel 和 PowerPoint。它是 iOfficeAI 团队开源，配套有桌面应用 AionUi（用自然语言创建编辑 Office 文档）、内置 MCP Server，并已接入 Claude Code、Cursor、Codex、Copilot 等主流编码 Agent。

一句话：它解决的是"AI 改 Office 文件时看不见、改不稳"的问题——让 AI 像操作网页一样，用稳定的路径和 JSON 读写文档，还能把文档渲染成图来"看效果、修版式"。

核心能力

一、内置 HTML 渲染引擎，给 AI 一双"眼睛"

• 把 .docx / .xlsx / .pptx 渲染成 HTML 或 PNG，让 Agent 看到渲染后的真实文档，而不是只能猜 DOM；

• 三种模式：view html（独立 HTML）、view screenshot（逐页 PNG，给多模态 Agent 读）、watch（本地 HTTP 实时预览，每次修改浏览器即时刷新）；

• 覆盖形状、图表（趋势线/瀑布/蜡烛/迷你图）、公式、3D 模型、切换动效等，CI / Docker / 无头环境都能跑，闭环 render→look→fix。

二、确定性 JSON 输出 + 路径寻址

• 每个命令都支持 --json，输出固定 schema，不用解析 stdout；每个元素都有稳定路径（如 /slide[1]/shape[2]）；

• Agent 无需理解 XML 命名空间，就能按路径导航、增删改元素。

三、三层架构，由浅入深

• L1 读：view（text / outline / annotated / html / svg / screenshot / issues）；

• L2 DOM：get / query / set / add / remove / move / swap，CSS 式查询（含 :contains、行按列名 row[Salary>5000]）；

• L3 原始 XML：raw / raw-set / validate，直接 XPath 兜底。Agent 从只读开始，需要时再加深，节省 token。

四、内置公式引擎与数据透视

• 350+ Excel 内置函数自动求值，写入 =SUM(A1:A2) 就能读到结果，无需回 Office 重算；

• 一条命令从数据源生成原生 OOXML 数据透视表（多字段行列、10 种聚合、showDataAs、日期分组、TopN）。

五、模板合并与往返 dump

• merge：把 {{key}} 占位符用 JSON 数据批量填充，设计一次、填充 N 次，避免 Agent 每次重排版式不一致；

• dump：把任意文档或其子树序列化成可重放的 batch JSON，Agent 从示例中学结构、再批量复刻。

六、常驻模式与批量操作

• open / set / close 常驻模式把文档留在内存，多次操作近乎零延迟；

• batch 一条命令应用多步操作，默认原子回滚，失败自动整批撤销。

七、AI 原生集成

• 内置 MCP Server：officecli mcp claude / cursor / vscode / lmstudio 一键注册，把文档操作暴露成工具；

• 自动安装：检测到 Claude Code、Cursor、Codex、Copilot 等，自动装入 skill 文件，Agent 立刻能用；

• 结构化错误码（not_found / invalid_value / unsupported_property 等）+ 修复建议 + 有效取值范围，Agent 可自我纠错。

八、全格式深度支持

• Word：段落、表格、图片、公式（LaTeX 输入）、目录、批注、脚注、水印、书签、修订/审阅、RTL 与多语言；Excel：单元格、公式、数据透视、切片器、图表、条件格式、迷你图、数据验证；PowerPoint：幻灯片、形状、图表、动画、切换、3D 模型、主题、备注、SmartArt。

工作原理

OfficeCLI 把 Office 文档当成一棵可寻址的元素树来操作：先用 create 生成空白文档，再用基于路径的命令（add / set / get / query / remove / move）增删改元素，所有元素都有稳定路径和 JSON schema，Agent 不用懂 XML 就能精确操作。最关键的是内置渲染引擎：把文档渲染成 HTML 或 PNG，Agent"看到"渲染结果后判断版式、溢出、重叠等问题，再回头修改——这就是官方强调的 render→look→fix 闭环。它自带一套自主修复工作流：create → 加内容 → view 验证 → validate 校验 → 根据 issues 修问题。

▲ 图1 官方展示：AI Agent 用 OfficeCLI 在 AionUi 上创建 PPT 的过程

技术栈与部署

功能截图

▲ 图2 官方示例：AI 用 OfficeCLI 生成的 Excel 财务估值看板（含预测、敏感性、股价区间图）

▲ 图3 官方示例：AI 用 OfficeCLI 生成的 Word 文档（学术论文 / 项目方案）

快速开始

1、安装（macOS / Linux 一行）：

2、创建 PPT 并实时预览：

3、查看与读取：

4、接 Agent（MCP）：

实操要点

想省 token，让 Agent 从 L1 读开始。先 view 或 get 看结构，别一上来就 set，按需加深到 L2/L3，避免烧 token。

用 watch 实时预览做反馈闭环。开 watch 后每次修改浏览器即时刷新，Agent 边改边看版式，比盲改稳得多。

批量生成用 merge 模板，别每次重排。设计一次 {{key}} 模板，数据批量填充，既省 token 又保证版式一致。

多步操作开常驻 + batch。open 后连续 set 零延迟；批量用 batch，默认原子回滚，失败自动整批撤销，别手动一条条改。

交付前 validate + view issues。校验规范、枚举文档问题（文字溢出、缺替代文本、公式错误），再交给下游或上传。

别拿它直接打开再手动改。它是 CLI，不是 Office 替代品；需要图形界面精修，用配套 AionUi 或装回 Office。

几句实在话：这些情况别用它

① 它是命令行工具，不是 Office 软件。要图形界面精修、复杂排版，仍需要 AionUi 或 Office / LibreOffice。

② 面向 AI 和自动化场景。纯人类用户、偶尔改一个文档，用图形工具更顺手，CLI 更适合脚本与 Agent 工作流。

③ 有些罕见格式/深度特性可能不完整。它支持极广，但极个别复杂版式或第三方插件生成的文件，可能需要 raw XML 兜底。

④ 版本迭代快，命令细节可能变。最新到 v1.0.153，功能高频更新，用前看官方 Wiki 或 officecli help。

⑤ 别拿它替代业务判断。它擅长文档结构操作，文档内容质量、数据准确性仍要靠人把关。

适合谁

适合五类人：想让 Claude Code / Codex / Cursor 等编码 Agent 直接交付可打开、可修改的 Office 文件的 AI 工程师；要批量生成报告、批量替换模板做流水线的开发者；在 CI/CD 或 Docker 无头环境里自动出文档的团队；想从数据库/API 自动化生成 Word 报告、Excel 看板、PPT 演示的人；以及想在不装 Office 的前提下让脚本稳定读写 Office 文件的运维与自动化工程师。

不适合：只想用图形界面偶尔改一个文档、不想碰命令行的普通用户；以及需要商业级 Office 完整兼容性的重度排版场景。

更新进度

100 期优质开源项目更新进度：037/100。欢迎在留言区聊聊你平时怎么让 AI 帮你写文档，或提名下一期想拆解的开源项目。

开源地址

GitHub：github.com/iOfficeAI/OfficeCLI

官网：officecli.ai

文档 Wiki：github.com/iOfficeAI/OfficeCLI/wiki

配套桌面应用：github.com/iOfficeAI/AionUi

Skill 文件：officecli.ai/SKILL.md（喂给 AI Agent 即可）

获取更多精彩内容和优质开源项目

请关注微信公众号「IT开源项目精选」

每天早上 5 分钟，看懂一个值得收藏的开源项目

免责声明

1、本文所分享的软件、代码或资源，均来自开源社区，遵循其原始许可证（Apache-2.0）。仅供学习和研究使用，严禁用于任何违法行为。

2、使用者在下载、部署或使用本项目时，需自行判断其适用性与合法性，由此产生的一切风险与责任均由使用者自行承担。

3、本文数据（Star、Fork、版本号）来自 GitHub 与项目官网公开信息，采集时间为 2026 年 10 月 4 日，项目迭代迅速，实际数据可能已更新。

4、本文涉及的项目能力描述与示例图片均引自项目官方公开资料，未做独立第三方验证，仅供了解参考。

5、本文配图来自项目官方仓库公开素材，版权归原作者所有；本文不对开源软件的安全性、可用性或完整性做任何保证。

6、本文与项目作者无商业合作，所有观点基于公开资料得出；若您为相关资源的版权方并对内容有异议，请联系我们，我们将在第一时间处理。