build-vesperfall-review-assets

构建 Vesperfall 审查资源

创建一组可供审查的资源配对，避免混淆目录媒体、导入文件、程序化工厂和未来契约。

工作流

1. 在选择模型路径前，先检查仓库的实际情况。
   • 查找已发布的 PNG、FBX、GLB、纹理、运行时工厂以及已声明但缺失的路径。
   • 如果已发布的 FBX/GLB 是实际的运行时来源，优先使用它。
   • 只有在通过代码从图像重建时才使用 $img2threejs。绝不能将导入的几何体重新标记为 img2threejs。
   • 不要因为代码声明了未来的 URL，就声称 GLB 或纹理已经存在。
2. 生成透明的目录参考图。
   • 如果生产肖像已经符合资源身份，直接复用或据此生成。
   • 除非项目契约另有规定，否则将目录副本统一为 512×512 RGBA。
   • 保持边角透明，避免烘焙地面、光晕或阴影。
   • 将项目专用输出存放在 public/asset-catalog/<category>/ 下。
3. 构建实时模型预览。
   • 将加载和模型构建逻辑放入小型的资源专用模块。
   • 在 userData 中保留运行时来源信息：源路径或工厂、动作数量、挂接点以及仅供审查的状态。
   • 将装备挂接到具名挂接点。材质、渲染器、混合器、事件和动画帧都必须可释放。
   • 根据测量得到的边界确定取景。根据脚部/接触几何体落地，而不是根据武器尖端最低点。
4. 配对目录展示界面。
   • 卡片/网格：仅显示透明 PNG，不使用画布。
   • 选中项检查器：显示一个实时模型画布，并提供真实准确的格式标签。
   • 添加指向独立预览或招式集路由的按钮。
   • 在 WebGL/模型加载就绪前保持回退媒体可见。
5. 构建独立的审查路由。
   • 如果存在动画片段，展示真实的动作库。
   • 提供重新开始、暂停/播放、动作选择、拖动旋转、源路径和来源信息。
   • 对程序化动作，分别标明运行时动作、契约动作和候选动作。
6. 提交前进行验证。
   • 运行 scripts/validate_pair.py <png> <model-source>。
   • 添加库存测试，检查准确路径、RGBA 尺寸、预览类型和路由。
   • 如果落地状态会随动画变化，则确定性地测试每个动作/接触点。
   • 运行构建、lint、完整测试以及 git diff --check。
   • 仅使用 Codex 应用内浏览器。验证桌面端和移动端、卡片 PNG/无画布、检查器模型/单个画布、预览导航、落地状态、滚动、溢出、媒体损坏情况以及控制台警告/错误。
7. 提交范围精简的任务，并在部署协调前交付其准确的 SHA。

更改目录类型、来源描述或审查路由行为时，请阅读 references/catalog-contract.md。

必需的报告内容

报告：

• PNG 路径、尺寸和 Alpha 状态
• 模型来源或程序化工厂
• 模型属于导入模型、运行时程序化模型还是仅供审查的重建模型
• 预览路由和可用动作
• 测试/构建/浏览器验证证明
• 准确的提交 SHA