什么是 Codex 宠物？
Codex 宠物是一个给应用使用的小型动画像素伙伴。每只宠物都包含一个 pet.json，用来描述 9 个状态（idle、working、sleeping 等），再加上一张横向 spritesheet。Codex 会根据你在当前会话里的操作自动选择合适的状态。
关于
Petdex 是 Codex 宠物索引
一个面向 Codex 的开源动画伙伴图库，收录了 0+ 个伙伴。用一条命令安装一个，然后带着陪伴一起工作。
Petdex 是什么
Petdex 是一个公开的开源注册表。每条记录都是一个宠物包：一小组 metadata 和像素画，Codex 会在你工作时把它显示出来。你可以把它想成应用伙伴版的宝可梦图鉴。
这个平台把猜测工作都拿走了：有 CLI 负责安装和提交，有带标签的图库方便你不用一直滚动就能找到合适的伙伴，还有按氛围划分的合集，比如 温馨系宠物 或 专注系宠物。
宠物包如何工作
每只宠物由两个文件组成。 pet.json 定义 metadata：名字、9 个动画状态、帧时长；而 spritesheet.webp 保存横向排列的像素画。Codex 会在启动时加载它们，并根据你当前会话里的情况切换状态。
常见问题
我该怎么安装宠物？
在图库页或任意宠物详情页复制安装命令（形如 `npx petdex install boba`），然后粘贴到终端。CLI 会从 R2 拉取宠物，放到 ~/.codex/pets/<slug>/ 下，并告诉 Codex 使用它。支持 macOS、Linux 和 Windows（通过 PowerShell）。
这些宠物来自哪里？
大多数宠物来自社区通过网站或 petdex CLI 的提交。少数是 Crafter Station 精选的推荐条目。每只宠物都会先经过管理员审核，之后才会出现在图库里。
我可以提交自己的宠物吗？
可以。先用 petdex CLI 登录（`npx petdex login`），再运行 `npx petdex submit ./my-pet/`，CLI 会把资源上传到 R2，并把提交加入审核队列。你也可以通过网站的 /submit 页面提交。你只需要一个 pet.json 文件和一张 9 状态 spritesheet。
Petdex 宠物是免费且开源的吗？
Petdex 上的每只宠物都可以免费安装和使用。宠物会保留原作者署名。Petdex 平台本身（CLI + 网站）也在 Crafter Station 体系下开源。
什么是 vibe？什么是 kind？
每只宠物都会标注一个 kind（creature、object、character）以及一到三种 vibe（cozy、playful、focused、mystical 等）。这些标签驱动图库筛选和按 vibe / kind 组织的落地页，让你不用翻 70 多个条目也能找到符合心情的伙伴。
Petdex 怎么赚钱？
它不赚钱。Petdex 是 Crafter Station 运营的社区项目。存储和数据库成本由平台团队承担：没有广告、没有加购，也没有超出标准分析范围的额外遥测；我们只看哪些宠物被安装。