Petdex

為 Hermes 安裝並選擇動畫 Petdex 吉祥物。

Skill 元數據

來源	捆綁（默認安裝）
路徑	skills/productivity/petdex
版本	1.0.0
作者	Hermes Agent
許可證	MIT
平臺	linux, macos, windows
標籤	petdex, mascot, display, cli, tui, desktop

參考：完整 SKILL.md

信息

以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時代理看到的指令。

Petdex 技能

從公共 petdex 畫廊中瀏覽、安裝和選擇動畫“寵物”吉祥物。已安裝的寵物會對代理活動（空閒、運行工具、審查、錯誤、完成）做出反應，適用於 Hermes CLI、TUI 和桌面應用。此技能驅動 hermes pets CLI 和 display.pet 配置——它不生成精靈圖。

何時使用

• 用戶想要桌面/終端吉祥物或詢問關於“pets”/ petdex 的問題。
• 用戶想要更改、預覽或禁用當前活躍的寵物。
• 診斷寵物未顯示的原因（終端圖形支持、配置）。

先決條件

• 能夠訪問 petdex.dev 以獲取畫廊/清單（只讀，無需認證）。
• Pillow（Hermes 的核心依賴項）用於精靈圖解碼——已預裝。
• 為了實現高保真終端渲染：需要支持圖形的終端（kitty、Ghostty、WezTerm、iTerm2 或 sixel）。否則會自動使用真彩色 Unicode 半塊回退方案。

如何運行

使用 terminal 工具運行 hermes pets <子命令>。

快速參考

目標	命令
瀏覽畫廊	hermes pets list（添加子字符串進行過濾：hermes pets list cat）
列出已安裝的寵物	hermes pets list --installed
安裝寵物	hermes pets install <slug>（添加 --select 使其成為活躍狀態）
設置活躍寵物	hermes pets select <slug>（省略 slug 以使用選擇器）
全局調整寵物大小	hermes pets scale <factor>（例如 0.5，限制在 0.1–3.0 之間）
在終端中預覽/動畫	hermes pets show [slug] [--cycle] [--state run]
禁用寵物	hermes pets off
移除寵物	hermes pets remove <slug>
診斷設置	hermes pets doctor

步驟

1. 查找寵物：hermes pets list <query> 並記下其 slug。
2. 安裝並激活：hermes pets install <slug> --select。
3. 預覽：hermes pets show（按 Ctrl+C 停止）。
4. 確認設置：hermes pets doctor — 顯示解析後的寵物、配置的渲染模式、檢測到的終端圖形協議以及有效模式。

寵物安裝到 <HERMES_HOME>/pets/<slug>/（感知配置文件）。選擇寵物會將 display.pet.slug 和 display.pet.enabled 寫入 config.yaml。

配置

在 config.yaml 的 display.pet 下：

• enabled (bool) — 總開關。
• slug (str) — 活躍寵物；為空則表示第一個已安裝的寵物。
• render_mode — auto（自動檢測）| kitty | iterm | sixel | unicode | off。
• scale (float) — 原生 192×208 幀在屏幕上的大小（默認 0.33，限制在 0.1–3.0 之間）。一個旋鈕調整所有界面的大小；通過 hermes pets scale <factor>、/pet scale 斜槓命令或桌面外觀滑塊進行設置。
• unicode_cols (int) — Unicode 回退方案的列寬。

常見陷阱

• 只有當寵物已安裝且被選中（enabled: true）時才會顯示。
• 在管道/重定向內部（無 TTY），終端渲染按設計禁用。
• petdex npm CLI 安裝到 ~/.codex/pets；Hermes 使用其 own 配置文件作用域的 <HERMES_HOME>/pets/ — 請通過 hermes pets 安裝。

驗證

• 當寵物已安裝、選中、啟用且可導入 Pillow 時，hermes pets doctor 報告 ✓ ready。