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

## 一句話總結

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

## 核心重點

1.  **工具定位**：OfficeCLI 是一個免費、開源、單一檔案的命令行工具，安裝後 AI 可直接操作 Word、Excel、PPT。
2.  **核心優勢**：
    *   全程不寫程式碼，由 AI 執行命令。
    *   內建渲染引擎（screenshot）可直接輸出圖片。
    *   內建 Excel 函數計算功能，節省時間與 Token 成本。
    *   具備即時預覽功能（Watch）。
3.  **操作邏輯**：將文件視為類似檔案系統的結構，透過路徑（如 `/slide[1]`）定位元素。
4.  **實際應用場景**：
    *   從 YouTube API 抓取真實數據生成 PPT。
    *   自動計算 Excel 報表（包含資料透視表生成）。
    *   Word 文件的即時預覽。
5.  **未來展望**：預告將介紹如何將 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 建立與編輯流程
1.  **建立文件**：使用 `create` 命令，指定副檔名（如 `.pptx`）以建立空文件。
2.  **添加頁面**：使用 `add` 命令並指定 `--type slide`。
3.  **設置屬性**：使用 `--prop` 設置標題（`title`）或背景色（`background`，十六進制代碼）。
    *   *注意*：深色背景需搭配淺色文字以確保可讀性。
4.  **添加內容（如文本框）**：
    *   定位路徑（如 `/slide[1]/shape`），路徑需加單引號。
    *   設置參數：`x`, `y`（位置，支援厘米/英寸/像素）、`size`（字號）、`color`（顏色）。
5.  **預覽/渲染**：使用內建 `screenshot` 引擎將 PPT 轉換為 PNG 圖片。

### 2. Excel 自動化計算流程
1.  **定位儲存格**：使用路徑（如 `/Sheet1/A1`）指定目標儲存格。
2.  **輸入公式**：填入求和或其他公式。
3.  **驗證計算**：查詢結果，若返回 `evaluated: true` 表示公式已計算完成。
4.  **數據匯總（進階）**：使用 `rows=Region` 和 `values=Revenue:sum` 等參數，一行命令生成資料透視表。

### 3. Word 文件編輯與預覽流程
1.  **定位內容**：內容位於 `/body` 底下。
2.  **添加段落**：使用 `--type paragraph`。
3.  **設置樣式**：使用 `style=Heading1` 設置標題等級。
4.  **即時預覽**：啟動 `Watch` 功能啟動本地預覽伺服器，透過瀏覽器查看文件效果。

### 4. 安裝流程
1.  執行一行安裝指令。
2.  驗證版本號以確認安裝成功。

## 值得注意的限制或風險

1.  **路徑語法限制**：在終端中，路徑中的方括號 `[]`（如 `slide[1]`）具有特殊含義，若不加單引號可能會報錯。
2.  **視覺對比度**：使用深色背景時，必須搭配淺色文字，否則可能因對比度不足導致無法閱讀。
3.  **Token 與時間成本**：雖然 OfficeCLI 節省了打開軟體的時間，但仍需關注 AI 執行命令時的 Token 成本（儘管影片強調其節省成本，但仍為潛在考量）。
4.  **依賴 AI 執行**：整個流程依賴 AI 執行命令，若 AI 理解錯誤或指令格式不對，可能導致操作失敗。

## 逐字稿辨識疑點

1.  **兩萬多星**：逐字稿提到「兩萬多星」，未明確指出是 GitHub Stars 數量，但語境暗示為 GitHub 排名依據。
2.  **screenshot**：逐字稿稱其為「內建了一個渲染引擎 screenshot」，通常 screenshot 意指截圖，此處作為引擎名稱需查證其官方定義是否為渲染引擎。
3.  **evaluated true**：逐字稿提到返回 `evaluated true`，需確認這是否為 OfficeCLI 的標準輸出格式或特定語境下的描述。
4.  **350 多個 Excel 函數**：需查證 OfficeCLI 是否確實支援此數量的函數。
5.  **路徑中的方括號 `[1]`**：逐字稿提到 `slide[1]` 並強調終端中方括號有特殊含義，需確認此為特定語法還是通用路徑表示法。
6.  **Claude Code**：需確認此為 Anthropic 官方產品名稱或影片作者自稱的整合方式。

## 可延伸追問

1.  OfficeCLI 的 `screenshot` 渲染引擎具體支援哪些圖片格式？是否僅限 PNG？
2.  在 Excel 中，內建的 350 多個函數是否包含所有常見的商业計算函數（如 VLOOKUP, INDEX-MATCH 等）？
3.  將 OfficeCLI 接入 Claude Code 後，如何處理 AI 生成錯誤時的自動修正機制？
4.  OfficeCLI 是否支援多語言環境下的文字排版（如中文、日文）？
5.  對於大型 PPT 文件（超過 50 頁），OfficeCLI 的渲染速度和記憶體佔用情況如何？