feat(starpuff): 星海終局篇 W2——L22 關稅巨獸與 L24 潮汐女王雙魔王關

.changeset/starpuff-w2-finale-bosses.md

@@ -0,0 +1,5 @@
+---
+'@app/starpuff': minor
+---
+
+星海終局篇 W2：新增兩座魔王關卡——L22 關稅要塞（關稅巨獸 Tariffang：貨櫃稽查、追蹤稅票、全面封關三階段）與 L24 潮汐王庭（潮汐女王 Maridella：潮線改道、海嘯階梯、深海月蝕三階段）。焰化星彈可燒毀稅票、吸入可把稅票回收成彈藥；潮化可在水流中穩定行走。兩王擊破後各自開放 EX 變體挑戰，世界地圖六、七區補齊成對章節，圖鑑與成就同步收錄兩位新魔王。

apps/starpuff/app.config.mjs

@@ -29,7 +29,7 @@ export const SITE_CONFIG = {
   shortName: 'StarPuff',
   title: '星噗噗 StarPuff｜免費橫向捲軸動作網頁遊戲・免下載離線可玩',
   description:
-    '星噗噗 StarPuff 是免費網頁遊戲：橫向捲軸動作玩法，操控 Q 彈果凍球吸入果凍怪、化為九系星彈與星化變身，闖越果凍星球五大區域二十道關卡、挑戰五大魔王與 EX 變體。免下載、免註冊、無廣告，支援 PWA 安裝與離線遊玩，手機、平板與電腦開啟瀏覽器即可暢玩。',
+    '星噗噗 StarPuff 是免費網頁遊戲：橫向捲軸動作玩法，操控 Q 彈果凍球吸入果凍怪、化為九系星彈與星化變身，闖越果凍星球七大區域二十四道關卡、挑戰七大魔王與 EX 變體。免下載、免註冊、無廣告，支援 PWA 安裝與離線遊玩，手機、平板與電腦開啟瀏覽器即可暢玩。',
 };
 
 export const APP_CONFIG = {

apps/starpuff/docs/GAME_DESIGN.md

@@ -34,7 +34,7 @@
 | [`00-foundations.md`](design/00-foundations.md)       | 產品定位、場景流程、技術架構與事件契約、品質門檻、版本號、跨系統架構級契約     |
 | [`01-controls-input.md`](design/01-controls-input.md) | 搖桿與 A/B/SP 鍵語意、輸入矩陣、觸控判定、移動手感、旋轉殼、虛擬鍵布局與配置頁 |
 | [`02-combat-star.md`](design/02-combat-star.md)       | 戰鬥數值、九系星味與混合星、殼盾與雷鏈、星化三形態與教學矩陣                   |
-| [`03-enemies-bosses.md`](design/03-enemies-bosses.md) | 主角與 18 隻小怪 FSM、精英系統、五座魔王階段與招式、EX 變體與 P4 第二血條      |
+| [`03-enemies-bosses.md`](design/03-enemies-bosses.md) | 主角與小怪 FSM、精英系統、七座魔王階段與招式、EX 變體與 P4 第二血條            |
 | [`04-levels-world.md`](design/04-levels-world.md)     | 20 關資料與節奏、五區分頁世界地圖、彩蛋、平台與環境機制、魔王關前室與增益      |
 | [`05-save-settings.md`](design/05-save-settings.md)   | 存檔 schema 與備援、重置語意、成就系統、使用者偏好 SSOT 與設定頁、PWA 更新閘   |
 | [`06-ui-shell-pwa.md`](design/06-ui-shell-pwa.md)     | 主選單與圖鑑分頁、暫停系統、HUD 命中層、結算動線、殼層卡片、PWA 安裝指引       |
@@ -175,3 +175,4 @@
 | §119 | 星海終局篇四新變身（W1；#886）                                                       | [`02-combat-star.md`](design/02-combat-star.md)       |
 | §120 | 星海終局篇六新小怪（W1；#886）                                                       | [`03-enemies-bosses.md`](design/03-enemies-bosses.md) |
 | §121 | 星海終局篇 L21/L23 走動關與進程（W1；#886）                                          | [`04-levels-world.md`](design/04-levels-world.md)     |
+| §122 | 星海終局篇雙魔王：Tariffang 關稅巨獸（L22）與 Maridella 潮汐女王（L24）（W2；#886）  | [`03-enemies-bosses.md`](design/03-enemies-bosses.md) |

apps/starpuff/docs/WALKTHROUGH.md

@@ -1,4 +1,4 @@
-# 星噗噗 StarPuff 全關卡攻略（L1–L20）
+# 星噗噗 StarPuff 全關卡攻略（L1–L24）
 
 > 對應遊戲版本：`@app/starpuff` 0.15.3（v18 修復列車；實測基準 0.13.0——其後
 > v15/v16 未變更關卡資料與魔王 FSM（僅 L1 教學關死亡重試改保留一半配額），
@@ -448,20 +448,105 @@
   P3 讀金紋打裂核窗，補給循環＋段起點重試保證磨死。
 - **星化優勢解（非必需）**：P2 風化機動全收星屑；P3 雷化裂核大窗爆發。
 - **彩蛋**：`survive-collect`——「星核共鳴」：P2 生存段 5 枚星屑全收，瞬間滿彈匣＋星光謝幕演出。
-- **通關後**：星光復甦謝幕（製作名單）→ 結算。全 20 關通關、五魔王擊破後，
-  地圖魔王節點開放 EX 挑戰（HP ×1.5、節奏 ×1.15、專屬新招）——全五王 EX 制霸另有星核紀念章。
+- **通關後**：星光復甦謝幕（製作名單）→ 結算。魔王關通關後該節點開放 EX 挑戰
+  （HP ×1.5、節奏 ×1.15、專屬新招）——**全在編魔王** EX 制霸另有星核紀念章
+  （§122 起共七王：主線五王＋星海終局篇 Tariffang／Maridella）。
 - **實測**：114.7 秒擊破、死亡 1（P2 段起點重試驗證成功）——P1 約 7 秒、P2 生存段表定
   40 秒（40 秒播完時間驅動入 P3；本次含一次段重試共經歷約 90 秒、過熱窗三輪輸出）、
   P3 低重力下約 11 秒融毀（截圖 `l20-start.png`、`l20-arena.png`、
   `l20-p2.png`、`l20-p3.png`、`l20-clear.png`；P2 生存段倒數環見 `l20-p2.png`）。
 
 ---
 
+## 第六區：星海港域（L21–L22）
+
+> 星海終局篇首章（§121/§122）。本區起為主線全破後的終局內容，難度接續 L20 續升。
+> 本區兩關的實測數據來自分級 bot 序列量測（`scripts/level-audit.mjs`，真實瀏覽器
+> 遊玩），與前二十關的人工實測方法互補；bot 水準與口徑見附錄二補記。
+
+### L21 星港集散地（走動關・焰化取得）
+
+- **主題**：貨櫃推進（cargo 緩推折返）× 掃描光（scanna 鎖定直線）；十一種混編、
+  六同屏高壓；蒸氣閥週期氣壓柱 ×2、卡點中點重生（checkpoint 1850）。
+- **焰化教學**：中段練習區保證 3 隻貨櫃丁——連吞 3 隻（重鑽味 ×3）站地面按 SP
+  即焰化（焰彈小爆＋焰衝刺＋熔岩爆；burn 可燒冰史萊姆與 L22 稅票）。
+- **要點**：貨櫃丁恆可吸是彈藥主軸；scanna 鎖定後不修正——鎖定閃爍時橫移一步即脫離；
+  雙精英（巨貨櫃長／緋紅掃描長）全在練習區之後，60 秒逾時保險照舊。
+- **實測（mid bot ×3）**：通關 3/3（100%）、通關中位 80.1 秒、3.33 死/次、
+  console error 0——與 W1 出貨量測（100%、84.4 秒）口徑一致。
+
+### L22 關稅要塞（魔王：關稅巨獸 Tariffang）
+
+- **主題**：星港海關三段——地面關卡官型。HP 112（接續 Voidra 110 續升）、體傷 1；
+  駐守崗哨（衝撞後換側），P2 起狂暴 ×1.15＋換 enraged 立繪。
+- **前室**：慈悲愛心＋補給 3 隻＋二選一：**護盾泡**／**星力果**；P2 高風險位刷疾風靴。
+  建議：星力果——本王輸出窗規律（idle 僵直 1.8–2.2 秒），吃傷害加成回報高。
+- **三段結構與反制**：
+
+| 段          | 門檻  | 內容                                                                                                     | 反制                                                                                             |
+| ----------- | ----- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| P1 貨物稽查 | > 66% | 貨櫃「檢查中」邊緣警示 0.8 秒 → 沿地面滑入橫越全場（高 52px）；關稅槌三落點預警 0.7 秒直墜               | 貨櫃跳越（單跳 98px 綽綽有餘）或站浮台讓過；關稅槌看落點橫移；僵直窗全力輸出                     |
+| P2 加收費用 | ≤ 66% | **星彈命中即生追蹤稅票**（0.9 秒節流、場上上限 4）；`levy` 查帳再撒 ×3；貨櫃 ×2 錯拍                     | **吸入稅票＝回收成彈藥**（稅金退還）；焰化焰彈直接燒票且穿透續飛；打帶跑——連射會被票海反噬       |
+| P3 全面封關 | ≤ 33% | 雙側閘門預警 0.9 秒由上而下關閉（各覆蓋 30% 寬、駐留 1.8 秒），中央走廊恆開；高速衝撞（三拍閃白 0.7 秒） | 聽到封關警示就進中央走廊；衝撞原地跳＋拍翅 2 次即可越過（本體高 150 < 淨高 211）；閘門升起再輸出 |
+
+- **保底打法（純標準星）**：吸補給點射 → P2 改「射一輪、吸一輪」節奏把稅票當免費彈藥 →
+  P3 守走廊跳衝撞，僵直窗磨死。閘門僅駐留 1.8 秒、被關在外側也只吃 1 傷（i-frame 足夠穿過）。
+- **星化優勢解（非必需）**：焰化燒票線——補給 cargo 權重 0.5，常態補給 ≤30 秒湊齊
+  重鑽味 ×3；焰化期間稅票威脅歸零、焰彈照常打王。
+- **下砸線**：下砸命中頭頂觸發 0.8 秒短暈（衝撞中免疫）——貼身高風險高回報。
+- **彩蛋**：`crown-early-hit`——可擊打後 5 秒內首次命中，回復 +2 HP。
+- **實測（×7 序列）**：high bot 通關 6/7（86%）、TTK 中位 30.3 秒（包絡 17.7–30.9）、
+  含重試通關中位 220.7 秒、5.0 死/次（三輪零死——乾淨線存在，死亡集中貼身站樁）；
+  low bot 0/7（0%）——「中高手可過、新手過不了」的終局定位成立；console error 0。
+
+---
+
+## 第七區：冰晶潮域（L23–L24）
+
+### L23 冰晶潮灣（走動關・潮化取得）
+
+- **主題**：糖漿潮汐管線的冰潮換裝（週期漲落、dry-window 55%）× 週期浮力柱 ×2；
+  潮系四供給 56%（frosty/foamy/manta/spora）、九種混編六同屏；checkpoint 1900。
+- **潮化教學**：中段練習區保證 3 隻泡泡機——連吞 3 隻（孢子味 ×3）按 SP 潮化
+  （水引拉近＋泡泡盾＋霜滑翔＋潮環撥開投射物）。
+- **要點**：漲潮期站平台層等退潮（等窗推進是官方合法保底）；manta 水刃走 hazards——
+  潮化潮環可直接撥開；frosty 分裂體用焰化燒或逐隻吸。
+- **實測（mid bot ×3）**：通關 3/3（100%）、通關中位 85.2 秒、4.33 死/次、
+  console error 0——與 W1 出貨量測（100%、85.1 秒）口徑一致。
+
+### L24 潮汐王庭（魔王：潮汐女王 Maridella）
+
+- **主題**：潮灣終章三段——懸浮場控型。HP 116（全魔王新峰值）、體傷 1；
+  女王懸浮於中高帶（y≈250，可自她底下走過），P2 起狂暴 ×1.15＋換 enraged 立繪。
+- **前室**：慈悲愛心＋補給 3 隻＋二選一：**護盾泡**／**疾風靴**；P2 高風險位刷星力果。
+  建議：疾風靴——本王的威脅全是「位置壓力」（水流/牆/環爆），移速直接換生存。
+- **三段結構與反制**：
+
+| 段          | 門檻  | 內容                                                                                                                     | 反制                                                                                                               |
+| ----------- | ----- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
+| P1 潮線改道 | > 66% | 方向箭頭沿地面流動預告 0.9 秒 → 地面帶水流推移 4 秒（90px/s、交替出向）；水滴彈幕拋物 ×3（舉臂 0.65 秒）                 | 水流推速低於你的移速——逆走可頂住，跳離地面帶直接免疫；**潮化完全免推**；水滴看拋物線落點讓開                       |
+| P2 海嘯階梯 | ≤ 66% | 波浪牆起浪預警 0.9 秒 → 留缺口橫越全場（240px/s）：低缺口＝貼地走廊、高缺口＝跳躍帶（102px 恆容本體）；潮湧召喚 foamy ×2 | 看牆型選解：低缺口站著不動就過、高缺口單跳入縫（拍翅修正）；foamy 泡泡踩上浮＝免費渡牆電梯；雷化鏈電可打斷召喚吟唱 |
+| P3 深海月蝕 | ≤ 33% | 背景轉暗、水月升起（氛圍暗場，預警亮度不變）；三水球繞行女王、每球爆裂前閃爍 0.6 秒 → 依序爆成環形放射彈 ×8              | 讀閃爍順序、貼著「已爆完的球位」走位；環形彈間有固定縫隙，站遠縫隙更寬；潮化潮環可直接撥開放射彈                   |
+
+- **保底打法（純標準星）**：她懸浮在單跳星彈可打帶——地面平射微導向自然上彎命中；
+  idle 僵直（1.9–2.2 秒）是固定輸出窗；水流期跳打、牆來讀缺口、月蝕期先躲完三爆再輸出。
+- **星化優勢解（非必需）**：潮化穩控線——補生孢子味權重 0.55＋P2 召喚 foamy 再補，
+  潮化期間水流失效、潮環撥開水滴與環爆彈；「潮汐女王的主場規則對你無效」。
+- **注意**：懸浮場控免暈——下砸只回彈不觸發暈眩；輸出窗來自僵直不來自打斷。
+- **彩蛋**：`crown-early-hit`——可擊打後 5 秒內首次命中，瞬間滿彈匣。
+- **實測（×7 序列）**：high bot 通關 6/7（86%）、TTK 中位 29.5 秒（包絡 26.2–36.9）、
+  含重試通關中位 155.3 秒、4.86 死/次；low bot 0/7（0%）；console error 0。
+  全魔王實測難度峰值（對照 L20 高階 100%、2.17 死/次），符合終局章收章定位。
+
+---
+
 ## EX 挑戰（#814 全面重設計，T6）
 
-全 20 關通關後地圖魔王節點開放。共同差分：HP ×1.5、節奏 ×1.15（面板僅此，
-§8.1 紅線）＋**每王專屬新型態（phase+1）**；進場清除蓄能星（EX 純度）；
-補給保證律照常（基礎星彈恆可通關）。
+魔王關通關後該節點開放 EX 入口。共同差分：HP ×1.5、節奏 ×1.15（面板僅此，
+§8.1 紅線）＋**主線五王專屬新型態（phase+1）**；進場清除蓄能星（EX 純度）；
+補給保證律照常（基礎星彈恆可通關）。星海終局篇雙王（L22/L24）的 EX 為
+HP/節奏共同差分＋質性差分（貨櫃雙向同時／水球 ×4 與召喚 ×3，見 §122），
+暫無專屬 P4 型態。
 
 | 王          | EX 專屬型態                                                                              | 血條結構                            | 反制要點                                                                                                                                                                                                         |
 | ----------- | ---------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -517,6 +602,9 @@
   ②L14／L15／L19 於 4 分鐘真實戰鬥後以官方 e2e 慣例之配額輔助收尾（該三關 bot 死亡率高，
   路線與機制描述均來自輔助前的真實遊玩段）。
 - 人類玩家可完整走本文所有路線；上述輔助僅為自動化實測的工程收尾手段。
+- **L21–L24 補記（§121/§122 出貨車）**：星海終局篇四關的實測改由 `scripts/level-audit.mjs`
+  分級 bot 序列量測（walk＝mid 350ms／boss＝high 250ms；魔王關供彈沿 v13 bot 慣例受控賦星）——
+  每份數據標注 bot 水準與 runs；勝率依 AGENTS 口徑為觀測值，裁決以靜態三軸＋TTK 包絡為準。
 
 ## 附錄三：實測發現問題（回報開發；v18 修復列車已全數收斂）