# 🤖 Project Golem 指令說明一覽表

本文件整理了 Project Golem (v9.5 及以上版本) 內建的核心系統指令，以及與 Google 網頁版服務連動的擴充功能召喚指令。

---

## 🛠️ 系統管理與急救指令

您可以直接在對話框中輸入以下指令，用來管理 Golem 底層的隱形瀏覽器與記憶狀態。

| 指令 | 功能名稱 | 觸發效果與使用時機 |
| :--- | :--- | :--- |
| `/sos` | **輕量級急救** | **(最常用)** 當 Golem 突然卡住、已讀不回，或遇到網頁小改版時使用。清除「網頁元素快取」，強迫 DOM Doctor 重新掃描並修復網頁結構，**不需重啟進程**。 |
| `/new` | **物理重生** | 當對話卡死，或是網頁跳出阻擋視窗時使用。強制重新整理底層瀏覽器，回到 Gemini 根目錄，開啟一個**全新的對話視窗**。 |
| `/new_memory`| **徹底轉生** | 當想要 Golem 完全忘記過去的所有專案細節時使用。**物理清空底層資料庫 (DB)** 並重置對話，讓 Golem 變成一張白紙。 |
| `/model` | **模型切換** | 操控底層的網頁 UI，實體切換 Gemini 的大腦模型（例如切換 Fast / Thinking / Pro 模式）。 |
| `/install skill <path>` | **安裝技能套件** | 從本機技能資料夾安裝新技能（資料夾內需有 `manifest.json`），安裝後會自動同步 capability/example/vector 索引。 |
| `/install skill-gh <url>` | **遠端安裝技能** | 從 GitHub repo/tree URL 安裝技能。 |
| `/install mcp-file <path>` | **安裝 MCP（檔案）** | 從本機 JSON 設定檔新增或更新 MCP 伺服器設定。 |
| `/install mcp-json <json>` | **安裝 MCP（JSON）** | 直接貼一行 JSON 來新增或更新 MCP 伺服器設定（至少要有 `name`, `command`）。 |
| `/install mcp-url <url>` | **遠端安裝 MCP** | 從 HTTPS JSON URL 新增或更新 MCP 伺服器設定。 |

---

## 🪄 雲端擴充功能召喚指令

✨使用前務必確認你的檔案是最新版，這是新功能✨

透過「斜線指令明確觸發機制」，您可以精準要求 Golem 在背景呼叫 Google 官方的擴充功能，來讀取您的私人信件或雲端硬碟。

**💡 使用格式：**
請在對話的最前面加上指令，例如：
> `/@Gmail 幫我總結今天早上主管寄來的信件重點`
> `/@Google 雲端硬碟 幫我找一下最新的 2026 財務報表 PDF`

| 支援的召喚指令 | 對應觸發的 Google 服務 |
| :--- | :--- |
| `/@Gmail` | 讀取、搜尋您的個人電子郵件 |
| `/@Google 雲端硬碟` | 搜尋您的 Google Drive 檔案 (文件、PDF、圖片等) |
| `/@Google 文件` | 讀取或搜尋特定的 Google Docs |
| `/@Google Keep` | 讀取您的個人筆記 |
| `/@Google Tasks` | 讀取或管理您的待辦事項 |
| `/@YouTube` | 搜尋 YouTube 影片資料 |
| `/@Google Maps` | 查詢地圖、地點資訊 |
| `/@Google 航班` | 查詢航班資訊 |
| `/@Google 飯店` | 查詢飯店住宿資訊 |
| `/@Workspace` | (通用型) 讓 AI 自行判斷要使用哪個辦公軟體 |

> **⚠️ 注意事項 (必看)：**
> 使用擴充功能指令前，請確保您在伺服器端部署 Golem 時，有先透過 `headless: false` 手動登入並**完成 Google Workspace 的權限授權驗證**。若未授權，AI 將無法存取您的私人資料。
>
> ---

### 💡 補充說明：如何首次開通 Workspace 擴充功能權限？

由於 Golem 運行在獨立的瀏覽器環境中，即使您平常用自己的瀏覽器授權過，初次讓 Golem 使用擴充功能（如讀取信件或雲端硬碟）時，仍需要您**手動授權一次**。

**授權 3 步驟 (只需做一次)：**

1. **啟動伺服器**：啟動 Golem 後，系統預設會自動彈出一個 Chrome 瀏覽器視窗。
2. **手動召喚**：請在該網頁的輸入框中，用實體鍵盤輸入 `@Gmail`。**務必用滑鼠點選下拉選單出現的標籤**，隨便打一句話後送出。
3. **點擊連線**：送出後，畫面上會跳出一張提示卡片，請點擊卡片下方的 **「連線 (Connect)」** 按鈕，順著畫面完成 Google 帳號授權即可！

> 💡 **進階設定 (背景運行)**：只要您親手授權過一次，Golem 就會永久記住權限！如果您未來不想再看到瀏覽器彈出，可以到程式碼中將 `headless: false` 修改為 `true`，讓它完全在背景默默為您工作。
> 
> ⚠️ **注意**：擴充功能僅限一般個人帳號（結尾為 `@gmail.com`）使用。企業或學校配發的 Workspace 帳號，通常會被組織管理員鎖定第三方權限而無法使用。