Initial import of HEROLL source and design documents

HEROLL_RULES_v0.2.8/08-BOSS与局内结束/boss_gauge_final_report.md

@@ -0,0 +1,24 @@
+# Boss Gauge 最终报告
+
+## 已确认的计数器运算
+
+`BoardController.AddBossDiceNumber`（0x569A170）：
+
+`BossDiceCounter = BossDiceCounter + argument`
+
+`BoardController.HandleBossDiceRolled`（0x569A19C）：
+
+`BossDiceCounter = BossDiceCounter - argument`
+
+直接调用扫描仅在 `Boss19AttackHandler.<Execute>d__3.MoveNext` 发现对 `AddBossDiceNumber` 传入 -1 与 +1。这证明属性的通用加减语义，但不能证明它就是主流程的 Boss 生成 Gauge。
+
+## 静态触发链
+
+`<MoveTile>d__133.MoveNext` 静态调用：
+
+- `TrySpawnBossTilesByGauge`（0x569FEC0）；
+- `TryRegisterMidBossByGaugeAsync`（0x569FF6C）。
+
+对应状态机继续检查功能/模式/棋盘条件，并进入 Boss 注册或生成相关调用。`stageinfo.csv` 中存在 `bossSpawnRule=DiceGauge` 配置，但状态机内未发现对 `BossDiceCounter` 的直接读取或可确认的数值比较。
+
+结论：移动后进入 Gauge 触发入口为 `INFERRED`；计数器是否就是生成 Gauge、每次增量、阈值比较符、触发后重置均为 `UNKNOWN`。Boss 关键帧仅为 `OBSERVED` 玩法表现。