跳到主要内容

皮肤与主题

皮肤控制 Hermes CLI 的视觉呈现：横幅颜色、微标脸部和动词、响应框标签、品牌文字和工具活动前缀。

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

  • 人格 改变代理的语气和措辞。
  • 皮肤 改变 CLI 的外观。

更换皮肤​

/skin                # 显示当前皮肤并列出可用的皮肤
/skin ares           # 切换到内置皮肤
/skin mytheme        # 切换到 ~/.hermes/skins/mytheme.yaml 的自定义皮肤

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

display:
  skin: default

内置皮肤​

皮肤描述代理品牌视觉特征
default经典 Hermes — 金色和可爱Hermes Agent暖金色边框、玉米丝色文字、可爱微标。熟悉的权杖横幅。简洁而友好。
ares战神主题 — 深红和青铜Ares Agent深红边框配青铜色点缀。激进的微标动词（"锻造"、"进军"、"淬炼钢铁"）。自定义剑盾 ASCII 艺术横幅。
mono单色 — 干净的灰度Hermes Agent全灰——无彩色。边框为 #555555，文字为 #c9d1d9。适合极简终端设置或屏幕录制。
slate冷蓝色 — 面向开发者Hermes Agent皇家蓝边框（#4169e1），柔和蓝色文字。冷静而专业。无自定义微标——使用默认脸部。
daylight浅色主题，适合亮色终端，深色文字配冷蓝色点缀Hermes Agent为白色或亮色终端设计。深板岩色文字配蓝色边框、浅色状态区域和浅色补全菜单，在浅色终端配置文件中保持可读性。
warm-lightmode适合浅色终端背景的暖棕色/金色文字Hermes Agent适合浅色终端的暖羊皮纸色调。深棕色文字配鞍棕色点缀、奶油色状态区域。比冷色的 daylight 主题更 earthier。
poseidon海神主题 — 深蓝和海沫Poseidon Agent深蓝到海沫渐变。海洋主题微标（"绘制洋流"、"探测深度"）。三叉戟 ASCII 艺术横幅。
sisyphus西西弗斯主题 — 严格灰度配坚持Sisyphus Agent浅灰配强烈对比。巨石主题微标（"推上山"、"重置巨石"、"忍受循环"）。巨石和山坡 ASCII 艺术横幅。
charizard火山主题 — 焦橙色和余烬Charizard Agent暖焦橙色到余烬渐变。火焰主题微标（"乘风而上"、"测量燃烧"）。龙剪影 ASCII 艺术横幅。

可配置键的完整列表​

颜色（colors:）​

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

键描述默认值（default 皮肤）
banner_border启动横幅周围的面板边框#CD7F32（青铜）
banner_title横幅中的标题文字颜色#FFD700（金色）
banner_accent横幅中的章节标题（Available Tools 等）#FFBF00（琥珀）
banner_dim横幅中的暗淡文字（分隔符、次要标签）#B8860B（暗金合欢）
banner_text横幅中的正文文字（工具名称、技能名称）#FFF8DC（玉米丝）
ui_accent通用 UI 强调色（高亮、活动元素）#FFBF00
ui_labelUI 标签和标签#4dd0e1（青色）
ui_ok成功指示器（勾选、完成）#4caf50（绿色）
ui_error错误指示器（失败、阻止）#ef5350（红色）
ui_warn警告指示器（注意、审批提示）#ffa726（橙色）
prompt交互式提示文字颜色#FFF8DC
input_rule输入区域上方的水平线#CD7F32
response_border代理响应框边框（ANSI 转义）#FFD700
session_label会话标签颜色#DAA520
session_border会话 ID 暗淡边框颜色#8B8682
status_bar_bgTUI 状态/使用情况栏的背景颜色#1a1a2e
voice_status_bg语音模式状态徽章的背景颜色#1a1a2e
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
welcomeCLI 启动时显示的欢迎消息Welcome to Hermes Agent! Type your message or /help for commands.
goodbye退出时显示的消息Goodbye! ⚕
response_label响应框标题上的标签⚕ Hermes
prompt_symbol用户输入提示前的符号❯
help_header/help 命令输出的标题文字(^_^)? Available Commands

其他顶级键​

键类型描述默认值
tool_prefix字符串CLI 中工具输出行前缀的字符┊
tool_emojisdict微标和进度的每工具表情符号覆盖（{tool_name: emoji}）{}
banner_logo字符串富标记 ASCII 艺术徽标（替换默认 HERMES_AGENT 横幅）""
banner_hero字符串富标记英雄艺术（替换默认权杖艺术）""

自定义皮肤​

在 ~/.hermes/skins/ 下创建 YAML 文件。用户皮肤从内置 default 皮肤继承缺失的值，因此你只需指定你想要更改的键。

完整自定义皮肤 YAML 模板​

# ~/.hermes/skins/mytheme.yaml
# 完整皮肤模板——显示所有键。删除你不需要的；
# 缺失值自动从 'default' 皮肤继承。

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"
  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: "┊"

# 每工具表情符号覆盖（可选）
tool_emojis:
  terminal: "⚔"
  web_search: "🔮"
  read_file: "📄"

# 自定义 ASCII 艺术横幅（可选，支持 Rich 标记）
# 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 皮肤编辑器

功能：

  • 列出所有内置和自定义皮肤
  • 将任何皮肤打开为可视化编辑器，包含所有 Hermes 皮肤字段（颜色、微标、品牌、工具前缀、工具表情符号）
  • 根据文本提示从文本生成 banner_logo 文字艺术
  • 将上传的图像（PNG、JPG、GIF、WEBP）转换为多种渲染样式的 banner_hero ASCII 艺术（盲文、ASCII 坡道、块、点）
  • 直接保存到 ~/.hermes/skins/
  • 通过更新 ~/.hermes/config.yaml 激活皮肤
  • 显示生成的 YAML 和实时预览

安装​

选项 1 — Pinokio（1键）：

在 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 环境变量，因此它也可以与画像一起使用。

操作说明​

  • 内置皮肤从 hermes_cli/skin_engine.py 加载。
  • 未知皮肤自动回退到 default。
  • /skin 立即更新当前会话的活动 CLI 主题。
  • ~/.hermes/skins/ 中的用户皮肤优先于同名的内置皮肤。
  • 通过 /skin 的皮肤更改仅限当前会话。要使皮肤成为永久默认，在 config.yaml 中设置。
  • banner_logo 和 banner_hero 字段支持 Rich 控制台标记（例如 [bold #FF0000]text[/]）用于彩色 ASCII 艺术。