OfficeCLI – 專爲 AI 智能體設計的開源命令行 Office 套件

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 模型。