AIGame/Doc/ResDesc_Model.md

资源说明 · Model

3D 模型及相关烘焙贴图。每条包含：路径、简要说明。

约定：

• 人物角色：AIClient/Assets/Bundles/Characters/Human/{英文名称}/
• 早期平铺：AIClient/Assets/Bundles/Characters/{ActorName}/（仅 MaleExplorer）
• 场景分件：AIClient/Assets/Bundles/Scenes/{类型}/{场景号}/{英文短名}/

资源路径	简要说明
AIClient/Assets/Bundles/Scenes/Town/TownSquare/TownSquare.prefab	小镇广场拼装体；Pipeline BuildTownSquare.Run；运行时地址 TownSquare；物件 Y 取地表碰撞高度
AIClient/Assets/Bundles/Scenes/Town/TownSquare/TownSquare.unity	可进游戏的广场场景（相机约 28° 俯斜 + 方向光）
AIClient/Assets/Bundles/Scenes/Town/TownSquare/ground/	广场地表；减面 800；XPbr；Prefab 带非凸 MeshCollider
AIClient/Assets/Bundles/Scenes/Town/TownSquare/shop/	红顶店铺；减面 1797；XPbr
AIClient/Assets/Bundles/Scenes/Town/TownSquare/tree/	树；减面 1498；XPbr
AIClient/Assets/Bundles/Scenes/Town/TownSquare/lamp/	路灯；减面 500；XPbr
AIClient/Assets/Bundles/Scenes/Town/TownSquare/board/	告示牌；减面 800；XPbr
AIClient/Assets/Bundles/Scenes/Town/TownSquare/fountain/	两层喷泉；减面 1798；XPbr
AIClient/Assets/Bundles/Scenes/Town/TownSquare/bench/	长椅；减面 699；XPbr
AIClient/Assets/Bundles/Scenes/Town/TownSquare/bush/	灌木花箱；collapse 卡住后体素重网格，减面 436；XPbr
Tools/output/townsquare_3d/	TownSquare 混元高模 GLB（不进 Bundle）
Tools/output/townsquare_game/	TownSquare 减面/烘焙中间输出（不进 Bundle）
Tools/output/caocao_3d/caocao.glb	曹操混元高模（约 5 万面，不进 Bundle）
Tools/output/caocao_game/	曹操减面/烘焙/XPbr 中间输出（不进 Bundle）
AIClient/Assets/Bundles/Characters/Human/CaoCao/	人物 CaoCao；Pipeline SetupCharacter.SetupCaoCao；运行时地址 CaoCao
…/CaoCao.fbx	减面低模 3000 tris；Y-up、底面原点、-Z 正面
…/CaoCao_base.png / CaoCao_mix.png	XPbr 1024；写出时 PNG 无损压缩
…/CaoCao.prefab	身高 1.8m，挂 Test/XPbr
Tools/output/lmgirl_3d/lmgirl.glb	LmGirl 混元高模（49978 面，不进 Bundle）
Tools/output/lmgirl_game/	LmGirl 减面/烘焙/XPbr 中间输出（不进 Bundle）
AIClient/Assets/Bundles/Characters/Human/LmGirl/	人物 LmGirl；Pipeline SetupCharacter.SetupLmGirl；身高 1.65m
…/LmGirl.fbx	减面低模 3000 tris；Y-up、底面原点、-Z 正面
…/LmGirl_base.png / LmGirl_mix.png	XPbr 1024
…/LmGirl.prefab	身高 1.65m，挂 Test/XPbr
Tools/output/lmcat_3d/lmcat.glb	LmCat 混元高模（49847 面，不进 Bundle）
Tools/output/lmcat_game/	LmCat 减面/烘焙/XPbr 中间输出（不进 Bundle）
AIClient/Assets/Bundles/Characters/Animal/LmCat/	动物 LmCat；Pipeline SetupCharacter.SetupLmCat；身高 0.42m
…/LmCat.fbx	减面低模 1999 tris；Y-up、底面原点、-Z 正面
…/LmCat_base.png / LmCat_mix.png	XPbr 1024
…/LmCat.prefab	身高 0.42m，挂 Test/XPbr
Doc/Design/Character/RockBall/rockball.png	岩团团设计图（纯白底）；Cursor GenerateImage v2；混元输入
Tools/output/rockball_3d/rockball.glb	RockBall 混元高模（50k，job d9390f797ba94f1b9099ae4c36213f00，不进 Bundle）
Tools/output/rockball_game/	RockBall 减面/烘焙/XPbr 中间输出（不进 Bundle）
AIClient/Assets/Bundles/Characters/Animal/RockBall/	动物 RockBall（岩团团）；Pipeline SetupCharacter.SetupRockBall；身高 0.55m
…/RockBall.fbx	减面低模 1500 tris；Y-up、底面原点、-Z 正面
…/RockBall_base.png / RockBall_mix.png	XPbr 1024
…/RockBall.prefab	身高 0.55m，挂 Test/XPbr；CharacterUnitReview 已通过（2026-10-20）；开战/营地替换另开任务
…/RockBall/Rigged/RockBall_Rigged.fbx	已验收低模外观 + 19 骨蒙皮（bl_transfer_skin）；tris≈1512
…/RockBall_Rigged.prefab	可驱动 + XPbr + Animator；Idle/Walk/Attack；SetupAnimalAnimator.SetupRockBall
Tools/model_tools/bl_transfer_skin.py	把 TokenRig 骨架权重转到已验收低模（低模直绑骨过少时用）
AIClient/Assets/Bundles/Scenes/Test/ModelView/ModelView.unity	模型观看测试场景；Pipeline BuildModelView.Run；4×3 摆放 LmHouses，前景为 LmGirl 与 LmCat，相机在 -Z 侧略俯视
AIClient/Assets/Bundles/Characters/MaleExplorer/	早期样例（平铺目录、约 5k tris，不作为新角色模板）
Doc/Design/Scene/LmHouses/	十二栋房屋分件设计图，由用户合图按 4×3 拆出，纯白底
Tools/output/lmhouses_3d/	LmHouses 混元高模 GLB（约 5 万面，不进 Bundle）
Tools/output/lmhouses_game/	LmHouses 减面/烘焙/XPbr 中间输出（不进 Bundle）
AIClient/Assets/Bundles/Scenes/Test/LmHouses/	十二栋场景房屋；Pipeline SetupLmHouses.Run；Y-up、底面原点、-Z 正面、XPbr 1024
…/cream_tile/	浅墙灰瓦双层；2000 tris；高 7.0m
…/cream_red/	浅墙红瓦双层；1998 tris；高 7.2m
…/white_balcony/	白墙阳台双层；2000 tris；高 7.0m
…/brown_wood/	木墙灰瓦和风；2000 tris；高 6.8m
…/cream_porch/	浅墙红瓦带阳台；2000 tris；高 7.2m
…/stone_balcony/	石基阳台双层；减面停在 3676 tris；高 7.0m
…/thatched/	茅草平房；减面停在 3740 tris；高 4.4m
…/white_blue/	白墙蓝瓦双层；2000 tris；高 7.0m
…/wood_fence/	灰瓦木房带围栏；1999 tris；高 6.6m
…/shop_awning/	蓝篷店铺；减面停在 2515 tris；高 7.0m
…/picket/	红瓦房带白栅栏；混元 Flash 先输出 20406 面，再减面到 1570；高 6.8m
…/gate/	灰墙双层带院门；1996 tris；高 7.0m
Tools/output/male_explorer_3d/male_explorer.glb	混元高模中间件（不进 Bundle）
Tools/output/male_explorer_game/	减面/烘焙中间输出（不进 Bundle）

G0 教学战场与原型角色（2026-10-15）

资源路径	用途与生成方式
AIClient/Assets/Bundles/Scenes/Prototype/PrototypeArena.prefab	开战加载的战场。伙伴、敌人、弹体、部署标记、技能表现和战斗相机仍在此预制体上。AttachGreenfield 把 Battlefield_Greenfield 嵌为 Greenfield，关闭方块地面/路线板/边饰/BattleLight，并把 Greenfield 整棵子树设为第 30 层（开战相机只画该层）。场景不摆桥。伙伴原点在脚底中心、局部 -Z 为正面。
AIClient/Assets/Bundles/Scenes/Prototype/Materials/Proto*.mat	十种原型材质，分别用于奶油色、岩色、橙色、叶色、深色、白色、青色、草地、路面和敌人；同一 Pipeline 构建脚本创建，URP Lit、低光滑度；Arena 依赖进入 Art/GameplayPrototype

运行时只实例化已制作的 Arena 并驱动角色/敌人/弹体节点，不用运行时代码替代场景资产制作。正式替换角色时保留 Heroes/Hero0～2 与 Enemies/Enemy0～8 的绑定契约，或同步更新表现层。实现边界见 Doc/Design/G0_Implementation.md。

首章五伙伴扩展（2026-10-16）

资源路径	用途与生成方式
AIClient/Assets/Bundles/Scenes/Prototype/PrototypeArena.prefab 的 Heroes/Hero3、Heroes/Hero4	新增电系闪闪雀（黄身、青翼/冠、橙喙）与水系泡泡龟（青色龟壳、圆头、四足）原型简模；Unity Pipeline 执行 AgentScripts/BuildPrototype.cs 持久化基础几何体制作，原点在脚底中心、Y-up、局部-Z正面。现行绑定为Hero0～4，不是正式角色美术或FBX。
AIClient/Assets/Bundles/Scenes/Prototype/Materials/ProtoYellow.mat、ProtoWater.mat	两只新伙伴的黄色与水蓝色 URP Lit 材质；同一Pipeline脚本创建并保存，复用既有深色/白色/青色/橙色材质，随Arena进入Art/GameplayPrototype。

五只角色、五个弹体节点与五张肖像的资产存在/绑定检查通过，新增水/电伙伴已在独立账号实战验证。

营地固定槽位装饰（2026-10-16）

资源路径	用途与生成方式
AIClient/Assets/Bundles/Scenes/Prototype/CampDecoration0.prefab	迎风小旗原型模型，旗杆/底座/橙色旗面/浅色横条；Unity Pipeline执行AgentScripts/BuildCampAssets.Build以基础几何体制作并持久化，复用ProtoDark/Cream/Orange/Yellow材质。用于营地装饰看板肖像，也可作为后续场景摆放资产。
AIClient/Assets/Bundles/Scenes/Prototype/CampDecoration1.prefab	花叶盆栽原型模型，橙色花盆、浅色盆沿、青色五瓣花与绿叶；相同Pipeline构建方式，复用既有材质。
AIClient/Assets/Bundles/Scenes/Prototype/CampDecoration2.prefab	暖光路灯原型模型，立柱/灯箱/黄色灯面/顶盖/底座；相同Pipeline构建方式，无额外动态灯光或真实照明收益。

三件均为Y-up、底面中心原点、局部-Z正面，进入现有Art/GameplayPrototype目录收集规则；当前以渲染肖像呈现在营地固定槽位看板，未放入首页背景插画或制作自由摆放场景。 | 2026-10-18 | AIClient/Assets/Bundles/Scenes/Prototype/Battlefield/ | 新战场资产目录骨架，按 Ground、Components、Markers、Materials 分层；模型仍需在设计方案确认后经微信网页图生3D和减面流程导入，当前未登记为已完成模型资源。 |

A·绿野三岔口战场资产（2026-10-18）

资源路径	用途与生成方式
Tools/output/battlefield/A/{tree,rock,bridge,sign,shrub}/*.glb	A 方案 5 类组件的混元图生 3D 原始 GLB，均 50k 面数档；输入为已审核的 GPT Image 2.5 分件图，任务回执写入对应 *_hunyuan_status.json。
Tools/output/battlefield/A/{tree_game,rock_game,bridge_game,sign_game,shrub_game}/*_xpbr/	5 类组件低模与 XPbr 资源；model_lowpoly_bake.py 使用 Blender 5.0 减面、UV、烘焙，目标面数树700/岩石450/桥1200/路牌450/灌木450，路牌实际448、灌木实际422；每类含 FBX、*_base.png、*_mix.png 与材质信息。
AIClient/Assets/Bundles/Scenes/Prototype/Battlefield/A/Components/{tree,rock,bridge,sign,shrub}/	5 类低模 FBX、XPbr base/mix 贴图、Test/XPbr 材质，以及 Pipeline BuildBattlefieldAssets.BuildComponents 生成的同目录 Prefab。
Doc/Design/Scene/Battlefield/A/ground.png	A 方案路线布局审核图。混元图生 3D 使用同一目录的 ground_model_ref.png。
2026-10-18	AIClient/AgentScripts/BuildBattlefieldAssets.cs
2026-10-18	Tools/output/battlefield/A/ground_hunyuan_status_latest.json
2026-10-19	Tools/output/battlefield/A/ground_model_ref/ground_model_ref.glb
2026-10-19	Tools/output/battlefield/A/ground_game/ground_model_ref_xpbr/
2026-10-19	AIClient/Assets/Bundles/Scenes/Prototype/Battlefield/A/Ground/
2026-10-19	AIClient/Assets/Bundles/Scenes/Prototype/Battlefield/GreenfieldGround.prefab
2026-10-19	AIClient/Assets/Bundles/Scenes/Prototype/Battlefield/Battlefield_Greenfield.prefab
2026-10-20	AIClient/Assets/Screenshots/battlefield_play_battle.png
2026-10-20	Doc/UIPrefabCreater/UI_PrototypeSettings.json / AIClient/Assets/Bundles/UI/Prefab/UI_PrototypeSettings.prefab

| 2026-10-20 | AIClient/AgentScripts/BuildSceneReview.cs / AIClient/Assets/Bundles/Scenes/Prototype/Battlefield/Battlefield_Greenfield_Review.unity | ?????????????Pipeline?Battlefield_Greenfield.prefab?????????Unity?????????????????????Doc/Design/Scene/SceneReviewGeneration.md? | | 2026-10-20 | Assets/Bundles/Scenes/Review/CharacterUnitReview.unity | 角色/单位美术专用验收场景。Pipeline BuildCharacterReview 按 manifest 摆放 Human/Animal Prefab，校验身高、面数、XPbr、底面贴地；流程见 Doc/Design/Character/CharacterUnitArtProc.md。截图 character_unit_review.png。 |

| 2026-10-20 | Tools/output/rockball_dgx/walk_verified/RockBall_Rigged.fbx / .skin.json | 同角色high_rig 12骨→项目静态FBX Y-up转Blender Z-up→底面中心/等比尺寸对齐→转移权重。保留验收低模750原始顶点/1500三角面、UV与材质；权重限制4根并归一化。表面距离RMS 0.00223（模型高度约1）。生成工具 Tools/model_tools/bl_transfer_skin.py --low-up Y --align-bounds。 | | 2026-10-20 | AIClient/Assets/Bundles/Characters/Animal/RockBall/Rigged/RockBall_Rigged.fbx / RockBall_Rigged.prefab | 上述12骨FBX经Pipeline导入，SetupAnimalAnimator.SetupRockBallWalk制作Prefab。0.55m、Y-up、底面中心、局部-Z正面，复用RockBall.mat XPbr。绑定姿态对原静态模顶点误差最大0.000031m。 | | 2026-10-20 | AIClient/Assets/Bundles/Scenes/Review/RockBallWalkReview.unity / RockBallWalkFloor.mat | Pipeline ReviewRockBallWalk.Build制作的静态/Walk并排专用验收场景和地面材质；Edit与Play均可预览。 | | 2026-10-20 | Tools/output/rockball_walk_audit/static_for_tokenrig.glb | dgx3d_animal_pipeline.mesh_to_glb 的FBX→GLB坐标转换回归样本：项目Y-up静态顶点先转Blender Z-up，再按glTF规范导出；重新导入测得高度Z=0..1.00690，未导入游戏资源目录。 | | 2026-10-20 | Tools/output/enemy_characters/RockBall/RockBall_Rigged.fbx / .skin.json | 敌方标准入口按配方重做同角色12骨蒙皮，750源顶点/1500三角面、4权重；对齐与静态形状通过，输出来源/几何距离记录。 | | 2026-10-20 | AIClient/Assets/Bundles/Characters/Enemy/RockBall/RockBall_Enemy.prefab | Pipeline BuildEnemyReview.Publish制作的敌方视觉Variant，复用Animal/RockBall已验收网格/XPbr/三动作Controller；外层根归一化，未包含玩法伤害/寻路组件。 | | 2026-10-20 | AIClient/Assets/Bundles/Scenes/Review/Enemy_RockBall_Review.unity / EnemyReviewFloor.mat | Pipeline按配方制作的静态、Idle、Walk、Attack、自动轮播五组并排场景与地面材质；Additive创建，独立渲染层，保留其它场景未保存编辑。Edit与Play验证通过。 |

火喵 FireCat T1 伙伴（2026-10-20）

资源路径	用途与生成方式
Tools/output/firecat_3d/firecat.glb	用户授权后，firecat.png提交腾讯混元3D网页50k档生成的同角色高模；50186 tris、内嵌贴图解码通过，回执hunyuan_status.json。保留用于同源绑骨及权重转移。
Tools/output/firecat_game/firecat_xpbr/	Blender5减面/UV/烘焙：1998 tris、1024贴图；含离线FBX与base/mix打包产物，制作回执bake_status.json。离线生成的mat/meta不直接写入Unity。
AIClient/Assets/Bundles/Characters/Animal/FireCat/FireCat.fbx、FireCat_base.png、FireCat_mix.png、FireCat.mat、FireCat.prefab	Pipeline导入FBX/两张贴图，SetupCharacter.Run创建Test/XPbr材质与0.55m静态伙伴Prefab；Y-up、底面中心、局部-Z正面。实际高度0.549977m、底面-0.000001m、1998 tris，隔离预览正侧背面通过。
Tools/output/firecat_dgx/high_rig/rigged.glb、rig_request.json	同角色混元高模经DGXA TokenRig original模板生成22骨；保留源高模和rig哈希、任务目录与日志，后续三动作仅使用此rig。
Tools/output/companions/FireCat/FireCat_Rigged.fbx、.skin.json	Y-up→Blender Z-up对齐后转移权重，保留1998 tris/1006原始顶点与UV；几何距离最大0.005568、RMS0.002045（源高约0.997），每顶点最多4权重并归一化。配方测地区域修正175个尾部顶点到根骨，避免抬爪带扁尾部；受影响范围写入skin报告。
AIClient/Assets/Bundles/Characters/Animal/FireCat/Rigged/FireCat_Rigged.fbx、FireCat_Rigged.prefab、FireCat_Companion.prefab	Pipeline导入同源蒙皮，SetupAnimalAnimator与BuildEnemyReview.Publish创建伙伴视觉资产；0.55m、XPbr、外层根单位缩放，绑定形状最大误差0.000030m，三动作及Edit/Play验证通过。伙伴用途，无敌方Variant。
AIClient/Assets/Bundles/Scenes/Review/Companion_FireCat_Review.unity	Pipeline按正式配方Additive构建静态、Idle、Walk、施法Attack、自动轮播五组；位置X=40，含角色名的对象/相机前缀，保留其它场景未保存内容。实际Play三状态通过并退出Play。