30分钟把二次元老婆/老公搬上桌面！Codex 桌宠完整教程

✍ Kimberly🕐 2026-07-21📦 13.6 KB 🟢 已读 𝕏 文章列表

本文介绍了如何利用一张 IP 设定图，在 Codex 中快速生成动态桌宠。文章详细讲解了从角色准备、生成包含多种状态和视角的动画图集，到最终打包安装的全流程，探讨了将 AI 工具个人化、使其成为工作伙伴的意义。

Codex 桌宠 AI工具教程个性化 IP设定动画 Hatch Pet Agent 工作流

# 30分钟把二次元老婆/老公搬上桌面！Codex 桌宠从 IP 设定图到可运行角色完整教程 **作者**: Kimberly **日期**: 2026-07-20T11:43:56.000Z **来源**: [https://x.com/king1818888/status/2079170439872729497](https://x.com/king1818888/status/2079170439872729497) --- ![Image](/doc/3234/image/img_528db471621a.jpg) 这两天我做了一个很有意思的实验：我用一张 IP 设定图，在 Codex 里成功做成了一个真正的个人动态桌宠。它支持多种状态：待机、走动、挥手、跳跃、运行中、等待确认、失败沮丧、检查结果等，还能根据鼠标方向触发 16 个不同的看向角度。我用的是追星风格的图片，大家可以轻松换成喜欢的明星、动漫角色或任何形象。整个过程不到 30 分钟，小白也能轻松上手。最后生成出来的是一个完整的 Codex v2 桌宠包： ``` /Users/meng/.codex/pets/operator-ip ├── pet.json └── spritesheet.webp ``` 其中 pet.json 负责告诉 Codex 这个桌宠是谁，spritesheet.webp 是它的完整动画图集。这件事的意义不在于“做了一个可爱的小人”。真正有意思的是：Codex 开始可以被你改造成一个更个人化的工作界面。以前 AI 工具大多是冷冰冰的聊天框。你输入任务，它返回文本。现在如果把自己的 IP、品牌角色、项目吉祥物做成桌宠，它就会变成一个一直跟着你工作的角色。你让 Codex 跑任务，它会进入“运行中”状态。它卡住等你确认，会进入“等待”状态。任务失败，会有沮丧表情。检查结果，会进入 review 状态。这比单纯换主题、换头像更接近一种“个人工作台”的感觉。 # 普通人要怎么做一个 Codex 桌宠？最简单的理解是：你需要准备一个角色，然后让 Hatch Pet 把它变成 Codex 能识别的动画 spritesheet。这里有两种常见方式。第一种是没有现成角色图，只给一段描述。比如： ``` 帮我做一个适合 Codex 的桌宠。风格是小型 3D 玩偶，像一个认真工作的 AI 助理。它要有待机、运行、等待、失败、检查结果等状态。 ``` 这种方式的优点是门槛低，不需要你提前画图。缺点是角色的一致性更难控制，因为所有身份特征都要靠提示词来锁定。第二种是用一张 IP 设定图作为主参考。这是我更推荐的方式。你可以准备一张角色设定图，里面最好包含： - 正面全身 - 侧面或半侧面 - 几个表情 - 一个挥手或工作姿态 - 服装和配色足够清楚这样 Hatch Pet 在生成每一行动画时，就不是凭空想象，而是围绕这张设定图保持角色一致。我这次用的就是第二种。我的参考图路径是： ``` /Users/meng/Documents/grok工具/codex-pet-ip-reference.png ``` 这张图里已经有完整的角色信息：长黑发、牛仔蓝外搭、黑色内搭、小金色耳饰、白鞋、清爽自信的表情，还有平板工作、挥手、沮丧等状态参考。这类图非常适合做桌宠。 # Codex 桌宠不是一张图，而是一套状态系统很多人第一次听到“桌宠”，会以为只是把一张图抠出来放在屏幕上。但 Codex 的桌宠不是这么工作的。它需要一张完整的动画图集。这次做出来的是 v2 格式，最终尺寸是： ``` 1536 x 2288 ``` 它由 8 x 11 个格子组成，每个格子是一个小动作帧。前 9 行是标准工作状态： ``` row 0 idle 待机 row 1 running-right 向右移动 row 2 running-left 向左移动 row 3 waving 挥手 row 4 jumping 跳跃 row 5 failed 失败/沮丧 row 6 waiting 等待确认 row 7 running 运行中/工作中 row 8 review 检查结果 ``` 后 2 行是 v2 版本新增的看向方向： ``` row 9 000 到 157.5 度 row 10 180 到 337.5 度 ``` 也就是说，它不只是“会动”，还要能根据方向做出自然的眼神和头部变化。对人形角色来说，这里尤其容易翻车。如果只是把整个人旋转，会很怪。如果只移动瞳孔，又会像贴了两颗新的眼珠。这次比较合理的做法是：眼睛先动，眉眼和头颈轻微跟随，身体、鞋子、牛仔外搭、包的位置保持稳定。这样看起来才像角色在“看向某个方向”，而不是整张图被硬拧过去。 # 我这次的实际流程我给 Codex 的核心要求大概是这样：保留角色的核心轮廓、长黑发、牛仔蓝外搭、黑色内搭、小金色耳饰、清爽自信的气质。动作与表情可以根据 Codex 的不同工作状态自由设计，包括待机、走动、挥手、运行中、等待确认、失败沮丧、检查结果等。桌宠要适合小尺寸显示，轮廓清楚，表情明显，不要堆太多细节。所有动画里的发型、服装、颜色和角色比例要保持一致。这里最重要的不是“画得多复杂”，而是“在很小的尺寸里还能认出来”。桌宠不是海报。它通常只有很小一块显示区域，所以细碎的纽扣、包纹理、衣服缝线都不能成为重点。真正要锁住的是： - 长黑发的大轮廓 - 牛仔蓝外搭 - 黑色内搭和黑裤子 - 小金色耳饰 - 白鞋 - 自信、清爽、偏工作型的气质 - chibi 比例细节可以简化，但这些识别点不能丢。 # 生成过程中最容易出问题的地方第一个问题是角色一致性。不同动作行如果分别生成，很容易出现“这一行像另一个人”的问题。比如发型变短、外套颜色变浅、鞋子变形、耳饰消失。所以我让每一行动作都绑定原始 IP 图和 canonical base，也就是生成出来的主参考角色图。第二个问题是动作语义。比如 running-right 和 running-left 不只是“人在跑”。在 Codex 里，它们更像桌宠在屏幕上移动时的拖拽/移动状态，需要明确向右或向左。而 running 这一行反而不能做成真的奔跑。在 Codex 的状态语义里，running 更接近“任务正在运行”。所以我这次把它做成拿平板和笔认真处理任务的状态，而不是让角色原地狂奔。第三个问题是方向。这是最麻烦的一步。第一次生成 16 个看向方向时，我遇到过一个典型问题：模型会把“角色自己的右边”和“画面里的右边”搞混。比如我们说 090 right，真正要的是“角色看向图片右边缘”，不是角色转到她自己的右手边。这一步必须说得非常硬： ``` screen-right means toward the right edge of the image screen-left means toward the left edge of the image ``` 最后还要做盲测。我让三个隔离的子代理只看未标注方向的 A/B 图，不看答案、不看提示词、不看原始方向表，让它们判断哪个是 left、right、up、down。第一次水平 cardinal 没过，说明左右方向确实不够清楚。所以我重做了 cardinal anchors 和两行 look direction，直到盲测 hard gate 通过。这一步很关键，因为如果只是自己看 labeled sheet，很容易因为知道答案而“脑补通过”。 # 最终效果怎么看？这是最终 QA contact sheet： ![Image](/doc/3234/image/img_66c730a6dafd.jpg) 你可以看到它已经不是单张图，而是一整套动作状态。第一张，原始 IP 设定图： ![Image](/doc/3234/image/img_819708de333c.jpg) 这张图负责告诉别人：桌宠不是凭空生成的，是从一个明确的角色设定出发。第二张，生成出来的主角色参考： ![Image](/doc/3234/image/img_e743012393ff.jpg) 这张图可以展示 Hatch Pet 先把 IP 设定统一成一个适合小尺寸动画的 canonical base。第三组，蓝色背景的状态行： ![Image](/doc/3234/image/img_c19ad9053cfc.jpg) ![Image](/doc/3234/image/img_a2693c3d4b07.jpg) ![Image](/doc/3234/image/img_59ef081b4fd2.jpg) ![Image](/doc/3234/image/img_cd7b92c79ba6.jpg) ![Image](/doc/3234/image/img_e97154f0886c.jpg) ![Image](/doc/3234/image/img_9df5799f3878.jpg) 这些蓝色背景图就是中间生成过程。它们还没被最终透明化和打包，但很适合发出来让人看到每个状态是怎么被单独生成的。第四组，方向系统： ![Image](/doc/3234/image/img_465947610a50.jpg) ![Image](/doc/3234/image/img_9fe6ed389a30.jpg) 这组图可以说明 v2 桌宠不是只有 9 个动作状态，还需要 16 个看向方向。第五张，最终 QA 总览： ![Image](/doc/3234/image/img_800481cd2bd2.jpg) 第六张，方向 QA： ![Image](/doc/3234/image/img_cae05ba4a321.jpg) 第七张，盲测方向 QA： ![Image](/doc/3234/image/img_dae47a5f6cfd.jpg) 最后，如果你想展示技术成品，可以再放完整 spritesheet： ![Image](/doc/3234/image/img_7d0da76bc3ca.jpg) 我会把图片顺序整理成这样： ``` 1. 01-ip-reference.png 原始 IP 设定图 2. 05-base-generated-blue.png 生成出的主角色参考 3. 06-running-right-blue.png 蓝底动作行：移动 4. 07-waving-blue.png 蓝底动作行：挥手 5. 09-failed-blue.png 蓝底动作行：失败沮丧 6. 11-running-work-blue.png 蓝底动作行：运行中 7. 13-look-cardinals-blue.png 四个看向基准方向 8. 14-look-row-9-blue.png 方向 row 9 9. 15-look-row-10-blue.png 方向 row 10 10. 02-final-contact-sheet.png 最终完整动作总览 11. 03-look-directions.png 方向 QA 12. 04-direction-blind-pairs.png 盲测 QA ``` 安装后的路径是： ``` /Users/meng/.codex/pets/operator-ip ``` 里面有两个核心文件： ``` pet.json spritesheet.webp ``` pet.json 内容是： ``` { "id": "operator-ip", "displayName": "Operator IP", "description": "A confident chibi operator with long black hair, denim-blue outerwear, black innerwear, small gold earrings, and a clean practical style.", "spriteVersionNumber": 2, "spritesheetPath": "spritesheet.webp" } ``` 这里最重要的是： ``` "spriteVersionNumber": 2 ``` 如果没有这个字段，Codex 可能会按旧版 9 行桌宠去读，最终就无法正确识别 8x11 的 v2 图集。 # 如果你也想做，最实用的准备清单如果你想在 Codex 里定制自己的个人桌宠，可以按这个顺序准备。第一，准备一张 IP 设定图。最好是干净背景、角色完整、服装配色明确。如果有多个表情和姿态，更好。第二，明确哪些东西必须保留。不要只说“照着这个图做”。你要把不可丢的识别点写出来。比如我这次写的是： ``` 保留长黑发、牛仔蓝外搭、黑色内搭、小金色耳饰、清爽自信的气质。桌宠要适合小尺寸显示，轮廓清楚，表情明显，不要堆太多细节。所有动画里的发型、服装、颜色和角色比例要保持一致。 ``` 第三，让 Hatch Pet 生成完整 v2 桌宠。不是只生成头像，也不是只生成一张透明 PNG，而是生成： - 标准 9 行状态动画 - 16 个 look direction - contact sheet - direction QA - blind direction QA - v2 spritesheet - pet.json 第四，把结果放到 Codex 的 pets 目录。我的最终路径是： ``` /Users/meng/.codex/pets/operator-ip ``` 如果换成你自己的角色，目录名可以换成自己的 pet id，例如： ``` /Users/你的用户名/.codex/pets/my-custom-pet ``` 目录里至少要有： ``` pet.json spritesheet.webp ``` 第五，在 Codex 里启用它。如果 Codex 里有桌宠/宠物选择入口，就选择这个自定义 pet。列表没刷新时，重启 Codex 或重新打开当前任务。 # 这件事真正好玩的地方我觉得这不是一个“换皮肤”的小功能。它更像是把 AI 工作台变成自己的空间。你可以做一个自己的 IP。也可以做一个公司 mascot。可以做一个产品发布专用角色。甚至可以给不同工作流做不同桌宠：写作一个，剪视频一个，投研一个，代码 review 一个。以前我们说 AI agent 个性化，通常是在说 system prompt、工具权限、知识库、工作流。但界面上的角色也很重要。因为它会改变你和工具相处的感觉。当一个角色能根据任务状态挥手、等待、沮丧、检查、运行，你会更自然地把它当成一个“工作伙伴”，而不是一个无表情的输入框。这次我做的这个桌宠还只是第一版。但它已经说明一件事：个人 AI 工作台以后不会只拼模型和插件。它也会拼你的界面、角色、习惯和工作流。而 Codex 这种能直接读文件、生成资源、跑 QA、安装到本地目录的环境，正好适合做这类深度个人化的小东西。一张 IP 设定图，最后变成一个能在 Codex 里陪你工作的桌宠。这就是我这次觉得最有意思的地方。 ## 相关链接 - [Kimberly](https://x.com/king1818888) - [@king1818888](https://x.com/king1818888) - [15K](https://x.com/king1818888/status/2079170439872729497/analytics) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [7:43 PM · Jul 20, 2026](https://x.com/king1818888/status/2079170439872729497) - [15.9K Views](https://x.com/king1818888/status/2079170439872729497/analytics) - [View quotes](https://x.com/king1818888/status/2079170439872729497/quotes) --- *导出时间: 2026/7/21 14:34:40*

🔗 相关文档