<!-- Source: https://hermesbible.com/docs/user-guide/features/skins -->

Section: Core Features · URL: https://hermesbible.com/docs/user-guide/features/skins

Skins 控制 Hermes CLI 的視覺呈現：橫幅顏色、旋轉動畫的圖示和動詞、回應框的標籤、品牌文字，以及工具活動前綴。

對話風格和視覺風格是兩個不同的概念：

• Personality 改變 agent 的語氣和用詞。
• Skin 改變 CLI 的外觀。

切換 skin

/skin                # 顯示目前的 skin 並列出可用的 skin
/skin ares           # 切換到內建 skin
/skin mytheme        # 切換到 ~/.hermes/skins/mytheme.yaml 的自訂 skin

或在 ~/.hermes/config.yaml 中設定預設 skin：

display:
  skin: default

內建 skin

完整的可設定鍵值列表

顏色（colors:）

控制 CLI 中所有的顏色值。值為十六進位色碼字串。

旋轉動畫（spinner:）

控制等待 API 回應時顯示的動態旋轉動畫。

當旋轉動畫值為空時（如 default 和 mono），會使用 display.py 中的硬編碼預設值。

品牌（branding:）

CLI 介面中使用的文字字串。

其他頂層鍵值

自訂 skin

在 ~/.hermes/skins/ 下建立 YAML 檔案。使用者的 skin 會從內建的 default skin 繼承缺失的值，因此只需指定要變更的鍵值。

完整自訂 skin YAML 範本

# ~/.hermes/skins/mytheme.yaml
# 完整的 skin 範本 — 列出所有鍵值。刪除不需要的項目；
# 缺失的值會自動從 'default' skin 繼承。

name: mytheme
description: My custom theme

colors:
  banner_border: "#CD7F32"
  banner_title: "#FFD700"
  banner_accent: "#FFBF00"
  banner_dim: "#B8860B"
  banner_text: "#FFF8DC"
  ui_accent: "#FFBF00"
  ui_label: "#4dd0e1"
  ui_ok: "#4caf50"
  ui_error: "#ef5350"
  ui_warn: "#ffa726"
  prompt: "#FFF8DC"
  input_rule: "#CD7F32"
  response_border: "#FFD700"
  session_label: "#DAA520"
  session_border: "#8B8682"
  status_bar_bg: "#1a1a2e"
  voice_status_bg: "#1a1a2e"
  selection_bg: "#333355"
  completion_menu_bg: "#1a1a2e"
  completion_menu_current_bg: "#333355"
  completion_menu_meta_bg: "#1a1a2e"
  completion_menu_meta_current_bg: "#333355"

spinner:
  waiting_faces:
    - "(⚔)"
    - "(⛨)"
    - "(▲)"
  thinking_faces:
    - "(⚔)"
    - "(⌁)"
    - "(<>)"
  thinking_verbs:
    - "processing"
    - "analyzing"
    - "computing"
    - "evaluating"
  wings:
    - ["⟪⚡", "⚡⟫"]
    - ["⟪●", "●⟫"]

branding:
  agent_name: "My Agent"
  welcome: "Welcome to My Agent! Type your message or /help for commands."
  goodbye: "See you later! ⚡"
  response_label: " ⚡ My Agent "
  prompt_symbol: "⚡"
  help_header: "(⚡) Available Commands"

tool_prefix: "┊"

# 各工具的 emoji 覆寫（可選）
tool_emojis:
  terminal: "⚔"
  web_search: "🔮"
  read_file: "📄"

# 自訂 ASCII art 橫幅（可選，支援 Rich markup）
# banner_logo: |
#   [bold #FFD700] MY AGENT [/]
# banner_hero: |
#   [#FFD700]  Custom art here  [/]

最小自訂 skin 範例

由於所有值都從 default 繼承，最小的 skin 只需變更不同之處：

name: cyberpunk
description: Neon terminal theme

colors:
  banner_border: "#FF00FF"
  banner_title: "#00FFFF"
  banner_accent: "#FF1493"

spinner:
  thinking_verbs: ["jacking in", "decrypting", "uploading"]
  wings:
    - ["⟨⚡", "⚡⟩"]

branding:
  agent_name: "Cyber Agent"
  response_label: " ⚡ Cyber "

tool_prefix: "▏"

Hermes Mod — 視覺化 Skin 編輯器

Hermes Mod 是一個社群開發的 Web UI，用於視覺化建立和管理 skin。你不需要手動編寫 YAML，而是透過點擊式編輯器搭配即時預覽來操作。

功能：

• 列出所有內建和自訂 skin
• 將任何 skin 開啟到視覺化編輯器中，包含所有 Hermes skin 欄位（顏色、旋轉動畫、品牌、工具前綴、工具 emoji）
• 從文字提示生成 banner_logo 文字圖
• 將上傳的圖片（PNG、JPG、GIF、WEBP）轉換為 banner_hero ASCII art，支援多種渲染風格（braille、ASCII ramp、blocks、dots）
• 直接儲存到 ~/.hermes/skins/
• 透過更新 ~/.hermes/config.yaml 來啟用 skin
• 顯示產生的 YAML 和即時預覽

安裝

選項 1 — Pinokio（一鍵安裝）：

在 pinokio.computer 上找到它並一鍵安裝。

選項 2 — npx（從終端機最快的方式）：

npx -y hermes-mod

選項 3 — 手動安裝：

git clone https://github.com/cocktailpeanut/hermes-mod.git
cd hermes-mod/app
npm install
npm start

使用方式

1. 啟動應用程式（透過 Pinokio 或終端機）。
2. 開啟 Skin Studio。
3. 選擇要編輯的內建或自訂 skin。
4. 從文字產生 logo 和/或上傳圖片作為英雄圖。選擇渲染風格和寬度。
5. 編輯顏色、旋轉動畫、品牌和其他欄位。
6. 點擊 Save 將 skin YAML 寫入 ~/.hermes/skins/。
7. 點擊 Activate 將其設為目前使用的 skin（更新 config.yaml 中的 display.skin）。

Hermes Mod 遵守 HERMES_HOME 環境變數，因此也能搭配 profiles 使用。

操作說明

• 內建 skin 從 hermes_cli/skin_engine.py 載入。
• 未知的 skin 會自動回退到 default。
• /skin 會立即更新目前 session 的 CLI 主題。
• ~/.hermes/skins/ 中的使用者 skin 優先於同名的內建 skin。
• 透過 /skin 變更的 skin 僅限目前 session。若要設為永久預設，請在 config.yaml 中設定。
• banner_logo 和 banner_hero 欄位支援 Rich console markup（例如 [bold #FF0000]text[/]）用於彩色 ASCII art。