跳到主要内容

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

操作流程​

  1. 找到宠物:kopi pets list <query> 并记下它的 slug。
  2. 安装并激活:kopi pets install <slug> --select。
  3. 预览:kopi pets show(Ctrl+C 停止)。
  4. 确认设置: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。