StormBreaker 是面向 Warcraft III 1.27a x86 的内存优化 ASI。1.3.0 的正式方案不再全面接管 Storm 小块池，而是采用经过实机验证的组合：
>= 0xFE7C的大块由 TLSF 管理，减缓 Win32 低地址空间碎片化。- 小块继续使用 Storm 原生 arena，保持游戏最敏感路径的速度与 ABI 兼容性。
- 默认启用
search修复，补上 Storm 分箱搜索在特定非空桶状态下漏掉高位可用块的问题。
完整接管、hybrid 和 mimalloc 后端仍保留在实验分支，不属于 1.3.0 正式包。
安装 Hook 前会校验 PE32/x86、文件 SHA-256、导出 RVA 和 relocation-safe 函数前导字节。未知版本不会部分安装 Hook，而是保持原生 Storm 运行。
| 模块 | Warcraft III 1.27a 已验证 SHA-256 |
|---|---|
Storm.dll |
F8F519CFAA6275A5172A014F0ABED2212284390A33F1194677155A7D408E63EB |
Game.dll |
E04D1716603C075EB0C8E1E21CF1093A664ADC5249EFAB396BFA08D7B09D0C3A |
WorldEdit.exe |
5F645DB7C436ED2DE0C52712D98ACAF75E518847E6234D4CC1E5C5BEE2D76DFC |
Warcraft III 要求 Storm.dll + Game.dll 匹配；World Editor 要求 Storm.dll + WorldEdit.exe 匹配。
- 将
StormBreaker.asi放入 Warcraft III 根目录。 - 启动游戏并等待 StormBreaker 控制台出现。
- 控制台出现
StormBreaker v1.3.0、HOOKS=YES、BACKEND=tlsf、native small repair=search即表示加载成功。
默认每 60 秒刷新一次控制面板，并写入 StormBreaker/StormMemory.log。
Storm 的四个公共内存入口 ordinal 401/403/404/405 被原子安装 Hook。尺寸达到 0xFE7C 的分配进入 TLSF：
- 两级隔离适配（Two-Level Segregated Fit），查找与合并具有有界常数时间。
- 16 字节受保护路由头实现 O(1) 所有权识别，不使用热路径哈希表。
- 初始池 64 MiB，按需求扩展，统一 requested-live 上限 1 GiB。
- 支持真正的原地 realloc、池回收、统计和低地址策略。
- Release ASI 永久 pin；进程退出时不拆除仍可能被 Storm 调用的 Hook。
Storm 原生小块 arena 使用 8 字节对齐和 9 个 free bin。其快速路径存在一个已逆向确认的缺口：目标 bin 非空但其中没有足够大的块时，原实现可能不再检查更高 bin。
search 修复只在这个状态出现时检查高位 bin，把合适的块提升到目标 bin 后仍交回原生分配函数处理。常见路径只做固定条件判断；不分配辅助内存、不引入 STL 容器、不增加新锁，也不改变 Storm 块头。
- 目标 DLL 版本和 Hook 前导字节双重校验。
realloc(ptr, 0)、跨域 realloc、OOM fallback 和计数修正具有明确结果语义。- Hook attach/detach 事务检查；Release 生命周期永久 pin。
- 可选 metrics、延迟直方图、LeakProfiler 和内存安全跟踪默认关闭，避免正式热路径开销。
| 环境变量 | 默认值 | 说明 |
|---|---|---|
STORMBREAKER_NATIVE_SMALL_REPAIR |
search |
off 回退原生行为；coalesce 仅用于诊断 |
STORMBREAKER_CONTROL_PANEL_INTERVAL_SECONDS |
60 |
控制面板刷新间隔 |
STORMBREAKER_DISABLE_CONTROL_PANEL |
0 |
设为 1 关闭控制面板线程 |
STORMBREAKER_DISABLE_DEBUG_CONSOLE |
0 |
设为 1 关闭调试控制台 |
STORMBREAKER_MEMORY_MONITOR |
0 |
设为 1 开启内存监控线程 |
STORMBREAKER_TELEMETRY |
0 |
设为 1 开启详细指标与延迟统计 |
STORMBREAKER_PROFILER |
off |
off、sampled 或 full |
STORMBREAKER_MEMORY_SAFETY |
0 |
设为 1 开启完整块跟踪 |
生产构建锁定 TLSF 后端，STORMBREAKER_MEMORY_BACKEND 不会切换正式 ASI。
测试环境与口径：
- 游戏：Warcraft III 1.27a x86，模块 SHA-256 与上方支持版本表一致。
- 测试地图：
(4)生与死v1.28读档bug修复.w3x。 - 测试文件：
E:\Work\War3\Maps\(4)生与死v1.28读档bug修复.w3x。 - 正式配置：
large-four-hook、TLSF、阈值0xFE7C、原生小块修复search。 - 加载时间为用户人工计时；内存数据为进图后继续运行时的同场景快照。它们不是十轮统计基准。
| 测试批次 | 配置 | 进入地图时间 | 相对同批原版 |
|---|---|---|---|
| Search 最终单轮 | StormBreaker 1.3.0 候选版 | 23.43 秒 | 该轮未重新测原版 |
| 最终配对评估 | 原版 | 约 30 秒 | 基线 |
| 最终配对评估 | StormBreaker 1.3.0 候选版 | 约 25 秒 | 约 -5 秒（-16.7%） |
不同批次的磁盘缓存、后台负载和原版基线发生过变化，因此 23.43 秒与“约 25 秒”只作为实测范围记录，不相互取代。
一次同场景配对观察中，启用 search 的情况下修复处理了 2,527,085 次原生小块入口，其中 51,276 次成功提升高位 bin，invalidSkips=0。相对未启用修复的同一构建：
| 指标 | 同比变化 |
|---|---|
| Private bytes | -9.25 MiB |
| Virtual size | -13.24 MiB |
| 低 2 GiB 空闲空间 | +13.23 MiB |
| 最大连续空闲区 | 持平（138.05 MiB） |
| 空闲区域数量 | 287 → 282 |
绝对值如下：
| 指标 | 未启用 Search | 启用 Search | 差值 |
|---|---|---|---|
| Private bytes | 1112.57 MiB | 1103.32 MiB | -9.25 MiB |
| Virtual size | 1671.27 MiB | 1658.03 MiB | -13.24 MiB |
| 低 2 GiB 空闲空间 | 378.25 MiB | 391.48 MiB | +13.23 MiB |
| 最大连续空闲区 | 138.05 MiB | 138.05 MiB | 0 MiB |
| 空闲区域数量 | 287 | 282 | -5 |
| TLSF reserved/committed | 230 MiB | 224 MiB | -6 MiB |
| TLSF 大块 requested-live | 173 MiB | 173 MiB | 0 MiB |
Search 运行计数：
| 计数器 | 数值 |
|---|---|
repairCalls |
2,527,085 |
promotions |
51,276（约 2.03%） |
bypasses |
2,403,890（约 95.12%） |
rebuilds |
0 |
invalidSkips |
0 |
以下是研发期间同一地图的人工单轮记录，用于解释为何 1.3.0 最终没有发布全接管模式。各行来自不同开发阶段和缓存状态，只能观察量级，不能与正式配对表直接同比。
| 实验配置 | 进入地图时间 | 结论 |
|---|---|---|
| 早期原版基线 | 24.5 秒 | 对照 |
| 仅大块 TLSF | 21.0 秒 | 快于该批原版，成为正式架构基础 |
| 仅大块 mimalloc 候选 | 21.3 秒 | 与 TLSF 接近但略慢 |
| 全接管 TLSF | 42 秒 | 小块接管开销过高，未晋级 |
| 全接管 mimalloc | 48 秒 | 小块接管开销过高，未晋级 |
| 全接管 hybrid | 约 70 秒 | 路由与双后端成本过高，未晋级 |
这些数据用于证明修复方向和架构选择，不等同于跨机器统计基准。
msbuild StormBreaker.sln /t:StormMemPoolFix /p:Configuration=Release /p:Platform=x86
cmake -S StormMemPoolFix -B build-release-tests -A Win32 -DSTORMBREAKER_BUILD_TESTS=ON
cmake --build build-release-tests --config Release --target StormBreakerTests
./build-release-tests/Release/StormBreakerTests.exe
python -m unittest tools.tests.test_storm_small_allocator_model -v
python tools/package_release.py