前言
你有没有遇到过这种场景:让 ChatGPT 或者 Claude Code 帮你做个 PPT,它吭哧吭哧写了一堆代码,最后生成的文件打开全是格式错乱?或者让它帮你处理一个 Excel 表格,它用 pandas 跑了一遍,结果公式全丢了、图表消失了。
问题出在哪?AI 没有「眼睛」——它看不见文档长什么样,只能靠猜。
今天要介绍的 OfficeCLI,就是为了解决这个问题而生的。它是全球第一个专为 AI 智能体设计的开源 Office 套件,GitHub 上已经超过 8657 个 Star,昨天(2026-07-06)刚刚发布了 v1.0.129 版本。
简单说:它是一个单二进制文件,不需要安装 Microsoft Office,就能让任何 AI 智能体(Claude Code、Cursor、Copilot 等)直接读取、编辑、创建 Word、Excel、PowerPoint 文档,还自带一个 HTML 渲染引擎,让 AI 能「看见」文档的样子。
这篇文章就来手把手带你用上它。
一、OfficeCLI 是什么?解决了什么问题?
OfficeCLI 的核心思路很简单,但非常巧妙:给 AI 装上「眼睛」。
1.1 传统方案有多痛苦
以前让 AI 操作 Office 文档,大概要走这个流程:
# 用 python-pptx 做一个 PPT(人类视角)
from pptx import Presentation
from pptx.util import Inches, Pt
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[0])
title = slide.shapes.title
title.text = "Q4 Report"
# ... 后面还有 45 行代码 ...
prs.save('deck.pptx')
50 行代码,调各种 API,还得处理单位换算(EMU)、坐标计算。最关键是,AI 写完不知道长什么样——没有预览,不知道排版对不对,只能靠猜。
1.2 OfficeCLI 的思路
OfficeCLI 引入了一个**「渲染 → 查看 → 修复」的视觉闭环**:
-
渲染:内置 HTML 渲染引擎,把
.docx/.xlsx/.pptx转成 HTML 或 PNG -
查看:AI 看到渲染结果,理解当前文档的视觉状态
-
修复:基于视觉反馈,精确修改需要调整的元素
这就好比 AI 从「盲打」变成了「边看边做」,质量提升是质的飞跃。
1.3 关键特性一览
| 特性 | 说明 |
|---|---|
| 单二进制 | 下载即用,零依赖,不装 Office |
| 三大格式全支持 | Word (.docx) / Excel (.xlsx) / PowerPoint (.pptx),读写创建全覆盖 |
| AI 友好 | 一键安装到 Claude Code、Cursor、Windsurf、Copilot |
| 实时预览 | officecli watch 命令开启浏览器实时预览 |
| 自然语言 GUI | 配套桌面应用 AionUi,纯自然语言操作 |
| Apache 2.0 开源 | 完全免费,商用友好 |
二、环境准备
2.1 系统要求
OfficeCLI 支持 macOS、Linux、Windows。由于它是用 C# 编写的单二进制文件,无需 .NET SDK,直接运行即可。
⚠️ 注意:如果你要在 Windows 上用,需要用 PowerShell 安装;macOS/Linux 用 shell 安装。
2.2 安装方式
方式一:一行命令安装(推荐)
# 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
这条命令会做三件事:
-
下载 OfficeCLI 二进制文件
-
把它加到系统的 PATH 里
-
自动检测你电脑上安装的 AI 工具(Claude Code、Cursor、Copilot 等),把 OfficeCLI 的 skill 文件装进去
方式二:手动下载
去 GitHub Releases 页面,下载对应系统的版本,然后手动放到 PATH 目录下。
方式三:验证安装
officecli --version
能输出版本号就说明安装成功了。
三、实操步骤:从零做一个 PPT
下面我们来实际体验一下,用 OfficeCLI 从零创建一个 PPT。
步骤一:创建空白演示文稿
officecli create deck.pptx
一条命令,生成一个空的 deck.pptx 文件。简单到让人怀疑人生。
步骤二:添加第一张幻灯片
officecli add deck.pptx / --type slide \
--prop title="Q4 业务报告" \
--prop background=1A1A2E
这里的路径 / 表示整个文档,--type slide 指定添加一个幻灯片,--prop 后面跟属性。我们设置了标题和背景色(深蓝黑色)。
步骤三:添加文本内容
officecli add deck.pptx '/slide[1]' --type shape \
--prop text="Q4 营收同比增长 25%" \
--prop x=2cm --prop y=5cm \
--prop font=Arial --prop size=24 --prop color=FFFFFF
这条命令在第一张幻灯片(/slide[1])上添加了一个文本框,设置了文字内容、位置、字体、大小和颜色。
步骤四:实时预览(最关键的一步!)
officecli watch deck.pptx
这条命令会在浏览器中打开 http://localhost:26315,实时预览 PPT 的样子。
这时候,你再打开一个终端,继续执行 add / set / remove 命令,浏览器里的预览会实时更新。这就是 OfficeCLI 最核心的「边看边做」体验。
步骤五:查看文档结构
# 以大纲模式查看
officecli view deck.pptx outline
# 输出示例:
# → Slide 1: Q4 业务报告
# → Shape 1 [TextBox]: Q4 营收同比增长 25%
# 以 HTML 模式查看(直接渲染)
officecli view deck.pptx html
步骤六:获取元素详情(JSON 格式)
officecli get deck.pptx '/slide[1]/shape[1]' --json
输出:
{
"tag": "shape",
"path": "/slide[1]/shape[1]",
"attributes": {
"name": "TextBox 1",
"text": "Q4 营收同比增长 25%",
"x": "720000",
"y": "1800000"
}
}
步骤七:保存并关闭
officecli close deck.pptx
这会刷写内存中的会话到磁盘,确保所有修改都被保存。
四、让 AI 智能体接管 Office 文档
这才是 OfficeCLI 真正发光的地方。
4.1 在 Claude Code 中一键启用
在 Claude Code 的聊天窗口中输入:
curl -fsSL https://officecli.ai/SKILL.md
就这么一行。Claude Code 会自动读取 skill 文件,安装二进制,然后把 Office 操作能力加载到自己的知识库里。之后你只需要用自然语言描述需求,它就能帮你做。
比如:
帮我做一个 5 页的 PPT,主题是「2026 年 Q2 团队总结」,深蓝色风格,第一页是大标题,后面四页分别是:团队成就、项目进展、数据指标、下季度规划。
Claude Code 会自动调用 OfficeCLI 的 CLI 命令完成,你只需要在浏览器里看着它实时生成即可。
4.2 支持的 AI 编码工具
OfficeCLI 安装后会自动检测以下工具并安装对应的 skill:
| AI 工具 | 安装方式 | 说明 |
|---|---|---|
| Claude Code | 自动检测 | Anthropic 出品,当前最火的 AI 编程助手 |
| Cursor | 自动检测 | 最流行的 AI 代码编辑器 |
| Windsurf | 自动检测 | Codeium 推出的 AI 编辑器 |
| GitHub Copilot | 自动检测 | GitHub 官方 AI 助手 |
| OpenClaw | 自动检测 | 新兴的开源 AI agent 平台 |
4.3 核心命令速查表
| 命令 | 作用 | 示例 |
|---|---|---|
officecli create | 创建空白文档 | officecli create report.docx |
officecli add | 添加元素 | officecli add doc.docx / --type paragraph |
officecli set | 修改元素属性 | officecli set doc.docx '/p[1]' --prop bold=true |
officecli remove | 删除元素 | officecli remove doc.docx '/slide[3]' |
officecli view | 查看文档 | officecli view doc.docx html |
officecli get | 获取元素 JSON | officecli get doc.docx '/cell[1,1]' --json |
officecli watch | 实时预览 | officecli watch deck.pptx |
officecli close | 保存关闭 | officecli close report.docx |
五、进阶玩法
5.1 创建带公式的 Excel 表格
# 创建空白工作簿
officecli create data.xlsx
# 添加表头
officecli add data.xlsx '/sheet[1]' --type cell --prop row=1 --prop col=1 --prop text="产品"
officecli add data.xlsx '/sheet[1]' --type cell --prop row=1 --prop col=2 --prop text="单价"
officecli add data.xlsx '/sheet[1]' --type cell --prop row=1 --prop col=3 --prop text="数量"
officecli add data.xlsx '/sheet[1]' --type cell --prop row=1 --prop col=4 --prop text="金额"
# 添加数据行
officecli add data.xlsx '/sheet[1]' --type cell --prop row=2 --prop col=1 --prop text="MacBook Pro"
officecli add data.xlsx '/sheet[1]' --type cell --prop row=2 --prop col=2 --prop text=12999
officecli add data.xlsx '/sheet[1]' --type cell --prop row=2 --prop col=3 --prop text=10
officecli add data.xlsx '/sheet[1]' --type cell --prop row=2 --prop col=4 --prop text='=B2*C2'
OfficeCLI 支持 350+ Excel 内置函数,并且会自动计算结果。公式写进去,它直接给你算好。
5.2 创建带 LaTeX 公式的 Word 文档
officecli create math.docx
officecli add math.docx / --type paragraph --prop text="勾股定理:"
officecli add math.docx / --type equation --prop text="a^2 + b^2 = c^2"
对,你没看错,LaTeX 公式直接输入,OfficeCLI 会转换成 Word 的原生公式对象。
5.3 使用 AionUi 桌面应用
不想敲命令行?可以试试 AionUi,一个桌面应用,让你用纯自然语言操作 Office 文档。
比如直接说:「帮我做一个销售月报的 PPT,要有图表和表格」,AionUi 底层调用 OfficeCLI 完成所有操作。
六、OfficeCLI 能做什么、不能做什么
能做 ✅
-
创建空白文档、读取已有文档
-
修改文字、字体、颜色、布局
-
处理公式、图表、数据透视表
-
支持多语言(含 RTL 右到左布局)
-
在浏览器中实时预览文档效果
-
与 Claude Code / Cursor 等 AI 工具无缝集成
暂时不能做 ❌
-
不支持 PDF 格式(专注 .docx/.xlsx/.pptx)
-
不支持 OneNote 文件
-
复杂动画和自定义 VBA 宏不在当前计划内
⚠️ 关键提示:OfficeCLI 的「看文档」能力依赖 HTML 渲染引擎。如果你的文档用了极其特殊的格式(比如自定义母版、特殊的字体嵌入),渲染效果可能不完全一致。但目前 99% 的常规文档都没问题。
总结
OfficeCLI 的出现,解决了 AI 智能体操作 Office 文档时最大的痛点——AI 看不见文档长什么样。它用「渲染 → 查看 → 修复」的闭环,让 AI 从「盲打」变成了「边看边做」。
对于普通用户,这意味着:以后再也不用让 AI 写 50 行 Python 代码来生成一个 PPT 了。一句话描述需求,AI 就能直接搞定,还能实时看到效果。
对于开发者来说,OfficeCLI 的 CLI 设计非常优雅——每条命令对应一个操作,路径语法简洁,JSON 输出方便调试。把它集成到自己的 AI agent 工作流中,只需一行 curl 命令。
GitHub 链接:https://github.com/iOfficeAI/OfficeCLI
💡 动手试试? 用上面给的命令序列,五分钟就能做出一个属于你的 PPT。装好了告诉我效果怎么样~
1531

被折叠的 条评论
为什么被折叠?



