D-20260609-01|接觸係數合成=Average 全域不變式¶
背景與驅動力¶
材質表逐項 review 撈出的結構洞:既有規範只講單一 part 內多材質如何取值,兩個 body 相撞時雙方 friction/restitution 如何合成全 corpus 未規範。合成規則若依引擎預設浮動、或允許 per-collider 覆寫,各 peer 可能得到不同接觸結果——這是共識層看不見的潛在 desync 源。
考慮過的選項¶
(流水帳未記錄替代方案;本決策以補洞形式成立——直接定死引擎合成規則並禁止覆寫。)
決定¶
- inter-body friction/restitution 合成一律採 Rapier
CoefficientCombineRule::Average。 - 資產禁止 per-collider 覆寫 combine rule;每 collider 仍依實際材質攜帶係數。逐 collider
材質與 tire/roller restitution
Min例外由 D-20260811-04 修訂。 - 列為跨 peer 決定性不變式:變更此規則走 版本規範.md 的 major 流程。
後果與影響¶
物理決定性自介面層(D-20260524-03)延伸到參數合成層:材質參數表加上合成規則,兩車接觸行為才真正跨 peer 可重現。同輪順修 K_TIRE 常數大小寫與早期設計代號殘留,屬例行清理。