SuperAPI AI 工具集

octocode-mannequin

通用与其它

查看项目

更新于 10-15 17:26

技能介绍

用途:用于摆姿势、制作动画或讲解 3D 人体骨架/人偶,涵盖解剖学关节、ROM 钳制、走/跑/舞/后空翻序列、Three.js 查看器,以及智能体实时驱动。

主要能力:提供解剖学命名的 22 骨骼人形骨架(手臂下垂中立位、左右镜像),运动协议会把每个关节钳制到真实活动度,并带根节点 6 自由度通道(平移/俯仰/偏航/翻滚)用于位移、转身、跳跃和后空翻。流程为 SCHEME → COMMAND → CLAMP+FK → RENDER → DRIVE。

使用方式:先运行 node scripts/skeleton.mjs scheme 查看骨骼与关节自由度/ROM/动作;用 references/movement-protocol.md 编写姿势命令,运行 node scripts/skeleton.mjs pose --cmd '...' 并查看警告/钳制结果;用 skeleton.mjs sequence --file frames.json 验证动画。渲染时运行 node scripts/skeleton.mjs viewer --out <file>.html [--pose pose.json],打开后可拖动滑块或在控制台调用 window.applyPose/window.playSequence,现成动画在 assets/(run-cycle.json、backflip.json、dance.json、idle.json)。智能体实时驱动需加载 references/webmcp-agent.md,并通过 CDP 提供查看器的 WebMCP 工具,共 11 个工具,含任务空间 reach 和 look_at。

限制:scripts/skeleton.mjs 是骨骼/关节/ROM/动作的唯一事实来源,查看器重新实现了钳制/sideSign/FK 数学,任何改动必须同时改两处并重新验证。运动命令必须使用该关节有效的解剖学名称,不能使用原始带符号角度或允许列表之外的动作。ROM 值应视为骨架默认值而非医学事实。写查看器文件会覆盖该路径,智能体驱动需要新的非无头 Chrome 和新端口,首次写入或启动浏览器前需确认输出路径并获得用户同意。不适用于通用 3D 场景搭建、物理/布娃娃模拟、IK 脚部锁定、平衡、碰撞或动作捕捉导入;运动是关键帧运动学,后空翻是编排而非模拟。