小编用 Hermes 这个 AI 助手也有一阵子了，命令行界面挺酷的，但总觉得少点什么。直到我发现它自带了一套宠物系统——Petdex，3243个动画宠物任选，装一个就能在终端陪你干活！

这玩意有点像以前的桌面宠物，不过它是直接嵌在 AI 助手里的。你运行命令、查代码、出错了它都有不同的反应，终端一下子就有了生气。今天就来分享一下怎么配。

本文基于飞牛NAS自建的 Hermes Agent 环境，但 Petdex 在 Linux/Mac/Windows 上都能用，不挑平台。

宠物系统是什么

Petdex 是一个开源的动画宠物画廊项目

https://github.com/crafter-station/petdex

专门为 AI 编程助手设计的。Hermes 直接内置了这个功能，通过 hermes pets 命令就能管理。

宠物在终端里以像素动画的形式显示，会根据当前活动状态切换表情和动作：

状态对应反应：

• 🟢 空闲 — 宠物乖乖待着，偶尔伸懒腰
• 🟡 运行中 — 宠物转圈/走动/忙活
• 🔴 查错 — 宠物露出担心的表情
• ✅ 完成 — 宠物开心跳跃

目前在 Hermes 里支持三种显示界面：纯命令行（CLI）、TUI 界面的状态栏、以及桌面模式。终端只要支持图片显示（Kitty、iTerm2、WezTerm 等），宠物就是高清像素动画；不太支持的话也会自动降级成 Unicode 字符显示，看着就像一团像素块。

3243 个宠物分三大类：

热门的宠物有 boba（奶茶，新手推荐）、lulu-capybara-2（噜噜水豚）、silver-shorthair（英短银渐层）、strike-freedom（强袭自由高达）等等，翻翻总有一款适合你。

手动配置宠物

配宠物有两种方式，推荐先用 hermes pets 命令走一遍流程，操作一步到位。

方式一：CLI 命令（推荐）

1️⃣ 浏览宠物列表

hermes pets list

不加参数会列出全部 3243 个。也可以搜索指定关键词：

hermes pets list cat       # 搜猫猫hermes pets list girl      # 搜妹子hermes pets list gundam    # 搜高达

2️⃣ 安装并激活

hermes pets install <宠物slug> --select

--select 参数会自动设为当前活动宠物并启用显示。

3️⃣ 预览效果

hermes pets show

按 Ctrl+C 停止预览。

4️⃣ 调整大小

默认比例 0.33，可以用 scale 调大或调小：

hermes pets scale 0.5   # 调大一点hermes pets scale 0.2   # 调小一点

5️⃣ 关闭宠物

hermes pets off

6️⃣ 卸载宠物

hermes pets remove <宠物slug>

方式二：直接改配置文件

如果你更喜欢直接编辑配置文件，Petdex 的相关配置在 Hermes 的 config.yaml 的 display.pet 下：

display:  pet:    enabled: false          # true=启用，false=关闭    slug: ''              # 宠物标识名，如 'boba' 'lulu-capybara-2'    render_mode: auto     # 渲染模式：auto|kitty|iterm|sixel|unicode|off    scale: 0.33             # 大小比例 0.1~3.0    unicode_cols: 0         # Unicode降级时的宽度

需要修改的位置：

• 先装宠物
  ：hermes pets install （这一步必须走 CLI，因为宠物文件需要下载到本地）
• 再改配置
  ：把 enabled 改成 true，slug 填你装的宠物名
• 重启生效
  ：重新打开 Hermes 终端，宠物就出现了

也可以装完宠物后用 hermes pets select 一键激活，CLI 会自动帮你改配置，不用手写 yaml，手动改的话，大概在370行，可以用nano或者vim编辑器来改。

CLI 命令速查

装好宠物后打开终端，旁边就有一个小可爱陪伴你工作了。编辑代码、运行命令、查错……它都会用动画给你回应。虽然是个小功能，但体验感满满。

今天这篇就到这了，我给我的 Hermes 装个了噜噜水豚（lulu-capybara-2），看着它发呆就很治愈～