# Release Notes v1.1.0 — Balance Overhaul

v1.1.0 是「快推進派」平衡大改版。這次更新的核心不是單純提高產出，而是把新手教學、建築與弟子雙軸、派別匹配、突破/飛升曲線、道學、羈絆、升級樹與自動化回測串成一條可驗證的體驗鏈。

## 玩家體感差異

- 前 30 分鐘更密集：兩個 optimal profile 在 M71 final 均達成前 30 分鐘 feedbackDensity `min=60`，不再是長時間等待單一資源數字。
- 第一突破更早：M71 final 中 `optimal-no-tutorial` 第一次突破為 0m，`optimal-with-tutorial` 為 1m；人工路徑仍以 2m 內可見為目標。
- 第一座新建築更早：兩個 optimal profile 都在 0m 達成 firstNewBuilding anchor；人工路徑以 3m 內可見為目標。
- 第 5 位弟子更早：兩個 optimal profile 都在 0m 達成 fifthDisciple anchor；人工路徑以 15m 內可達為目標。
- 飛升循環提前可見：第一次飛升與 Stage 5 在 29-30m 達成，Stage 7 在 30m 達成；人工測試仍保留 5h / 24h 的寬鬆驗收窗口。
- 60 分鐘資源 cap 收斂：`optimal-no-tutorial` spiritQi 為 720100.0000000002（9.48x baseline），`optimal-with-tutorial` 為 694700.0000000002（9.15x baseline），都落在 3x-10x cap 內。
- 派別配置更有意義：主派、副派、不匹配、同派 stacking 與道學深修會影響實際生產，不再只是展示文案。
- 飛升不是 reset：升界與飛升仍遵守永不重置原則，舊界、建築、倉庫、道學與既有進度不應被清空。

## 13 個 milestone 摘要

| Milestone | 摘要 | 玩家可感知變化 |
|---|---|---|
| M60 tutorial-engine | 將 FTUE 升級為強制觸發、spotlight 鎖定、25 條教學 step 與三層跳過。 | 新玩家每次解鎖都知道下一步；老玩家可單步、群組或全部跳過。 |
| M61 balance-simulator | 新增 4 種 player profile、anchor、feedbackDensity、CSV/JSON baseline 與比較工具。 | 平衡不再只靠體感，每次調整都有可回測的時間錨點。 |
| M62 coupling-formula | 將弟子正式接入 production-loop，重做建築 × 弟子公式與主/副派匹配。 | 弟子屬性、境界、靈根與派別配置會真實改變產能。 |
| M63 recruitment-rework | 前 3 次招募保底、mortal/genius 屬性上調、雙靈根與變異靈根機率提高。 | 開局弟子更可靠，早期突破更少被 RNG 卡死。 |
| M64 building-values | 重設早期建築 baseRate、升級曲線、buildCost 與 buildTime。 | 前幾座建築更快出現，每 5 級約 2x 產出更好理解。 |
| M65 breakthrough-ascension | 大幅下修突破 cost、世界飛升要求，強化 cosmicMul 與閉關速率。 | 第一次突破與第一次飛升更早進入玩家視野。 |
| M66 auto-playtest | 新增自動 playtest，跑 4 profiles × 240m，產出 pass/fail 與補刀方向。 | balance regression 會被報告捕捉，不靠人工猜測。 |
| M67 dao-tech-recal | 重校 230 個道學節點，放大主分支、屬性節點與深層 affinity bonus。 | 深修某一派會回饋到同派建築與弟子配置。 |
| M68 bonds-calibration | 校準羈絆倍率，新增同建築同派 stacking bonus。 | 多名同派弟子放在同建築有額外收益，但不會無限制膨脹。 |
| M69 upgrade-tree-values | 將升級樹節點分為 breadth/depth/main，統一倍率與成本語義。 | 解鎖型節點與純加成節點更容易判斷取捨。 |
| M70 balance-doc | 新增 `docs/BALANCE_DESIGN.md`，固化 v1.1 平衡設計依據與可調 hook。 | 後續調參有明確依據，避免臨時堆倍率。 |
| M71 auto-patch | 根據 M66 報告做三輪常數補刀，讓兩個 optimal profile 全部通過。 | 主動操作玩家的核心節奏達標；idle profile 問題被明確隔離。 |
| M72 final | 校正人工測試 playbook，新增本 release notes，交由 Orchestrator tag。 | 測試與發版資料完整，可進入 v1.1.0 驗證與標記流程。 |

## 主要數值變更

- 招募：mortal 屬性從 `[30,60]` 上調到 `[45,75]`，M71 補刀後 mortal throughput 進一步提高；前 3 次 mortal 招募保底 elite。
- 靈根：dual / variant 機率提高，讓副派與派別配置更常出現。
- 建築：早期 baseRate 上調，早期 buildCost 降低，若干 early buildings buildTime 歸零；M71 將 `UPGRADE_COST_MULTIPLIER` 調到 `1.2`，`UPGRADE_RATE_MULTIPLIER` 調到 `2`。
- 派別：主派匹配 1.5，副派匹配 1.2，不匹配 0.8；道學深層節點可提高 affinity bonus。
- 突破：突破 cost 大幅下修，M71 又進一步降低部分門檻以保證 optimal profile anchor。
- 飛升：世界飛升要求降低，cosmicMul 提高到 `3e3 / 3e6 / 3e9 / 3e12` 階梯。
- 羈絆：pair/ring/full rate multipliers 經 M71 補刀後為 `1.15 / 1.30 / 1.45`。
- 升級樹：breadth 5%、depth 15%、main 50%，仙界建築補基本節點。

## 已知問題

兩個 idle profile 仍為 8/8 criteria FAIL。根因是目前 `applyIdleDecisions()` 不會招募、建造、突破、飛升或產生 feedback events；M71 的 constant-only 範圍無法修正 decision logic。v1.1.0 驗收因此以兩個 optimal profile 與人工操作路徑為主；idle/offline 測試只驗證已有進度的離線收益、存檔一致性與 gate 不被繞過。

## 驗證狀態

- `npm run auto-playtest`：16/32 criteria passed；兩個 optimal profile 16/16 passed，兩個 idle profile 0/16 passed。
- `npm run typecheck`：passed。
- `npm test -- tests/balance/auto-playtest.test.ts`：passed，1 file / 2 tests。
- `npm run lint`：0 errors，保留 2 個既有 Fast Refresh warnings in `src/renderer/components/AutoRuleRow.tsx`。

Git commit、tag 與 push 不屬於 Codex 本步驟，由 Orchestrator 接手處理。