Back to Details

build-vesperfall-review-assets

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Build Vesperfall Review Assets

构建Vesperfall审核资产

Create one reviewable asset pair without confusing catalog media, imported files, procedural factories, and future contracts.
创建一组可审核的资产配对，避免混淆目录媒体、导入文件、程序化工厂及未来合约相关内容。

Workflow

工作流程

  1. Inspect repository truth before choosing a model path.
    • Locate shipped PNG, FBX, GLB, textures, runtime factories, and declared-but-missing paths.
    • Prefer a shipped FBX/GLB when it is the actual runtime source.
    • Use 
      $img2threejs
      only when reconstructing from an image in code. Never relabel imported geometry as img2threejs.
    • Do not claim a GLB or texture exists because code declares a future URL.
  2. Produce the transparent catalog reference.
    • Reuse or derive from the production portrait when it already matches the asset identity.
    • Normalize catalog copies to 512×512 RGBA unless the project contract says otherwise.
    • Keep transparent corners and avoid baked floor, halo, or shadow.
    • Store project-bound output under 
      public/asset-catalog/<category>/
      .
  3. Build the live model preview.
    • Put loading/model construction in a small asset-specific module.
    • Preserve runtime provenance in 
      userData
      : source paths or factory, action count, sockets, and review-only status.
    • Attach equipment to named sockets. Keep materials, renderer, mixers, events, and animation frames disposable.
    • Frame from measured bounds. Ground from foot/contact geometry, not the lowest weapon tip.
  4. Pair the catalog surfaces.
    • Card/grid: transparent PNG only, with no canvas.
    • Selected inspector: one live model canvas plus truthful format label.
    • Add a button to an isolated preview or moveset route.
    • Keep fallback media visible until WebGL/model loading is ready.
  5. Build the isolated review route.
    • Expose the real action library when clips exist.
    • Provide restart, pause/play, action selection, drag rotation, source paths, and provenance.
    • For procedural motions, mark runtime, contract, and candidate actions separately.
  6. Validate before committing.
    • Run 
      scripts/validate_pair.py <png> <model-source>
      .
    • Add inventory tests for exact paths, RGBA dimensions, preview kind, and route.
    • Test every motion/contact point deterministically when grounding changes with animation.
    • Run build, lint, full tests, and 
      git diff --check
      .
    • Use the Codex in-app browser only. Verify desktop and mobile, card PNG/no canvas, inspector model/one canvas, preview navigation, grounding, scroll, overflow, broken media, and console warnings/errors.
  7. Commit the narrow task and hand off its exact SHA before deployment reconciliation.
Read references/catalog-contract.md when changing catalog types, provenance language, or review-route behavior.
  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尺寸、预览类型及路由。
    • 当定位随动画变化时，对每个动作/接触点进行确定性测试。
    • 运行构建、代码检查、完整测试及
      git diff --check
      命令。
    • 仅使用Codex内置浏览器。验证桌面端和移动端的卡片PNG/无画布、检视器模型/单画布、预览导航、定位、滚动、溢出、损坏媒体及控制台警告/错误情况。
  7. 提交窄范围任务，并在部署协调前移交其精确的提交SHA值。
当修改目录类型、来源追溯语言或审核路由行为时，请阅读references/catalog-contract.md。

Required reporting

必需报告内容

Report:
  • PNG path, dimensions, and alpha status
  • model source or procedural factory
  • whether the model is imported, runtime procedural, or review-only reconstruction
  • preview route and available actions
  • test/build/browser proof
  • exact commit SHA
需报告：
  • PNG路径、尺寸及透明度状态
  • 模型源或程序化工厂
  • 模型是导入的、运行时程序化的还是仅审核用的重建模型
  • 预览路由及可用动作
  • 测试/构建/浏览器验证证明
  • 精确的提交SHA值