Codex 桌宠换肤给 CodexDream 换上伊蕾娜皮肤开源项目原文链接https://github.com/bxck1234/codexdream-ileina-pet-skin本文已同步收录到开源项目中可随意转载请保留作者与 GitHub 链接。前言最近折腾 Codex Desktop / CodexDream 的时候发现它的桌宠其实支持自定义皮肤。研究了一下之后我给它做了一套“伊蕾娜”主题的动画桌宠皮肤并把完整生成记录、安装脚本、皮肤包和教程全部开源了。先看效果项目地址https://github.com/bxck1234/codexdream-ileina-pet-skin这个项目是什么这是一个给 Codex 桌宠换皮肤的完全开源项目把 Codex 默认桌宠替换成银白层次短发、小翘发、蓝紫眼睛、白色宽袖服装、黑色蝴蝶结与蓝色菱形挂饰的“伊蕾娜”桌宠。整个皮肤是8×9的动画精灵图尺寸1536 × 1872单帧单元192 × 208支持 9 种状态状态行帧数用途idle06待机、呼吸、眨眼循环running-right18向右拖拽移动running-left28向左拖拽移动waving34打招呼 / 引起注意jumping45悬停或跳跃failed58失败 / 取消 / 阻塞waiting66等待审批或输入running76正在处理任务review86输出完成、待查看原理Codex 桌宠皮肤放在哪里Codex 自定义桌宠主要靠两个地方皮肤文件目录~/.codex/pets/ileina/ ├── pet.json # 宠物元数据 └── spritesheet.webp # 8×9 动画精灵图配置文件~/.codex/config.toml[desktop] selected-avatar-id custom:ileina avatar-overlay-mascot-width-px 224只要把皮肤文件放到pets/目录再在配置里选中这个 ID重启 Codex 桌面客户端就可以看到新桌宠。项目结构. ├── README.md ├── LICENSE ├── package.json ├── docs/ │ └── make-your-own-pet-skin.md ├── packages/ileina/ │ ├── pet.json │ └── README.md ├── pet-runs/ileina/ │ ├── pet_request.json │ ├── prompts/base-pet.md │ ├── frames/ │ ├── final/ │ │ ├── spritesheet.webp │ │ └── validation.json │ ├── qa/ │ └── generated/ ├── output/imagegen/ │ └── codex-pet-character-sheet.png ├── pet-tools/ │ └── ensure-native-pet.mjs └── scripts/ ├── install.mjs ├── install.ps1 ├── install.sh └── uninstall.mjs安装方式一Windows PowerShell打开 PowerShell进入项目目录后执行powershell-ExecutionPolicy Bypass-File scripts\install.ps1方式二跨平台 Node.jsnodescripts/install.mjs方式三手动安装新建目录~/.codex/pets/ileina/复制文件packages/ileina/pet.json - ~/.codex/pets/ileina/pet.json pet-runs/ileina/final/spritesheet.webp - ~/.codex/pets/ileina/spritesheet.webp修改~/.codex/config.toml[desktop] selected-avatar-id custom:ileina avatar-overlay-mascot-width-px 224重启 Codex Desktop / CodexDream。卸载皮肤nodescripts/uninstall.mjs脚本会删除~/.codex/pets/ileina移除config.toml中的伊蕾娜选择并关闭桌宠叠层。如何用这套流程做自己的桌宠皮肤项目里保留了完整的生成记录pet-runs/ileina/pet_request.json定义 8×9 atlas、每种状态的帧数、参考图和抠图参数。pet-runs/ileina/prompts/base-pet.md角色基础提示词。pet-runs/ileina/frames/从绿幕精灵图中拆分出的透明单帧。final/validation.json最终 WebP 的机器校验结果。如果你想做自己的角色只需要生成一张纯色#00FF00绿幕角色图按 9 种状态生成 9 行横向精灵条合成为1536 × 1872的 WebP写一份pet.json放到~/.codex/pets/id/在config.toml中选择custom:id。详细教程见项目里的docs/make-your-own-pet-skin.md。开源协议本项目使用 MIT License完全开源。角色“伊蕾娜”及相关形象版权归原作品权利人所有。本项目为粉丝自制、非官方皮肤仅供学习交流。最后如果你也喜欢 Codex 桌宠或者想给自己的 CodexDream 换一个角色皮肤可以直接 clone 这个仓库安装体验。后续我也会继续更新其他桌宠皮肤。欢迎 Star、Fork、Issue 交流作者bxck1234