Soma Dynamics v1.0.3.10｜男性角色默认关闭与兼容性优化

Soma Dynamics v1.0.3.10

新增男性角色默认关闭，并合入外部 DynamicBone 骨骼保护与缺骨扫描优化。

男性角色默认关闭

• Defaults 面板新增「男性角色默认关闭 / Disable males by default」，默认开启。
• 男性套卡时关闭大腿、手臂、腹部、胸部和臀部，优先于卡片启用状态、会话记忆、Force enable 和全局部位开关；胸部覆盖所有服装及坐标状态。
• 可手动开启某个男性角色的部位。换装保留手动选择，重新载入角色卡恢复默认关闭。女性默认行为保持原样。
• 载入同名男性不会关闭另一个已手动启用的角色；数值调节继续保留会话记忆。
• 胸臀全部关闭时，恢复之前接管的原生参数，并跳过后续空接管及延迟重应用。

配置项：[Defaults] Disable male characters by default = true。

兼容性与扫描开销

• 与 BP 等外部 DynamicBone 重叠时，Soma 对受影响的同侧链让权，避免 Spring、Chain、清除形变和体型重采覆盖外部状态；未冲突部位继续运行。
• 骨骼发现改为索引缓存，普通复位复用索引。缺失或长期不活动的骨架最多后台重试三次，显式复位和角色重载可重新发现。
• 保留 1.0.3.8 的 Chain 低频回弹曲线与默认弹性调整。

安装

退出游戏和工作室，将 ZIP 中的 BepInEx 目录合并到游戏目录，保留自己的配置与 XML 预设。重新启动后，新配置项默认开启；需要时可在 Defaults 面板取消。

验证范围

• 正式控制器与求解器集成测试：25 个场景通过。
• 参数模型：1,178 条断言通过；现有性能源码和服装状态回归门禁通过。
• Release 构建：0 警告、0 错误。
• 本机工作室启动日志已确认加载 1.0.3.10，且 disableMales=True；发行构建与该构建的反编译源码及 IL 输出一致。

集成测试模拟 Unity/native 边界。扫描测试中的 1,200 → 9 次不等于实际 FPS 提升；#12 的原始 BP 视觉场景、#13 的整帧掉帧和具体男性角色卡效果仍欢迎实机反馈。

English summary: Male characters now load with all Soma parts disabled by default, with manual per-character opt-in preserved across outfit refreshes. Shared external DynamicBone chains are protected, and repeated skeleton discovery is bounded. Original reported visual/FPS scenarios still require in-game feedback.

Soma Dynamics v1.0.3.8

新版 Soma Dynamics 发布。

• 恢复低 JitterFreq 下 Chain 的可见回弹幅度。
• 提高默认 Thigh Chain 弹性基线。
• 常量计算移出粒子循环，不增加每帧粒子循环数量。
• 性能回归、服装状态回归、参数模型测试全部通过。
• Release 构建：0 警告、0 错误。

Soma Dynamics v1.0.3.7｜Maker underwear 预览腿部变形修复

1.0.3.6 → 1.0.3.7

本版本修复 Koikatu Maker 中反复点击 underwear 半脱预览后，角色腿部逐渐变成罗圈腿的问题。

外部姿态重采

• ChaControl.SetClothesState 现在会通知启用的 Spring/Chain 部件进入外部形体重采流程。
• 先撤销 Soma 自身的上一轮输出，等待服装刷新后的骨架稳定，再将新姿态采为休止基准。
• 原生胸臀 DynamicBone 重应用延后到重采窗口之后，避免服装预览与全身物理状态互相污染。

验证

• 服装状态回归门禁通过。
• 参数与安全回归测试：1166 assertions 通过。
• Release 构建：0 warnings / 0 errors。

安装

关闭 Koikatu 与 CharaStudio，将压缩包内的 BepInEx 文件夹合并到游戏根目录。配置文件、角色卡数据与现有预设均会保留。

SHA256：536ad9e6f139fb6cd61aee73450e80d0a8a12bdca172571b6e748895d97b8d50

Soma Dynamics v1.0.3.6｜PushUp 联动与面条腹部修复

1.0.3.5 → 1.0.3.6

本版本集中修复 PushUp 胸托滑条错误影响手臂、小腹，以及 Studio 中腹部逐渐拉长成“面条”的问题。

PushUp / 胸托

• 修正 1.0.3.5 的桥接时机：PushUp 写入胸型前，Soma 会先撤销自己当前的大腿、手臂和腹部偏移。
• 等游戏真正完成体型刷新并连续稳定两帧后，才重新采样休止基准并恢复物理。
• 延迟的胸部与服装刷新现在只重套原生胸臀 DynamicBone，不再调用全身 ApplyFlesh。
• PushUp 的 Lift、Push Together、Squeeze 等滑条不应再把效果错误传到手臂和小腹。

腹部安全保护

• 腹部单粒子 Chain 的休止基准累计偏移限制为 0.020 m。
• 腹部最终可见局部位移限制为 0.045 m。
• 内置高预设理论正常峰值为 0.04455 m，仍完整保留，不会因为安全保护失去效果。
• 即使 ABMX、NodesConstraints、Timeline 或其他插件在 Soma 后持续写入微小位移，也不能再无限累计成面条状。

验证

• 1166 项参数与安全回归测试通过。
• Release 构建：0 warnings / 0 errors。
• 已反查成品 DLL，确认包含 PushUp 前置暂停、延迟重采和腹部双重安全函数。

安装

关闭 Koikatu 与 CharaStudio，将压缩包内的 BepInEx 文件夹合并到游戏根目录。配置文件、角色卡数据与现有预设均会保留。

SHA256：621cd7896eb0bf781466a793c66c7234970bbd29391ecafe94dddea9e65a9d8e

Soma Dynamics v1.0.3.5｜v1.0.2.7 以来累计更新

升级范围：v1.0.2.7 → v1.0.3.5

这是一次累计发布，包含 v1.0.2.7 之后的全部 Soma Dynamics 更新。v1.0.3.2–v1.0.3.4 的修正均已合并进本最终包。

新增功能

• XML 预设一键保存、载入，并可设为新角色默认预设。
• 大腿、手臂、腹部、胸部、臀部独立默认启用开关，可选择是否覆盖所有角色。
• Timeline 安全弹簧支持关闭、手动、自动检测和自定义快捷键。
• 自由 H 场景自动将相关部位临时切换到 Spring，退出后恢复原求解模式。
• 面板新增“一键全部弹簧 / 一键全部链式”。

内置“高”档更新

• “高”档现在精确采用 MyPreset1.xml 的五部位参数，不再使用简单倍率。
• 同时采用 Spring/Chain、逐骨 Amp、轴向值，以及胸部 0.95 / 0.90 / 0.78、臀部 1.20 / 1.20 / 0.75。
• 应用时保留角色当前启用状态和 Spring/Chain 模式。
• 安装包不会覆盖用户已有的 Presets 目录或 MyPreset1.xml。

稳定性与性能

• 修复 Force enable 覆盖默认部位开关。
• 修复 Spring 旋转采纳和自由 H 中的肢体扭曲。
• 修复 v1.0.3.1 自由 H 兜底每帧扫描全场景造成的严重掉帧；现在只在场景加载或切换后扫描一次并缓存。

PushUp / BPC 最终修复

经反编译 BPC、PushUp 1.5.2 与游戏本体确认：PushUp 会依次写入 4–13 号胸型参数；BPC 在左右胸 DynamicBone 参数写完后执行 ReSetupDynamicBoneBust(0)。旧 Soma 迁移漏掉了这一步，并曾在 PushUp 尚未写完胸型时重套物理，因此胸部会被旧基准拉回，而手臂、小腹发生形变。

v1.0.3.5 已：

• 恢复 BPC 的 BustSoft/BustGravity ReCalc 防覆盖顺序。
• 左右胸参数写完后统一提交并刷新原生胸链基准。
• 在 PushUp 完整写完 4–13 号胸型后只刷新胸部。
• 不再因 PushUp 滑条事件重套大腿、手臂或腹部。
• 实机确认 Lift、Push Together、Squeeze 均重新作用于胸部，且不再拉动手臂和小腹。

安装

将压缩包内的 BepInEx 目录合并到 Koikatu / Koikatsu Party 游戏目录。可直接覆盖旧 DLL；用户配置、角色卡数据和 Presets 不会被删除。

验证

• 1162 项参数模型断言通过。
• Release 构建：0 warnings / 0 errors。
• ZIP SHA256：95f886bbcd5b371c6e420a8a1f94c1e2b00519cd8bff17a7f957913f04de4383

Soma Dynamics v1.0.3.1

Soma Dynamics v1.0.3.1

• 修复「默认值 Defaults」被 Force enable 覆盖、点了不生效的问题;面板改动立即生效
• 中档(Natural)大腿 Thigh02 Amp 封顶 0.50
• 弹簧模式旋转所有权:动画/其他插件写入旋转时采纳为新基准,不再硬拽回卡片姿态
• 检测到自由H场景(含 MyRoom 内的 H)自动将大腿/手臂/腹部切到弹簧,退出自动恢复
• 面板「全身控制」新增一键【全部弹簧 / 全部链式】
• 构建管线改为强制清空重建,杜绝旧 DLL 误发

卡数据格式不变(v61),直接覆盖升级。

Soma Dynamics v1.0.3.0

Soma Dynamics v1.0.3.0

用户反馈三项改进:

• 预设一键化:面板【保存当前设置 Save】直接写入预设、【应用所选 Apply】一键套用;【设为默认】后所有无卡数据的角色加载时自动应用该预设,多角色共用一套参数只需调一次。
• 五部位默认启用开关(大腿/手臂/腹部/胸部/臀部)+「应用到所有角色」全局覆盖;腹部偏瘦可全局默认关闭。
• Timeline 兼容三档:关闭 / 手动(全部角色)/ 自动(仅 Timeline 实际驱动的 NodesConstraints 角色);新增自定义快捷键(F1 插件列表可设),播放中一键翻转。

卡数据格式不变(v61),直接覆盖升级即可。完整说明见 README。

Soma Dynamics v1.0.2.7

Soma Dynamics v1.0.2.7

• 面板新增「播放 Timeline 时 Chain 临时切换为弹簧」兼容开关(默认关闭):遇到特定 Timeline 一播放就让四肢扭曲时可按场景开启,播放期间 Chain 临时使用 Spring,暂停/停止自动恢复,不改写角色卡或 XML 保存的模式。
• 切换进出兼容状态时先撤销 Soma 上一帧的 Chain 形变并重新捕获基准,避免模式交接留下旧旋转、速度或永久形变;面板实时显示待命/临时 Spring 状态。

安装见 README 与 USER_GUIDE。

Soma Dynamics 1.0.2.4｜Timeline 大位移形变修复

重点修复：Timeline 大位移不再拉坏小腿和手臂

Soma Dynamics 1.0.2.4 修复 Timeline 直接移动或旋转整个角色时，Chain 把瞬移误当成物理惯性输入的问题。

• 新增 Chain 锚点世界空间跳变检测。
• 单帧世界位移超过 8 cm 或旋转超过 35° 时，整链在当前位置安全重锚一帧。
• 瞬移速度不会进入 Verlet 解算，小腿和手臂不再被大幅拉伸或扭曲。
• 下一帧立即恢复正常 Chain 弹性与惯性，不会持续关闭物理。
• 连续小幅 Timeline 运动仍作为实时基准，保留原有物理效果。
• 实机使用原问题场景复测，用户已确认修复。

从 1.0 到 1.0.2.4 修复了什么

1.0.0.0｜统一正式版

• 统一管理大腿、手臂、腹部、胸部和臀部。
• 胸臀改为安全接管游戏原生 DynamicBone 碰撞链，保留服装与碰撞效果。
• 移除胸臀实验性独立 Spring，避免双重解算、碰撞后持续抖动和无效参数。
• 保留旧 GUID、DLL 路径、角色卡及 XML 兼容。

1.0.1.0｜Studio 换角色与换动作

• 换角色、换服装、切换或重播动作时自动重置 Soma 运行状态。
• 降低每次操作后手动 Restore Pose 的需要。
• 关闭诊断时移除无意义的指标采样开销。

1.0.2.0｜保留 Timeline 姿势

• 场景载入和动作切换时不再强制恢复角色卡初始姿势。
• 当前 Timeline/Animator 姿势稳定后自动成为 Chain 新基准。
• 修复首粒子没有识别外部旋转、继续使用旧 RC 基准造成的大腿扭曲。

1.0.2.1｜场景事件与手臂自转

• 接入 KKAPI Studio 场景 Load、Import、Clear 完成事件。
• Timeline 场景载入不再依赖普通动画切换事件。
• 外部骨骼写入后整条 Chain 原位清除旧速度和 RC 目标。
• 修复 Timeline 控制骨骼时手臂持续自动旋转。

1.0.2.2｜静止慢慢变形

• 每帧求解前剥离 Soma 自己上一帧写入的位移和旋转。
• 在未形变骨架上重新计算 Chain，切断父骨 RC/位移进入子骨基准的反馈循环。
• 修复 Timeline 暂停或人物静止时，大腿仍逐渐变形。
• Spring/Chain 热切换时重建运行状态，避免复用上一模式的残余速度。

1.0.2.3｜恢复播放中的物理

• Timeline 连续关键帧成为实时 Chain 基准。
• Soma 在 Timeline 姿势上继续叠加 Chain 位移与 RC 物理。
• 修复为阻止变形而导致播放时物理效果全部消失的回归。
• 只有真实姿势跳变才整链清零一帧，连续动作不再被永久让权。

1.0.2.4｜角色整体瞬移保护

• 将跳变检测从形体骨局部坐标扩展到 Chain 锚点世界坐标。
• 修复 Timeline 大幅移动角色时小腿、手臂严重拉伸和扭曲。
• 新增 SOMA_CHAIN_TELEPORT 诊断日志，记录距离、角度和重锚动作。

验证

• 参数与求解器回归：1108 项断言通过。
• Release 构建：0 警告、0 错误。
• 实机 Timeline 大位移复测：通过。

下载说明：

• SomaDynamics_1.0.2.4.zip：仅 Soma Dynamics。
• SomaDynamics_1.0.2.4-with-MMD-Stabilizer-v1.2.1.zip：Soma 与 MMD 稳定器组合包。

Soma Dynamics 1.0.2.3｜Timeline 形变修复并保留 Chain 物理

重点修复

解决 Timeline 与 Soma Chain 同时写骨骼时的大腿扭曲、静止慢慢变形和手臂自动旋转。

• Timeline 播放时不再通过关闭 Chain 来回避形变，弹性与惯性物理完整保留。
• 换角色、切动作、载入/导入/清空场景及 Spring/Chain 切换时自动重建物理基准。
• 每帧使用 Timeline 当前姿势作为基准，再叠加 Soma Chain 输出，阻止上一帧结果反复反馈。
• 只有超过 8 cm 或 35° 的真实跳变才整链重置一帧。
• 实机验证：静止不变形、播放有物理，用户已确认解决。

包含独立 Soma 安装包，以及带 MMD Stabilizer 1.2.1 的组合包。