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