Initial import of HEROLL source and design documents

2026-10-26 16:05:39 +08:00
commit fdb55672c1
1846 changed files with 290692 additions and 0 deletions
@@ -0,0 +1,54 @@
+# Stage 2.5.3 最终交付审计
+
+审计日期：2026-08-21  
+目标：HEROLL 2.0.1（`com.percent.aos.rollinghero`）  
+审计性质：只补齐报告已引用的 Primary Native 与文件完整性记录；未新增逆向任务，未新增或修改玩法结论。
+
+## 审计结论
+
+**PASS / READY FOR CHATGPT HANDOFF**。
+
+Stage 2.5.3 原有 Critical、Gacha、Boss Gauge 报告和 Evidence Matrix 保持原结论等级。此前报告引用但未随包提供的指定原生函数现已全部加入，并以完整、排他的函数地址范围导出。
+
+## Primary Native 覆盖
+
+### Gacha
+
+| 要求地址 | 随包文件 | 完整范围 | 结果 |
+|---|---|---|---|
+| `0x52F4840` | `05_NATIVE_PRIMARY/GACHA_PRIMARY/RewardGacha_prob_reader__06001C52.txt` | `[0x52F4840, 0x52F4854)` | PASS |
+| `0x50EDB34` | `05_NATIVE_PRIMARY/GACHA_PRIMARY/Address_0x50EDB34_weighted_selector.txt` | `[0x50EDB34, 0x50EDCA4)` | PASS |
+| `0x513C53C` | `05_NATIVE_PRIMARY/GACHA_PRIMARY/Address_0x513C53C_rng_helper.txt` | `[0x513C53C, 0x513C8C4)` | PASS |
+| `0x51138F0` | `05_NATIVE_PRIMARY/GACHA_PRIMARY/Address_0x51138F0_counter_update.txt` | `[0x51138F0, 0x5113C40)` | PASS |
+| `0x510078C` | `05_NATIVE_PRIMARY/GACHA_PRIMARY/Address_0x510078C_ceil_compare.txt` | `[0x510078C, 0x5100928)` | PASS |
+
+### Boss Gauge
+
+| 要求内容 | 随包文件 | 完整范围 | 结果 |
+|---|---|---|---|
+| 包含 `0x55445E8–0x5544614` 的 ExecuteAsync | `05_NATIVE_PRIMARY/BOSS_GAUGE_PRIMARY/ExecuteAsync_d__0.MoveNext__06003026.txt` | `[0x553EEEC, 0x5547874)` | PASS |
+| getter `0x52E4DA8` | `05_NATIVE_PRIMARY/BOSS_GAUGE_PRIMARY/Address_0x52E4DA8_gauge_getter.txt` | `[0x52E4DA8, 0x52E4E10)` | PASS |
+| setter `0x52E4E10` | `05_NATIVE_PRIMARY/BOSS_GAUGE_PRIMARY/Address_0x52E4E10_gauge_setter.txt` | `[0x52E4E10, 0x52E4F94)` | PASS |
+| 包含 `0x52E6064–0x52E6068` 清零调用的完整函数 | `05_NATIVE_PRIMARY/BOSS_GAUGE_PRIMARY/MoveFocusToCompositeRoot.MoveNext_clear_call__06001BD8.txt` | `[0x52E5740, 0x52E78E8)` | PASS |
+
+## Evidence → Finding → Path 复核
+
+- Critical：原有 Primary Native 与 `F-CRIT-253-001/002` 路径未改动。
+- Gacha：新增的五份 Primary Native 为 `F-GACHA-253-001/002/003` 提供随包原始函数体；Finding 的 `VERIFIED/PARTIAL` 等级未改动。
+- Boss Gauge：新增的四份 Primary Native 覆盖 `F-BOSS-253-001/002` 报告引用区间；Finding 的 `VERIFIED/PARTIAL` 等级未改动。
+- `06_EVIDENCE_MATRIX.csv` 仍是结论等级主索引；`05_NATIVE_PRIMARY/FINAL_AUDIT_NATIVE_INDEX.csv` 是本轮原始函数附件索引。
+
+## 范围与语义保护
+
+- 包名已更正为 `com.percent.aos.rollinghero`。
+- 最终原始函数核对确认，先前报告把 ExecuteAsync 指令区间多写了一个十六进制位；已从 `0x554445E8–0x55444614` 校正为原生文件中的 `0x55445E8–0x5544614`。该校正不改变玩法结论。
+- 未进行新的动态测试、静态追踪或玩法推断。
+- 未把 Gacha reset 或 Boss 完整触发谓词从 `PARTIAL` 提升为 `VERIFIED`。
+- 新增文件仅用于补足报告已引用地址的原始指令可审计性。
+
+## 完整性
+
+- `SHA256SUMS.csv` 覆盖包内除其自身外的全部文件。
+- `05_NATIVE_PRIMARY/FINAL_AUDIT_NATIVE_INDEX.csv` 记录本轮九份新增 Primary Native 的地址范围、大小与单文件 SHA-256。
+- 已对原始 case `work/heroll-stage-2-5` 执行 Case Review 的 `--verify-hashes --strict` 检查：`0 errors / 0 warnings / PASS`。
+- 最终打包前执行逐文件 SHA-256 回验和 ZIP 条目检查；结果必须为 PASS 后方可交付。