摘要
v21–v23(#813 T5 列車)新增的六個純邏輯模組,檔頭註解一律寫 GAME_DESIGN §5——§5 是「角色設定(全部原創)」的主角/小怪設定表,與這些模組毫無關係。正確章號應為 §111–§113。
背景/證據
T7-C 文件拆分(PR 待補)為「章號 §N 是穩定識別碼、索引表負責解析章號到檔案」做了守門,這批誤引因此浮現——照註解查號會落到完全無關的章節。
apps/starpuff/src/game/logic/moveTable.ts:1 // 魔王加權選招 SSOT(GAME_DESIGN §5 / #813)
apps/starpuff/src/game/logic/eclipseCloak.ts:1 // 蝕月斗篷純邏輯(GAME_DESIGN §5 / #813)
apps/starpuff/src/game/logic/jellyPatch.ts:1 // 果凍回彈純邏輯(GAME_DESIGN §5 / #813)
apps/starpuff/src/game/logic/mirrorShadow.ts:1 // 鏡像殘影純邏輯(GAME_DESIGN §5 / #813 W2)
apps/starpuff/src/game/logic/caramel.ts:1 // 焦糖化純邏輯(GAME_DESIGN §5 / #813 W2)
apps/starpuff/src/game/logic/starSiphon.ts:1 // 星光虹吸純邏輯(GAME_DESIGN §5 / #813 W3)
對應的正確章節(現行 SSOT apps/starpuff/docs/design/03-enemies-bosses.md):
| 檔案 |
應引章號 |
moveTable.ts |
§111.1(加權選招基礎設施 SSOT) |
jellyPatch.ts |
§111.2 |
eclipseCloak.ts |
§111.3 |
mirrorShadow.ts |
§112.3 |
caramel.ts |
§112.4 |
starSiphon.ts |
§113.2 |
影響
- 低(P3,僅維護性):不影響執行期行為;但破壞「程式註解→設計章節」的可追溯性,後續調參者依註解查到錯章。
範圍
- 上列六個檔案的檔頭註解單行,純字串修正。
- 不在範圍:任何邏輯、型別或測試變更。
驗收標準
- 六檔註解章號改為上表值。
rg "GAME_DESIGN §5 " apps/starpuff/src 零命中(§5 僅應由角色設定相關處引用)。
- 全量 vitest 綠(純註解變更,行為零改變)。
摘要
v21–v23(#813 T5 列車)新增的六個純邏輯模組,檔頭註解一律寫
GAME_DESIGN §5——§5 是「角色設定(全部原創)」的主角/小怪設定表,與這些模組毫無關係。正確章號應為 §111–§113。背景/證據
T7-C 文件拆分(PR 待補)為「章號 §N 是穩定識別碼、索引表負責解析章號到檔案」做了守門,這批誤引因此浮現——照註解查號會落到完全無關的章節。
對應的正確章節(現行 SSOT
apps/starpuff/docs/design/03-enemies-bosses.md):moveTable.tsjellyPatch.tseclipseCloak.tsmirrorShadow.tscaramel.tsstarSiphon.ts影響
範圍
驗收標準
rg "GAME_DESIGN §5 " apps/starpuff/src零命中(§5 僅應由角色設定相關處引用)。