Codex Pet 创建指南：以灰原哀学习伙伴为例
制作一个自定义 Pet，需要让同一角色在待机、工作、等待和转头时保持一致。本文以灰原哀学习伙伴为例，记录角色设计、动画修复、图集校验，以及向读者分享成果时需要说明的细节。 整理与官方资料核对日期：2026-09-17。本文保留案例中的 Codex 产品称呼；当前官方 Pets 页面以 ChatGPT 桌面应用介绍桌面入口，实际菜单以安装版本为准。文件与视觉检查结果来自既有制作记录，本次文章整理未复测 Pet，应用内显示仍待验证。 1. 适用范围 本文介绍自定义 Codex Pet 的制作流程，包括角色设计、动画生成、方向检查、图集合成、打包和安装验证。文档以灰原哀 Pet 项目的制作记录为例，记录从角色母版到安装验证的完整过程。 案例使用本地 hatch-pet v2 流程。文中的图集尺寸、目录结构和配置示例对应该项目，不代表所有版本或使用端的统一要求。开始制作前，制作者应让 Codex 读取当前环境中的技能说明，确认目标版本、图集规格及安装位置。桌面端与网页端的资源要求应分别确认。 案例中的动画与文件检查已完成，安装副本已验证；应用界面中的实际加载效果尚未确认。 2. 工具与输入材料 案例使用内置图像生成工具制作角色和动作，使用 hatch-pet 配套脚本进行图像提取、对齐、透明背景处理、图集合成及格式检查。 制作前需要明确以下输入： 输入 说明 角色描述或参考图 确定外观、服装、配色和可辨识特征 画风与比例 例如 Q 版、像素风，或其他适合小尺寸显示的风格 动作要求 明确待机、工作、等待等状态的表现方式与动作幅度 目标环境 确认应用版本、可用图像工具及当前 Pet 格式 验收要求 明确需要交付的预览、检查报告、安装文件及应用内验证结果 官方 Pets 文档提供通过设置中的 Create pet 入口创建自定义 Pet 的流程；具体入口以所安装的版本为准。该入口会加载配套制作技能。制作完成后，需要返回 Pet 设置刷新列表并选择新角色。具体流程见官方 Pets 文档。1 3. 确定角色母版 3.1 生成静态候选图 制作流程首先生成静态候选图，由制作者确认角色外观，再进入动画阶段。候选图需要完整呈现角色，并保留动作所需的画面空间。 灰原哀案例采用紧凑的 Q 版比例，保留茶棕短发、冷静神情和深色外套。动作设计围绕学习、思考和检查代码的场景展开。 候选图检查包括： 缩小后，脸部、四肢和主要轮廓是否仍然清楚。 发型、服装和配色是否符合角色设定。 头部、手部与鞋子是否完整，没有贴近裁切边界。 轮廓附近是否存在背景残留或明显光晕。 3.2 固定母版与外观约束 候选图确认后，生成统一的角色母版。后续动作应持续引用同一母版，并保持发型、服装、头身比例和配色一致。 ...