影片筆記：GitHub 上月第一名，居然是个做 office的命令行工具

一句話總結

影片介紹了一款名為 OfficeCLI 的免費開源命令行工具，該工具在 GitHub 上月獲得全球第一名（超過兩萬顆星），其主要功能是讓 AI 透過單一指令檔直接操作 Word、Excel 和 PowerPoint 文件，無需打開對應軟體，並具備內建渲染、即時預覽及 Excel 函數計算等功能。

核心重點

工具定位：OfficeCLI 是一個免費、開源、單一檔案的命令行工具，安裝後 AI 可直接操作 Word、Excel、PPT。

核心優勢：

• 全程不寫程式碼，由 AI 執行命令。
• 內建渲染引擎（screenshot）可直接輸出圖片。
• 內建 Excel 函數計算功能，節省時間與 Token 成本。
• 具備即時預覽功能（Watch）。

操作邏輯：將文件視為類似檔案系統的結構，透過路徑（如 /slide[1]）定位元素。

實際應用場景：

• 從 YouTube API 抓取真實數據生成 PPT。
• 自動計算 Excel 報表（包含資料透視表生成）。
• Word 文件的即時預覽。

未來展望：預告將介紹如何將 OfficeCLI 接入 Claude Code，實現 AI 自動生成報告並檢查修正至無誤的全自動化流程。

詳細大綱

I. OfficeCLI 工具介紹

• 基本資訊：
• 名稱：OfficeCLI。
• 特性：免費、開源、單一檔案。
• 地位：GitHub 全球第一名（上月），超過兩萬顆星。
• 功能：安裝後，AI 可直接操作 Word、Excel、PPT。

II. PowerPoint (PPT) 操作演示

• 基礎建立：
• 使用 create 命令建立空文件，根據副檔名（.pptx, .docx, .xlsx）自動判斷類型。
• 使用 add 命令添加內容。
• 頁面與樣式設定：
• --type slide：添加新頁面。
• --prop：設置屬性，如 title（標題）和 background（背景色，使用十六進制代碼）。
• 重要習慣：深色背景需搭配淺色文字，避免對比度不足導致無法閱讀。
• 預覽與渲染：
• 使用內建的 screenshot 渲染引擎，直接將 PPT 轉換為 PNG 圖片，無需打開 PowerPoint。
• 路徑結構概念（核心概念）：
• 文件結構類似檔案夾：最外層為頁面（如 /slide[1]），內部包含子元素（如 /slide[1]/shape）。
• 使用斜杠 / 表示路徑層級。
• 添加文本框：
• 路徑需加單引號（因終端中方括號 [] 有特殊含義，不加會報錯）。
• 參數包括 x, y（位置，支援厘米、英寸、像素）、size（字號）、color（文字顏色）。

III. Excel 報表自動化

• 痛點解決：傳統流程需寫完公式後打開 Excel 計算，OfficeCLI 可省略此步驟。
• 操作方式：
• 使用路徑（如 /Sheet1/A1）定位儲存格。
• 填入求和公式後，直接查詢結果。
• 返回 evaluated: true 表示公式已計算完成。
• 功能亮點：
• 內建 350 多個 Excel 函數。
• 節省時間與 Token 成本（無需來回打開軟體）。
• 數據匯總案例：
• 使用 rows=Region 和 values=Revenue:sum 一行命令生成資料透視表。

IV. Word 文件與即時預覽

• Word 基本操作：
• 內容位於 /body 底下。
• --type paragraph 設置段落。
• style=Heading1 設置一級標題。
• 殺手鐧功能：Watch 即時預覽：
• 啟動本地預覽伺服器。
• 透過瀏覽器即可查看文件效果。

V. 安裝與後續預告

• 安裝驗證：
• 安裝指令僅一行。
• 安裝後需驗證版本號以確認成功。
• 下期預告：
• 將介紹如何將 OfficeCLI 接入 Claude Code。
• 目標：讓 AI 自動生成報告並檢查修正至無誤，全程無需人工盯梢。

工具 / 模型 / 名詞整理

• OfficeCLI：影片介紹的命令行工具。
• GitHub：程式碼託管平台。
• YouTube API：用於抓取真實數據的介面。
• PowerPoint：微軟簡報軟體。
• Word：微軟文書軟體。
• Excel：微軟試算表軟體。
• Claude Code：影片預告將要接入的 AI 模型/工具。
• PNG：圖片格式。
• screenshot：OfficeCLI 內建的渲染引擎名稱。

操作流程整理

1. PPT 建立與編輯流程

建立文件：使用 create 命令，指定副檔名（如 .pptx）以建立空文件。

添加頁面：使用 add 命令並指定 --type slide。

設置屬性：使用 --prop 設置標題（title）或背景色（background，十六進制代碼）。

• *注意*：深色背景需搭配淺色文字以確保可讀性。

添加內容（如文本框）：

• 定位路徑（如 /slide[1]/shape），路徑需加單引號。
• 設置參數：x, y（位置，支援厘米/英寸/像素）、size（字號）、color（顏色）。

預覽/渲染：使用內建 screenshot 引擎將 PPT 轉換為 PNG 圖片。

2. Excel 自動化計算流程

定位儲存格：使用路徑（如 /Sheet1/A1）指定目標儲存格。

輸入公式：填入求和或其他公式。

驗證計算：查詢結果，若返回 evaluated: true 表示公式已計算完成。

數據匯總（進階）：使用 rows=Region 和 values=Revenue:sum 等參數，一行命令生成資料透視表。

3. Word 文件編輯與預覽流程

定位內容：內容位於 /body 底下。

添加段落：使用 --type paragraph。

設置樣式：使用 style=Heading1 設置標題等級。

即時預覽：啟動 Watch 功能啟動本地預覽伺服器，透過瀏覽器查看文件效果。

4. 安裝流程

執行一行安裝指令。

驗證版本號以確認安裝成功。

值得注意的限制或風險

路徑語法限制：在終端中，路徑中的方括號 []（如 slide[1]）具有特殊含義，若不加單引號可能會報錯。

視覺對比度：使用深色背景時，必須搭配淺色文字，否則可能因對比度不足導致無法閱讀。

Token 與時間成本：雖然 OfficeCLI 節省了打開軟體的時間，但仍需關注 AI 執行命令時的 Token 成本（儘管影片強調其節省成本，但仍為潛在考量）。

依賴 AI 執行：整個流程依賴 AI 執行命令，若 AI 理解錯誤或指令格式不對，可能導致操作失敗。

逐字稿辨識疑點

兩萬多星：逐字稿提到「兩萬多星」，未明確指出是 GitHub Stars 數量，但語境暗示為 GitHub 排名依據。

screenshot：逐字稿稱其為「內建了一個渲染引擎 screenshot」，通常 screenshot 意指截圖，此處作為引擎名稱需查證其官方定義是否為渲染引擎。

evaluated true：逐字稿提到返回 evaluated true，需確認這是否為 OfficeCLI 的標準輸出格式或特定語境下的描述。

350 多個 Excel 函數：需查證 OfficeCLI 是否確實支援此數量的函數。

路徑中的方括號 [1]：逐字稿提到 slide[1] 並強調終端中方括號有特殊含義，需確認此為特定語法還是通用路徑表示法。

Claude Code：需確認此為 Anthropic 官方產品名稱或影片作者自稱的整合方式。

可延伸追問

OfficeCLI 的 screenshot 渲染引擎具體支援哪些圖片格式？是否僅限 PNG？

在 Excel 中，內建的 350 多個函數是否包含所有常見的商业計算函數（如 VLOOKUP, INDEX-MATCH 等）？

將 OfficeCLI 接入 Claude Code 後，如何處理 AI 生成錯誤時的自動修正機制？

OfficeCLI 是否支援多語言環境下的文字排版（如中文、日文）？

對於大型 PPT 文件（超過 50 頁），OfficeCLI 的渲染速度和記憶體佔用情況如何？