reflex4
Project FeatureFile 03 / 03

04.03 / CODEX SKILL / LITE V1

把 PRTS 基建动画
变成 Codex 桌面宠物

从皮肤确认、透明帧处理，到九状态预览与验收安装。

用户只需提供干员名与皮肤，Skill 即可把已有 PRTS 基建动画整理为符合 Codex Lite/v1 规格的透明精灵图宠物。

NINE-STATE PREVIEWCEOBE / DEFAULT
刻俄柏默认皮肤的九状态离线验收页，包含方向提醒、播放速度和状态来源标识九状态预览页的播放暂停与速度控制局部
MEDIA 01 / ANIMATION REVIEW九状态同时预览；方向、来源与降级状态保持可见。
01

REPRODUCIBLE PIPELINE

把易出错的手工步骤，
整理成一条可复现工作流

01PRTS皮肤确认
02WebM动画导出
03Frames透明帧
04Atlas8 × 9 图集
05Preview九状态预览
06Approval验收安装
02–04

THREE ENGINEERING GATES

每一次自动处理，
都必须通过一道门

这条管线不把“问题、步骤、功能”分开陈列。它把风险放回发生的位置：先确认来源，再建立可靠图集，最后把安装权交还给用户。

GATE 01 / CONFIRM来源确认

先确认处理的是谁

风险：动作集合不统一，页面还可能静默回退到默认皮肤。

  1. 01接收干员名与可选皮肤
  2. 02两次独立探测并确认结果一致
  3. 03只重试缺失或损坏的来源动作
STABLE PROBEPARTIAL RETRY
GATE 02 / BUILD图集建立

让每一帧进入正确位置

风险：透明噪声、基线抖动、裁切和错误方向都会在运行时被放大。

  1. 04解码透明帧并清理低 Alpha 噪声
  2. 05共享缩放、脚底基线与防裁切
  3. 06抽帧并映射到九种 Codex 状态
ALPHA CLEANUPSTATE MAPPING
GATE 03 / APPROVE验收安装

把最后决定留给用户

风险：结构校验通过，不代表角色大小、节奏和降级状态已经合格。

  1. 07组装 1536 × 1872 的 PNG / WebP
  2. 08独立验证透明格、裁切与移动方向
  3. 09九状态预览；明确批准后原子安装
OFFLINE PREVIEWAPPROVAL GATE

PRTS→CONFIRM→BUILD→VERIFY→APPROVAL→CODEX PET

05

TECHNICAL DEEP DIVE

一个固定图集，九种运行状态，多份可追溯报告

刻俄柏最终 8 列乘 9 行精灵图的棋盘格展示版本
MEDIA 02 / VALIDATED ATLAS棋盘格只帮助阅读透明区域；网页不提供运行时透明原图下载。
输出
RGBA PNG / WebP
画布
1536 × 1872 px
结构
8 列 × 9 行
单元格
192 × 208 px
语言
Python 3.10+
自动化
Playwright + Chromium
图像
Pillow
可选恢复
FFmpeg + Spine WebGL runtime
MANIFESTDECODE REPORTATLAS REPORTVALIDATION REPORT
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带门控与备份的安装器
06

CASE STUDY / CEOBE

刻俄柏：从默认皮肤到九状态宠物

此案例记录现有产物报告，而不是实时 CI 状态。历史离线回归数据截至 2026-08-12。

57必需非空单元
15未使用透明单元
0边缘接触单元
2.09MiB WebP 示例
30/30历史离线回归通过
Move 右移与逐帧镜像左移的八帧静态对比
MEDIA 03 / DIRECTION同一段 Move 动画逐格水平镜像，帧序保持不变。
刻俄柏初始版、1.3 倍调校版和状态改映射版的并排对比
MEDIA 04 / TUNING同一干员与皮肤，只比较缩放、镜像与状态来源选择。
DEFAULT SKININTERACT / MOVE / RELAX / SIT / SLEEPFAILED → SLEEPPNG + WEBP VALIDATED
07

ENGINEERING DECISIONS

可靠性来自明确的边界

LITE / V1

先把固定规格做扎实

首版不冒充完整 v2 宠物格式；九状态足以验证这条资产处理管线。

HUMAN APPROVAL

自动化不替用户验收

角色观感和安装决定都保留给用户；没有明确批准，工具不会写入本地宠物目录。

CODE ONLY

仓库不分发游戏资产

公开仓库只包含原创代码与文档，不提交 WebM、Spine、解码帧、图集或成品宠物包。

08

LIMITATIONS / NEXT

它是一条个人工具管线，
不是角色素材库

当前边界

  • 不是独立 Windows / macOS 桌宠应用。
  • 不补绘、不重画、不生成新的角色动作。
  • 缺失动作会降级复用，并在报告与预览中标出。
  • PRTS 页面结构变化时，导出选择器可能需要更新。

继续完善

  • 增加更多干员与皮肤的兼容性案例。
  • 建立实时 CI 与选择器诊断。
  • 丰富状态、缩放与映射对比体验。
  • 在规格允许时单独评估更高阶格式。