用途:从源参考到游戏运行时与目录证明,构建一个真实可信的演员资产包,适用于角色或怪物的创建、集成与审计。
主要能力:先检查仓库事实,定位源图/模型、运行时加载器、骨架约定、动作API、装备系统、碰撞系统、目录schema、评审路由、预算与测试;区分角色与怪物,区分仅目录、仅评审或运行时交付;保留不可变源文件与优化后运行时文件分离。
使用方式:从assets/复制对应模板(character-asset-manifest.template.json或monster-asset-manifest.template.json)填写并放在实现旁或资产元数据位置;构建前运行scripts/validate_asset_manifest.py <manifest>,发布文件检查加--root <repo>,全部验收通过后才加--require-verified;创建模型、绑定、动作、装备、插槽或碰撞前阅读references/requirements.md,添加目录卡、检查器、招式路由、遥测或发布测试时阅读references/catalog-and-testing.md。
角色档案:主模型为持久身体层,不融合可换装备;声明头饰、外衣、手套、护腿、靴子、主手、副手、背部/远程等槽位,不支持的槽位显式标注;装备绑定命名插槽,切换槽位关闭后不得残留浮空装饰或碎片;要求idle、walk、run、primary-attack、hit、dodge、death等动作角色。
怪物档案:视为一个创作战斗演员,不要求可穿戴槽位;仅分离需独立动画、隐藏、脱落或碰撞的武器、可破坏部位、掉落部位、投射物或道具;要求idle、locomotion、primary-attack、hit、death等动作角色;定义导航与受击碰撞体及每次攻击的预警、激活、恢复窗口。
目录实验室:目录卡使用透明PNG、真实标签、零WebGL画布;选中检查器仅一个实时模型画布,展示源、状态、预算、绑定、插槽、动作与已知边界;提供拖拽旋转、动作选择、重启与暂停/播放、角色装备开关或怪物战斗状态控制、回退图与确定性遥测。
验证与提交:运行聚焦资产测试、清单验证器、构建、lint、全量测试与git diff --check;在仓库认可的浏览器中验证卡片与检查器、点击每个动作、切换每个槽位、检查前后左右、拖拽与滚动、窄屏/移动布局、回退与加载失败行为、无损坏媒体或控制台错误;仅提交窄资产通道,报告清单、模型、装备文件、绑定与插槽、动作、目录路由、状态、验证结果、已知边界与提交SHA。
限制:资料未提供具体引擎、格式、价格或平台信息;不得用高细节源覆盖运行时优化;每顶点最多四个归一化蒙皮影响,除非引擎契约另有规定;检查器必须加载与游戏相同的运行时模型、绑定、剪辑、装备规则与动作API,截图或独立look-dev网格不算运行时证明。