如果你让 AI Agent 帮你做 PPT,大概会遇到一个尴尬:AI 写好了内容大纲,但没法直接生成能打开的 .pptx 文件。要用 python-pptx 写一堆代码,或者手动复制粘贴到 Office 里。
OfficeCLI 就是来解决这个问题的。它是一个专为 AI Agent 设计的 Office 命令行工具——单个二进制文件,不需要装 Office,就能读写编辑 Word、Excel、PowerPoint 文件。
GitHub 上 5,852 星,C# 编写,Apache-2.0 开源。从今年 3 月中上线到现在不到三个月,社区非常活跃。
OfficeCLI 是什么
一个纯命令行的 Office 套件,专门给 AI Agent 用的。你给 Agent 说「帮我做一份 Q4 汇报 PPT,风格简约深色」,Agent 就调 OfficeCLI 一条条命令把幻灯片建好、文字填上、图表生成。整个过程你不用打开 PowerPoint。
支持的格式:Word (.docx)、Excel (.xlsx)、PowerPoint (.pptx)——读写改创全支持。
单文件体积:约 30MB(每个平台一个二进制)
技术栈:C#(88%)、Shell(11%)
协议:Apache-2.0
官网:officecli.ai
核心能力
从零创建 Office 文件。 一行命令建好 PPT:officecli create deck.pptx。然后一条条加幻灯片、加文字、加图表。所有操作都有命令行反馈。
实时预览。 officecli watch deck.pptx 启动一个本地 HTTP 服务(端口 26315),浏览器打开就能看到 PPT 的实时渲染。你加一张幻灯片浏览器自动刷新,不用来回保存打开。
读取和修改已有文件。 可以把现有文档的结构读成 JSON,然后针对性修改。格式检查、批量替换、样式更新都可以命令行搞定。
渲染引擎。 不需要安装 Office 就能把 .docx/.xlsx/.pptx 渲染成 HTML 或 PNG。Agent 可以「看一眼」自己生成的文件,发现问题马上修,形成闭环。
支持完整 Office 特性。 不只是简单文字排版——支持图表(包括箱线图、帕累托图)、数据透视表、切片器、条件格式、动画、Morph 过渡、3D 模型、公式、批注、书签、目录、水印……列出来很长一串。
AI Agent 一键安装。 一条命令 curl -fsSL https://officecli.ai/SKILL.md 就能教 Agent 怎么用。OfficeCLI 会自动检测本机上的 Claude Code、Cursor、Windsurf、Copilot 等 Agent,把 skill 装进去。
怎么用
安装:
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
一行体验完整流程:
officecli create demo.pptx
officecli watch demo.pptx # 浏览器打开预览
officecli add demo.pptx / --type slide --prop title="Q4 报告" --prop background=1A1A2E
officecli add demo.pptx '/slide[1]' --type shape --prop text="营收增长 25%" --prop x=2cm --prop y=5cm
查看结构:officecli view demo.pptx outline
导出 HTML:officecli view demo.pptx html
跟同类怎么比
对比 python-pptx / openpyxl / python-docx(免费 / Python 库): 这些库功能强,但代码量大。一个简单的 PPT 要 50 行 Python。OfficeCLI 一行命令完事。而且 OfficeCLI 自带渲染引擎,Python 库要预览还得装 LibreOffice。
对比 LibreOffice CLI(免费 / 需要完整安装 LibreOffice): LibreOffice 的 headless 模式可以做文档转换,但要装一整套 LibreOffice(几百 MB),而且不是设计给 AI Agent 用的结构化操作接口。OfficeCLI 30MB 单文件,JSON 输出,Agent 友好得多。
对比 Microsoft Graph API(商业 / 需要云端): 需要 Azure AD 配置、OAuth 授权、网络访问。OfficeCLI 本地跑,无依赖,断网也能用。
槽点
C# 生态,跨平台靠 .NET。 虽然支持 Windows/Mac/Linux,但 C# 做 CLI 工具在 Rust/Go 当道的今天显得有点重。好在单文件发布,用户感知不到。
不是普通用户的工具。 命令行操作 Office 对开发者来说很自然,但对普通用户来说,不如直接打开 Word 拖拽排版。它真正的用户是 AI Agent,不是人。
复杂排版需要摸索命令。 简单的文字和图表好搞,但如果你要做非常精细的排版(精确到每个形状的阴影、渐变、动画时序),命令会变得很长。
Excel 公式依赖 .NET 计算引擎。 150+ 内置函数自动求值,但一些非常新的 Excel 函数可能需要 Office 本身支持。
一句话总结:如果你在用 AI Agent 写代码,又需要自动生成 Office 文档,OfficeCLI 是目前最省事的方案——一行命令装好,你的 Agent 可以直接干活。
GitHub:iOfficeAI/OfficeCLI
官方网站:https://officecli.ai