OfficeCLI是什么
OfficeCLI 是 iOfficeAI 团队推出的全球首个专为 AI 智能体设计的开源命令行 Office 套件。让任何 AI Agent 只需一行代码即可完全掌控 Word、Excel 和 PowerPoint 文件的读取、创建、编辑与自动化处理。项目采用单一自包含二进制文件，内嵌 .NET 运行时，无需安装 Microsoft Office 或任何依赖，跨 macOS、Linux、Windows 全平台运行。内置 MCP 服务器与 SKILL.md 技能文件，安装后自动配置到 Claude Code、Cursor、VS Code Copilot 等主流 AI 编程助手，实现零配置开箱即用。
OfficeCLI的主要功能
- 全格式文档操作：完整支持 Word（.docx）、Excel（.xlsx）、PowerPoint（.pptx）的创建、读取、修改与批量处理。
- 三层渐进式架构：
- L1 读取层：语义化视图，支持文本、大纲、统计、问题诊断、HTML 预览
- L2 DOM 层：结构化元素操作（get / query / set / add / remove / move / swap）
- L3 原始 XML 层：XPath 直接访问，作为万能降级方案
- 实时预览模式：
officecli watch启动本地 HTTP 服务器，浏览器实时渲染文档修改效果，支持点击选中元素并反向同步到 CLI。 - 内置 MCP 服务器：通过 JSON-RPC 暴露所有文档操作能力，一键注册到 Claude Code、Cursor、VS Code Copilot、LM Studio 等，无需 shell 访问。
- AI 自动集成：安装二进制文件后自动检测已知 AI 工具配置目录并安装 SKILL.md 技能文件，智能体读取后即可自主学习所有命令。
- 驻留内存模式：
officecli open将文档保持在内存中，实现近零延迟的连续批量编辑。 - 模板合并：支持
{{key}}占位符替换，可基于 JSON 数据批量生成文档。 - 全命令行帮助系统：
officecli help <格式> <元素>提供完整属性、别名、示例与机器可读的结构化 schema。
如何使用OfficeCLI
- 安装二进制文件：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，或从 GitHub Releases 手动下载对应平台（macOS/Windows/Linux，x64/ARM64）的单一可执行文件。 - 验证安装：终端执行
officecli --version，确认输出版本号即表示安装成功。 - 创建空白文档：执行
officecli create deck.pptx、officecli create report.docx或officecli create budget.xlsx快速生成对应格式的 Office 文件。 - 添加与编辑内容：使用
officecli add <文件> <路径> --type <元素> --prop <属性>添加幻灯片、段落、形状、表格等；使用officecli set <文件> <路径> --prop <属性>修改现有元素的样式、文本、位置等。 - 查看文档结构：执行
officecli view <文件> text提取纯文本，officecli view <文件> outline查看大纲层级，officecli view <文件> stats查看元素统计，officecli view <文件> html生成浏览器可渲染的 HTML 预览。 - 启动实时预览：执行
officecli watch <文件> --port 26315启动本地 HTTP 服务器，浏览器实时渲染文档，每次 add/set/remove 操作后自动刷新页面，支持点击选中元素并反向同步到 CLI。 - AI 自动集成：执行
officecli install自动扫描并配置到 Claude Code、Cursor、VS Code Copilot、LM Studio 等 AI 助手；或手动执行officecli mcp claude/officecli mcp cursor/officecli mcp vscode注册 MCP 服务器。 - 手动投喂技能文件：若自动配置未覆盖当前环境，可执行
curl -fsSL https://officecli.ai/SKILL.md -o ~/.claude/skills/officecli.md（以 Claude Code 为例），让 AI 读取后自主学习所有命令语法与架构。 - 编程语言调用：在 Python、JavaScript/Node.js、Go 等语言中通过
subprocess/child_process调用 OfficeCLI 命令，追加--json参数获取结构化输出，便于程序解析和处理。 - 驻留内存批量处理：执行
officecli open <文件>将文档保持在内存中，后续连续执行多条 add/set/remove 命令实现近零延迟的批量编辑，完成后自动保存。 - 模板批量生成：准备含
{{key}}占位符的模板文件，结合 JSON 数据使用 OfficeCLI 命令批量替换生成合同、报告、标书等标准化文档。 - 管理配置与更新：执行
officecli config查看或修改~/.officecli/config.json；执行officecli config autoUpdate false或设置环境变量OFFICECLI_SKIP_UPDATE=1关闭自动更新。
OfficeCLI的官网地址
- Github仓库：https://github.com/iOfficeAI/OfficeCLI
OfficeCLI的关键信息和使用要求
- 开源协议：Apache 2.0。
- 运行环境：macOS、Linux、Windows（x64 / ARM64）。
- 依赖要求：零依赖，无需安装 Office 或运行时。
- 安装权限：需要系统 PATH 写入权限（自动安装脚本会尝试写入
/usr/local/bin或等价路径）。 - 配置文件路径：
~/.officecli/config.json，支持officecli config管理。 - 自动更新：默认后台自动检查更新，可通过
officecli config autoUpdate false或环境变量OFFICECLI_SKIP_UPDATE=1关闭。 - AI 技能文件：SKILL.md 约 239 行 / 8K tokens，涵盖命令语法、架构设计与常见陷阱。
- MCP 注册：支持 Claude Code、Cursor、VS Code / Copilot、LM Studio，通过
officecli mcp list查看注册状态。
OfficeCLI的核心优势
- AI 原生设计：专为 AI Agent 打造，基于路径寻址让智能体无需理解 XML 命名空间即可操作文档。
- 零依赖开箱即用：单一二进制文件，内嵌 .NET 运行时，无需安装 Office、WPS 或 Python 环境。
- 跨平台全覆盖：支持 macOS Apple Silicon/Intel、Linux x64/ARM64、Windows x64/ARM64。
- 双模 AI 集成：同时支持 SKILL.md（自然语言指令集，约 8K tokens）和 MCP 服务器（JSON-RPC 安全调用），适配受限环境与富集环境。
- 实时反馈闭环：浏览器实时预览 + CLI 命令即时生效，开发与调试效率极高。
- 生产级能力：支持 150+ Excel 内置函数、数据透视表、条件格式、PPT Morph 过渡、3D 模型（.glb）、OLE 对象等高级特性。
- 开源免费：Apache 2.0 协议，可自由用于商业场景。
OfficeCLI的同类竞品对比
| 对比维度 | OfficeCLI | Unoserver | Python-Office 库组合（python-docx / openpyxl / python-pptx） |
|---|---|---|---|
| 产品定位 | 全球首个专为 AI 智能体设计的命令行 Office 套件 | 基于 LibreOffice 的命令行文档转换与监听服务 | 传统 Python 编程库，用于读写 Office 文档 |
| 核心能力 | Word/Excel/PPT 的创建、读取、精细编辑、实时预览、模板填充、批量自动化 | 文档格式转换（如 DOCX ↔ PDF、XLSX ↔ CSV）、文档比对 | Word/Excel/PPT 的编程级读写操作，需编写 Python 脚本 |
| AI 原生支持 | 内置 MCP 服务器与 SKILL.md，安装后自动集成 Claude Code、Cursor、Copilot 等 | 无原生 AI 集成，需通过 shell 调用或编程语言封装 | 无原生 AI 集成，AI 智能体需通过生成 Python 代码间接调用 |
| 使用方式 | 单一二进制命令行，直接执行 officecli add/set/view 等命令 | 需先启动 unoserver 监听服务，再通过 unoconvert 执行转换 | 需安装 Python 环境及多个依赖库，编写脚本调用 API |
| 依赖环境 | 零依赖，单一自包含二进制，内嵌 .NET 运行时 | 必须安装 LibreOffice 和 Python 环境，依赖较重 | 必须安装 Python 及 pip 依赖（pip install python-docx openpyxl python-pptx） |
| 安装复杂度 | 一行命令安装（curl/irm），开箱即用 | 需安装 LibreOffice + Python + pip 安装 unoserver，配置监听服务 | 需分别安装多个 Python 库，处理版本兼容性 |
| 文档编辑粒度 | 三层架构（语义视图 / DOM 元素操作 / 原始 XML），支持段落、表格、图表、动画、公式等精细编辑 | 仅支持整文档转换，不支持内部元素级编辑 | 支持元素级编辑，但 API 复杂，不同格式需调用不同库 |
| 实时预览 | 内置 officecli watch 启动本地 HTTP 服务器，浏览器实时渲染 | 无实时预览能力 | 无实时预览能力，需保存后手动打开查看 |
| 驻留内存模式 | 支持 officecli open 驻留内存，近零延迟连续操作 | 通过监听模式避免重复加载 LibreOffice，降低 50%-75% CPU 负载 | 库本身无驻留模式，每次脚本执行需重新加载 |
| 跨平台支持 | macOS / Linux / Windows（x64 / ARM64）全平台 | 主要面向 Linux/Unix，Windows 和 macOS 支持未充分测试 | 跨平台，但依赖 Python 环境配置 |
OfficeCLI的应用场景
- 自动化报告生成：从数据库或 API 数据自动生成 Word/Excel/PowerPoint 报告，嵌入 CI/CD 流水线。
- AI 演示文稿生成：根据用户自然语言提示，由 AI Agent 全自动创建 PPT，无模板、无人工编辑。
- 文档批量处理：批量查找替换、样式更新、格式标准化、水印添加等。
- 结构化数据提取：将 Word/Excel/PPT 中的内容提取为 JSON，供下游系统消费。
- 文档质量验证：交付前自动检查文档格式问题、断链、缺失元素等。
- 财务模型构建：通过
officecli-financial-model技能构建三表模型、DCF 估值、Cap Table 等公式驱动的 Excel 模型。