[AI]剑焊在了胯上

0.12.0 时的状态说明，现用补丁版本见正文：

**截至 2026-09-09：**兵种 mod 为 0.12.0，已安装十四种墓园兵种。本文数字保留各次交付版本的含义；最新进展见黑暗骑士与骨龙动画。

**截至 2026-09-09：**兵种 mod 为 0.11.1，已安装十种墓园兵种。本文涉及的安装数字按各次交付版本注明；最近一次扩展见吸血鬼与蝙蝠形态。

2026-09-09 工具迁移： 后续代码在 h3-art-pipeline 维护，原 tools/creature-art/ 与 tools/town-art/ 对应新仓库的 creature-art/ 与 town-art/。本文的旧路径和 PR 链接保留作历史记录。迁移与复现说明。

2026-09-09 更新： 本文的图片、姿势和测量保留为当时试稿，不能视为当前游戏版本。后续替换见完整动画，当前八兵种安装状态见尸巫交付。

骷髅的剑有两个毛病，一个我修了三轮，另一个我差点没发现。

第一个：剑的长度

概念图那一步，我先要求"武器贴着腿垂下"——对绑骨友好。结果剑重建成一片薄皮， 侧视图里彻底消失。

改成"武器横向伸出、完全离开躯干"，剑进模型了，但变成一把跟身高差不多长的巨剑， 伸直手臂拎着，像根钓鱼竿。

第三版加上尺寸约束——“不超过身高一半、肘部弯曲、手在髋部附近”——才对。剪影重叠度 21% → 37%，宽高比 0.47（原版 0.52）。

每一轮修复都在制造下一个问题，因为我每次只约束了上一次出错的那一个维度。

第二个：剑根本不跟手走

姿势还是不对，我以为是手腕角度问题，就扫了五个手部旋转值。

五张图一模一样。

以为是扫描范围不够，换了组参数再扫——又是五张一模一样。

问题不在参数。查权重发现 RightHand 主导 3180 个顶点，看着没问题；但转 90° 之后 那堆顶点的质心只移动了 0.05 个单位——一把长剑绑在手上，转 90° 质心会扫过很大距离。 那 3180 个顶点是手骨本身。

按空间位置反查，剑绑在 Hips 上。

Meshy 的自动绑骨把整个网格当一个身体处理，武器被分配给了离它质心最近的骨头。而剑斜挎在 腿边，最近的就是髋部。手臂挥出去，剑留在原地——每一个攻击动画都是错的， 而且没有任何东西会报错：骨架是合法的，动画能播，只是剑不动。

按几何找，不按权重找

修法是在 Blender 里重新绑定，判据是几何而不是权重：手握住的那个连通分量—— 有顶点落在手关节 16 厘米内，并且延伸得最远的那个。手附近其他分量都是指骨， 指骨只有几厘米，而武器有小臂那么长。

骷髅网格有 906 个连通分量（每根骨头都是独立的），这个判据选出一个 474 顶点、 延伸 0.90 单位的分量——就是剑。

中间还踩了个坑：armature.data.bones[].head 和网格的世界坐标不在一个空间—— glTF 导入之后读它，手的位置在 23 个单位之外，什么都匹配不到。要用 pose bone 的矩阵。

教训

这两个 bug 有个共同点：症状看起来都像调参问题。剑太长像是提示词没写好，剑不动 像是角度没找对。前者确实是，后者不是——我为它扫了十个参数值，全是白扫的。

分辨方法其实很简单：同一个参数扫一遍，如果结果完全一样，那你调的根本不是这个东西。 我第一次看到五张一样的图时就该停下来，而不是换组参数再扫五张。

代码在 PR #10。