sidebar_position: 10 title: “Skins & Themes” description: “Customize the Hermes CLI with built-in and user-defined skins”

外观皮肤与主题

外观皮肤用于控制Hermes CLI的视觉呈现效果，包括横幅颜色、加载动画的图案与文字、响应框标签、品牌标识文本以及工具操作的前缀。

对话风格与视觉风格是两个不同的概念：

• 个性设置用于改变智能体的语气和用词方式。
• 外观皮肤则用于改变CLI的整体外观。

更改外观皮肤

/skin                # show the current skin and list available skins
/skin ares           # switch to a built-in skin
/skin mytheme        # switch to a custom skin from ~/.hermes/skins/mytheme.yaml

或者可以在 ~/.hermes/config.yaml 中设置默认皮肤：

display:
  skin: default

内置主题皮肤

所有可配置键的完整列表

颜色 (colors:)

用于控制CLI中的所有颜色值，数值为十六进制颜色字符串。

加载动画 (spinner:)

用于控制等待API响应时显示的动画加载符号。

当spinner相关键的值为空时（如default和mono主题），将使用display.py文件中预定义的默认值。

品牌标识 (branding:)

用于CLI界面各处的文本字符串。

其他顶层键

自定义主题皮肤

可在~/.hermes/skins/目录下创建YAML文件。用户自定义的主题会自动继承内置default主题中缺失的配置值，因此只需指定需要修改的键即可。

完整的自定义主题皮肤YAML模板

# ~/.hermes/skins/mytheme.yaml
# Complete skin template — all keys shown. Delete any you don't need;
# missing values automatically inherit from the '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: "┊"

# Per-tool emoji overrides (optional)
tool_emojis:
  terminal: "⚔"
  web_search: "🔮"
  read_file: "📄"

# Custom ASCII art banners (optional, Rich markup supported)
# banner_logo: |
#   [bold #FFD700] MY AGENT [/]
# banner_hero: |
#   [#FFD700]  Custom art here  [/]

最简自定义皮肤示例

由于所有内容都继承自 default，因此最简皮肤只需修改那些需要差异化的部分即可：

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 — 可视化皮肤编辑器

Hermes Mod 是一个由社区开发的网页界面，用于以可视化方式创建和管理皮肤。您无需手动编写 YAML 文件，而是可以通过点击式编辑器进行操作，并实时查看预览效果。

功能特点：

• 列出所有内置及自定义皮肤
• 打开任意皮肤后，即可进入可视化编辑器，可调整所有 Hermes 皮肤相关参数（颜色、旋转组件、品牌标识、工具前缀、工具表情符号等）
• 根据文本提示生成 banner_logo 文字艺术效果
• 将上传的图片（PNG、JPG、GIF、WEBP 格式）转换为多种渲染风格的 banner_hero ASCII 艺术图（点阵、斜坡、方块、点状等）
• 直接保存到 ~/.hermes/skins/ 目录
• 通过修改 ~/.hermes/config.yaml 文件来启用特定皮肤
• 显示生成的 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. 选择内置皮肤或自定义皮肤进行编辑。
4. 根据文本生成徽标，或上传图片作为主视觉图。同时选择渲染风格和宽度。
5. 编辑颜色、加载动画、品牌标识及其他相关字段。
6. 点击 Save，将皮肤配置的 YAML 文件保存至 ~/.hermes/skins/ 目录中。
7. 点击 Activate，将其设置为当前皮肤（此操作会更新 config.yaml 文件中的 display.skin 设置）。

Hermes Mod 会优先使用 HERMES_HOME 环境变量指定的路径，因此也可与 profiles 功能协同使用。

操作注意事项

• 内置皮肤从 hermes_cli/skin_engine.py 文件中加载。
• 未知皮肤会自动回退为 default 皮肤。
• 使用 /skin 命令可立即为当前会话更新活跃的 CLI 主题。
• 位于 ~/.hermes/skins/ 目录中的用户自定义皮肤，其优先级高于同名的内置皮肤。
• 通过 /skin 命令更改的皮肤设置仅适用于当前会话。若要将某皮肤设为永久默认值，则需在 config.yaml 中进行配置。
• banner_logo 和 banner_hero 字段支持使用富文本标记语法（例如 [bold #FF0000]text[/]），以便生成带颜色的 ASCII 艺术字。