OfficeCLI：AI 代理專用 Office 套件 CLI

1. 專案概覽

OfficeCLI 是一款單一執行檔的命令列工具，能讓 AI 代理與開發者在無需安裝 Microsoft Office 的情況下，建立、讀取、分析及修改 Word、Excel 和 PowerPoint 文件，並支援高保真度的視覺化轉譯。

2. 背景與定位

OfficeCLI 自詡為「全球首款且最頂尖的 AI 代理專用 Office 套件」。其核心使命是賦予自主式 AI 系統一種可靠、結構化且可檢查的方式來產出真實的 Office 檔案，彌合 LLM 文字輸出與人類可直接開啟並信任的最終 .docx/.xlsx/.pptx 交付成果之間的差距。

相較於傳統方法——透過 COM/UNO 自動化驅動 Microsoft Office/LibreOffice，或使用 python-docx 和 openpyxl 等 Python 函式庫進行腳本編寫——OfficeCLI 從底層起即以 AI 原生架構打造：它以單一封裝執行檔形式發布，內嵌 .NET 執行環境（無需安裝 Office，無外部相依性）；採用路徑定址模型（例如 /slide[1]/shape[2]），完美對應 LLM 對文件的推理方式；並內建轉譯引擎，讓代理在交付文件前能以視覺化方式驗證自身輸出。

3. 功能分類

📄 文件操作 — 20 個命令（create、view、get、set、add、remove、move、swap、batch、validate）— 透過一致且支援路徑定址的命令集，為 .docx、.xlsx 和 .pptx 檔案提供完整的 CRUD 生命週期管理。
🎨 轉譯與預覽 — 支援 HTML、PNG、PDF 及 SVG 輸出 — 將文件轉換為高保真度視覺畫面，方便代理（及人類）檢查結果，並包含即時重新整理的 watch 命令。
📊 Excel 引擎 — 超過 350 個內建函數 — 支援公式計算、動態陣列，以及直接從資料範圍產生原生樞紐分析表，無需額外的試算表引擎。
🔁 資料與範本 — merge、dump — 支援 {{key}} 預留位置範本合併以進行批次文件產生，並具備雙向 JSON 序列化功能，便於重現文件藍圖。
🤖 AI 代理整合 — MCP 伺服器、自動安裝技能 — 可註冊為 Model Context Protocol 伺服器（officecli mcp claude），並能自動偵測及安裝技能檔案至 Claude Code、Cursor 和 GitHub Copilot 等工具中。

4. 主要亮點

零相依性單一執行檔 — 內嵌 .NET 執行環境，無需安裝 Office、無需 COM 自動化，也沒有脆弱的系統相依鏈。
三層架構 — L1 語意檢視（文字、大綱、統計）、L2 結構化 DOM 操作（透過路徑進行 get/set/add/remove），以及 L3 原始 XPath 存取以處理特殊情況——兼顧高階便利性與低階控制力。
內建視覺化轉譯 — 可依需求將文件轉譯為 HTML/PNG/PDF/SVG，讓 AI 代理能「看見」其產出內容，而非僅憑原始 XML 猜測。
常駐模式 — officecli open 可將文件保留在記憶體中供多個命令使用，實現幾乎零延遲的多步驟編輯工作流程。
原子批次操作 — 可透過 batch 將多項編輯分組為單一交易，降低部分套用變更的風險。
原生 MCP 支援 — 開箱即用，相容於 Claude Code、Cursor、VS Code 及其他支援 MCP 的 AI 工具，並提供 Python 和 Node.js SDK 以便進行更深度的程式化整合。

5. 依角色劃分的應用場景

一般開發者 — 在 CI 管線或後端服務中自動化產生報表、發票或簡報，無需綑綁 Office 或 LibreOffice。
AI 代理開發者 — 透過內建的 MCP 伺服器，賦予程式設計/辦公代理一個可靠的工具，使其能在代理式工作流程中產出並驗證真實的 Office 交付成果。
資料/研究科學家 — 直接從資料管線產生含計算公式與樞紐分析表的 Excel 活頁簿，或從結構化資料產生範本化的 Word/PowerPoint 報告。
專案經理 — 結合 merge 與資料檔案，從單一範本批次產生狀態報告、提案或簡報。

6. 快速入門

尋找所需資訊 — 瀏覽命令參考與 Wiki 以取得特定格式的指南：

officecli --help
officecli view <file> outline

安裝與整合：

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
# 註冊為 Claude Code 的 MCP 伺服器
officecli mcp claude

貢獻：

git clone https://github.com/iOfficeAI/OfficeCLI.git
# 建置需要 .NET 10 SDK；輸出為自包含的原生執行檔

請對 main 分支發起 Pull Request，或加入社群 Discord 先行討論想法。

7. 專案結構

OfficeCLI/
├── src/officecli/     # 核心 CLI 原始碼
├── sdk/                # Python 與 Node.js SDK
├── skills/             # AI 代理技能定義（Claude Code、Cursor 等）
├── plugins/            # 擴充性框架
├── schemas/            # OpenXML 驗證結構描述
├── examples/           # 可執行的範例腳本
├── npm/                # Node.js 套件發佈
├── assets/             # 視覺化展示與示範
└── .github/workflows/  # CI/CD 自動化

src/officecli 包含三層文件引擎；skills/ 中的內容會自動安裝至偵測到的 AI 程式設計工具中；sdk/ 則是團隊希望透過程式化存取（而非呼叫 CLI）時的進入點。

8. 相關生態系

上游/執行環境： .NET 10 SDK（建置時）、OpenXML 格式規範（OfficeCLI 用於驗證的結構描述）。
AI 工具整合： Model Context Protocol (MCP)、Claude Code、Cursor、VS Code、GitHub Copilot — OfficeCLI 作為文件操作後端接入這些工具。
互補/替代工具： 傳統的 Microsoft Office/LibreOffice COM/UNO 自動化，以及 python-docx 和 openpyxl 等 Python 函式庫 — OfficeCLI 以 AI 原生、無相依性的 CLI 針對相同問題領域提供解決方案。

9. 授權條款

採用 Apache License 2.0 授權。

✅ 可自由使用、修改及散佈，包括用於商業與閉源產品。
✅ 包含貢獻者的明確專利授權。
❌ 不提供任何擔保；軟體係以「現狀」提供。
ℹ️ 修改版本必須保留著作權、授權及歸屬聲明，並清楚標示所做的任何變更。

10. 常見問題

問：使用 OfficeCLI 需要安裝 Microsoft Office 嗎？
答：不需要。OfficeCLI 以自包含執行檔形式發布，內嵌 .NET 執行環境，並直接操作 OpenXML 檔案。

問：支援哪些檔案格式？
答：.docx (Word)、.xlsx (Excel) 和 .pptx (PowerPoint)，包括 Excel 公式計算與樞紐分析表。

問：OfficeCLI 如何與 AI 程式設計助理整合？
答：它作為 MCP 伺服器執行（officecli mcp claude），並可將技能檔案自動安裝至 Claude Code、Cursor、VS Code 和 GitHub Copilot 等支援的工具中。

問：可以在不使用 Office 開啟的情況下預覽文件嗎？
答：可以 — 使用 officecli watch <file> 進行即時重新整理的瀏覽器預覽，或使用 officecli view <file> 轉譯出 HTML/PNG/PDF/SVG 輸出。

問：是否有程式化 SDK，還是只有 CLI？
答：兩者皆有 — 安裝 officecli-sdk (Python) 或 @officecli/sdk (Node.js) 即可直接從程式碼呼叫 OfficeCLI 功能。

11. 快速連結

儲存庫：https://github.com/iOfficeAI/OfficeCLI
官方網站：https://officecli.ai
文件/Wiki：https://github.com/iOfficeAI/OfficeCLI/wiki
社群 (Discord)：https://discord.gg/2QAwJn7Egx

12. 總結

OfficeCLI 填補了 AI 工具生態系中的一個特定缺口：為代理提供一種無相依性、支援路徑定址且可視覺化驗證的方式來產出真實的 Office 文件。其主要受眾為建構文件產生管線的開發者，以及需要輸出可信賴 Word/Excel/PowerPoint 檔案的 AI 代理團隊——內建的轉譯功能與 MCP 整合使其特別適合 AI 需自行檢查工作的代理式工作流程。