Themes
Gemini CLI themes 的用途：終端 UI 個性化、可讀性和團隊教學截圖一致性。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Themes | 主題 | 終端介面的外觀設定。 |
| 可讀性 | readability | 配色對長時間使用的影響。 |
| 切換 | switch | 按環境切換主題。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你選 / 配 Gemini CLI 的主題，提升長時間使用的可讀性。
你是 Gemini CLI 主題設定顧問。
【角色】
Gemini CLI 主題設定顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的步驟或示例，不停留在空泛建議。
【輸入】
- 我的使用環境（亮 / 暗 / 戶外）：___
- 對可讀性 / 護眼的偏好：___
- 終端型別：___
- 是否需要按場景切換：___
- 經驗水平：___
【工作流程】
1. 按環境推薦主題
2. 說明可讀性和護眼考慮
3. 給設定和切換方式
4. 處理終端相容
5. 給驗證
【輸出規範】
▌一、推薦主題 + 理由
▌二、可讀性考慮
▌三、設定與切換
▌四、相容 + 驗證
【硬約束】
- 主題按實際環境選，不只看好看
- 長時間使用優先護眼可讀
- 不確定的主題欄位查官方
- 不要替我臆測情況或編造不存在的設定項，資訊不全先問清
- 不確定的設定或欄位一律以官方文件為準，禁止照搬過時寫法Themes 影響 Gemini CLI 的終端顯示。它不是核心能力，但會影響長時間使用的可讀性。
主題設定的目標是可讀和一致，不是把教學截圖做得花哨。終端工具最重要的是文本、diff、warning 和 error 都能看清。
可以透過 /theme 互動選擇，也可以在 settings.json 的 ui.theme 或 ui.customThemes 固定。官方內建深色和淺色主題，也支援 extension 提供主題。
什麼時候需要設定主題
- 深色/淺色終端不匹配。
- 錄屏或截圖需要統一風格。
- 字型顏色在目前終端裡不清晰。
- 團隊教學要保持截圖一致。
設定方式
互動方式：
/theme如果 settings.json 裡已經固定了 ui.theme，需要先移除該設定，否則 /theme 中的互動選擇可能不會覆蓋檔案裡的設定。
自定義主題放在 ui.customThemes，至少要定義 name、type: "custom"、背景色和主要文字色。也可以把主題放在獨立 JSON 檔案裡，再在 ui.theme 指向該檔案路徑。出於安全考慮，Gemini CLI 只會載入位於使用者 home 目錄內的主題檔案。
官方主題變數不只影響普通文字。常見變數包括 Background、Foreground、AccentBlue、AccentPurple、AccentCyan、AccentGreen、AccentYellow、AccentRed、Comment、Gray，以及用於 diff 的 DiffAdded、DiffRemoved、DiffModified。如果主題沒有覆蓋關鍵狀態色，程式碼修改和錯誤提示會很難讀。
一個穩定的教學主題至少要檢查三類畫面：普通對話、工具確認、diff 展示。只看歡迎頁好不好看沒有意義，真正影響學習體驗的是 warning、error、added、removed 這些狀態是否清晰。
教學截圖建議
教學站不要追求花哨主題，優先選對比度穩定、淺深色都可讀的主題。截圖前固定主題、終端字型和視窗寬度，否則同一篇教學裡 UI 變化會顯得不專業。
| 場景 | 推薦做法 | 避免 |
|---|---|---|
| 教學截圖 | 固定主題、字型、視窗寬度 | 每張圖隨機主題 |
| 長時間編碼 | 選擇對比度穩定的主題 | 低對比度彩色主題 |
| 團隊文件 | 用專案文件記錄截圖環境 | 只靠個人終端偏好 |
| 自定義主題 | 先檢查 warning、error、diff 色 | 只看普通文本 |
如果教學面向新手，主題更應該接近預設體驗。過度自定義會讓讀者開啟自己的終端後找不到對應 UI 狀態。
不要過度投入
主題不會提升 agent 質量。先把上下文、許可權、工具、驗證流程做好，再調視覺。
如果主題只是個人偏好，放使用者級 settings；只有教學錄屏、團隊截圖規範或共享開發環境需要一致時，才考慮寫入專案文件。不要因為自己喜歡某個顏色，就把 ui.theme 固定進儲存庫級設定。
常見排錯
主題不生效時，先看 settings.json 裡是否已經固定 ui.theme。如果檔案裡寫死了主題，/theme 的互動選擇可能不會覆蓋這個設定。第二步檢查自定義主題檔案是否在 home 目錄內；官方出於安全原因不會從任意路徑載入主題 JSON。
顏色看不清時，不要只調背景色。優先檢查 Foreground、Comment、AccentRed、AccentYellow 和 diff 相關變數。warning、error、diff 刪除行是教學截圖裡最容易出問題的地方。
截圖驗收清單
教學站截圖要固定三件事：終端寬度、字型大小、主題名稱。每次換主題後，至少截一張普通對話、一張命令確認、一張檔案 diff。三張都清楚，才說明主題適合教學內容。
如果頁面要給讀者複製設定，建議同時說明這是視覺設定，不影響模型能力、配額、上下文和工具許可權。新手最容易把 UI 變化誤解成“模型模式變化”，這一點要在教學裡主動消除。
主題只服務可讀性，不應承擔功能解釋，也不應掩蓋真實命令輸出和錯誤資訊。
驗收方式
執行 /theme 確認可選列表裡出現預期主題。自定義主題要同時檢查普通文本、程式碼塊、diff added/removed、warning/error 狀態色，確保錄屏和截圖中不會看不清。
接下來去哪
Trusted folders
UI 設定結束後，繼續看 workspace 信任和安全邊界。
Settings
主題最終要回到 settings.json 固化。
Local development
如果是錄屏或教學環境，繼續看本地開發設定。