歷史記錄 · 2026-06-11¶
重大重構里程碑¶
2026-06-11 ─ 建模參數表 第二輪完整複審：直修 9 項（A 組 4 + B8/B9 + C 組 3）¶
背景：建模參數.md 全檔重讀 + 跨 corpus 核對（上一輪 2026-06-09 修過的 K 常數 / AABB 50× / 雙 50:1 / 玩家上限公式 / weather patch 參數 / 章節錨點全部驗證健康）。本批為使用者裁決後的直修項；另有 AABB 三元組軸序、ambient_temp 模型、chip slot 閾值三題待裁決（見對話）。
| 項 | 變動 | 位置 |
|---|---|---|
| 常數名漂移 | 「system MAX_PLAYERS（8）」×3 → 權威名 TRACK_MAX_PLAYERS_HARDCAP（程式參數表 §3） |
建模 §5.4 / §7.2 / §8.2 |
auto_narrowest_path_mm 斷指標 |
「[車輛組裝.md §相容性] 用」（章節不存在）→ 實際消費者 = 賽前場地相容性檢查（車輛 AABB.x + 50mm ≤ 此值、警告不阻擋，[比賽進行.md]） | 建模 §8.6 |
weather.temperature desc 去歷史註記 |
「對齊 ambient_temp 命名去後綴」（改名歷程，違廢棄資訊鐵則；本檔 §4 對照表已有記錄）→ 語義註「= runtime ambient_temp 來源（算式表 §6.1，另含 burn/freeze zone 加成）」 |
建模 §8.3 |
| RespawnPoint forward 軸明定 | 「forward 軸」未指明 → −Z（Blender 前向慣例，同 RoutePoint）；§5 軸向速查補 RespawnPoint −Z + tire/roller hinge = mount empty +X（§6.4 既有定義、速查漏列） | 建模 §5.4 / §5 速查 |
| ⭐ destructible entity 碎片儲存位置 | §9.3 引「§4.1 預烘焙」但 §4 是零件 Root Extras、場地 §8.6 / entity §9.2 皆無 fragments 欄位 → §9.2 新增 node-level auto_fragments（結構同 §4.1、Stage 3 僅對 destructible: true entity 烘焙、🔒）；§9.3 步驟 3 改指 §9.2 |
建模 §9.2 / §9.3 |
| ⭐ lap_mode 恰 2 點退化 loop 邊角 | fixed 恰 2 點 + RP1↔RPn 中心距 100mm–1m 會被推斷成幾何退化的 2 點 loop → 規則補「且 route ≥ 3 點」（恰 2 點一律 linear、無法構成迴圈幾何）；UI 覆蓋同步限「fixed 且 ≥ 3 點」；§8.2 例外句補（≥ 3 點） |
建模 §8.1 / §8.2 + UGC機制 ×2 + UGC上傳流程 |
| §7 零件層限制入口 | §7 只有整車 / 場地層 → 補指標行（PART_AABB_MIN/MAX_MM、PART_VERTEX/TRIANGLE_COUNT_MAX、退化三角形閾值 → 程式參數表 §3） |
建模 §7 |
| 散落數字常數化 | 程式參數表 §3 新增 ROUTEPOINT_SURFACE_TOLERANCE_MM(5) / ROUTEPOINT_MIN_SPACING_MM(100) / TRACK_CHECKPOINT_TRIGGER_MIN_MM([100,100,1000]) / TRACK_CHECKPOINT_TRIGGER_MAX_AABB_RATIO(0.1) / START_GRID_SAFETY_MARGIN_MM(50)（賽道 checkpoint 用 TRACK_CHECKPOINT_* 前綴避開 CHECKPOINT_*=賽內快照保留名）；建模 §5.4 / §8.2 引用標常數名 |
程式參數表 §3 + 建模 §5.4 / §8.2 |
| 錨點精確化 | 「遊戲機制.md §技能」→「§1 晶片技能」 | 建模 §3.6 |
另：其他.md §5 補掛「builtin-assets canonical 尺寸表（§7.3 容差檢核基準）」待補項（原 builtin-assets「inventory 待補」指標實際未列）。
2026-06-11 ─ 公版三變體軸統一：美術 prompts 對齊 canon speed/heavy/control（方案 A）¶
決策檔：D-20260611-01
裁決：使用者定案方案 A —— 美術檔對齊 [程式架構/builtin-assets.md] canon speed / heavy / control；tire 照 canon（speed = 軟高摩擦光面 / heavy = 硬耐磨越野 / control = 通用淺紋）；原 Speed 削刃降級為 UGC 造型範例。asset-image-prompts.md 整檔重寫執行。
| 項 | 變動 |
|---|---|
| 軸統一 | asset-image-prompts.md 24 提示詞全改 <Part> - speed / heavy / control；asset-art-direction.md「3 台原創車型」同步；附錄檔名慣例 <part>-<archetype>.png |
| 第三變體重寫（8 張） | Hazard（兇悍戰鬥）→ control（平衡對稱精準；pearl-white / 銀灰中性視覺語言）：chassis 前後對稱、body 通用中 drag、tire 通用淺紋、motor 中體積 torque 50、battery 平衡、roller 中尺寸、chip 鏡像對稱版面、weapon = active launch 釘刺（全新一張）（三釘刺為 launcher 子節點 sub-mesh、發射序 = 子節點序） |
| tire 三格照 canon | speed：hard slick → soft 高摩擦光面軟胎；heavy：soft sticky 越野 → 硬橡膠耐磨越野紋；補注「胎面紋路 = 碰撞 mesh（mesh + material 決定物理）」 |
| weapon 三變體重配 | speed = passive 輕型撞角（原 Grip 撞角輕量化）、heavy = active general_rotate 360 連旋（原揮擊鎚改連旋 rotor、補 Pivot / Axis / weapon_max_angle_deg: 360 註）、control = launch（新）；原削刃 → 8.4 UGC 造型範例（非公版），全檔計 24 公版 + 1 範例 |
| chip 三組照 canon §5 | [boost50,brake20,weapon30] / [slam40,stabilize20,weapon40] / [stabilize30,swerve_l20,swerve_r20,weapon30]；三張 mood 重寫、每張含武器觸發元素 |
| 前兩格中度調整 | chassis heavy 補前置重心 + 6 導輪座強化 bosses；body heavy 改裝甲耐撞語言；roller heavy 改中摩擦 composite（canon 中摩擦、非高摩擦 rubber）；battery speed 重定位為高輸出（原小容量輕量） |
| 體積 / 容量視覺化 | motor control 26mm 中體積（lenient 內）；battery speed 12mm 高輸出端子 / heavy 14mm 滿倉大容量 / control 13mm（容量 = volume 推算、高輸出 = declared_output_w）；roller speed 10×8 / heavy 12.5×10 / control 11×9；各 part 兼容約束行同步 |
| 去印字標籤 | 全檔 spec 印字（RS-540 / RPM / mAh / 警語）→ 純色帶；共通 prefix 補「物件本體不出現印字」—— 修掉檔內自相矛盾（CRITICAL 零文字 vs prompt 又要求印 label，印字會被 AI 3D 烘進貼圖） |
2026-06-11 ─ asset-image-prompts.md 殘留清理（visual-mockups 美術檔對 canon 重對）¶
背景：清同日前條（指紋圖）發現的待辦。美術資源/visual-mockups/ 為脫鉤時複製進來的美術成品檔、內容未 reconcile，殘留大量 asset-functional-spec 時代術語。本批把 asset-image-prompts.md 整檔對現行 canon（建模參數表 §3.6 / §3.7 / §5 / §6 / §7.3、程式架構/builtin-assets.md）重對 + sibling 機械性修正。
| 項 | 變動 | 位置 |
|---|---|---|
| ⭐ lenient 容差語義漂移 | 舊文「>±15% 警告但不拒收」→ 現行三段制：0–±2mm 無警告 / ±2mm–±15% 軟警告不擋上鏈 / >±15% Stage 3 拒收（對齊建模參數表 §7.3）；廢「functional spec §11.6 / §13」指標 | asset-image-prompts 使用方式 |
| Mount / Empty 命名 | _mount → Mount_* 配對（tire/roller 前綴匹配、其餘嚴格相符）；roller_slot_* / weapon_slot_* → Mount_Roller_FL…_RR / 唯一 Mount_Weapon（前後兩面擇一）；_axis / _pivot → Axis（+Z、缺漏 fallback mesh 主軸標 auto_inferred）/ Pivot；slot 工作流「Blender 加 empty」→ Stage 2 編輯器自動加標準命名 mount + 玩家拖放 |
同檔 Part 1 / Part 8 |
_launch_point 廢除收尾 |
launch 子彈 = weapon_main_mesh_node（launcher_body）子節點 sub-mesh（順序 = 發射序、每顆可各自指派 material） |
同檔 Part 8 |
| weapon 宣告方式 | 「sidecar JSON 宣告 passive / active + motion_type」→ GLB extras passive + active 的 weapon_mechanism（general / magnet / launch） |
同檔 Part 8 |
| gp-chip → chip 收尾 | Part 7 全段 + 介面表「GP 倉」→「晶片倉」+ prompt 內 GP slot / GP control chip 等 9 處；skill enum weapon_trigger → weapon；「技能與 slot 數 sidecar 宣告」→ slot 數 volume 自動 1–4（玩家不可宣告）、skill_slots[] Stage 2 設定上鏈鎖死 |
同檔 Part 7 + 介面表 |
| chassis 介面位置語義 | 「位置與尺寸固定」→ 尺寸固定；位置分 canonical 固定（軸孔 / 電池倉 / 車殼柱）vs 自訂（馬達座 / 晶片倉 / 導輪座 ×6 / 武器面，提示詞給的位置即成為該 chassis 的 mount 位置）；「4–6 導輪座」→ 6、「1–2 武器面」→ 前後各 1、對應唯一 Mount_Weapon | 同檔 Part 1 |
| 路徑 / 附錄 | 最終 GLB assets/glb-blender/ → assets/builtin/parts/（builtin-assets canon 路徑）；附錄「asset-functional-spec §11」「project-resources png-prompts」→ 建模參數表 §5–§6 / §7.3 + builtin-assets.md + final 收 美術資源/visual-mockups/ |
同檔 |
| sibling 機械修 | asset-art-direction.md：gp-chip → chip、零件分類 11 → 8 類（shaft / gear / aux 收「歷史工作區視覺輔助類」註記）；README.md 頂部加角色註（本 README 描述 project-resources 原始工作區、零件類型與機制以 企劃/ canon 為準） |
asset-art-direction + README |
未定案衝突（同日裁決狀態）：
- ⭐ 三變體軸不一致：prompts / art-direction 用 Speed / Grip / Hazard，builtin-assets.md canon =
speed / heavy / control（chip 技能組合、weapon 三變體機制、tire 軟硬配置皆對不上 builtin-assets §5 設計方向表）→ 涉 24 個提示詞的風格軸重寫方向。已裁決並執行（同日，見上條）：方案 A + tire 照 canon + 削刃降 UGC 範例。 - stat-gp-chip 連動改名 → 已裁決並執行（2026-06-11）：原則「舊區域（project-resources 原始工作區）binary 一律不動、新區域 binary 改名」；新區域
美術資源/visual-mockups/ui-assets-generated-svg/icons/stat-gp-chip.svg→stat-chip.svg、ui-asset-prompts.md 引用同步。 - track-image-prompts.md 同類整檔重對（track-functional-spec 引用 ×5、「12 種場地材質」stale 計數等；另記 ui-image-prompts.md:234「GP」字樣同類殘留）→ 壓後處理（使用者裁決）。
- （知悉項）builtin GLB 預算 < 100KB/檔（builtin-assets §7）vs prompts 管線「50K 面 + 1024 紋理」的張力 → 壓後處理（使用者裁決）。
2026-06-11 ─ ugc-fork「5 組指紋對照」圖重畫（清 2026-06-09 待辦）¶
背景：兌現 2026-06-09 待辦。程式架構/程式流程/ugc-fork.md「5 組指紋對照」mermaid 圖整張對權威 [程式架構/ugc-fork.md §3]（PhysicsFingerprint per-type 介面）重畫；權威先經全 corpus grep 驗證為現行（廢欄位僅存本檔歷史 + 該圖）。勘誤：原待辦寫「對 anti-piracy.md 重對」係誤指 —— anti-piracy.md 是 mesh 幾何指紋（防複製），物理指紋權威是 程式架構/ugc-fork.md §3。
| 項 | 舊（stale） | 新（照權威 §3） |
|---|---|---|
| 剛體 chassis 補充 | gear_ratio（2026-05-17 廢、併入 motor torque_ratio） |
無補充 |
| 剛體 weapon 補充 | motion_type / motion_params hash（已廢） |
weaponBranchHash（mechanism / main_mesh_node / max_angle_deg 雜湊） |
| 滾動 tire 補充 | tread_type（已廢、由 mesh + material 反映） |
tire / roller 皆無補充 |
| motor sidecar | wattage / accel_topspeed_split |
torqueRatio_pct |
| battery sidecar | capacity_mah / discharge_rate |
declaredOutputW（容量 = volume 自動推算、已含於 mesh 部） |
| chip skill 部 | slot count + slot IDs | slotCount + skillSlots（skill + kineticRatio、字母排序） |
| 全圖欄位名 | 短名無單位 | 對齊權威整數量化欄位名（mass_mg / com_um / volume_um3…）+ 圖前補權威指標行 |
場地 6 維原本就正確、保留。同檔其餘 4 張圖（兩階段判定 / 雙標準決策樹 / OR 邏輯 / fingerprintVersion）核對權威 §2 / §4 / §7 無誤、不動。
新待辦（未動）：美術資源/visual-mockups/asset-image-prompts.md 殘留大量 asset-functional-spec 時代術語（motion_type、「sidecar JSON 宣告」、_axis、_launch_point、roller_slot_* / weapon_slot_*、「functional spec §x」引用，≥7 處）→ 需整檔對現行 建模參數表 / 編輯器操作 重對，不盲改。