摘要
PR #864(T7-A 運行時功能)改變了慈悲補血的判定機制與偏好設定的儲存架構,但設計 SSOT apps/starpuff/docs/GAME_DESIGN.md 仍記載舊規格。後續平衡調校、migration 與驗收若依此文件執行會走到錯誤基準。
背景/證據
來源:PR #864 兩則 Codex review thread(皆 P1)
漂移點一 — 慈悲補血(§62)
- 實作
apps/starpuff/src/game/logic/mercyHeal.ts 已改為確定性 pity(受傷次數/低血時間門檻,boss 房 bossPityHurts=2,commit 045401f 與 6feab1b)。
GAME_DESIGN.md L820、L828、L871 仍宣告「RNG 由呼叫端注入」並以一般 35%/魔王 60% 擲骰。
漂移點二 — UserSettings(§38 等)
- 實作已導入
sp-settings 單一 SSOT(apps/starpuff/src/game/core/settings.ts),migration 落盤成功後刪除 sp-muted/sp-rotation/sp-key-layout 三個 legacy 散鍵(commit 8bd256d);Title 已有「設定」入口(settingsPage.ts)。
GAME_DESIGN.md L65、L325、L363–364、L1482、L1647、L1733 仍宣告靜音/旋轉/布局使用舊鍵,且明載「無設定頁」與 Title 直接開啟按鈕配置。
影響
範圍
apps/starpuff/docs/GAME_DESIGN.md:§62 參數表與魔王 override、L12 交叉引用;§38 儲存鍵、重置進度保留鍵清單、設定入口與 migration 語意。
- 依 repo 慣例:隨版升級並對舊章加取代標註,不刪除歷史章節。
- 不在範圍:任何執行期程式碼變更。
驗收標準
- §62 慈悲補血參數表改為確定性 pity 門檻(含
bossPityHurts=2 魔王 override),移除 RNG 注入與 35%/60% 擲骰敘述。
- §38 及相關段落改為
sp-settings 單一 SSOT,明載 migration 落盤成功後刪除三個 legacy 散鍵、以及 persist 失敗時保留 legacy 作下次開機來源的例外語意。
- 記載 Title「設定」入口存在,移除「無設定頁」敘述;按鈕配置改為由設定頁轉入。
- 舊章節依慣例加註取代標記,
grep 全檔不再殘留 sp-muted/sp-rotation/sp-key-layout 作為現行規格的敘述。
摘要
PR #864(T7-A 運行時功能)改變了慈悲補血的判定機制與偏好設定的儲存架構,但設計 SSOT
apps/starpuff/docs/GAME_DESIGN.md仍記載舊規格。後續平衡調校、migration 與驗收若依此文件執行會走到錯誤基準。背景/證據
來源:PR #864 兩則 Codex review thread(皆 P1)
漂移點一 — 慈悲補血(§62)
apps/starpuff/src/game/logic/mercyHeal.ts已改為確定性 pity(受傷次數/低血時間門檻,boss 房bossPityHurts=2,commit 045401f 與 6feab1b)。GAME_DESIGN.mdL820、L828、L871 仍宣告「RNG 由呼叫端注入」並以一般 35%/魔王 60% 擲骰。漂移點二 — UserSettings(§38 等)
sp-settings單一 SSOT(apps/starpuff/src/game/core/settings.ts),migration 落盤成功後刪除sp-muted/sp-rotation/sp-key-layout三個 legacy 散鍵(commit 8bd256d);Title 已有「設定」入口(settingsPage.ts)。GAME_DESIGN.mdL65、L325、L363–364、L1482、L1647、L1733 仍宣告靜音/旋轉/布局使用舊鍵,且明載「無設定頁」與 Title 直接開啟按鈕配置。影響
範圍
apps/starpuff/docs/GAME_DESIGN.md:§62 參數表與魔王 override、L12 交叉引用;§38 儲存鍵、重置進度保留鍵清單、設定入口與 migration 語意。驗收標準
bossPityHurts=2魔王 override),移除 RNG 注入與 35%/60% 擲骰敘述。sp-settings單一 SSOT,明載 migration 落盤成功後刪除三個 legacy 散鍵、以及 persist 失敗時保留 legacy 作下次開機來源的例外語意。grep全檔不再殘留sp-muted/sp-rotation/sp-key-layout作為現行規格的敘述。