什麼是 OfficeCLI？為什麼它如此重要？
OfficeCLI 不是一個簡單的文件解析庫，而是一個完整的、可執行的 Office 套件。它的核心使命是：讓 AI Agent 擁有對 Office 文件的「眼睛」和「手」。
傳統上，AI Agent 要處理 Word 或 Excel 檔案，需要呼叫 Python 庫（如 python-docx 或 openpyxl），但這些庫功能有限，無法處理複雜的樣式、圖表、公式或 PowerPoint 的動畫。更關鍵的是，它們無法讓 AI 「看到」最終渲染效果——Agent 只能猜測文字在頁面上的位置，卻不知道標題是否溢出、兩個形狀是否重疊。
OfficeCLI 解決了這個根本問題。它內建了一個從零編寫的高保真 HTML 渲染引擎，可以將 .docx / .xlsx / .pptx 檔案完美渲染為 HTML 或 PNG。這意味著 AI Agent 不再是「盲人摸象」，而是能像人類一樣，透過查看渲染後的預覽來理解文件結構，並做出精準的修改。
核心特性一覽
| 功能 | Word (.docx) | Excel (.xlsx) | PowerPoint (.pptx) |
|---|---|---|---|
| 建立 | ✅ | ✅ | ✅ |
| 讀取 | ✅ (文字、結構、樣式、公式) | ✅ (儲存格、公式、圖表、樞紐分析表) | ✅ (投影片、形狀、圖表、動畫) |
| 修改 | ✅ (字型、顏色、段落、表格、圖片、公式) | ✅ (儲存格、公式、圖表、樞紐分析表、條件格式) | ✅ (投影片、形狀、圖表、動畫、3D 模型) |
| 渲染預覽 | ✅ (HTML, PNG, Live Watch) | ✅ (HTML, PNG, Live Watch) | ✅ (HTML, PNG, Live Watch) |
| 單一檔案二進制 | ✅ | ✅ | ✅ |
| 無需安裝 Office | ✅ | ✅ | ✅ |
OfficeCLI 是一個真正的「開箱即用」的解決方案。它不是一個 SDK，而是一個可以直接執行的 CLI 工具。對於開發者，它是自動化報告產生的利器；對於 AI Agent，它是實現 Office 文件全端操控的終極武器。
快速安裝與入門
OfficeCLI 支援所有主流平台，安裝極其簡單。
macOS / Linux
# 一鍵安裝（推薦）
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
# 或使用 Homebrew
brew install officecli
Windows
# PowerShell 一鍵安裝
irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex
# 或使用 Scoop
scoop install officecli
驗證安裝
安裝完成後，在終端中執行：
officecli --version
# 輸出類似：officecli v1.24.7
建立你的第一個簡報
讓我們用一條命令建立一個空白的 PowerPoint 檔案：
officecli create deck.pptx
現在，啟動一個即時預覽伺服器，它會在瀏覽器中開啟 http://localhost:26315：
officecli watch deck.pptx
在另一個終端視窗中，向投影片新增一個標題：
officecli add deck.pptx / --type slide --prop title="Hello, World!"
你將在瀏覽器中立刻看到新的投影片！這就是 OfficeCLI 的「render → look → fix」閉環，讓 AI Agent 的開發變得直觀且高效。
AI Agent 整合實戰
OfficeCLI 最強大的應用場景，是與 AI Agent 深度整合。它讓 Agent 不再是「文件盲人」，而是具備完整 Office 文件處理能力的智慧助手。
場景一：自動產生週報
假設你有一個 AI Agent，每天從各種資料來源收集資訊。以前，它只能產生純文字報告。現在，它可以：
- 使用
officecli create weekly-report.docx建立新文件 - 用
officecli add新增封面、目錄、章節標題 - 用
officecli insert插入從資料庫匯出的圖表和表格 - 用
officecli render產生最終 PDF 報告
整個流程完全自動化，無需人工干預。
場景二：智慧 PPT 製作
AI Agent 接收到使用者需求：「幫我做一個關於 Qwen3 發佈的介紹 PPT，包含技術亮點、效能對比和生態支援。」
Agent 可以：
- 建立新 PPT：officecli create qwen3-intro.pptx
- 為每張投影片新增內容：officecli add qwen3-intro.pptx /slide1 --type text --prop text="Qwen3：新一代開源大模型"
- 插入效能對比圖表：officecli insert qwen3-intro.pptx /slide2 --type chart --file charts/qwen3-benchmarks.png
- 新增動畫效果：officecli modify qwen3-intro.pptx /slide3/title --prop animation=fade
- 最後渲染：officecli render qwen3-intro.pptx --format pdf
場景三：Excel 資料分析助手
Agent 可以直接讀取 Excel 檔案，執行複雜的資料分析任務：
# 讀取銷售資料
officecli read sales-q2.xlsx --sheet "Q2 Summary" --range "A1:E100"
# 自動產生分析報告
officecli analyze sales-q2.xlsx --prompt "分析各區域銷售額趨勢，找出增長最快和最慢的區域"
# 將分析結果插入新工作表
officecli insert sales-q2.xlsx --sheet "Analysis" --data "..."
進階設定與多模型支援
OfficeCLI 支援多種大模型後端，讓你可以根據任務需求選擇最合適的 AI 引擎：
- 本機模型： 透過 Ollama 或 LM Studio 執行 Qwen3、DeepSeek-Coder 等開源模型
- 雲端 API： 支援 OpenAI、Anthropic、SiliconFlow、DeepSeek 等服務
- 混合模式： 敏感資料本機處理，複雜推理雲端完成
設定方法非常簡單，只需編輯 ~/.officecli/config.yaml：
models:
default: ollama/qwen3:latest
fallback: siliconflow/qwen3
local: ollama/deepseek-coder:33b
效能與可靠性
OfficeCLI 在設計之初就考慮了生產環境的需求：
- 記憶體效率： 即使處理 100MB+ 的大型 Excel 檔案，記憶體佔用也控制在 512MB 以內
- 併發安全： 支援多行程併發處理多個文件，無資源競爭問題
- 錯誤恢復： 所有操作都支援原子性，失敗時自動回復到安全狀態
- 企業級安全： 支援文件浮水印、權限控制、稽核日誌
總結
OfficeCLI 正在重新定義 AI Agent 與辦公文件的互動方式。它不是另一個「文件解析庫」，而是一個完整的、可執行的 Office 套件，讓 AI Agent 真正擁有了對 Word、Excel 和 PowerPoint 的「眼睛」和「手」。
對於開發者，它是自動化辦公的終極工具；對於 AI Agent，它是實現真正智慧辦公的關鍵拼圖。如果你正在建構 AI 辦公助手、自動化報告系統或智慧文件處理平台，OfficeCLI 絕對值得你立即嘗試。
🚀 立即開始：
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash📚 專案主頁： https://github.com/iOfficeAI/OfficeCLI 📄 官方文件： https://docs.officecli.dev
本文由 dashen-tech 團隊撰寫，2026年7月19日發佈。OfficeCLI 是開源專案，遵循 MIT 授權協議。