1. 下载并解压宠物包
下载 `piggy-pop-codex-pet.zip`，解压后会得到一个完整的 `piggy-pop` 文件夹。
piggy-pop/
pet.json
spritesheet.webp
Tabbit AI trend pick
GG Bond 风格Codex 桌面宠物自定义教程
Tabbit 近期观察到 AI 圈一个很有意思的方向：大家不只想让工具更强，也想让工作台更有陪伴感。所以我们把 Codex pet 这件小玩法整理成教程，顺手做了一只可以直接安装的小猪桌面宠物。
关注 Tabbit，我们会继续把这类新鲜、有趣、能立刻动手试的 AI 玩法整理给你。
Desktop Preview · Piggy Pop
idle · 待机轻微呼吸和眨眼，适合安静陪伴。
怎么安装到 Codex
2. 放入 Codex pets 目录
把整个 `piggy-pop` 文件夹复制到 Codex 的 pets 目录，不要只复制单个 spritesheet 文件。
~/.codex/pets/piggy-pop/
pet.json
spritesheet.webp
3. 重启或刷新 Codex
重启 Codex 后，在桌面宠物/外观相关入口选择 Piggy Pop。运行中、等待、审阅和失败等状态会由 Codex 自动触发。
~/.codex/pets/piggy-pop/
如何自定义自己的 Codex pet
最小文件结构
一个可分享的 Codex pet 包，本质上就是一个独立目录，里面至少包含配置和精灵图。
your-pet/
pet.json
spritesheet.webp
pet.json 写什么
`id` 是目录和宠物标识，`displayName` 是界面展示名，`spritesheetPath` 指向同目录下的精灵图文件。
{
"id": "piggy-pop",
"displayName": "Piggy Pop",
"spritesheetPath": "spritesheet.webp"
}
spritesheet 怎么排
这只宠物使用 8×9 图集，单格 192×208。行顺序对应 idle、左右跑、挥手、跳跃、失败、等待、进行中和 review。
1536×1872
8 columns × 9 rows
192×208 per cell
状态效果
idle · 待机
触发：空闲时
轻微呼吸和眨眼，适合安静陪伴。
waiting · 等待
触发：等待任务时
小幅度晃动和等待感，表示正在等下一步。
running · 进行中
触发：任务运行时
忙碌但不乱跑，表示正在处理事情。
running-right · 向右跑
触发：向右移动时
朝右移动的步态，用于桌面上的方向移动。
running-left · 向左跑
触发：向左移动时
朝左移动的步态，由右跑镜像生成。
jumping · 跳跃
触发：轻互动或庆祝时
用身体高度变化表现弹跳。
waving · 挥手
触发：被唤起或互动时
抬爪打招呼，适合当表情包开场。
review · 检查
触发：审阅或专注时
身体前倾、眼神专注，像在认真帮你看任务。
failed · 失败
触发：任务失败或出错时
低落或趴下的反应，适合表达小小挫败。
GIF 预览素材
idle待机 · 空闲时
waiting等待 · 等待任务时
running进行中 · 任务运行时
running-right向右跑 · 向右移动时
running-left向左跑 · 向左移动时
jumping跳跃 · 轻互动或庆祝时
waving挥手 · 被唤起或互动时
review检查 · 审阅或专注时
failed失败 · 任务失败或出错时