用途：用于 Three.js 游戏，把基础几何体（BoxGeometry、SphereGeometry 等）替换为真实 3D 模型。角色可用 Meshy AI 生成并绑定骨骼与动画，世界物体可生成或从免费素材库获取。
主要能力：分析游戏代码定位使用几何体的实体，识别玩家角色；为角色生成模型、绑定骨骼并制作 Idle/Walk/Run 动画；为树木、房屋、木桶、金币等世界物体生成或下载模型；使用 SkeletonUtils.clone() 与 AnimationMixer、fadeToAction() 完成动画交叉淡入；接入 OrbitControls 第三人称相机并实现相机相对的 WASD 移动；通过 preloadAll() 预加载模型。
使用方式：运行 /add-3d-assets <游戏路径>，未提供路径时使用当前目录。先加载 game-3d-assets 和 meshyai 技能。检查 .env 中的 MESHY_API_KEY（test -f .env && grep -q '^MESHY_API_KEY=.' .env && echo "found"；存在则 set -a; . .env; set +a），未设置时按提示获取密钥或输入 skip 回退到免费素材库。之后依次审计 package.json、src/core/Constants.js、实体文件与 LevelBuilder.js，规划实体，生成或下载模型，创建 AssetLoader.js，更新 Constants.js、Player.js、Game.js，最后调优并运行 npm run dev 和 npm run build 验证。Meshy 生成命令示例：MESHY_API_KEY=<key> node <plugin-root>/scripts/meshy-generate.mjs --mode text-to-3d --prompt "..." --polycount 15000 --pbr --output public/assets/models/ --slug player；骨骼绑定用 --mode rig --task-id <refine-task-id> --height 1.7。
回退角色库：Soldier（Idle/Walk/Run）、Xbot、RobotExpressive、Fox（scale 0.02）。世界物体可搜索 Poly Haven、Sketchfab。
限制与注意：这是 Three.js 专用，Phaser 2D 游戏应使用 /add-assets；动画模型必须用 SkeletonUtils.clone()，否则骨骼失效变 T-pose；不同模型朝向不同，需设置 facingOffset；meshopt 压缩的 GLB 需加载 MeshoptDecoder；绑定失败通常因模型几何不适合自动绑定。收费与定价信息暂未提供。