菲比啾比 Codex Pet

一个可直接加载到 Codex Desktop 的原创同人桌面宠物包。

动画预览 | Codex Pets 官方说明 | 版权与来源说明

在 Codex 中安装菲比啾比

如果浏览器不允许打开 codex:// 链接，可使用下列脚本或手动安装。

irm https://raw.githubusercontent.com/KanadeK/feibi-jiubi-codex-pet/main/scripts/install.ps1 | iex

curl -fsSL https://raw.githubusercontent.com/KanadeK/feibi-jiubi-codex-pet/main/scripts/install.sh | sh

安装器会校验 SHA-256。已有同 ID 宠物会先备份到 ~/.codex/pet-backups/，不会直接删除。

把这两个文件放入 ~/.codex/pets/feibi-jiubi/：

pet/pet.json
pet/spritesheet.webp

然后打开 Settings > Pets，选择 Refresh，再选择 菲比啾比。使用 /pet 或 Wake Pet 唤醒她。

Codex 状态	动画
空闲陪伴
向右奔跑
向左奔跑
挥手问候
开心跳跃
任务受阻
等你回复
忙碌工作
等你验收

• 图集：1536 × 1872 lossless WebP
• 网格：8 × 9
• 单格：192 × 208
• 背景：透明 RGBA
• 元数据：pet.json
• Sprite 版本：1
• 文件大小：小于官方 20 MiB 上传限制

scripts/validate_pet.py 会逐格检查已用帧、空白帧、透明度、尺寸、文件类型和元数据。

uv venv .venv
uv pip install --python .venv\Scripts\python.exe -r requirements-dev.txt
.venv\Scripts\python.exe scripts\build_assets.py
.venv\Scripts\python.exe scripts\validate_pet.py
.venv\Scripts\python.exe -m pytest -q

macOS / Linux 将 Python 路径改为 .venv/bin/python。

生成流程只依赖仓库内的透明九姿势角色板。构建脚本会裁切姿势、生成状态动效、打包图集、输出 GIF 预览并更新校验和。

• 用户提供的参考图只用于视觉方向，不在仓库中分发。
• 角色板由 OpenAI 内置图像生成工具重新绘制。
• 透明背景由本地图像处理辅助脚本生成。
• 动作帧、图集、GIF 和校验和由仓库脚本确定性生成。
• 本项目没有复制其他菲比啾比仓库的图片、脚本或提交历史。

完整生成提示词见 artwork/PROMPT.md。版权边界与非官方声明见 NOTICE.md。

首个公开版本由 KanadeK 提交和发布。项目没有添加自动生成的 Co-authored-by 条目，也没有继承其他仓库的 Git 历史。完整名单见 AUTHORS.md。

Feibi Jiubi is an unofficial, non-commercial Codex Desktop pet package with nine native status animations. The package contains an original generated pose board, a reproducible atlas builder, validation tests, install scripts, and a small preview site.

Original code and documentation are released under the MIT License. Character names, recognizable character traits, and third-party rights are not relicensed. See NOTICE.md.