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的应用场景

• 自动化报告生成：从数据库或 API 数据自动生成 Word/Excel/PowerPoint 报告，嵌入 CI/CD 流水线。

• AI 演示文稿生成：根据用户自然语言提示，由 AI Agent 全自动创建 PPT，无模板、无人工编辑。

• 文档批量处理：批量查找替换、样式更新、格式标准化、水印添加等。

• 结构化数据提取：将 Word/Excel/PPT 中的内容提取为 JSON，供下游系统消费。

• 文档质量验证：交付前自动检查文档格式问题、断链、缺失元素等。

• 财务模型构建：通过 officecli-financial-model 技能构建三表模型、DCF 估值、Cap Table 等公式驱动的 Excel 模型。