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 <名稱>套用編輯後的皮膚,並回讀hermes config get display.skin後再報告成功。
驗證檢查清單
報告這些確切檢查:
- 目標檔案路徑與內嵌的皮膚
name一致。 - YAML 解析成功。
- 根據取得的規範
SKIN_COLOR_TOKENS,missing_tokens=none。 - 套用後,作用中皮膚解析為目標名稱。
陷阱
- 皮膚現有的調色板可能刻意省略
background;新增它對於可靠的桌面/TUI 基底表面渲染仍然是必要的。 status_bar_bad和status_bar_critical是不同的。不要停留在較舊、較小的範本調色板。- 在同一工作階段中變更已設定的模型提供者時,請在選擇 OAuth 提供者後移除繼承的自訂
model.base_url;否則舊的本地端點可能仍留在設定中。在宣告遷移完成前,請驗證所選提供者的驗證狀態。 - 不要修改捆綁或用戶擁有的 Hermes 技能。請改為建立或更新由策展人管理的配套技能。