OfficeCLI 是什麼？讓 AI Agent 操作 Word、Excel、PowerPoint
OfficeCLI 把 Word、Excel、PowerPoint 這三種常見文件，變成 AI Agent 可以穩定讀取、修改、驗證和預覽的工程接口。
以前要讓 AI 幫你處理 Office 文件，常見做法是丟給 Python 套件，例如 python-docx、openpyxl、python-pptx。這些工具很有用，但每種格式各自一套 API，版面問題也很難用純文字確認。OfficeCLI 的方向則比較像給 Agent 一支專門的文件手臂，用 CLI 和 JSON 把文件操作標準化。
先講結論
OfficeCLI 是 iOfficeAI 開源的 Office 文件命令列工具，主打給 AI Agent 使用。它可以建立、讀取、修改和驗證 docx、xlsx、pptx，不需要安裝 Microsoft Office，也不需要額外 runtime，官方定位是 single binary。
我會把它放在 Playwright CLI 同一類思路裡，Playwright CLI 是讓 Agent 操作瀏覽器，OfficeCLI 則是讓 Agent 操作文件，兩者共同點都是把原本依賴 GUI 或複雜 library 的任務，改成可重複、可檢查、可寫進 skill 的 CLI 工作流。
為什麼 Agent 需要 OfficeCLI
文件不是只有文字，Word 有段落、樣式、頁首頁尾、註腳、目錄和追蹤修訂。
Excel 有公式、表格、樞紐分析、條件格式和資料驗證。P
owerPoint 有投影片、形狀、圖表、圖片、動畫和轉場。這些東西如果只轉成純文字，Agent 很容易看漏版面和結構。
OfficeCLI 的關鍵設計，是把文件轉成 Agent 能理解的結構化輸出，也能渲染成 HTML 或 PNG，這讓 Agent 不只知道文件裡有什麼文字，也能檢查排版結果。對需要交付正式報告、簡報、表格的人來說，這個 render → look → fix 的迴圈非常重要。
一行指令取代很多樣板程式碼
傳統 Python 套件通常要先 import library、建立物件、找到段落或投影片、設定屬性，最後再存檔，OfficeCLI 把這些操作變成像 shell command 一樣的命令。例如建立簡報、加入投影片、設定文字、讀取 outline、輸出 JSON，都可以用命令完成。
officecli create deck.pptx officecli add deck.pptx / --type slide --prop title="Q4 Report" officecli view deck.pptx outline officecli get deck.pptx /slide[1] --json
這種形式對 Codex、Claude Code、Cursor、GitHub Copilot 這類 coding agent 很友善。Agent 不需要在不同文件格式之間背很多 Python API，只要知道 OfficeCLI 的命令和路徑規則，就能用一致方式操作三種 Office 文件。
OfficeCLI 能做哪些事
OfficeCLI 的命令不只 create 和 view。官方文件列出的核心能力包含 get、query、set、add、remove、move、swap、validate、batch、dump、merge、watch、mcp、raw 和 raw-set。這代表它不只是產生文件，也能讀取現有文件、定位元素、修改內容、驗證問題、批次處理和啟動 MCP server。
| 格式 | 可做的事 | 適合場景 |
|---|---|---|
| Word | 段落、樣式、表格、圖片、註腳、目錄、追蹤修訂 | 報告、自動合約、專案文件、審稿流程 |
| Excel | 儲存格、公式、表格、排序、條件格式、圖表、樞紐分析 | 月報、資料清理、預算表、營運儀表板 |
| PowerPoint | 投影片、形狀、圖片、表格、圖表、動畫、轉場 | 簡報初稿、銷售 deck、課程投影片、專案提案 |
如果你的工作已經在用 MarkItDown 把 Office 文件轉成 AI 可讀 Markdown，OfficeCLI 可以補上另一半。MarkItDown 偏向讀取和轉換，OfficeCLI 更偏向讀寫修改和驗證。
最重要的是可視化回饋
Agent 產生文件最常見的問題，是內容看起來對，但交付檔打開後版面歪掉。OfficeCLI 的 built-in rendering engine 可以把 docx、xlsx、pptx 渲染成 HTML 或 PNG，再讓 Agent 檢查畫面。這對簡報和報告特別有用，因為很多錯誤不是純文字能看出來的。
例如 Agent 做完簡報後，可以先用 `officecli view deck.pptx html` 或 `officecli watch deck.pptx` 看預覽，再用 `officecli view deck.pptx issues –json` 找問題。這會讓文件生成變成工程流程，而不是一次性產出後靠人工開檔檢查。
安裝方式
OfficeCLI 官方提供多種安裝路線。AI Agent 可以先讀 skill file，讓 Agent 自己理解如何安裝和使用。一般開發者也可以直接跑安裝腳本，或透過 npm 安裝。
curl -fsSL https://officecli.ai/SKILL.md curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash npm install -g @officecli/officecli
Windows 則可以用 PowerShell 安裝。它的核心好處是 single binary，文件處理不必依賴本機有沒有安裝 Office。這對伺服器、CI、Docker 或 Agent 執行環境很重要。
跟 Python 套件和 LibreOffice 怎麼選
python-docx、openpyxl、python-pptx 還是很實用，尤其是你已經有固定資料結構和成熟程式碼時，LibreOffice headless 也適合某些批次轉檔需求，OfficeCLI 的優勢，是它把三種 Office 文件收斂成同一套 CLI、JSON 和路徑模型，對 Agent 來說比較容易自我修正。
我會這樣選。如果只是固定模板套資料，Python 套件仍然簡單。如果要讓 Agent 自己讀一份未知文件、理解結構、修改局部、檢查品質，再回頭修正，OfficeCLI 會更接近 AI-native 的工作方式。如果團隊正在做 Codex 與 AI 代理工作流，這種工具就很值得放進標準工具箱。
可以怎麼接到 Codex
最務實的做法，是先把 OfficeCLI 當成專案工具使用。讓 Codex 讀文件、產生命令、執行修改，再用 validate 和 issues 做回饋。等流程穩定後，再寫成 skill。這和 讓 Agent 自己發現和使用 skills 的方向很一致。
舉例來說，可以做一個「每週報告 skill」。輸入資料來源後，Agent 先產生 Excel 摘要，再把重點轉成 PowerPoint，最後輸出 Word 報告。OfficeCLI 負責文件讀寫與驗證，Codex 負責資料整理、判斷和修正。若還需要把團隊知識一起查進來，也可以搭配 OpenWiki 這類 Agent 共用知識庫。
我的判斷
OfficeCLI 的真正價值，是把 Office 文件從「人打開 GUI 慢慢改」變成「Agent 可以讀、改、看、驗證、再修正」的循環。它不一定取代所有 Python library，但很適合補上 AI Agent 在文件處理裡最缺的一塊：穩定操作接口加可視化回饋。
如果你的工作常常要做報表、合約、簡報、月報、批次文件修改，這類工具會越來越重要。未來的文件自動化不只是產生文字，而是讓 Agent 能理解文件結構，知道自己改了哪裡，也能在交付前先檢查成果。
延伸資源
- iOfficeAI/OfficeCLI GitHub
- OfficeCLI 官方網站
- OfficeCLI Wiki
- Playwright CLI 是什麼？讓 Codex 用 CLI 操作瀏覽器
- MarkItDown 教學
FAQ
OfficeCLI 是什麼？
OfficeCLI 是給 AI Agent 和開發者使用的 Office 文件 CLI，可以建立、讀取、修改和驗證 Word、Excel、PowerPoint 文件。
OfficeCLI 需要安裝 Microsoft Office 嗎？
不需要。官方主打 single binary，不依賴本機 Office 安裝，適合伺服器、CI 和 Agent 執行環境。
OfficeCLI 和 python-docx、openpyxl 差在哪裡？
Python 套件適合固定程式流程。OfficeCLI 更適合 AI Agent，因為它提供一致的 CLI、JSON 輸出、路徑式元素定位、文件驗證和 HTML 或 PNG 預覽。
Codex 可以用 OfficeCLI 嗎？
可以。Codex 可以透過終端執行 OfficeCLI 命令。若把常用流程寫成 skill，就能讓 Codex 更穩定地處理報告、簡報和表格。
近期留言