图片 → Pose v6.5：原地粘贴，支持三节腿 / Horse 四节腿

v6.5 原地应用与独立模块
独立入口 ImagePose.ms，原入口 PoseExtractor.ms 仍可用。
以应用前当前帧的CS质心为位置基准，X/Y始终保持不变，不再回到体型模式的位置。
默认勾选“保持高度”：Z也保持不变；若支撑不可达，保留高度并提示接地未完全满足。
取消勾选后只允许支撑求解调整Z；自动/腾空模式仍不自动改变高度。
删除地面偏移输入，不自动调整视图；“视图居中”“图片视角”仍可手动使用。
单独模块的宿主调用和依赖说明见 ImagePose_INTEGRATION.txt。

v6.4.1 修正
膝盖不再无界叠加体型预弯：以默认与角色的基准弯曲为分界，分别映射可用伸直和弯曲范围。
标准输入仍还原角色基准；默认体型保持默认动作；大预弯不会累加越过180度而反折。
图片腿部参考直接由关节点几何计算，不再借目标腿的原生 IK 求源动作。
四节腿使用整腿关键帧，并显式指定 HorseLink limb 写入；保留额外关节的体型角度。
锁骨的有限自由度由 Biped 投影，骨段方向偏差不得超过2度、旋转修正不得超过8度；超出仍报错。
投影目标和实际写入分别校验，并记录于 cs_pose_validation.txt，不将失败当作成功。
自动识别单个 Biped，无需改名。多个 Biped 时先选中目标角色的一根 CS 骨骼。
需要重新运行插件、重新计算旧图片结果；旧直驱脚本仍包含旧算法。

使用
在 Max 中运行本文件夹内的 ImagePose.ms，确认标题为 图片 → Pose v6.5 · 原地应用。
场景中准备好目标 CS 后，只需：打开图片 → 选择支撑方式 → 应用到角色 CS。
每次应用都会自动读取角色的体型模式，不要求手动进入体型模式或确认基准。
保留角色原有的驼背、屈膝等体态；不要为了使用插件而强行摆直角色。
换角色或修改体型后自动读取新数据；旧版结果需要重新打开图片计算一次。
出现“未通过验收”时表示本次应用失败，不能把脚底贴地当作姿势匹配成功。

原理
用 3ds Max 2018 默认 CS 的骨骼局部旋转作为参考，不在用户场景中创建参考骨架。
SAM 3D Body 提供图片身体姿态，先求默认参考下的动作，再迁移到目标角色。
MAXScript 行向量矩阵约定下，普通旋转关节：
目标局部姿态 = 目标体型局部旋转 × 默认CS局部旋转的逆 × 图片动作局部旋转。
之后按实际父子层级转换为世界旋转，使用 Biped API 写入。
不是欧拉角直接相减，也不是按比例拉长后强制覆盖原始体态。
角色骨长、宽度和原有局部位移保留；整体朝向与驼背等局部弯曲分开。
最后执行指定的脚底/骨盆支撑约束，因此接地可能进一步调整腿部和根节点。

Horse 四节下肢
自动识别 Thigh -> Calf -> HorseLink -> Foot，不需要开关或手动确认。
SAM 是人体模型，没有提供额外的 Horse 关节动作；该关节采用角色体型模式的弯曲。
将 Calf -> Foot 看作跨过 HorseLink 的虚拟小腿；从标准几何独立求解图片动作，再作有界体型映射。
脚部旋转通过 Biped 的关键帧机制写入；接地采用保持 Horse 弯曲的几何解，不拉长骨骼。
支撑目标超出腿长时调整身体高度；无法满足四节支撑或弯曲约束时明确报错。
修正接地目标迭代漂移，三节腿同步使用稳定的脚底目标求解。

已测范围
v6.4.1 使用 12125_guard.max 副本回归：4张缓存图片×5种支撑，共20组应用通过。
另验双脚、左脚、右脚、腾空、坐地的跨帧保持、重复应用、体型数据及名称/节点数保持。
三节/四节40组对照、12组脊柱与朝向/支撑测试，以及多角色明确选择测试通过。
本次为 Max 写入与重定向修复，SAM 推理模型和离线运行环境未变；不承诺任意极端关节姿态均可达。
默认体型、弯背且膝关节约35.46度的体型、加宽体型。
默认参考输入还原、反复换图、切换帧、体型数据不变、不增加辅助对象。
此前映射算法已测1/3/4/10段脊柱及左右单脚、双脚、腾空、坐地。
新版新增无标定记录的按钮应用、自动读取修改后体型、实际写入验收。
v6.3.1 的完整图片计算曾在禁止网络连接的测试进程中通过。
v6.4 在本机 ARM Windows / Max 2018 测试：40 组三节/四节对照，含修改角度及节长、
4 张缓存图片、默认中立参考、双脚/坐地、重复应用、切换帧与 Figure 数据保持。
另测 Horse 的 1/2/10 段脊柱、旋转朝向、不同身高/场景位置及左/右单脚、双脚、腾空，共12组。
中立参考还原误差小于0.00021场景单位；第二帧写入未改变第一帧；未增加辅助节点。
本机虚拟机无 NVIDIA CUDA，本次使用已有 SAM 数据，未重新验收新图片推理全流程。

限制
目前适用于 CS/Biped，自动识别根名称，骨骼后缀须保持标准命名；单段颈，三节或标准 Horse 四节下肢，1至10段脊柱。
Horse 支持指人体姿态到带动物腿的角色映射，不代表 SAM 能识别四足动物图片或四足步态。
任意自定义骨链、超过四节下肢、多段颈、CAT 骨架不在本次支持范围。
不处理手指，不包含胖角色蒙皮网格的自动穿插避让。
脚底接触使用 Biped 几何代理，不等同于任意鞋子/蒙皮网格的精确碰撞。
单张图片本身的遮挡、深度和透视歧义仍受 SAM 模型估计能力限制。
完整离线包自带运行所需的模型和依赖，不需要联网下载模型。
