Codex Pets

我制作的 Codex 动画宠物合集。这个仓库会持续更新，每只宠物都可以独立安装。

宠物清单

作品 / 系列	宠物	ID	版本	安装命令
《凡人修仙传》	银月	yinyue	v2	./scripts/install-pet.sh yinyue

完整分类目录见 CATALOG.md。

独立桌面版

宠物现在可以脱离 Codex 独立运行。运行器直接读取 pets.json 和每只宠物的 v2 图集，以后新增宠物不需要修改渲染核心。

macOS 原生版（推荐）

Apple Silicon 用户可以直接下载 Codex Pets v1.0.0，解压后打开 Codex Pets.app。

要求 macOS 12 或更高版本，并已安装 Xcode Command Line Tools。构建应用：

./scripts/build-macos-app.sh
open "dist/Codex Pets.app"

生成的 Codex Pets.app 不依赖 Codex、Node.js 或 Electron，宠物素材会打包在应用内部。

操作方式：

• 拖动宠物：移动桌面位置
• 双击宠物：挥手
• 右键宠物：切换宠物、动作和显示大小
• 菜单栏 🐾：显示、隐藏或退出
• 鼠标远离宠物时：使用 v2 的 16 个方向注视鼠标

Electron 跨平台版

Electron 版本为 macOS 和 Windows 共用入口，需要 Node.js 20+ 与 pnpm：

pnpm install
pnpm test
pnpm start

打包命令：

pnpm dist:mac
pnpm dist:win

Electron 首次安装需要下载对应平台的官方运行时。macOS 用户可以直接使用上面的原生版，体积更小。

《凡人修仙传》

银月（Yinyue）

一位冷静、敏锐、重视结构与验证的银月狐仙伙伴。

• Codex spritesheet v2
• 8 × 11 图集，单帧 192 × 208
• 包含标准动画和 16 个注视方向

安装

克隆仓库后运行：

./scripts/install-pet.sh yinyue

脚本会把宠物复制到 Codex 的自定义宠物目录：

~/.codex/pets/yinyue/
├── pet.json
└── spritesheet.webp

如果同名宠物已经存在，脚本会拒绝覆盖。确认要替换时使用：

./scripts/install-pet.sh yinyue --force

添加新的宠物

以后新增宠物时，在 pets/ 下添加独立目录：

pets/<pet-id>/
├── pet.json
├── spritesheet.webp
├── preview.png
└── idle.gif

然后把宠物信息追加到根目录的 pets.json，并在 CATALOG.md 对应作品下添加一行。运行包必须包含 pet.json 和 spritesheet.webp；预览图与 GIF 用于 GitHub 展示。

pet.json 示例：

{
  "id": "pet-id",
  "displayName": "宠物名称",
  "description": "一句话介绍",
  "spriteVersionNumber": 2,
  "spritesheetPath": "spritesheet.webp"
}

友情链接

其他作者制作的 Codex 宠物：

作品 / 系列	宠物	作者	仓库
《凡人修仙传》	玄骨	mhy450017850	xuangu-codex-pet

友情链接中的宠物由对应作者维护，请前往原仓库查看介绍、安装方式和使用说明。

支持创作

制作一只完整的动画宠物需要不少时间。如果你喜欢这些作品，欢迎请我喝杯咖啡。制作不易，你的支持就是我继续创作和更新的动力。

支付宝

微信支付

说明

• 仓库只收录发布包和展示素材，不包含生成过程中的提示词、中间帧或 QA 内部文件。
• 未经明确授权，请不要把这里的角色素材用于转售、冒充原创或训练素材包。
• 本仓库中的同人宠物与原作及其版权方无官方隶属或授权关系；原作名称和角色权利归相应权利人所有。