项目介绍
OfficeCLI 是第一个专为 AI agent 设计的 Office 套件,让任何 AI agent 用一行命令读取、编辑、自动化 Word、Excel、PowerPoint 文件。GitHub 周榜(2026.07.14-07.19)第 10 名,当前 22.2k stars,周增 4217。Apache-2.0 协议,C# 编写,单静态二进制,无需安装 Microsoft Office。
核心功能
- 单二进制零依赖:.NET 运行时嵌入二进制,macOS / Linux / Windows 通吃,无需 Office 安装。
- 三格式全覆盖:.docx / .xlsx / .pptx 读写改创建,路径式元素寻址(
/slide[1]/shape[2]),agent 无需懂 OOXML 命名空间。 - 内置渲染引擎:自研 HTML 渲染引擎把文档渲染成 HTML / PNG,让 AI "看见"产出,闭合 render → look → fix 循环;
watch命令本地起服务实时预览。 - 公式与数据透视:350+ Excel 函数写入即自动求值(含 FILTER / SORT / XLOOKUP / 金融债券 / 统计回归),原生 OOXML 透视表一条命令生成。
- 模板合并 + Round-trip dump:
merge用{{key}}占位符把模板批量填充成 N 份文档;dump把任意文档序列化成可回放的 batch JSON,agent 从样例学结构而非啃 XML。 - 内置 MCP server:
officecli mcp claude/cursor/vscode/lmstudio一键注册,所有文档操作暴露为 JSON-RPC 工具。 - 三层架构:L1 Read(view 语义视图)→ L2 DOM(get/set/add/remove)→ L3 Raw XML(XPath 兜底),按需升级省 token。
安装使用
一键安装:
# 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
# 或包管理器
brew install officecli # macOS
scoop install officecli # Windows
npm install -g @officecli/officecli # 全平台装完跑 officecli install,自动检测 Claude Code / Cursor / Windsurf / Copilot 并装入 skill 文件。给 agent 发 curl -fsSL https://officecli.ai/SKILL.md,agent 自己读完就会装会用。快速上手:
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 报告"
officecli watch deck.pptx # localhost:26315 实时预览适用场景
- 数字员工 / 办公自动化:AI agent 按用户提示生成 PPT / Word / Excel,无需人工排版。
- 报告批量生成:CI/CD 流水线里从数据库或 API 出数据,
merge模板批量产出报表,agent 设计一次布局,生产代码填 N 次。 - 文档处理流水线:Docker / 无头环境里 headless 自动化,批量查找替换、样式更新、文档校验。
- AI agent 工具化:把 Office 文档能力包成 MCP 工具给 Claude Code / Cursor 调用,让 agent 真正产出可交付文档。
参考来源
- OfficeCLI GitHub 仓库:https://github.com/iOfficeAI/OfficeCLI
- OfficeCLI 官网:https://officecli.ai