OfficeCLI：AI Agent 原生 Office 套件，一行命令操控 Word/Excel/PPT

今天 GitHub Trending 日榜上一匹黑马冲到了前列——OfficeCLI，一个专为 AI Agent 设计的开源 Office 套件。12k+ Stars，日增 1700+ 星，它的口号很直接：一行代码，让任何 AI Agent 完全控制 Word、Excel 和 PowerPoint。

它解决了什么问题？

AI 生成文档不是新鲜事，但大多方案要么依赖 Microsoft Office 的 COM 接口（Windows 专属），要么用各种分散的库（python-docx、openpyxl、python-pptx）拼凑，API 不统一、维护成本高。OfficeCLI 用一个 单一二进制文件 解决了这一切——无需安装 Office，无需 Python/Node 环境，跨平台运行。

核心特性

• 单一二进制，零依赖——下载即用，Windows/macOS/Linux 全支持
• 内置 HTML 渲染引擎——将 .docx/.xlsx/.pptx 渲染为 HTML 或 PNG，让 AI “看到”文档
• CLI 命令行操作——JSON 输出天然适合 AI Agent 解析和处理
• 一键安装到主流 AI 编码工具——Claude Code、Cursor、Windsurf、GitHub Copilot 等
• 实时预览——officecli watch 启动本地服务器，浏览器实时刷新

安装与上手

安装

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash

# 或通过包管理器
brew install officecli
npm install -g @officecli/officecli

# Windows (PowerShell)
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex

创建 PPT

# 创建空白 PPT
officecli create demo.pptx

# 启动实时预览
officecli watch demo.pptx
# 浏览器打开 http://localhost:26315

# 添加幻灯片
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   --prop font=Arial --prop size=24 --prop color=FFFFFF

操作 Excel

# 设置单元格值
officecli set data.xlsx '/sheet[1]/cell[A1]' --value "Hello"

# 设置公式
officecli set data.xlsx '/sheet[1]/cell[B1]' --value "=SUM(A1:A10)"

# 条件筛选
officecli get data.xlsx '/sheet[1]/row[Salary>5000]' --json

操作 Word

# 创建文档
officecli create report.docx

# 添加段落
officecli add report.docx / --type paragraph --text "第一章 引言"

# 添加表格
officecli add report.docx / --type table --rows 3 --cols 2

# 查看结构
officecli view report.docx outline --json

技术架构亮点

OfficeCLI 用 C# 编写，内置了一个 高保真 HTML 渲染引擎——这是它最独特的竞争力。传统方案让 AI “盲操作”文档（写入后无法验证效果），OfficeCLI 的渲染引擎让 AI 能”看到”文档的实际渲染效果，形成 渲染→检查→修正 的闭环。

支持的格式操作深度也相当惊人：

• Word：段落、表格、图片、公式（LaTeX）、Mermaid 图表、水印、批注、脚注、目录、跟踪修订
• Excel：350+ 内置函数、数据透视表、条件格式、图表、数据验证、切片器、迷你图
• PowerPoint：动画（15 种强调 + 16 种退出）、Morph 过渡、3D 模型（.glb）、缩放幻灯片

与同类方案对比

适用场景

• AI Agent 自动化办公：让 Claude Code、Cursor 等直接生成和编辑 Office 文档
• 批量文档处理：批量生成报告、发票、合同等规范化文档
• 数据报告自动生成：从数据库导出数据，自动创建带图表的 Excel 和 PPT
• CI/CD 文档化：在流水线中自动生成测试报告、变更日志

总结

OfficeCLI 精准地抓住了 AI Agent 时代办公自动化的痛点——不是让 AI 去调用一堆积重难返的 Office 库，而是从零重新设计一套原生面向 AI 的文档操作语言。单一二进制、零依赖、自带渲染引擎这些设计选择，让它在同类工具中独树一帜。12k+ Stars 和日增 1700+ 星的热度，也证明了开发者对这类工具的需求。

GitHub 地址：https://github.com/iOfficeAI/OfficeCLI

官网：https://officecli.ai