一个可以直接安装到 Codex Desktop 的自定义宠物包。
主角是“麦总”：一只戴墨镜、会陪你写代码和审阅工作的白色比熊犬小老板。
如果你已经 clone 了这个仓库：
./install.sh安装后重启 Codex，然后进入：
Settings -> Personalization -> Pets -> Refresh
在自定义宠物里选择 麦总，再点击 Open pet。如果你的 Codex 界面是中文，大概是：
设置 -> 个性化 -> 宠物 -> 刷新 -> 选择麦总 -> 打开宠物
也可以在 Codex 输入框里试试：
/pet
用于唤醒或收起桌面宠物。
如果你正在让 Codex 帮你安装这个宠物，直接把下面这段给它：
请把本仓库根目录下的 pet.json 和 spritesheet.webp 复制到 ~/.codex/pets/mai/。
如果目标目录不存在，请创建它。复制完成后提醒我重启 Codex，并到 Settings -> Personalization -> Pets -> Refresh 选择“麦总”。
不要修改 Codex 的内部全局状态文件。
为什么不要手改内部状态文件：不同版本的 Codex 状态键可能变化，强行写配置容易把宠物窗口或设置状态搞乱。最稳的方式是让 Codex 自己在设置页刷新并识别自定义宠物。
mkdir -p ~/.codex/pets/mai
cp pet.json spritesheet.webp ~/.codex/pets/mai/然后重启 Codex，去宠物设置页刷新。
.
├── pet.json # Codex 读取的宠物描述文件
├── spritesheet.webp # Codex 实际使用的动画精灵图
├── install.sh # 一键安装脚本
├── preview/ # README 和文章用预览素材
│ ├── mai-idle.gif
│ ├── mai-running.gif
│ ├── mai-review.gif
│ └── ...
├── assets/
│ └── spritesheet.png # 便于人工检查的 PNG 版本
└── validation/
└── validation.json # 打包校验结果
这个宠物包包含 9 组状态预览：
| 状态 | 说明 | 预览 |
|---|---|---|
idle |
待机呼吸 | |
waiting |
等待输入 |  |
waving |
打招呼 |  |
running |
通用运行 | |
running-left |
向左跑动 |  |
running-right |
向右跑动 |  |
jumping |
跳跃 |  |
review |
审阅/复核 | |
failed |
失败/卡住 |  |
静态总览：
最小可用包只需要两个文件：
~/.codex/pets/<your_pet_id>/
├── pet.json
└── spritesheet.webp
pet.json 示例：
{
"id": "mai",
"displayName": "麦总",
"description": "麦总玩 AI 的酷萌白色比熊犬小老板。",
"spritesheetPath": "spritesheet.webp"
}真正难的不是写 JSON，而是让每个状态都像同一个角色。建议按这个顺序做：
- 先确定宠物身份锚点，比如颜色、表情、道具、气质。
- 先生成一张稳定的基础形象，不要一上来就做全套动画。
- 再分别生成
idle、waiting、running、review等状态。 - 每个状态都检查是否同一只宠物、是否被裁切、是否混入文字或多余 UI。
- 最后再合成
spritesheet.webp并放进~/.codex/pets/<your_pet_id>/。
这个包面向 Codex Desktop 的自定义宠物功能。不同 Codex 版本的设置入口文案可能略有不同，但基本思路不变：
把宠物包放到 ~/.codex/pets/<pet_id>/ -> 重启 Codex -> 设置页刷新 -> 选择宠物
如果设置页没有出现自定义宠物，先确认：
~/.codex/pets/mai/pet.json存在。~/.codex/pets/mai/spritesheet.webp存在。pet.json里的spritesheetPath是spritesheet.webp。- Codex 已完全退出并重新打开，而不是只关闭窗口。
MIT License. See LICENSE.