📊
让 AI 直接读写 Word / Excel / PPT
OfficeCLI：全球第一个为 AI agent 设计的 Office 套件——单二进制、无需安装 Office，Create/Read/Modify/校验一条命令搞定，还能把文档渲染成图给 AI 看
Apache-2.0
单二进制
MCP 集成
📖 它是什么
OfficeCLI（仓库 iOfficeAI/OfficeCLI）自称是"世界上第一个、也是最好的、为 AI agent 设计的 Office 套件"。一句话：给任何 AI agent 对 Word、Excel、PowerPoint 的完全控制权——Create、Read、Modify、校验，一条命令完成，全程不用打开 Office。开源、单二进制、无需安装 Office、无依赖、跨平台。
它最大的杀手锏是内置的高保真 HTML 渲染引擎：能把 .docx / .xlsx / .pptx 渲染成 HTML 或 PNG，让 AI 真正"看见"文档长什么样，而不是只读 DOM 猜——从而闭环 render → look → fix（渲染 → 看 → 修）。这也让它能在 CI、Docker、无显示器的服务器上工作。以前写 50 行 Python + 3 个库才能加一张幻灯片，现在一条 officecli add 命令搞定。
项目用 C# 写成、内置 .NET 运行时，编译产物是单文件原生二进制。采用 Apache-2.0 协议，2026-03-15 建仓、目前 GitHub 已 32,101 Star（前天仍在更新），配套有 GUI 桌面端 AionUi 和 MCP server。官网 officecli.ai。
📎 GitHub：github.com/iOfficeAI/OfficeCLI ｜ 官网：officecli.ai ｜ GUI 桌面端 AionUi：github.com/iOfficeAI/AionUi
✨ 核心亮点
🖥️
让 AI 有眼睛
内置高保真渲染引擎，文档转 HTML/PNG，AI 看得见布局再自修
📦
单二进制
无需安装 Office、无依赖，内嵌 .NET 运行时，跨平台即装即用
🧮
公式引擎内置
350+ Excel 函数自动求值，数据透视表一行生成，无需回 Office 重算
🔗
原生 MCP
officecli mcp 一键接入 Claude Code / Cursor / VS Code 等工具
🖥️ 环境要求
| 操作系统 | Windows / macOS（Apple Silicon 与 Intel）/ Linux（x64 与 ARM64） |
| 运行时 | 无需安装 Office、无需 .NET 运行时——二进制内嵌；编译源码才需 .NET 10 SDK |
| 安装方式 | 一行 curl/irm；或 brew / scoop / npm 包管理器；或手动下载二进制 |
| AI 集成 | 自动检测 Claude Code / Cursor / Copilot / Codex 并安装 skill；或用内置 MCP |
| 配置目录 | ~/.officecli/config.json（可关自动更新） |
🚀 上手步骤
① 安装（一行命令）
# 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/Linux）、scoop install officecli（Windows）、npm install -g @officecli/officecli。装完 officecli --version 验证。
② 30 秒上手：实时预览做 PPT
officecli create deck.pptx
officecli watch deck.pptx # 浏览器打开 http://localhost:26315
# 另开一个终端加一页——浏览器即时刷新
officecli add deck.pptx / --type slide --prop title="Hello, World!"每次 add / set / remove 都会让预览实时刷新——浏览器就是你做文档的即时反馈环。
③ 核心操作一览
# 创建 + 加一页 + 加一个文本框
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
# 看大纲 / 渲染成 HTML / 导出 PNG 给 AI 看
officecli view deck.pptx outline
officecli view deck.pptx html
officecli view deck.pptx screenshot -o /tmp/deck.png
# 拿结构化 JSON
officecli get deck.pptx '/slide[1]/shape[1]' --json
# 保存并关闭
officecli close deck.pptx
④ 接入 AI agent（MCP 一行注册）
officecli mcp claude # Claude Code
officecli mcp cursor # Cursor
officecli mcp vscode # VS Code / Copilot
officecli mcp lmstudio # LM Studio
officecli mcp list # 查看注册状态把全部文档操作暴露成 JSON-RPC 工具，agent 不需要 shell 权限也能操作 Office 文档。
关键信息速查
| 安装（Unix） | curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash |
| 安装（Windows） | irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex |
| 实时预览 | officecli watch <file> → http://localhost:26315 |
| 三层架构 | L1 view（text/annotated/outline/html/screenshot）· L2 get/query/set/add/remove/move/swap · L3 raw/raw-set |
| 模板填充 | officecli merge template.docx out.docx --data '{"key":"value"}' |
| 引用前落盘 | 其他工具读改动前，先 officecli save / close |
🖼️ 效果图与演示
以下为官方 README 公开的成品演示（GIF 动图）——全部由 AI agent 用 OfficeCLI 生成，无模板、无手动编辑。
PowerPoint · AI 生成的设计感演示文稿：
Word · AI 生成的学术论文/方案：
Excel · AI 生成的预算/仪表盘：
这些文件本身就是 Office 格式，用 Office/WPS 打开可直接继续编辑（公众号端为动图演示）。
🎯 典型玩法
🤖 AI 生成文档：从提示词生成可编辑 PPT/Word/Excel，AionUi 里用自然语言做文档
⚙️ 报表自动化：从数据库/API 自动生成报表，CI/CD 里批量处理文档
📄 数据抽取：把文档结构化数据抽成 JSON，validate / view issues 校验质量
🖇️ 模板批量填充：merge 一次设计布局，{{key}} 填 N 份，零 token、结果一致
🧱 Docker/无头环境：内置渲染引擎，服务器/CI/容器里也能让 AI "看见"文档自修
🔁 文档往返学习：dump 现有模板→batch 重放，学人类样例再生成变体
📊 和同类做法比
| Microsoft Office | 付费授权、非 AI 原生、COM/Add-in 调用受限 |
| LibreOffice | 免费但需安装、UNO API、无 AI 友好的 JSON 输出 |
| python-docx / openpyxl | Python only、需 pip 安装、每种格式一个库、读 DOM 猜布局 |
| OfficeCLI | 开源单二进制、AI 原生 CLI+JSON、内置渲染引擎让 AI 看见、任意语言调用 |
原理一句话：OfficeCLI 把 Office 文档抽象成一套稳定的路径寻址 DOM（/slide[1]/shape[2]），并内置 HTML 渲染引擎把文档画出来给 AI 看——AI 既能精确改任意元素（L2），又能在渲染图上发现"标题溢出、图形重叠"这类 DOM 看不出的问题并自修（render → look → fix），全程无需打开 Office。
❓ 常见问题
Q：需要安装 Office 吗？
不需要。OfficeCLI 是单文件原生二进制，内嵌 .NET 运行时，Word/Excel/PPT 都能读写改，还自带渲染引擎出图。
Q：开源免费吗？能商用吗？
Apache-2.0 协议，开源免费，可商用可二开。
Q：我的 AI（Claude Code / Cursor / Copilot）能用吗？
能。安装后 OfficeCLI 自动检测本机 AI 工具并装好 skill；也可用内置 MCP server 一行接入（officecli mcp claude/cursor/vscode/lmstudio/opencode）。
Q：AI 怎么"看见"文档？
内置高保真 HTML 渲染引擎，把 .docx/.xlsx/.pptx 渲染成 HTML 或 PNG（view html / view screenshot / watch），所以 AI 能读图发现布局问题并自修，甚至能在无显示器的 Docker/CI 里工作。
Q：Excel 公式和数据透视表支持吗？
支持。内置 350+ Excel 函数自动求值（含 FILTER/SORT/UNIQUE/XLOOKUP 及金融统计类），原生 OOXML 数据透视表一行生成，写进去 Excel 打开就能看到聚合结果。
Q：其他程序读不到我的改动？
常驻模式下改动先缓存在内存，其他程序（python-docx/openpyxl/Word 等）读取前先 officecli save 或 close 落盘。
Q：一定要给 AI 用吗？普通人能用吗？
普通人可装配套 GUI AionUi，用自然语言创建/编辑 Office 文档；也支持 brew/scoop/npm 和直接下载二进制。
📎 GitHub 搜索 iOfficeAI/OfficeCLI ｜ 官网 officecli.ai ｜ GUI 桌面端 AionUi
关注「AI工具匠」，获取更多 AI 工具实操教程