04.03 / CODEX SKILL / LITE V1
把 PRTS 基建动画
变成 Codex 桌面宠物
让基建里的小人，也能出现在桌面上。
这是一个给 Codex 用的 Skill。指定干员和皮肤后，它会从 PRTS 导出基建动画，处理透明背景，整理成 Lite/v1 桌宠。安装前可以先预览动作，看看大小和节奏是否合适。
HOW IT WORKS
从一段基建动画，
到可以安装的桌宠
PROCESS NOTES
制作桌宠时，
有哪些细节要处理？
不同皮肤的动作不一定齐全，导出的动画也不能直接交给 Codex 使用。这里主要处理三件事：确认素材、整理画面，再检查实际播放效果。
选中的皮肤，
真的加载了吗？
PRTS 有时会退回默认皮肤，页面却没有明显提示。下载前需要再次核对，避免做完才发现选错了。
- 01接收干员名与可选皮肤
- 02两次独立探测并确认结果一致
- 03只重试缺失或损坏的来源动作
统一大小，
对齐脚底位置
每段动画的画面范围不同。分别缩放会让角色在切换动作时突然变大或变小，脚底的位置也可能跟着跳动。
- 04拆出透明帧，清理边缘杂点
- 05统一缩放和脚底位置，留足动作空间
- 06抽取帧，分配给九种 Codex 状态
先看它动起来，
再决定安装
尺寸和格式可以用脚本检查，动作是否自然还得看一遍。预览页能同时播放九种状态，也会标出借用了其他动作的状态。
- 07生成 1536 × 1872 的 PNG / WebP
- 08检查空白帧、画面裁切和行走方向
- 09打开预览，确认后备份并安装
PRTS→CONFIRM→BUILD→VERIFY→APPROVAL→CODEX PET
FILES & TOOLS
九种状态，
装进一张精灵图
- 输出
- RGBA PNG / WebP
- 画布
- 1536 × 1872 px
- 结构
- 8 列 × 9 行
- 单元格
- 192 × 208 px
- 语言
- Python 3.10+
- 自动化
- Playwright + Chromium
- 图像
- Pillow
- 可选恢复
- FFmpeg + Spine WebGL runtime
prts_skin_probe.py干员与皮肤探测prts_export.py动画导出与局部重试decode_webm.py透明帧解码与标准化build_lite_atlas.py状态映射与图集生成validate_lite_atlas.py独立图集校验build_preview_page.py离线动态验收页install_local_pet.py确认安装并备份旧版本CASE STUDY / CEOBE
刻俄柏做出来是什么样？
下面用默认皮肤展示行走方向和几次调校的差别。数字来自这份成品的检查报告，其中 30 项离线回归测试记录于 2026-08-12。
PROJECT NOTES
这一版的几个取舍
先支持 Lite/v1
当前按八列九行的固定规格生成桌宠。更高阶的 v2 格式还没有实现，需要另行适配。
安装前停下来确认
大小和动作节奏各有偏好，所以生成后先给出预览。用户明确同意后，才会写入本地宠物目录。
开源处理工具
仓库提供代码和使用说明。游戏动画、模型文件和生成的宠物包不随代码一起分发。
LIMITATIONS / NEXT
目前的限制，
和后面想补的东西
使用前要知道
- 生成的宠物需要在 Codex 中使用，不能作为独立桌宠应用运行。
- 动作来自已有基建动画，工具不会补画新动作。
- 某个动作缺失时会借用其他动作，预览页会注明。
- PRTS 改版后，下载脚本可能需要跟着调整。
后续计划
- 用更多干员和皮肤测试兼容性。
- 把现有回归测试接入持续集成，方便及时发现下载问题。
- 让不同尺寸和动作配置的效果更容易比较。
- 研究其他宠物格式的适配方式。
SOURCE & CREDITS
源码与使用说明，
以及素材出处
本项目为非官方个人项目，与鹰角网络、PRTS 或 OpenAI 均无隶属、合作或背书关系。
《明日方舟》及相关角色、图像、动画和商标归各自权利人所有。项目只应在用户有权访问和处理源素材时使用，生成宠物以个人使用为主。