Codex Pet Director：一个把想法和参考图变成 Codex 桌宠的 Skill

项目地址：

https://github.com/zixuanzhou0-ai/codex-pet-director

我为什么做这个

这个项目是做什么的

Codex Pet Director 是一个 Codex Skill。

它不是重新写一个桌宠程序，也不是替代 hatch-pet。它更像一个“制作导演”：先帮用户把想法问清楚、把角色方向确认好、把参考图转成适合 Codex 桌宠的小尺寸资产，然后再交给 hatch-pet 生成正式宠物包。

最终产物是：

• pet.json
• spritesheet.webp

也就是 Codex 桌面端可以加载的宠物文件。

它的基本流程

用户想法 / 参考图
↓
/create-pet 启动
↓
检查本机 Codex 桌宠环境
↓
分轮确认角色、形态、风格、性格、外观
↓
生成确认图，让用户选择方向
↓
锁定角色
↓
生成 192x208-ready 的 production_base
↓
检查是否适合官方桌宠规格
↓
交给 hatch-pet
↓
生成 pet.json + spritesheet.webp

我主要想解决的问题

• 新手不知道 Codex 宠物文件应该放哪里。
• 不知道官方桌宠支持哪些动作。
• 参考图经常很好看，但不一定适合 192x208 的小尺寸动画。
• 生图过程中角色容易越来越不像。
• 最后还是需要和 hatch-pet 对接，不能乱生成一套 Codex 不认识的格式。

所以我做了一个前置流程，让用户先用人话说需求，再一步步收敛成官方格式能承载的桌宠。

它现在能做什么

• 先检查本机 Codex pet 环境。
• 用简单问题一步步确认角色设定。
• 支持参考图。
• 支持每轮生成确认图，让用户选择方向。
• 正式角色确认后锁定角色，后续动作不重新发明角色。
• 把高清确认图和正式生产图分开。
• 在官方 192x208 边界内尽量还原参考图。
• 生成 hatch_pet_handoff.json。
• 最后交给 hatch-pet 生成正式宠物包。

示例效果

Wukong Spark

贝吉塔

黑瞳裁决者

完整静帧展示

Wukong Spark

贝吉塔

黑瞳裁决者

安装方式

最简单的方式：

npx --yes github:zixuanzhou0-ai/codex-pet-director

Windows PowerShell：

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/zixuanzhou0-ai/codex-pet-director/main/install.ps1 | iex"

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/zixuanzhou0-ai/codex-pet-director/main/install.sh | bash

安装完成后重启 Codex，然后输入：

/create-pet

使用方式

一个简单例子：

/create-pet 做一个赛亚人风格的桌宠，战斗感强一点，但要适合 Codex 官方桌宠尺寸

之后它会继续问：

• 角色是谁
• 是全身、半身还是头像
• 想要什么风格
• 性格是什么
• 失败、等待、挥手时怎么动
• 哪些特征一定要保留
• 哪些东西不要出现

和 hatch-pet 的关系

create-pet 更像前置导演流程，hatch-pet 负责最后正式生成。

我的理解是：

create-pet 负责把需求整理清楚
hatch-pet 负责把宠物真正生产出来

这样做的好处是，用户不用一开始就懂 spritesheet、动作行、尺寸限制这些东西，只需要描述自己想要什么，而且在我的理解下，人们对自己想要的东西，其实了解不是那么清晰。而这个 skill 可以帮助你更好挖掘你的想法，通过问问题的方式。

当前限制

Codex 官方桌宠格式是固定的，所以这个项目不会承诺无限动作或无限帧。

目前遵循的是：

• 单格 192x208
• 8x9 图集
• 9 个官方动作
• 输出 pet.json
• 输出 spritesheet.webp

如果用户给的参考图很复杂，流程会尽量保留最重要的识别点，比如发型、轮廓、主色、服装大色块、表情气质和标志性道具；但太细的纹理和复杂背景会被简化。

后面想继续改的地方

• 继续优化 Windows 一键安装体验。
• 让 /create-pet 在不同 Codex 环境里更稳定地出现。
• 增加更多真实案例。
• 优化小尺寸动画资产的检查。
• 让参考图到 production_base 的转换更稳定。
• 做更多风格菜单和动作模板。

最后希望大家都能用它生成出自己真正想要的 Codex Pet。