夜雨聆风AI 做 PPT，为什么容易翻车
你有没有试过让 AI 帮你做个 PPT，总结个 excel 表格或 word 文档？
听起来简单——AI 都能写代码了，这不是手到擒来？但真试过的人都知道，这里头全是坑。
常见做法是让 AI 写 Python 代码：装 python-pptx 管 PPT、python-docx 管 Word、openpyxl 管 Excel，每个库的 API 风格完全不同。一个简单的"加页幻灯片加个标题"，Python 代码要写 50 多行，还得处理坐标、字号、颜色这些细节。
更要命的是，AI 写完代码生成了文档，它自己看不见效果。
没有可视化，Agent 生成 Office 文件就是在盲飞。
OfficeCLI 是什么
OfficeCLI 是目前最受关注的专为 AI Agent 设计的开源 Office 命令行工具。由 iOfficeAI 团队开发，GitHub 上已有 14k+ star，免费使用。
它的核心定位很清晰：不是给人类用的 Office，而是给 AI Agent 用的。
它是一个用 C# 编写的单文件二进制程序，.NET 运行时直接内嵌到文件里。下载下来就能用，不需要安装 Office、不需要 Python 环境、不需要任何依赖。支持 macOS、Linux、Windows 全平台。
一行安装命令：
# macOS / Linuxcurl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash# Windows (PowerShell)irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex装完之后，AI Agent 就能用一行命令创建、读取、修改 Word、Excel、PowerPoint 文件。
核心突破：给 AI 装上"眼睛"
OfficeCLI 最大的亮点不是"又一个 Office 库"，而是它内置了一个从零自研的渲染引擎。
这个引擎能把 .docx、.xlsx、.pptx 文件直接渲染成 HTML 或 PNG 图片。AI Agent 做完文档之后，可以立刻"看到"效果——标题有没有溢出、形状有没有重叠、配色是不是和谐。
这就打通了一个关键闭环：渲染 → 看 → 改。
Agent 做完文档，渲染成图片，检查效果，发现问题，修正，再渲染。整个过程不需要人类介入，也不需要安装 Microsoft Office。即使在 Docker 容器里、在 CI/CD 流水线上、在没有图形界面的服务器上，这个闭环都能跑起来。
用社区里的一句话说："以前 Agent 编辑 Office，是闭着眼睛在改。现在它能睁着眼看着自己的活。"
5 分钟上手
安装完成后，试一下最简单的流程——创建一份 PPT 并实时预览。
第一步：创建空白 PPT
officecli create deck.pptx第二步：启动实时预览
officecli watch deck.pptx# 浏览器自动打开 http://localhost:26315第三步：在另一个终端窗口添加内容
# 添加一页幻灯片officecli add deck.pptx / --type slide --prop title="Q4 报告" --prop background=1A1A2E# 在幻灯片上添加文字officecli add deck.pptx '/slide[1]' --type shape \ --prop text="营收增长 25%" --prop x=2cm --prop y=5cm \ --prop font=Arial --prop size=24 --prop color=FFFFFF每次执行 add、set、remove 命令，浏览器里的预览会自动刷新。三行命令，一页有模有样的幻灯片就出来了。
更进一步，可以用 view 命令把文档渲染成 HTML 或 PNG：
officecli view deck.pptx html # 生成 HTML 预览officecli view deck.pptx screenshot # 生成每页 PNG 截图命令结构遵循统一范式：create → add → get → set → remove → view → close。学会了 PPT 的操作，Word 和 Excel 的命令自然就会了——一套语法覆盖三种格式。
如果你的 AI Agent 是 Claude Code、Cursor 或 Windsurf，安装后运行 officecli install，工具会自动检测你的 Agent 并注册 skill 文件。Agent 读完 skill，几秒钟内就能学会全部命令。
项目地址：https://github.com/iOfficeAI/OfficeCLI
