OfficeCLI

OfficeCLI – 专为 AI 智能体设计的开源命令行 Office 套件

OfficeCLI，由 iOfficeAI 团队匠心打造，荣膺全球首个专为 AI 智能体量身定制的开源命令行 Office 套件桂冠。它赋予了任何 AI Agent 仅凭一行代码，便能全面驾驭 Word、Excel 和 PowerPoint 文件，实现读写、创建、编辑及自动化处理的强大能力。

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），OfficeCLI 都能提供无与伦比的支持，无论是创建、读取、修改还是进行批量处理，都游刃有余。
• 精妙的三层架构设计：
  • L1 语义视图层：提供了一种高度抽象的视角，支持文本提取、大纲梳理、统计分析、问题诊断以及 HTML 格式的预览，让文档内容一目了然。
  • L2 DOM 操作层：允许用户以结构化元素为单位进行精细操作，包括获取（get）、查询（query）、设置（set）、添加（add）、删除（remove）、移动（move）和交换（swap）等，操作精准高效。
  • L3 原始 XML 层：提供 XPath 直接访问的通道，作为一种万能的降级方案，以应对复杂或特殊场景。
• 即时预览的绝佳体验：通过执行 officecli watch 命令，可以启动一个本地 HTTP 服务器。在浏览器中，您将实时看到文档的修改效果。更棒的是，您还可以通过点击浏览器中的元素，将其反向同步到 CLI 中，实现交互式的编辑体验。
• 无缝集成的 MCP 服务器：通过 JSON-RPC 协议，OfficeCLI 将所有文档操作能力以安全、标准化的方式暴露出来。只需一键注册，即可轻松集成到 Claude Code、Cursor、VS Code Copilot、LM Studio 等 AI 工具中，无需复杂的 shell 访问配置。
• AI 智能的自动赋能：一旦您安装了 OfficeCLI 的二进制文件，它会自动检测并配置到已知的 AI 工具目录中，并安装 SKILL.md 技能文件。这样，AI 智能体便能自行学习并理解所有命令，实现自主操作。
• 内存驻留的卓越性能：使用 officecli open 命令，可以将文档加载到内存中，从而实现近乎零延迟的连续批量编辑操作，极大地提升了处理效率。
• 灵活的模板合并功能：OfficeCLI 支持使用 {{key}} 占位符进行内容替换，能够基于 JSON 数据批量生成各种文档，极大地简化了标准化文档的创建流程。
• 详尽的命令行帮助系统：您可以通过 officecli help <格式> <元素> 命令，获取关于命令的完整属性、别名、使用示例以及机器可读的结构化 schema，帮助您更好地理解和使用 OfficeCLI。

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 服务器。
• 手动加载技能文件：如果自动配置未能覆盖您的当前环境，您可以手动将技能文件加载到 AI 工具中。例如，对于 Claude Code，可以执行 curl -fsSL https://officecli.ai/SKILL.md -o ~/.claude/skills/officecli.md 命令。这样，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 架构。
• 依赖项要求：零依赖，只需一个自包含的二进制文件，内嵌 .NET 运行时，无需额外安装 Office 或其他运行时环境。
• 安装权限需求：安装过程需要写入系统 PATH 的权限（自动安装脚本会尝试写入 /usr/local/bin 或同等目录）。
• 配置文件路径：用户配置文件位于 ~/.officecli/config.json，可通过 officecli config 命令进行管理。
• 自动更新机制：默认情况下，OfficeCLI 会在后台自动检查更新。您可以通过 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 原生的设计理念：OfficeCLI 专为 AI 智能体而生，其基于路径寻址的独特设计，使得智能体无需深入理解复杂的 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 过渡动画、.glb 格式的 3D 模型以及 OLE 对象等在内的丰富高级特性。
• 开源免费的承诺：遵循 Apache 2.0 协议，用户可以地将其用于各种场景，包括商业用途，无需任何费用。

OfficeCLI 与同类竞品的深度对比

OfficeCLI 的典型应用场景

• 自动化报告的生成：能够从数据库或 API 获取数据，自动生成 Word、Excel 或 PowerPoint 格式的报告，并可无缝集成到 CI/CD 流水线中。
• AI 驱动的演示文稿创建：完全根据用户输入的自然语言提示，由 AI Agent 自动生成 PPT，无需任何模板或人工干预。
• 文档的批量化处理：支持批量查找替换、样式更新、格式标准化、水印添加等多种操作。
• 结构化数据的提取：能够将 Word、Excel 或 PowerPoint 中的内容高效地提取为 JSON 格式，方便下游系统进行消费。
• 文档质量的严谨验证：在文档交付前，可自动检查是否存在格式问题、断链或缺失元素等情况。
• 财务模型的构建：通过 officecli-financial-model 技能，可以构建包含三表模型、DCF 估值、Cap Table 等公式驱动的 Excel 模型。