AI 智能体——能自主调用工具完成任务的 AI 程序,比如 Claude Code、Cursor 这类编程助手——写代码已经很熟练,但操作 Word、Excel、PowerPoint 一直很别扭。OfficeCLI 就是解决这个问题的开源工具:它把 Office 文档的创建、读取、修改能力打包进一个可执行文件,AI 程序用一行命令就能操作 .docx、.xlsx、.pptx 文件,全程不需要安装 Microsoft Office。
这个项目由 iOfficeAI 维护,在 GitHub 上已有 29.2k Star、2k Fork,采用 Apache-2.0 开源协议,代码 94.7% 由 C# 写成,最新版本 v1.0.144 发布于 2026 年 8 月 13 日。它的直接受益者是两类人:做自动化办公与文档流水线的开发者,以及想让自己的 AI 助手真正「会做文档」的人。
AI 操作 Office 文档,难点在哪
过去 AI 程序处理 Office 文件要拼凑 Python 库:python-docx 管 Word、openpyxl 管 Excel、python-pptx 管 PPT。改一个演示文稿的标题,要先加载文件、定位幻灯片、找到形状、设置文字、再保存,大约要 50 行代码。各库的写法还不一样,AI 生成的代码常在边缘情况上报错,改起来很费 token。
OfficeCLI 的办法是把这些操作统一成一个命令行入口(CLI,即用文本命令操作程序的界面):文档里的每个元素都有稳定的路径地址,比如 /slide[1]/shape[2] 表示第一张幻灯片的第二个形状,AI 直接对路径发命令。给演示文稿加一张标题为「Q4 Report」的幻灯片,一条命令:
officecli add deck.pptx / --type slide --prop title=Q4 Report
四个核心能力
- 创建:从空白生成 Word、Excel、PowerPoint 文件,可带初始内容;
- 读取:把文档内容导出为纯文本或结构化 JSON,供程序继续处理;
- 修改:改文字、字体、颜色、公式、图表、图片,支持批量查找替换;
- 重组:在同一份或多份文档间复制、移动、删除元素。
三种格式全部支持读取、修改、创建。内置的公式引擎能自动计算 350+ 个 Excel 函数——写入 =SUM(A1:A2) 后再读取,单元格里已经是计算结果,不需要经过 Excel 重算;数据透视表也可以直接用命令从源数据生成,Excel 打开文件时聚合已经算好。
内置渲染引擎:给 AI 一双眼睛
AI 改文档最怕「看不见」:它能读出结构,但看不出标题是否溢出、两个形状是否重叠。OfficeCLI 内置了一套从零写的 HTML 渲染引擎,可以把 .docx、.xlsx、.pptx 渲染成网页或逐页 PNG 图片,AI 看到图再决定改哪里,形成「渲染 → 查看 → 修复」的闭环。这种渲染在服务器、CI(持续集成环境,代码自动构建测试的流水线)、Docker 容器里都能跑,不依赖图形界面。
安装与接入:一行命令
安装是单文件分发——整个程序就是一个二进制文件,.NET 运行时已嵌入其中,不用另装运行时或依赖。macOS、Linux、Windows 都有对应版本,也支持 Homebrew、Scoop、npm 安装。
对 AI 编程助手,装了二进制后执行 officecli install,它会自动把技能文件(SKILL.md,教 AI 怎么用这些命令的说明书)装进检测到的 Claude Code、Cursor、Windsurf、GitHub Copilot 等工具。另有内置 MCP 服务器(MCP 是一种让 AI 工具连接外部程序的开放协议),一条命令注册后,AI 就能把文档操作当作工具直接调用。开发者也可以从 Python 或 Node.js 通过官方 SDK 调用,或用任何语言直接执行命令并解析 JSON 输出。
数据与社区
仓库有 138 个 release、6072 次提交、18 位贡献者,最近的提交在 2026 年 8 月 24 日,迭代很活跃。项目文档以 Wiki 形式维护,Word、Excel、PowerPoint 各有一套完整命令参考。
适合谁用
- 做报表自动化的开发者:从数据库或 API 拉数据,自动生成周报、对账单、演示文稿;
- 搭建 CI/CD 文档流水线的团队:测试结果直接生成文档,模板合并批量产出;
- 重度使用 AI 编程助手的个人:让 Claude Code 这类工具直接替你排版文档、做幻灯片;
- 需要批量处理文档的运营、行政场景:一条命令批量生成多份结构一致的合同、发票或报告。
它的取舍也很清楚:如果只是偶尔手动改一下文档,直接用 Office 或 WPS 就行;但如果你要的是「程序或 AI 能稳定、可重复地操作 Office 文档」,OfficeCLI 是目前少见的完整方案——开源、免费、单文件、无需安装 Office,且把格式细节都封装在了命令背后。
一句话结论:OfficeCLI 是专为 AI 智能体设计的开源办公命令行套件,让程序用一行命令创建、读取、修改 Word、Excel、PPT,适合做文档自动化和让 AI 助手直接产出办公文件的人。