Petdex
为 Hermes 安装并选择动态 petdex 吉祥物。
Skill 元数据
| 来源 | 内置(默认安装) |
| 路径 | skills/productivity/petdex |
| 版本 | 1.0.0 |
| 作者 | KOPI AI AGENT |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | petdex, mascot, display, cli, tui, desktop |
参考:完整 SKILL.md
信息
以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
Petdex Skill
从公开的 petdex 图库中浏览、安装和选择动态"宠物"吉祥物。已安装的宠物会根据 agent 的活动(空闲、运行工具、审查、出错、完成)作出反应,覆盖 Hermes 的 CLI、TUI 和桌面应用。本 skill 驱动 kopi pets CLI 和 display.pet 配置 —— 它不生成精灵图。
使用时机
- 用户想要一个桌面/终端吉祥物,或询问"宠物"/ petdex。
- 用户想要更换、预览或禁用当前的宠物。
- 诊断宠物为什么不显示(终端图形支持、配置)。
前置条件
- 能够访问
petdex.dev以获取图库/清单(只读,无需认证)。 - Pillow(Hermes 的核心依赖)用于精灵图解码 —— 已经安装。
- 要获得全保真终端渲染:需要支持图形的终端(kitty、Ghostty、WezTerm、iTerm2 或 sixel)。否则会自动使用 truecolor Unicode 半块字符回退方案。
如何运行
使用 terminal 工具运行 kopi pets <subcommand>。
快速参考
| 目标 | 命令 |
|---|---|
| 浏览图库 | kopi pets list(附加子串进行过滤:kopi pets list cat) |
| 列出已安装的宠物 | kopi pets list --installed |
| 安装宠物 | kopi pets install <slug>(附加 --select 可将其设为当前) |
| 设置当前宠物 | kopi pets select <slug>(省略 slug 则打开选择器) |
| 在所有界面调整宠物大小 | kopi pets scale <factor>(例如 0.5,限制在 0.1–3.0) |
| 在终端中预览/播放动画 | kopi pets show [slug] [--cycle] [--state run] |
| 禁用宠物 | kopi pets off |
| 移除宠物 | kopi pets remove <slug> |
| 诊断设置 | kopi pets doctor |
操作流程
- 找到宠物:
kopi pets list <query>并记下它的slug。 - 安装并激活:
kopi pets install <slug> --select。 - 预览:
kopi pets show(Ctrl+C 停止)。 - 确认设置:
kopi pets doctor—— 显示解析出的宠物、配置的渲染模式、检测到的终端图形协议和实际生效的模式。
宠物安装到 <KOPI_HOME>/pets/<slug>/(按 profile 区分)。选择宠物会把 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)。一个旋钮调整所有界面的大小;用kopi pets scale <factor>、/pet scale斜杠命令或桌面应用的外观滑块来设置。unicode_cols(int)—— Unicode 回退方案的列宽。
常见陷阱
- 只有在宠物已安装并且被选中(
enabled: true)后才会显示。 - 在管道/重定向中(没有 TTY)终端渲染会被有意禁用。
- petdex 的 npm CLI 安装到
~/.codex/pets;Hermes 使用自己按 profile 划分的<KOPI_HOME>/pets/—— 请通过kopi pets安装。
验证
- 当宠物已安装、已选中、已启用,且 Pillow 可导入时,
kopi pets doctor报告✓ ready。