Hermes 皮肤维护
使用此技能来审计、扩展或修复现有的 Hermes 皮肤,同时保持其在 CLI、TUI 和桌面应用中的视觉特征。
权限与范围
- 跨表面颜色契约的规范来源是 Hermes Agent 仓库中
apps/shared/src/skin.ts文件内的SKIN_COLOR_TOKENS。从用户指定的分支获取该原始文件,未指定修订时使用main。 - 一个皮肤可以包含遗留或小众键,但令牌覆盖率必须仅以规范列表为衡量标准。不要仅仅因为额外键不在该列表中而删除它们。
- 从
$HERMES_HOME环境变量解析活跃的 Hermes 主目录;如果未设置,则使用~/.hermes。切勿手动编辑config.yaml。
流程
- 加载 Hermes 主题指南(如果可用),并检查目标皮肤的 YAML 文件。
- 获取并解析
SKIN_COLOR_TOKENS;不要从旧模板推断列表。 - 通过皮肤
colors映射程序化地计算出缺失的键。 - 仅添加缺失的规范键。保留现有值,并根据语义族分配新颜色,而不是发明无关的色调:
background:符合已有皮肤基调的深色或浅色底色。- primary/text/border:重用现有的标题、正文和结构调色板。
- tool/thinking:继承皮肤的主体强调色和次要标签颜色,除非存在有意的对比区分。
- diff/status/syntax:将 positive→ok、warning/number→warn、negative→error 进行映射;对于单词级别的差异和关键状态,使用稍强的色调。
- terminal chrome:一致地重用提示符、强调色和文本层次结构。
- 所有颜色值保持为带引号的六位十六进制格式,如
#rrggbb。 - 验证 YAML,并确保每个规范令牌都已存在。
- 使用
hermes config set display.skin <name>应用编辑后的皮肤,并在报告成功前使用hermes config get display.skin确认。
验证检查清单
报告以下确切检查项:
- 目标文件路径与内嵌的皮肤
name一致。 - YAML 解析成功。
missing_tokens=none(与获取到的规范SKIN_COLOR_TOKENS对比)。- 激活的皮肤在应用后解析为目标名称。
注意事项
- 皮肤现有的调色板可能有意省略
background;但添加它对于可靠的桌面/TUI 基础表面渲染仍然是必要的。 status_bar_bad和status_bar_critical是不同的项。不要止步于旧版、较小的模板调色板。- 在同一会话中更改配置的模型提供者时,在选择 OAuth 提供者后需移除继承的自定义
model.base_url;否则旧本地端点可能保留在配置中。在声明迁移完成前确认所选提供者的认证状态。 - 不要修改捆绑的或用户拥有的 Hermes 技能。请创建或更新由维护者管理的配套技能。