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。