PetDex宠物系统原版仅支持claude code、codex等工具，就是没有hermes agent，而且原版目前只支持MAC操作系统，windows和Linux系统暂无。这个宠物系统有何用处？除了桌面有个形象可爱的小宠物之外，它有6种形态可以响应claude code、codex、hermes的工作状态，我们就不用一直盯着终端或界面看了。瞟一眼宠物的形态就知道工具的执行任务情况了。

Hermes Petdex

Petdex 的修改版，增加了对 Hermes Agent 的支持，特别是Deepin 25系统的Hermes Desktop桌面版支持。（Deepin 25如何安装Hermes Desktop桌面版看我另一篇帖子 https://bbs.deepin.org/post/299269）
让你的 Hermes Agent 也能拥有可爱的宠物伙伴。

Gitee 仓库 · 原版 Petdex

这是什么

Hermes Petdex 是 Petdex 的修改版，专门为 Hermes Agent 提供宠物支持，有3000+宠物可选择。

原版 Petdex 只支持 Codex 和 Claude Code，这个版本让 Hermes Agent 也能使用宠物系统。

快速开始

方案 A：本地构建 CLI（推荐）

适合快速测试或单次使用。

# 1. 克隆仓库
git clone https://gitee.com/yngeek/hermes-petdex.git
cd hermes-petdex

# 2. 安装依赖
bun install

# 3. 构建 CLI
cd packages/petdex-cli
bun run build

# 4. 使用本地 CLI 安装宠物
node dist/petdex.js install boba

# 5. 初始化（下载桌面应用并配置 agent hooks）
node dist/petdex.js init

方案 B：全局注册命令（开发模式）

适合需要频繁使用 petdex 命令的场景。

# 1. 克隆仓库
git clone https://gitee.com/yngeek/hermes-petdex.git
cd hermes-petdex

# 2. 安装依赖
bun install

# 3. 构建 CLI
cd packages/petdex-cli
bun run build

# 4. 注册为全局命令
npm link

# 5. 现在可以在任何地方使用 petdex 命令
petdex install boba
petdex init
petdex doctor

注意：如果修改了代码，需要重新执行 bun run build 才能生效。

常用命令

卸载全局命令

如果使用了方案 B，可以通过以下命令卸载：

npm unlink -g petdex

本地开发

如果你想参与开发或修改代码：

# 克隆仓库
git clone https://gitee.com/yngeek/hermes-petdex.git
cd hermes-petdex

# 安装依赖
bun install

# 启动开发环境（需要 Docker）
bun run dev:docker

# 或者使用真实服务（需要配置 .env.local）
bun run dev

访问 localhost:3001 查看本地运行的应用。

项目结构

hermes-petdex
├── src/
│   ├── app/[locale]/          公共网站：画廊、宠物详情、收藏等
│   ├── app/api/cli/           CLI 接口：OAuth、提交、去重检查等
│   ├── app/api/manifest/      公共清单：所有已审核宠物的信息
│   └── lib/db/schema.ts       数据库 schema (Postgres)
├── packages/
│   ├── petdex-cli/            CLI 工具（认证、列表、安装、选择、提交、hooks、初始化）
│   ├── petdex-desktop/        桌面浮动宠物应用
│   └── discord-bot/           Discord 机器人
├── public/                    静态资源
└── drizzle/                   数据库迁移文件

与原版的区别

• ✅ 新增 Hermes Agent 支持
• ✅ 自动配置 Hermes Agent hooks
• ✅ 保持与原版完全兼容的宠物格式
• ✅ 支持所有原版宠物和功能

相关链接

• 原版 Petdex - 官方仓库
• Petdex 官网 - 浏览和提交宠物
• Discord 社区 - 交流和反馈

许可证

与原版相同，采用 MIT 许可证。

基于 Petdex 修改。 原作者：Crafter Station · @RaillyHugo