Issue #126 point 4: same-tick A/B parity and timing record
build / mod (push) Failing after 29s

The temporary in-session shader switch (harness build, reverted) renders the
same frozen tick with both effects.wgsl versions: old-vs-new differs by at
most 1-2/255, no pixel over 5/255, and no more than two frames of the same
shader differ. Frame time is below the in-game noise floor on M5 (32
screen-filling late-life fireballs: +0.37 ms median, sigma 3.6). Includes
the hd_bench polygon_noon run and test counts.

Co-Authored-By: Kimi Code <noreply@moonshot.ai>
This commit is contained in:
2026-11-21 13:50:07 +03:00
parent 8fb849f195
commit d8d9913770
2 changed files with 221 additions and 0 deletions
@@ -0,0 +1,103 @@
# Issue #126, пункт 4: пропуск рэймарча огненного шара при нулевом fade — проверка
Мёртвая работа в `airdef-mod/shaders/effects.wgsl` (раздел «2. Fireballs and their smoke»). Счёт и
картинка не менялись ни на пиксель; меняется только то, что при `fade == 0` цикл марша больше не
крутится.
## Изменение
```wgsl
// было (для каждого шара): ds, затем сразу цикл
for (var s = 0; s < steps; s++) { ... let n = fbm(...); ... }
// стало
if fade > 0.0 {
for (var s = 0; s < steps; s++) { ... } // тот же цикл, тот же выход по trans < 0.02
}
// свечение огня после марша осталось; оно само под `if heat > 0.0`
```
Почему картинка та же: при `fade == 0` на каждом шаге `density = shape * (1.2 + n*2.0) * fade == 0`,
значит `absorb = 1 - exp(0) == 0`, `lit += trans * absorb * c` ничего не добавляет, а
`trans *= 1 - absorb` не меняет `trans`. HD-ветка гасит `fade` уже к `k = 0.28`
(`1 - smoothstep(0.08, 0.28, k)`), поэтому у позднего шара марш (6–14 вызовов `fbm` на пиксель)
не виден, но выполнялся. Свечение (`heat = 1 - smoothstep(0.05, 0.55, k)`) живёт до `k = 0.55` и
вынесено из нового условия; второй `if heat > 0.0` убирает только заведомо нулевое слагаемое.
Шаги, разрешение, плотность, семплирование, свет и туннели не тронуты.
## Стенд
- Apple M5, Metal, 2560×1440 offscreen; engine pin `3428a571b`, база мода `c08b73729`, правка
`7d77c09f0` (только `effects.wgsl`).
- Мир `Polygon` — копия в `run-home/saves` рабочего дерева (оригинальные сохранения не трогались),
свежий `HORIZON_HOME` в `run-home-bench/home` на прогон.
- Сцена: spectator, `tp @s 40.5 76 40.5 135 <pitch>`, `time set 6000`,
`advance_time/advance_weather false`, `weather clear`, `doMobSpawning false`,
`randomTickSpeed 0`, `kill @e[type=!minecraft:player]`, HUD скрыт; `HORIZON_HD_TAA=0`,
`HORIZON_HD_WIND=0`, `HORIZON_HD_CLOUDS=0`, `HORIZON_HD_VOLFOG=0`, `HORIZON_HD_WATER=0`,
`HORIZON_HD_AO=0`. В кадре только небо и один/32 шара: никакого дрейфа LOD и сущностей.
- Все прогоны игры — под `flock -x /tmp/airdef-bench.lock` (один клиент за раз).
## Пиксельный паритет: A/B на одном замороженном кадре
Кросс-процессные прогоны расходятся (LOD/стриминг, партиклы, интерполяция настроек мода по
частичному тику), поэтому сравнение сделано **в одном процессе**: временная сборка мода (в коммит
не входит, дерево после неё чистое) содержала
- `testblast` — ставит шар(ы) в фиксированной мировой точке с `start 0, life 4000`, так что
состояние зависит только от абсолютного тика;
- выбор шейдера файлом `<HORIZON_HOME>/horizon-mods/.horizon-mod-data/airdef/harness-command`
(`old` — `effects.wgsl` из `7d77c09f0~1`, `new` — из `7d77c09f0`; обе версии вкомпилированы);
- настройки мода (`set-params`, `set-lights`, `set-smoke`) выталкиваются каждый кадр, иначе хост
интерполирует последние два тика по частичному тику и кадр «плывёт» даже на паузе.
Игра ставится на паузу без меню (F3+Esc) в нужном тике, затем на **этом же тике** снимаются кадры
`new → old → new` (переключение шейдера — запись файла). `p[1020] = 1` в харнессе убирает частичный
тик из часов эффектов.
Результаты (2560×1440, кадр целиком; `mean` — средняя разница по каналам из 255, методика
`tools/hd_bench.py`: `compare_runs`, движущиеся пиксели маскируются по размаху между `new` и `new2`):
| сцена | тик | k | путь | old-vs-new mean | >20/255 | шум того же шейдера (new-vs-new2) |
|---|---|---|---|---|---|---|
| 32 шара, небо | 623 | 0.156 | активный марш | 0.0054 | 0 | 0.0030 |
| 32 шара, небо | 1603 | 0.401 | fade = 0, марш пропущен | 0.0075 | 0 | 0.0069 |
| 1 шар 20 блоков, небо | 620 | 0.155 | активный марш | 0.0455 | 0 | 0.0597 |
| 1 шар 20 блоков, небо | 1608 | 0.402 | fade = 0, марш пропущен | 0.0436 | 0 | 0.0770 |
Покадрово: максимум расхождения **1/255** (32 шара) и **2/255** (один шар), пикселей с разницей
> 5/255 — **ноль**; разница old-vs-new не больше, чем у двух кадров одного и того же шейдера.
То есть правка невидима и в активном пути, и в пропущенном.
## Пиксельный паритет в штатной сцене hd_bench
`tools/hd_bench.py --only polygon_noon` (Polygon, полдень, статичное окружение
`HORIZON_HD_WIND/CLOUDS/VOLFOG=0`), старый мод против нового, под локом:
- old: GPU 18.06 мс; new: GPU 21.29 мс (бюджет 18 мс превышен в обоих — это шум/нагрузка стенда:
тот же кадр в этой сессии давал 18–31 мс);
- сравнение кадров new к базе old: средняя разница 0.79/255, пикселей >20/255 — 0.58% (порог 5%),
т.е. в пределах мерцания TAA между прогонами; в этой сцене нет взрывов, ветка правки не
выполняется.
## Время кадра (честно)
Парные `bench` на одном замороженном кадре, шейдеры чередуются каждую секунду (снимает дрейф
частот/тепла), сцена — небо, late-life шары невидимы:
| сцена | тик | new, медиана | old, медиана | old − new |
|---|---|---|---|---|
| 32 шара (каждый ~полэкрана) | 1606 | 79.27 мс | 79.63 мс | +0.37 мс (mean +1.15, σ 3.65, N=10) |
| 1 шар на 20 блоках | 1604 | 15.49 мс | 16.30 мс | +0.82 мс (mean +0.95, σ 3.79, N=16) |
Разброс между парами больше эффекта, знак нестабилен: на M5 выигрыш **ниже шума** измерения кадра.
Это ожидаемо — экономится один 7-шаговый `fbm`-марш по площади шара на пиксель, доли миллисекунды
на типичном кадре; замер требует изоляции прохода мода (в таймингах паков прохода мода нет).
## Что проверено
- `cargo test` в `airdef-mod`: 113 lib + 1 `core_boundary` + 2 `saturation` + 5 `scenarios` = 121,
0 падений.
- `python3 tools/test_hd_bench.py`: 5 тестов OK.
- Шаги/плотность/свет/туннели не менялись: см. diff `7d77c09f0` (только `effects.wgsl`).
@@ -0,0 +1,118 @@
{
"issue": 126,
"point": 4,
"base": "c08b73729",
"engine_pin": "3428a571b",
"change": "7d77c09f0",
"method": "same-process same-frozen-tick A/B (temporary harness build, reverted); pair benches interleaved",
"scene": {
"world": "Polygon (copy)",
"resolution": [
2560,
1440
],
"env": {
"HORIZON_HD_TAA": "0",
"HORIZON_HD_WIND": "0",
"HORIZON_HD_CLOUDS": "0",
"HORIZON_HD_VOLFOG": "0",
"HORIZON_HD_WATER": "0",
"HORIZON_HD_AO": "0"
},
"tick_clock": "p[1020]=1 (no partial tick), blast start 0 life 4000",
"parity_frames": {
"32_blasts": [
"/tmp/st4/new_623.png",
"/tmp/st4/old_623.png",
"/tmp/st4/new2_623.png",
"/tmp/st4/new_1603.png",
"/tmp/st4/old_1603.png",
"/tmp/st4/new2_1603.png"
],
"one_blast": [
"/tmp/st3/new_620.png",
"/tmp/st3/old_620.png",
"/tmp/st3/new2_620.png",
"/tmp/st3/new_1608.png",
"/tmp/st3/old_1608.png",
"/tmp/st3/new2_1608.png"
]
}
},
"pixel_parity": [
{
"scene": "32 blasts, sky",
"tick": 623,
"k": 0.156,
"path": "march runs (fade>0)",
"old_vs_new_mean_255": 0.0054,
"px_over_20": 0,
"same_shader_floor_mean_255": 0.003,
"max": 1
},
{
"scene": "32 blasts, sky",
"tick": 1603,
"k": 0.401,
"path": "march skipped (fade=0)",
"old_vs_new_mean_255": 0.0075,
"px_over_20": 0,
"same_shader_floor_mean_255": 0.0069,
"max": 1
},
{
"scene": "one blast at 20 blocks, sky",
"tick": 620,
"k": 0.155,
"path": "march runs (fade>0)",
"old_vs_new_mean_255": 0.0455,
"px_over_20": 0,
"same_shader_floor_mean_255": 0.0597,
"max": 2
},
{
"scene": "one blast at 20 blocks, sky",
"tick": 1608,
"k": 0.402,
"path": "march skipped (fade=0)",
"old_vs_new_mean_255": 0.0436,
"px_over_20": 0,
"same_shader_floor_mean_255": 0.077,
"max": 2
}
],
"frame_time": [
{
"scene": "32 blasts, late life",
"tick": 1606,
"new_median_ms": 79.274,
"old_median_ms": 79.628,
"old_minus_new_median_ms": 0.37,
"old_minus_new_mean_ms": 1.15,
"stdev_ms": 3.65,
"pairs": 10
},
{
"scene": "one blast at 20 blocks, late life",
"tick": 1604,
"new_median_ms": 15.493,
"old_median_ms": 16.302,
"old_minus_new_median_ms": 0.82,
"old_minus_new_mean_ms": 0.95,
"stdev_ms": 3.79,
"pairs": 16
}
],
"hd_bench_polygon_noon_static": {
"old_gpu_avg_ms": 18.06,
"new_gpu_avg_ms": 21.29,
"budget_ms": 18,
"vs_baseline_mean_255": 0.79,
"vs_baseline_pct_over_20": 0.58,
"note": "no blasts in the scene; the changed branch is not taken; budget exceeded in both runs (this session's same scene ranged 18-31 ms)"
},
"tests": {
"cargo test airdef-mod": "121 passed, 0 failed",
"tools/test_hd_bench.py": "5 passed"
}
}