夜雨聆风
项目简介
| 字段 | 内容 |
|---|---|
| 项目名称 | iOfficeAI/OfficeCLI |
| 项目地址 | https://github.com/iOfficeAI/OfficeCLI[1] |
| Star 数 | 9739 |
| Fork 数 | 666 |
OfficeCLI 是首个专为 AI 智能体设计的 Office 文档命令行工具，让 Agent 用一行命令即可创建、读取、编辑和自动化 Word、Excel、PowerPoint 文件。项目以单一自包含二进制分发，无需安装 Microsoft Office，也无需 Python 等运行时依赖，跨平台即下即用。
其核心思路是把 OpenXML 文档当作可寻址的结构化对象：通过类似 DOM 的路径（如 /slide[1]/shape[1]）或 CSS 风格选择器，Agent 可以精确读写段落、表格、公式、图表乃至动画与 3D 模型。内置 HTML/PNG 渲染引擎还能让 AI「看见」文档效果，形成「渲染—检查—修正」的闭环，显著降低多模态 Agent 处理办公文档的门槛。
核心特性
AI 原生 CLI 设计：命令输出结构化 JSON，配合 SKILL.md 技能文件与 MCP 服务，可被 Claude Code、Cursor、Windsurf、GitHub Copilot 等编码 Agent 直接调用。 三格式全覆盖：统一工具链支持 .docx、.xlsx、.pptx的创建、读取、分析与修改，Word 段落样式、Excel 公式与透视表、PPT 幻灯片动画均可命令化操作。零依赖单文件部署：内置 .NET 运行时，下载二进制后 officecli install即可完成 PATH 配置与 Agent 技能注入，无需额外环境。内置渲染与实时预览：可将文档渲染为 HTML 或 PNG， watch模式在浏览器中实时刷新，便于 Agent 或开发者验证排版效果。批量与驻留模式： batch命令一次执行多条变更；驻留模式将文档常驻内存，多步操作避免反复读写磁盘，适合复杂工作流。
快速开始
方式一：让 AI Agent 自行安装
将以下命令粘贴到 Agent 对话中，它会读取技能文件并自动完成安装：
curl -fsSL https://officecli.ai/SKILL.md
方式二：手动安装（macOS / Linux）
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
officecli install
创建并编辑 PowerPoint 示例：
# 创建空白演示文稿
officecli create deck.pptx
# 添加标题页
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
# 在首页添加文本框
officecli add deck.pptx '/slide[1]' --type shape \
--prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
--prop font=Arial --prop size=24 --prop color=FFFFFF
# 查看大纲结构
officecli view deck.pptx outline
# 浏览器实时预览（另开终端修改时自动刷新）
officecli watch deck.pptx
# 保存并关闭驻留会话
officecli close deck.pptx
安装完成后，Agent 可通过 MCP 或已注入的 skill 直接调用 create、get、set、batch 等命令处理办公文档，无需编写 python-docx 等库的冗长脚本。
为什么火了
AI 编码 Agent 爆发式增长后，「让 Agent 产出 Word 报告、Excel 表格、PPT 演示稿」成为高频刚需，但传统方案各有短板：python-docx/openpyxl 需要编程且三格式分散；LibreOffice UNO API 学习曲线陡峭；Microsoft Office COM 接口仅限 Windows 且无法 headless 自动化。OfficeCLI 用统一 CLI + 路径式元素访问 + JSON 输出，把文档操作降维成 Agent 可理解的命令序列，填补了「办公文档最后一公里」的空白。
项目还踩中了 MCP 与 Agent Skills 生态的风口：officecli install 一键向 Claude Code、Cursor 等工具注册技能与 MCP 服务，配合内置渲染引擎让多模态 Agent 能「看」文档再改，演示案例（纯 AI 生成的 Word/Excel/PPT）在社媒传播效果显著。项目 2026 年 3 月创建，Apache 2.0 开源，社区讨论将其视为 AI 原生办公自动化的代表性基础设施，热度持续攀升。
引用链接
[1]https://github.com/iOfficeAI/OfficeCLI
