Files
airdef/docs/measurements/issue-126-first-stage
chexit 1e2d5dd0c0
build / mod (push) Failing after 55s
Record #126 first stage: retained mod-model meshes, measured
Engine a861c1ed2 (kimi-work-124), based on ed751714e: mod-model faces resolved once per pack generation, frames only transform and light them; motion #124 from the same faces; counters and span; reload/unload invalidate the cache. HD-RENDERER status + section, and docs/measurements/issue-126-first-stage with the A/B method and numbers (M5/Metal, Polygon raid: entity_geometry CPU 5.71 -> 1.57 ms avg, prepare 23.5 -> 7.05 ms; static scene pixel-identical; reload/unload smoke). Not GPU instancing; 5600X/3060 acceptance pending. Issue #126 stays open.

Co-Authored-By: Kimi Code <noreply@moonshot.ai>
2026-11-20 21:46:46 +03:00
..

Issue #126, этап 1: retained-геометрия моделей мода — замеры

Первый самостоятельный этап направления A #126: грани моделей мода резолвятся против атласа один раз на generation пака, кадр только трансформирует и освещает их. Это не GPU-instancing: вершины по-прежнему собираются на CPU и загружаются каждый кадр; объём upload не менялся. Изменение только в рендере (game/mod_models.rs + span/счётчики/инвалидация), боевая симуляция (WASM-мод) не тронута — тот же airdef.hmod в обоих прогонах A/B.

Стенд

  • Apple M5 (10 ядер, 16 ГБ), macOS, Metal. Ryzen 5600X / RTX 3060 не профилировались — приёмка на целевом железе pending (контракт #126).
  • Engine pin ed751714e (ветка форка agent/126-engine-first-stage), AirDef base 60f1bf0fd. Baseline-бинарник — тот же pin без правки; after — с правкой. Оба --profile fast --features mods.
  • 2560×1440 offscreen (окно 1280×720 @2x), пресет HD, HORIZON_HD_SCALE=1, in-frame (--in-frame: фидбек мода читается chat-log, тик в кадре — одинаково в A/B), HORIZON_NO_AUDIO=1, HORIZON_SPIKES=0 (span каждого кадра в логе), HORIZON_SHADER_PACK_TIMING=1. Одна игра за раз; чужих игр во время парных прогонов не было.
  • Мир Polygon (копия run-home/saves/Polygon), свежий HORIZON_HOME на прогон. Камера tp @s 40 76 40 135 25, time set 6000, advance_time/advance_weather false, weather clear, creative, HUD скрыт.

Сцена и драйвер

Драйвер — scratch-скрипт /tmp/airdef-issue126-run/profile.py (в коммит не входит; команды и тайминги зафиксированы здесь и в report.json):

  1. 14 батарей: airdef deploy s400/patriot/pantsir/gepard/nasams/irist/tor ×2.
  2. Raid: airdef wave shahed 40 900, airdef wave kh101 16 1400, airdef wave mix 24 700. Волна принимается не сразу: противник ищет площадки и ждёт terrain (~15–20 с), факт принятия проверялся по чату («ВОЗДУШНАЯ ТРЕВОГА», «В воздухе: N») и counters mod_models.models.
  3. bench N (сброс frame-stats и counters, ответ — p50/p95/p99/max frame/CPU/GPU + фазы), stats (counters mod_models), sample процесса на окно bench, скриншот.

Static-сцена: только батареи, HORIZON_HD_TAA=0 HORIZON_HD_WIND=0 HORIZON_HD_CLOUDS=0 HORIZON_HD_VOLFOG=0, 3 кадра подряд; движущиеся пиксели (вода) маскируются по размаху >16/255 между кадрами одного прогона (методика tools/hd_bench.py), сравнение A/B — по статичным.

Результаты (парные прогоны, одна сцена)

Raid, develop 30 с + bench 12 с (before-raid3 / after-raid), ~135 моделей/кадр:

Метрика before after
entity_geometry CPU avg / p95 / p99, мс 5.71 / 8.7 / 10.6 1.57 / 2.2 / 2.7
фаза prepare avg, мс 23.49 7.05
frame CPU avg / p50 / p95 / p99, мс 78.8 / 75.5 / 133.0 / 263.4 71.8 / 65.3 / 112.7 / 181.0
span mod_models CPU avg / p95 / p99, мс — (внутри entity_geometry) 1.32 / 2.0 / 2.3

Combat-плотный raid, develop 45 с + bench 15 с (before-combat / after-combat); фазы боя не синхронизированы по тикам (before: 28 в воздухе, 12 сбито; after: 40 в воздухе, 0 сбито):

Метрика before after
entity_geometry CPU avg / p95 / p99, мс 6.5 / 12.1 / 15.0 1.95 / 3.3 / 4.4
фаза prepare avg, мс 20.13 7.78
frame CPU avg / p50 / p95 / p99, мс 85.8 / 84.8 / 127.2 / 167.5 49.5 / 48.9 / 71.8 / 77.1

Counters mod_models (after-raid, окно bench, 155 кадров): models 21001 (~135/кадр), quads 2 760 334 (~17.8 тыс./кадр), vertex_bytes 485.8 МБ (~3.1 МБ/кадр, 44 Б/вершина), motion_bytes 618.3 МБ (~4 МБ/кадр, 56 Б/вершина), mesh_builds 0, atlas_scans 0 — в установившемся кадре bake нет, только трансформы. Байты upload до/после одинаковы (вершины те же).

Static (4 батареи, ~60 моделей/кадр): prepare 6.38 → 1.51 мс, frame CPU p50 15.1 → 10.9 мс, p95 42.7 → 15.5, p99 77.1 → 18.3 (settle 8 с). Пиксели A/B при settle 25 с (LOD сошёлся): 0 статичных пикселей с разницей >20/255 из 3.44 млн (93.2% кадра статичны), mean abs diff 0.128. При settle 8 с разница 3991 px (0.116%) — вся в полосе горизонта y≤385 (дальний LOD не сошёлся, after-бинарник быстрее → другое состояние LOD к снимку); baseline↔baseline при том же settle — 14 px.

Reload и world unload (lifecycle-smoke)

lifecycle.py: батареи → скриншот → F3+T (reload) → скриншот → Esc → «Save and Quit to Title» → open Polygon → батареи → скриншот. Counters after: atlas_scans 1 → 2 → 3, mesh_builds 17 → 34 → 51 (17 состояний моделей перестроены после reload и после unload), модели рисуются в каждом этапе. Пиксели pre/post reload при 25 с ожидания: before 0.3003%, after 0.2982% статичных пикселей >20/255 — одинаковая у обоих бинарников остаточная разница самого reload (атлас/LOD после clear_lod), не регрессия правки; при 12 с ожидания разница больше у обоих (LOD не сошёлся), вся в полосе горизонта, на моделях — ноль.

Тесты

cd horizon && cargo test --profile fast -p horizon-client --bin horizon-client --features mods mod_models::tests
  • retained_emit_matches_the_per_frame_bake — вершины retained-пути бит-в-бит равны прежнему покадровому bake (block_model_vertices + material/post-pass) на матрице трансформов (scale × rotation × translation) × glow × light × emission, включая previous-позиции motion (#124).
  • special_materials_match_names_and_centres — таблица special-материалов и строгие границы прямоугольников (центр квада).

Ограничения и что дальше

  • Замеры только на M5/Metal; 5600X/3060 и M5-боевой p99-trace — pending acceptance #126.
  • In-frame режим замера (тик в кадре); server-thread путь проверен smoke-прогоном (HD, модели, reload работают), парные замеры в нём не снимались.
  • Фазы боя в A/B не синхронизированы по тикам (wall-clock waits); ordered combat trace harness не строился — правка только рендерная, sim/RNG не тронуты (diff scope).
  • Upload bytes/frame не уменьшены: GPU-instancing (per-instance буферы, GPU-интерполяция, indirect draws) — следующий этап A. HD smoke (направление B) не тронут.
  • Скрипты драйверов — scratch (/tmp/airdef-issue126-run/), в репозиторий не входят; воспроизведение — по командам выше и report.json.