歷史記錄 · 2026-06-09¶
重大重構里程碑¶
2026-06-09 ─ 建模參數表逐項 review（場地 AABB 50× 修正 + 密度比/質量比拆兩約束 + output_w 改名收尾）¶
背景：spec 逐檔複審第 2 檔。跨 corpus 核對撈出 5 類問題 + 1 張 stale 圖（後者列待辦不盲改）：
| 項 | 變動 | 範圍 |
|---|---|---|
| ⭐ 場地 AABB 差 50× | 程式參數表 TRACK_AABB_MAX_MM [10000,10000,5000](10×10×5m) → [500000,500000,100000](500×500×100m)；權威值是 stale 孤兒、與 5 檔 + 設計 rationale 矛盾 |
程式參數表 §3 |
| ⭐ 50:1 拆兩約束 | 確認本是兩種：①單一零件內多材質密度比 ②整車零件質量比。VEHICLE_DENSITY_RATIO_MAX（名掛 VEHICLE 實為 per-part、會撞名）→ 改名 PART_MATERIAL_DENSITY_RATIO_MAX；新增 VEHICLE_PART_MASS_RATIO_MAX（原本無權威常數）；建模 §7.1 / 車輛組裝 §3.4 / 編輯器 措辭分流 |
程式參數表 §3 + 建模 §7.1 + 車輛組裝 + 編輯器操作 |
| output_w 改名收尾 | 2026-05-24「只保留 declared_output_w」只改了欄位定義、~12 處技能能量公式仍用 battery.output_w → 全改 battery.declared_output_w |
算式表/遊戲機制/材質表/建模/車輛組裝/零件/physics-engine/其他（8 檔） |
| 5 個 K 常數進權威 + 大寫 | K_MOTOR_INPUT(80)/K_BATTERY_OUTPUT(80)/K_BATTERY_CAPACITY(50)/K_STRESS_BURST_FACTOR(1.5)/K_THERMAL(TBD) 補進 程式參數表 §18；引用全大寫正規化（原小寫違反「K 常數大寫」慣例、同上輪 K_tire）；K_THERMAL 原為斷指標（其他/算式表指向程式參數表但其實不在） |
程式參數表 §18 + 建模/編輯器/零件/算式表 |
| passive 武器 kinetic_ratio | 確認：佔 §3.6「總 ≤ 100%」預算（目前白佔、確定的設計取捨；未來被動加持沿用此預留值、免重上鏈） | 建模 §3.7 |
| Axis 軸向速查 | §5 加 +Z（Axis 武器/launch/magnet-N）vs −Z（RoutePoint/conveyor forward）慣例速查；刻意不統一 | 建模 §5 |
待辦（未動）：程式架構/程式流程/ugc-fork.md「5 組指紋對照」mermaid 圖多欄位 stale（gear_ratio / motion_type / motion_params / tread_type 皆已廢）→ 需對現行 fork 指紋規格整張重對，不盲改。（已於 2026-06-11 完成，見上條）
2026-06-09 ─ 材質表逐項 review（補 inter-body 摩擦/restitution 決定性不變式）¶
決策檔：D-20260609-01
背景：開始 spec 逐檔複審，首檔材質表。跨 corpus 核對後整體一致（31 計數 / K 常數 / magnet_source_strength_n 0–10 / deploy_behavior 5-set / magnetism_role schema / 章節引用 / 版本規範雙 bump / auto_thermal_limit 全對）；產出 3 項修正：
| 項 | 變動 | 位置 |
|---|---|---|
| ⭐ inter-body 接觸係數合成（新不變式） | 兩 body 相撞時 friction/restitution 由 Rapier CoefficientCombineRule::Average 合成、全 collider 禁 per-collider 覆寫 → 跨 peer 決定性不變式（變更走 §11 major）。原 §7 只規範單一 part 內多材質取值、未規範雙方合成 = 潛在 desync；權威落 材質表 §7、physics-engine §8 加 drift-safe 指標 |
材質表 §7 / physics-engine §8 |
| K 常數大小寫 | §9 K_tire → K_TIRE（其餘 5 處引用皆大寫，對齊權威程式參數表 §18） |
材質表 §9 |
| 去殘留術語 | §2 注 1「方案 D fallback」→「fallback」（方案 D 是早期設計代號、canon 未定義；廢棄資訊鐵則） | 材質表 §2 |