Petdex：给 Codex 找一个会动的桌面伙伴
一句话定位
Petdex 是一个面向 Codex 的动态宠物图鉴网站：你可以在里面浏览、预览、收藏和安装各种像素风 companion，让本地 Codex 使用体验多一点陪伴感。
基础信息卡片
| 项目 | 信息 |
|---|---|
| 官网 | https://petdex.crafter.run/ |
| GitHub | https://github.com/crafter-station/petdex |
| 项目定位 | Codex-compatible animated pets public gallery |
| 当前规模 | 首页显示 870+ 个宠物，GitHub 仓库约 600+ Stars |
| 快速安装示例 | npx petdex install boba |
解决什么问题
Codex 这类命令行工具通常很高效，但也很“冷”：窗口里只有文本、任务、日志和结果。
Petdex 做的事情很简单：把各种动态 companion 做成一个公开图鉴，让用户可以像逛头像库、贴纸库一样，为自己的 Codex 环境挑一个宠物。
它主要解决三个小问题：
- 资源集中展示：不用到处找宠物包，直接在 Petdex 里浏览。
- 效果可以预览：每个 companion 不只是一个名字，而是带有图像、状态和描述。
- 安装路径明确：网站直接给出安装命令，降低尝试成本。
这不是一个提高模型能力的工具，而是一个让开发环境更有个性、更有仪式感的小组件。
核心功能
1. 浏览宠物图鉴
首页展示了大量 companion 卡片，每个卡片包含编号、名称、分类、简介、标签、作者和安装数据。
比如首页中的 Boba，是一只喝珍珠奶茶的小水獭；Duo、Doraemon、Noir Webling 等角色也都以像素风或 chibi 风格呈现。
这种设计让 Petdex 更像一个“宠物图鉴”，而不只是一个文件列表。
2. 一条命令安装
Petdex 首页直接给出安装命令：
npx petdex install boba对用户来说，这个体验比较直接：看到喜欢的 companion，复制命令安装即可。
3. 精选合集
网站有 Collections 页面和首页精选合集，例如：
- GRAYCRAFT：原创机甲风角色合集
- Meme Lords：Pepe、Wojak、Doodlebob 等 meme 风格角色
- Anime Heroes：动漫角色风格 companion
合集让浏览更有主题感，也方便创作者把一组相关设计放在一起展示。
4. 社区提交
Petdex 提供 Submit 入口，README 里也提到支持在浏览器中校验并提交社区宠物包。
这意味着它不是一个只读图库，而是希望让更多人参与补充 companion。
5. 开源维护
Petdex 的 GitHub 仓库公开，README 中说明它是一个 Codex-compatible animated pets gallery，并列出了几个核心能力：
- 浏览已审核的宠物包
- 预览每个动画状态
- 下载单个 ZIP 包
- 下载完整图库包
- 在浏览器中校验和提交社区宠物包
从仓库结构看，宠物资源放在 public/pets，可下载包生成在 public/packs。
适合谁
Petdex 适合几类人：
- 经常使用 Codex，想让本地环境更有个性的人；
- 喜欢像素风、chibi 风、桌面宠物这类轻量视觉元素的人；
- 想给自己的工具链加一点“陪伴感”的开发者；
- 想创作并分享 Codex companion 的设计者。
如果你只关心模型效果、任务成功率或工程自动化，Petdex 不是必需品；但如果你已经每天都在终端里和 Codex 打交道，它能让这个过程更轻松一点。
快速上手
打开官网：
选择一个喜欢的 companion，比如 Boba，然后执行：
npx petdex install boba也可以在网站里继续浏览更多宠物、合集和创作者页面。
如果想了解项目本身，可以查看 GitHub 仓库：
https://github.com/crafter-station/petdex
结论
Petdex 不是一个复杂的大工具，它更像 Codex 生态里的一个趣味入口：把 companion 做成可浏览、可预览、可安装、可提交的公共图鉴。
它的价值不在于让 Codex 变得更聪明，而在于让使用 Codex 的过程更有个性、更轻松，也更像一个可以被社区一起装饰的工作空间。
