用途:为 Hermes 添加桌面/终端动画宠物吉祥物,并管理其安装、选择、预览与关闭。宠物会随智能体活动状态变化(空闲、运行工具、审查、错误、完成),覆盖 Hermes CLI、TUI 与桌面应用。该技能只驱动 hermes pets CLI 和 display.pet 配置,不生成精灵图。
主要能力:浏览公开 petdex 画廊、安装宠物、设为活动宠物、调整全局缩放、在终端预览动画、禁用或移除宠物,以及诊断显示问题。
使用方式:通过终端工具运行 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。典型流程:list 找到 slug,install --select 安装并激活,show 预览,doctor 确认。宠物安装到 <HERMES_HOME>/pets/<slug>/(按 profile 区分);选择宠物会写入 config.yaml 的 display.pet.slug 与 display.pet.enabled。
配置:config.yaml 的 display.pet 下含 enabled(总开关)、slug(活动宠物,空则取第一个已安装)、render_mode(auto|kitty|iterm|sixel|unicode|off)、scale(原生 192×208 帧的屏幕尺寸,默认 0.33,范围 0.1–3.0)、unicode_cols(Unicode 回退宽度)。缩放可用 hermes pets scale、/pet scale 斜杠命令或桌面外观滑块调整。
适用场景:用户想要桌面/终端吉祥物、询问 pets 或 petdex、想更换/预览/禁用宠物,或排查宠物不显示的问题。
限制与前提:需要访问 petdex.dev 获取画廊/清单(只读、无需认证);依赖 Pillow 解码精灵图(Hermes 核心依赖,已安装)。完整终端渲染需支持图形协议的终端(kitty、Ghostty、WezTerm、iTerm2 或 sixel),否则自动回退为真彩色 Unicode 半块。宠物必须已安装且被选中(enabled: true)才会显示;在管道/重定向(无 TTY)中终端渲染按设计禁用。petdex npm CLI 安装到 ~/.codex/pets,而 Hermes 使用自己的 <HERMES_HOME>/pets/,应通过 hermes pets 安装。hermes pets doctor 在宠物已安装、已选择、已启用且 Pillow 可导入时报告 ✓ ready。