AIGame/Doc/ResDesc_Animation.md

资源说明 · Animation

动画与动作资源。每条包含：路径、简要说明。

资源路径	简要说明
Tools/output/mixamo/Male/*.fbx	Mixamo 男骨架（Y Bot）基础动作中间件，FBX for Unity / Without Skin / 30fps。含 Idle、Walking、Running、Punching、Kick(Kicking)、SwordSlash(Stable Sword Outward Slash)、HitReaction、FallingFlatImpact。脚本：Tools/download_mixamo_anims.py。未入库 Bundles。
Tools/output/mixamo/Female/*.fbx	Mixamo 女骨架（X Bot）同套动作，导出设置同上。未入库 Bundles。
Tools/output/mixamo/manifest.json	上述 16 个 FBX 的下载清单。
Tools/dgx3d_animal_pipeline.py	非人：已验收 FBX/GLB → TokenRig + UniMate Idle/Walk/Attack（不重做 DGX 模）；--caps-only 门禁
Tools/install_animal_rigged.py	将 pipeline 产物拷入 Characters/Animal/{Name}/Rigged 与 Anims
AIClient/AgentScripts/SetupAnimalAnimator.cs	Generic Animator；Motion Int 0=Idle/1=Walk，Attack Trigger单次攻击；样例 SetupRockBall，正式敌方由配方入口调用
Tools/output/{name}_dgx/	DGX 非人中间件（rigged_fbx / anims，不进 Bundle）
Tools/output/rockball_dgx/	岩团团中间件；旧 3cead72a 19骨代理与验收低模空间不一致，已停用；当前采用同角色 high_rig/rigged.glb 12骨和 walk_verified/ 单Walk验证
…/RockBall_Rigged.fbx	TokenRig 绑骨 FBX（减面约 2k）
…/anims/RockBall_{Idle,Walk,Attack}.fbx	UniMate 三动作；入库后见 Bundles
AIClient/Assets/Bundles/Characters/Animal/RockBall/Anims/RockBall_Idle.fbx	2026-10-20：同角色12骨专用UniMate Idle原始源动作，已替换旧19骨来源；任务 aigame_idle_54f85e5750484ecca7d8eaf439a02f77
…/RockBall_Walk.fbx	2026-10-20：同角色12骨重新生成的双足直立Walk原始剪辑；未做脚底与循环修正的源数据
…/RockBall_Attack.fbx	2026-10-20：同角色12骨专用UniMate Attack原始源动作，已替换旧19骨；任务 aigame_attack_40bc28cae3d24ad0bd737fae1eb6aafc
…/RockBall_Animator.controller	三动作Generic，默认Idle；Motion=0/1、Attack Trigger，支持Idle/Walk进入Attack并恢复请求状态，Root Motion关闭；正式入口 Tools/enemy_character_pipeline.py
…/Clips/Walk.anim	2026-10-20：UniMate原始Walk＋离线根骨绑定姿态校准、脚底贴地、周期接缝与短腿交替步幅编辑；1.1秒循环，步幅0.06m、抬脚0.018m；最终播放资产
…/Clips/Idle.anim	新12骨源动作＋离线呼吸/参考姿态/贴地收尾；1.6秒循环，首尾一致
…/Clips/Attack.anim	新12骨源动作＋离线蓄力/冲撞/恢复编辑；1秒单次，0.45秒OnEnemyAttackImpact事件，首尾恢复Idle参考
Tools/output/rockball_dgx/walk_verified/motion/	本次UniMate原始GLB/FBX、带高模预览、motion.npy、请求记录及日志；明确双足英文提示词，face-right=bone_8、face-left=bone_10；任务 aigame_walk_89299832de714470b6ed70e5cc837880
Tools/generate_animal_walk.py	复用既有骨架生成单Walk；保留英文提示词与明确左右骨，独立远程辅助脚本，不改外部LLM3DGraphics源码
AIClient/AgentScripts/FinalizeAnimalWalk.cs	离线烘焙入口；可调strideMeters/liftMeters/cycleSeconds，最终保存.anim，无运行时反向旋转或程序拼动画
AIClient/AgentScripts/VerifyAnimalWalk.cs	核验静态形状、61帧蒙皮顶点、根骨倾角、左右脚步幅、循环接缝和Animator连续播放；报告 Tools/output/rockball_walk_audit/verification.txt
Tools/run_rockball_walk.ps1	单Walk可复现入口：默认使用缓存骨架/源动作，重做权重→Pipeline导入→Setup→Finalize→Verify并更新manifest；-Generate重新生成源动作，-BuildReview重建并排验收场景
Tools/enemy_character_pipeline.py / Config/Art/EnemyCharacters/RockBall.json	敌方三动作标准入口与样例配方；同rig来源哈希、蒙皮、Pipeline导入、离线收尾、整段QA、Enemy视觉Variant与并排场景
Tools/generate_enemy_motions.py	按配方顺序生成指定Idle/Walk/Attack，生成成功后封存源FBX哈希与回执；失败保留旧有效产物
AIClient/AgentScripts/FinalizeEnemyMotions.cs	根据配方将Idle与Attack源动作离线编辑为可交付.anim，保存循环、命中事件与恢复参考姿态
AIClient/AgentScripts/VerifyEnemyMotions.cs	三动作各121帧实际蒙皮、根姿态、脚底、步幅、接缝、事件、控制器和Play轮播验证
Tools/output/enemy_characters/RockBall/motions/{Idle,Attack}/	新UniMate源GLB/FBX、带高模预览GLB、motion.npy、任务日志/回执；同rig哈希62f41bc5…6ca6c0f，与Walk一致
Tools/output/enemy_characters/RockBall/{production_manifest.json,verification.txt,motion_processing.txt,walk_processing.txt}	三动作来源、哈希、配方、事件时刻、生产状态与验收报告；生成源＋离线编辑，不含运行时骨骼补丁

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

资源路径	用途与生成方式
Tools/output/companions/FireCat/motions/{Idle,Walk,Attack}/	DGXA UniMate同角色22骨源GLB/FBX、高模预览、npy、回执与日志；rig哈希62a50970…3bea一致。Idle/Walk使用CUDA，Attack首次CUDA内存不足后独立CPU任务成功，未中断其他模型服务。
AIClient/Assets/Bundles/Characters/Animal/FireCat/Anims/FireCat_{Idle,Walk,Attack}.fbx	Pipeline导入上述三段同rig原始动画；Generic、共享Avatar，保留来源，不直接作最终播放。
AIClient/Assets/Bundles/Characters/Animal/FireCat/Clips/Idle.anim	1.6秒循环，源动作8%＋离线轻呼吸/贴地/端点绑定姿态；最大形变约0.01596m，根倾角约1.85°。
AIClient/Assets/Bundles/Characters/Animal/FireCat/Clips/Walk.anim	1.1秒循环，全骨骼源首帧相对绑定校准、保留35%运动＋交替短步/贴地/周期闭合；解决源69.5°根倾斜和坐姿腿偏移，左右步幅约0.06248/0.04547m，根倾角约4.35°。
AIClient/Assets/Bundles/Characters/Animal/FireCat/Clips/Attack.anim	1.1秒非循环，源动作12%＋双爪75°抬起/小幅前伸的离线施法，0.55秒OnCompanionAttackImpact事件，恢复Idle绑定参考；根倾角约11.31°，视觉根位移<0.005m。火球/伤害未接入。
AIClient/Assets/Bundles/Characters/Animal/FireCat/FireCat_Animator.controller	默认Idle，Motion Int 0/1切换Idle/Walk，Attack Trigger单次施法后恢复请求状态；Root Motion关闭。实际Play三状态与根位置固定通过。事件接收器应位于Animator所在Model或由该处转发。
Tools/output/companions/FireCat/{production_manifest.json,verification.txt,play_verification.txt,walk_verification.txt,motion_processing.txt,walk_processing.txt}	完整来源与哈希、配方、出手时刻、三段各121帧蒙皮及状态切换、单Walk门禁和实际Play报告；完整入口已成功复现，status=validated。
Tools/character_animation_pipeline.py、Config/Art/Companions/FireCat.json	伙伴/敌方共享三动作入口与火喵正式配方，包含自身骨名、全骨骼Walk校准、尾部蒙皮修正、源动作幅度与施法参数；默认缓存，--generate显式推理，--generation-device cpu可选。