Skip to content

docs(starpuff): GAME_DESIGN.md 與 T7-A 實作漂移(慈悲補血 pity、UserSettings 儲存鍵與設定頁) #871

Description

@s123104

摘要

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 045401f6feab1b)。
  • GAME_DESIGN.md L820、L828、L871 仍宣告「RNG 由呼叫端注入」並以一般 35%/魔王 60% 擲骰。

漂移點二 — UserSettings(§38 等)

  • 實作已導入 sp-settings 單一 SSOT(apps/starpuff/src/game/core/settings.ts),migration 落盤成功後刪除 sp-mutedsp-rotationsp-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 慣例:隨版升級並對舊章加取代標註,不刪除歷史章節。
  • 不在範圍:任何執行期程式碼變更。

驗收標準

  1. §62 慈悲補血參數表改為確定性 pity 門檻(含 bossPityHurts=2 魔王 override),移除 RNG 注入與 35%/60% 擲骰敘述。
  2. §38 及相關段落改為 sp-settings 單一 SSOT,明載 migration 落盤成功後刪除三個 legacy 散鍵、以及 persist 失敗時保留 legacy 作下次開機來源的例外語意。
  3. 記載 Title「設定」入口存在,移除「無設定頁」敘述;按鈕配置改為由設定頁轉入。
  4. 舊章節依慣例加註取代標記,grep 全檔不再殘留 sp-mutedsp-rotationsp-key-layout 作為現行規格的敘述。

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingseverity:p1High-priority work

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions