非官方同人项目，与字节跳动、豆包或 OpenAI 无隶属、授权或背书关系。

快速开始

不需要克隆仓库。先列出全部桌宠：

npx --yes codex-doubao-pets@latest list

选好后直接安装，例如知性热裤版：

npx --yes codex-doubao-pets@latest install doubao-q-hotshorts-v2

也可以一次安装全部六个：

npx --yes codex-doubao-pets@latest install all

命令会把桌宠放到 ${CODEX_HOME:-$HOME/.codex}/pets/<id>/。重新选择桌宠或重启 Codex Desktop 即可看到它。

更新

重复运行安装命令即可用 npm 上的最新版本覆盖对应桌宠：

npx --yes codex-doubao-pets@latest install doubao-q-hotshorts-v2

若要更新全部六个，运行 npx --yes codex-doubao-pets@latest install all。

已经安装的桌宠不会自动跟随仓库更新。

选一个豆包

点击角色图片可以查看对应的完整动作图。

完整动作

每个桌宠都包含待机、移动、挥手、跳跃、失败、等待、奔跑和审阅动作，也能根据移动方向切换朝向。

包里有什么

packages/<id>/
├── pet.json
├── spritesheet.webp
└── validation.json

安装时只会复制 pet.json 和 spritesheet.webp。全部 ID、名称和描述见 catalog.json。

开发与检查

python3 -m pip install -r requirements.txt
python3 scripts/verify.py
shasum -a 256 -c SHA256SUMS
python3 scripts/make-readme-assets.py

许可与说明

脚本和元数据使用 MIT License。packages/**/spritesheet.webp 与 previews/** 使用 CC BY-NC 4.0。商标权不随许可转让。