先说最容易踩的坑：这个插件本身不含 AI 模型，也不含 PyTorch。装上后你得到的是一个「自动安装器 + 桥接面板」。点一下 Install Kimodo (Auto)，它会自己在 ~/.kimodo-venv/ 建一个独立虚拟环境，下载安装 PyTorch + Kimodo 模型权重 + LLM2Vec 文本编码器，合计约 10 GB。所以：第一次装必须联网且留足 10 GB 磁盘；装完之后完全离线可用（插件自动设好 TRANSFORMERS_OFFLINE=1 与 HF_DATASETS_OFFLINE=1）；必须有 NVIDIA 显卡，8 GB 显存起步、16 GB 以上效果最好；macOS 不支持（因为要 CUDA）。
它解决什么问题？Kimodo 是 NVIDIA 出的文本驱动人体动作模型，能力很强，但官方用法是：在终端跑 Python 脚本 → 存成 BVH → 回 Blender 手动导入 → 想改一句提示词就得重来一遍。作者 Lewdineer 把这整条流水线压进了 Blender 的一个 N 面板：输入提示词 → 点生成 → 动作直接落到场景里的骨架（骨架上已经有烘焙好的关键帧）。模型只在启动时加载一次并常驻，所以反复迭代的速度只取决于你的显卡。
它不只是「打一句话出动作」，控制部分做得意外地硬。多数文生动作工具的死穴是「没法指挥」——你只能反复重掷骰子直到碰巧对。这些插件给了你四层约束：根节点 XZ 路径点（在指定帧指定地面位置）、随手画一条贝塞尔/NURBS 曲线然后一键采样成路径点（角色就沿着你画的路走，而不是永远朝 +Y）、手与脚的末端目标、全身姿势约束（摆一个参考骨架当精确关键帧）。还有一个 Auto-Origin，自动把所有约束位置平移到 Kimodo 的世界原点——所以你可以在场景任何地方做约束，不用管绝对坐标。
免费开源，作者原话很实在：「我免费分享这个插件，因为它几乎 100% 依赖 NVIDIA 在 Kimodo 上的工作。所以我源码也放在 GitHub 上，欢迎提交 PR 或自己 fork。」Superhive 上定价 $0，另有 $5 / $10 的赞助版（多送一个绑定好的 SOMA 骨架）。★ 版本说明：包内 blender_manifest.toml 实测 version = "1.5.5"，与官方版本历史顶部一致；psdly 页面标的是 V1.5.7，以包内为准。本站此前未收录，本次为新增。
一、一键安装：不用碰终端（这是它最大的工程价值）
官方原文强调 no terminal required。点 Install Kimodo (Auto) 之后它自动做完这些事：
· 在 ~/.kimodo-venv/ 建独立 Python 虚拟环境（v1.5.4 起位置可以自己选，会记进偏好设置，Retry Install 时复用不再问）
· 装 PyTorch，自动选对 CUDA 版本：默认 12.1；Python 3.13 用 12.4；Blackwell / RTX 50 系用 12.8。预编译 wheel，Windows 上不需要 C++ 编译工具链
· 装 Kimodo 本体与依赖（用的是 Aero-Ex 的离线分支 kimodo）
· 下载 LLM2Vec 文本编码器并打补丁改成离线加载
· 全程在 Connection 面板有实时进度，不用盯控制台
失败可以点 Retry Install 清空重来，也可以点 Delete Venv 整个删掉，不会在 Blender 里留垃圾。
二、打一句话，出一个动作
Quick Generate：输提示词、设时长、点生成。官方给的两个例子很能说明它的定位——「a person jogs in a circle」（一个人绕圈慢跑）、「someone picks up a heavy box and sets it down」（某人搬起一个重箱子放下）。
结果会落到场景里一个叫 Kimodo_Source 的骨架上，动画已经烘焙进去。想用自己的骨架？用吸管点一下任意骨架即可，或者让它自动抓最近生成的那个。没有导入弹窗、没有中间文件——官方原话 no file imports, no intermediary steps。
三、Motion Segments：像播放列表一样串多个动作
这是它比「单次生成」强一个档的地方。打开 Motion Segments，加任意多段提示词，每段给一个帧范围（开始帧会自动接上一段的结束帧，拖一个结束帧下一段开始就跟着变），然后点 Generate Motion。Kimodo 在一次模型调用里把所有段平滑过渡地生成出来，得到一条连贯的整体时间线。
Transition Frames 控制段与段之间交叉淡化的锐度——调大更柔和，调小更干脆。每段在时间线上有独立颜色方便对照，可以单独开关而不删除，可复制、可上下移动排序。
四、变体与历史：不用重掷骰子
Generate N Variations：同一提示词一次生成 2–5 个随机种子的版本，每个各占一个骨架，直接横向挑。
History 记录最近 20 次生成（提示词、种子、时长、时间戳），任何一次都能一键 Re-import 重新导回来——以前想要回上一次那个「还行但没存」的版本只能重新随机，现在翻记录就行。
五、空间约束：四层控制（包内 21 KB 的 constraints.py）
1) Root XZ Waypoints——在指定帧给地面平面位置。
2) Curve-Path Following——画一条贝塞尔或 NURBS 曲线，在面板里选中它、选要采多少点，点 Sample N Waypoints，插件沿曲线等弧长撒下根位置点铺满你的帧范围。v1.5.4 起每个路径点的朝向也跟着曲线切线走，所以角色是真的沿路走，不再永远朝 +Y；视口里的小箭头空物体能直接看出朝向。
3) Hand & Foot End-Effectors——手腕与脚跟/脚掌的目标位置。
4) Full-Body Pose Constraints——摆一个参考骨架，作为一个精确的全身姿势关键帧约束。
Auto-Origin：自动把所有约束位置整体平移，让最早的那个路径点落在 Kimodo 的世界原点。官方说法是 constrain anywhere in your scene and let the Auto-Origin toggle handle the rest——你在场景里怎么摆都行，坐标换算它做。
六、重定向：三种模式，能存能导出
在 Retarget 面板把 Source 设为 Kimodo_Source、Target 设成你的角色骨架，点 Auto-Match Bones，模糊匹配器会把 Kimodo 的骨架映射到你的骨架上（开箱即认 Mixamo 与大多数标准双足命名）。然后逐根检查、单独开关。
每根骨头可选三种模式：
· Child Of（默认）——完整父子关系，对大多数全身骨架整体效果最好
· Copy Rotation——局部空间旋转复制，标准双足骨架首选
· Copy Transforms——位移+旋转+缩放，处理骨长不一致的情况
点 Apply Constraints 再点 Bake & Remove Constraints，得到干净的、自带关键帧的独立动画，约束全部拆掉。骨骼映射可以存成预设，也能导出成 JSON 发给同事或跨项目复用。
七、七条省时间的细节
1) 常驻桥接进程——模型只加载一次，之后每次生成都复用，没有冷启动。
2) Blender 全程可操作——生成在后台线程跑，转视口、改材质都不卡。
3) 30 FPS 检查——Kimodo 固定输出 30 FPS，检测到与场景帧率不符会提示，附一键 Set to 30 FPS。
4) 内置帮助面板——从安装到出片的完整步骤清单就在 N 面板里，不用翻文档。
5) 完全离线——装完就能断网生成。
6) GPU 检测只跑一次——v1.5.2 起不再在每次视口重绘时调 nvidia-smi（以前会把 Linux 拖卡、Windows 上每次重绘闪一个控制台窗口）。
7) 官方附完整视频教程——从安装到烘焙动画全流程：https://youtu.be/nbiaS43Ncng
八、包内实测：15 个文件、51 个算子、6 个面板
纯 Python，无模型、无二进制——所以整包只有 268,807 B。按字节排：
operators.py 81,589 · setup_operator.py 39,077（自动安装器，建 venv／装 PyTorch／下权重都在这里）· panels.py 31,280 · constraints.py 21,764 · properties.py 18,663 · CHANGELOG.md 16,878 · subprocess_client.py 16,538 · retarget.py 14,896 · bridge_server.py 12,448（跑在 Kimodo venv 里的服务端）· README.md 9,522 · ui_list.py 3,616 · __init__.py 1,897 · blender_manifest.toml 427 · timeline.py 183
实测 51 个 bl_idname 算子（全部 kimodo. 前缀），覆盖安装/启停桥接、生成、变体、分段增删与排序、约束增删与跳帧、曲线采样、重定向匹配/应用/烘焙/清理、预设存读导出、历史回导、30FPS 修正等全流程。
6 个面板：KIMODO_PT_Connection（环境与桥接）、KIMODO_PT_Generate（生成）、KIMODO_PT_Segments（多段）、KIMODO_PT_Constraints（约束）、KIMODO_PT_Retarget（重定向）、KIMODO_PT_Help（内置帮助）。
双进程架构值得说一句：Blender 内置的 Python 加载不了 PyTorch 与 Kimodo，所以作者做了桥接——subprocess_client.py 跑在 Blender 里，通过 stdin/stdout 跟 bridge_server.py 通信，后者跑在装了 Kimodo 的独立 venv 里、模型加载一次后常驻。这就是为什么生成时 Blender 不卡。
九、v1.5.5 修的三件事（官方 changelog 意译）
1) Blender 4.x 上第二次生成后动画停止播放。4.4 引入了「slotted Actions」——对象的 animation_data 必须绑定到具体的 Action slot 关键帧才会播放。而每次 BVH 导入产生的 Action 其 slot 名字是随机的，第二次生成交换 Action 时 Blender 匹配不上旧 slot 标识，结果没绑定任何 slot，骨架就静止了。现在给每个 Action slot 一个固定名字并在转移时显式绑定；4.4 之前的版本仍走原来的赋值方式。
2) 反复导入会堆积重复的 Action 与骨架数据。以前每次重导（从历史重新导入、重复生成）都会把上一个 Action 与临时导入骨架的数据块留成孤儿，.blend 里越堆越多 Action.001、Kimodo_Source.001、.002…现在没人引用时会清掉。
3) 删约束删错了行。约束上的 X 按钮以前删的总是「当前选中行」（通常就是第一行），不是被点的那一行，因为它依赖列表的选中索引。现在每个 X 传自己的行号。
十、几条实操建议（作者 README 里的干货）
显存不够怎么办：在激活了 Kimodo venv 的终端里跑 kimodo_textencoder --device cpu，把文本编码器挪到 CPU，能省下几个 GB 显存——这是官方给的唯一低显存方案。
重定向看起来不对：先确认骨架已经应用缩放（CTRL+A → Scale），再试 per-bone 的三种模式——前面说过 Child Of 适合大多数全身骨架，骨长不一致用 Copy Transforms，标准双足用 Copy Rotation。还可以用开关逐根排查问题骨。
时间不对：先确认场景帧率是 30 FPS，面板会提示并给一键修正。
桥接起不来：检查 Connection 面板里 Python 路径是否指向正确的 venv；已装过就点 Use Installed Kimodo 直接用，不必重装。
装失败：点 Retry Install 清空重来；要彻底干净用 Delete Venv。完整日志在 Blender 系统控制台。
⚠ 版本说明：包内 blender_manifest.toml 实测 id = "kimodo_blender_bridge"、version = "1.5.5"、blender_version_min = "4.2.0"、tagline = "Generate human motion with NVIDIA Kimodo AI"、维护者 Lewdineer、许可 SPDX:GPL-2.0-or-later、标签 Animation。与官方 CHANGELOG 顶部 1.5.5（2026-06-24）一致；psdly 条目写的是 V1.5.7，与包内不符，以包内为准。本站此前未收录本插件，本次为新增。
包内文件（逐字节实测）：解压 15 个文件 / 268,807 B（纯 Python，无模型权重、无二进制）；本站目录 18 个文件 / 498,369 B = 上述 15 个 268,807 B + 原始 rar 75,543 B + 封面 144,315 B + 中文说明 9,704 B。远端已按 18 文件 / 498,369 B 逐字节核对，与本机完全一致。未改动原始包内任何文件。
官方元数据：Superhive 上作者 Lewdineer（分类 Rigging），定价 $0（免费），另有 $5 与 $10 的赞助版多送一个绑定好的 SOMA 骨架；销量 70+、下载 1600+、7 条评分、上架 5 个月；Blender Version 4.2 – 5.1、Extension Compatible 是、License GPL。官方明确写 macOS 不支持（NVIDIA CUDA 要求），Windows 与 Linux 可用。
为什么这个包值得收：Kimodo 是 NVIDIA 官方开源模型（github.com/nv-tlabs/kimodo），但官方只给你命令行与 BVH。这个插件的价值全在「工程封装」——把环境安装、模型常驻、BVH 导入、约束、重定向、预设这一整条链子做进了一个面板，而且作者把源码也开源了（github.com/lewdineer/Kimodo_Blender_Bridge）。对本机没有 NVIDIA 显卡的人来说它没用——这点必须先看清再下载。
示例提示词（官方给的，可直接照抄试）：「a person jogs in a circle」、「someone picks up a heavy box and sets it down」。官方教程视频：https://youtu.be/nbiaS43Ncng（全流程），另有「Full-Body Constraints」专题视频。
原产品页：https://superhivemarket.com/products/kimodoblenderbridge
封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。
暂无评论内容