皮肤与主题（Skins & Themes）

皮肤（Skins）控制 Hermes CLI 的视觉呈现：横幅颜色、加载动画图案和动词、响应框标签、品牌文字以及工具活动前缀。

对话风格和视觉风格是两个独立的概念：

个性（Personality） 改变 Agent 的语气和措辞。
皮肤（Skin） 改变 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

内置皮肤

皮肤	描述	Agent 品牌名	视觉特征
`default`	经典 Hermes——金色与可爱风	`Hermes Agent`	温暖金色边框，玉米丝色文字，加载动画中有可爱表情。熟悉的双蛇杖横幅。简洁友好。
`ares`	战神主题——深红与青铜	`Ares Agent`	深红色边框配青铜点缀。激进的加载动词（"forging"、"marching"、"tempering steel"）。自定义剑盾 ASCII 横幅。
`mono`	单色——纯净灰阶	`Hermes Agent`	全灰色——无彩色。边框 `#555555`，文字 `#c9d1d9`。适合极简终端设置或录屏。
`slate`	冷蓝色——面向开发者	`Hermes Agent`	宝蓝色边框（`#4169e1`），柔蓝色文字。沉稳专业。无自定义加载动画——使用默认图案。
`daylight`	深色文字配冷蓝色调的亮色终端主题	`Hermes Agent`	专为白色或亮色终端设计。深板岩色文字配蓝色边框，浅色状态栏，在亮色终端配置中清晰易读。
`warm-lightmode`	适合亮色终端背景的暖棕/金色文字	`Hermes Agent`	适合亮色终端的暖羊皮纸色调。深棕色文字配马鞍棕色点缀，奶油色状态栏。比冷色 daylight 主题更温暖的土系替代方案。
`poseidon`	海神主题——深蓝与海泡绿	`Poseidon Agent`	深蓝到海泡绿渐变。海洋主题加载动画（"charting currents"、"sounding the depth"）。三叉戟 ASCII 横幅。
`sisyphus`	西西弗斯主题——朴素灰阶与坚持意志	`Sisyphus Agent`	浅灰色配强烈对比。巨石主题加载动画（"pushing uphill"、"resetting the boulder"、"enduring the loop"）。巨石与山丘 ASCII 横幅。
`charizard`	火山主题——焦橙与余烬	`Charizard Agent`	暖焦橙到余烬渐变。火焰主题加载动画（"banking into the draft"、"measuring burn"）。龙剪影 ASCII 横幅。

可配置键完整列表

颜色（`colors:`）

控制整个 CLI 的所有颜色值。值为十六进制颜色字符串。

键	描述	默认值（`default` 皮肤）
`banner_border`	启动横幅的面板边框	`#CD7F32`（青铜）
`banner_title`	横幅中的标题文字颜色	`#FFD700`（金色）
`banner_accent`	横幅中的章节标题（可用工具等）	`#FFBF00`（琥珀）
`banner_dim`	横幅中的淡色文字（分隔符、次要标签）	`#B8860B`（暗金）
`banner_text`	横幅中的正文（工具名称、技能名称）	`#FFF8DC`（玉米丝）
`ui_accent`	通用 UI 强调色（高亮、活动元素）	`#FFBF00`
`ui_label`	UI 标签和标签	`#4dd0e1`（青色）
`ui_ok`	成功指示器（对勾、完成）	`#4caf50`（绿色）
`ui_error`	错误指示器（失败、阻塞）	`#ef5350`（红色）
`ui_warn`	警告指示器（注意、审批提示）	`#ffa726`（橙色）
`prompt`	交互提示文字颜色	`#FFF8DC`
`input_rule`	输入区域上方的水平分割线	`#CD7F32`
`response_border`	Agent 响应框的边框（ANSI 转义）	`#FFD700`
`session_label`	会话标签颜色	`#DAA520`
`session_border`	会话 ID 淡色边框颜色	`#8B8682`
`status_bar_bg`	TUI 状态/使用量栏的背景色	`#1a1a2e`
`voice_status_bg`	语音模式状态徽章的背景色	`#1a1a2e`
`selection_bg`	TUI 鼠标选择高亮器的背景色。未设置时回退到 `completion_menu_current_bg`。	`#333355`
`completion_menu_bg`	补全菜单列表的背景色	`#1a1a2e`
`completion_menu_current_bg`	当前活动补全行的背景色	`#333355`
`completion_menu_meta_bg`	补全元信息列的背景色	`#1a1a2e`
`completion_menu_meta_current_bg`	当前活动补全元信息列的背景色	`#333355`

加载动画（`spinner:`）

控制等待 API 响应时显示的动画加载器。

键	类型	描述	示例
`waiting_faces`	字符串列表	等待 API 响应时循环显示的图案	`["(⚔)", "(⛨)", "(▲)"]`
`thinking_faces`	字符串列表	模型推理期间循环显示的图案	`["(⚔)", "(⌁)", "(<>)"]`
`thinking_verbs`	字符串列表	加载动画消息中显示的动词	`["forging", "plotting", "hammering plans"]`
`wings`	[左, 右] 对列表	加载动画周围的装饰括号	`[["⟪⚔", "⚔⟫"], ["⟪▲", "▲⟫"]]`

当加载动画值为空时（如 default 和 mono），使用 display.py 中的硬编码默认值。

品牌（`branding:`）

整个 CLI 界面中使用的文字字符串。

键	描述	默认值
`agent_name`	横幅标题和状态显示中显示的名称	`Hermes Agent`
`welcome`	CLI 启动时显示的欢迎信息	`Welcome to Hermes Agent! Type your message or /help for commands.`
`goodbye`	退出时显示的消息	`Goodbye! ⚕`
`response_label`	响应框标题的标签	`⚕ Hermes`
`prompt_symbol`	用户输入提示前的符号（裸 token，渲染器会添加尾部空格）	`❯`
`help_header`	`/help` 命令输出的标题文字	`(^_^)? Available Commands`

其他顶级键

键	类型	描述	默认值
`tool_prefix`	string	CLI 工具输出行的前缀字符	`┊`
`tool_emojis`	dict	各工具加载动画和进度的表情覆盖（`{tool_name: emoji}`）	`{}`
`banner_logo`	string	Rich 标记 ASCII 艺术 logo（替换默认 HERMES_AGENT 横幅）	`""`
`banner_hero`	string	Rich 标记主视觉艺术（替换默认双蛇杖艺术）	`""`

自定义皮肤

在 ~/.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 是一个社区开发的 Web UI，用于可视化创建和管理皮肤。无需手写 YAML，你可以使用点击式编辑器和实时预览。

Hermes Mod skin editor

功能：

列出所有内置和自定义皮肤
将任意皮肤打开到可视化编辑器，编辑所有 Hermes 皮肤字段（颜色、加载动画、品牌、工具前缀、工具表情）
从文本提示生成 banner_logo 文字艺术
将上传的图片（PNG、JPG、GIF、WEBP）转换为 banner_hero ASCII 艺术，支持多种渲染风格（盲文、ASCII 渐变、方块、点）
直接保存到 ~/.hermes/skins/
通过更新 ~/.hermes/config.yaml 激活皮肤
显示生成的 YAML 和实时预览

安装

选项一 — Pinokio（一键安装）：

在 pinokio.computer 上找到并一键安装。

选项二 — npx（从终端最快）：

npx -y hermes-mod

选项三 — 手动安装：

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

使用方式

启动应用（通过 Pinokio 或终端）。
打开 Skin Studio。
选择内置或自定义皮肤进行编辑。
从文本生成 logo，和/或上传图片作为主视觉艺术。选择渲染风格和宽度。
编辑颜色、加载动画、品牌和其他字段。
点击 Save 将皮肤 YAML 写入 ~/.hermes/skins/。
点击 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 字段支持 Rich 控制台标记（如 [bold #FF0000]text[/]）用于彩色 ASCII 艺术。

切换皮肤​

内置皮肤​

可配置键完整列表​

颜色（colors:）​

加载动画（spinner:）​

品牌（branding:）​

其他顶级键​

自定义皮肤​

完整自定义皮肤 YAML 模板​

极简自定义皮肤示例​

Hermes Mod — 可视化皮肤编辑器​

安装​

使用方式​

操作注意事项​