docs: record API27 readiness and reverse logistics verification
build / mod (push) Failing after 19s
build / mod (push) Failing after 19s
Document capability milestones, budget limits versus measurements, real-game no-audio observations, reverse pickup reservation and the Windows stale-URL fix. Co-authored-by: Codex <codex@openai.com>
This commit is contained in:
+53
-1
@@ -59,4 +59,56 @@ runtime закреплённого движка. Используется вре
|
||||
и причина (`awaiting-frame`, `disabled`, `path-unavailable`, `ready`). AirDef убирает обычный дым
|
||||
только когда выполнены все четыре условия; после смены мира старые сегменты и часы очищаются.
|
||||
Это подтверждение выбранного пути рендера, а не завершения GPU или видимости каждого сегмента.
|
||||
Для акустики и capture аналогичное подтверждение этим API не реализовано.
|
||||
Сам `smoke-status` не подтверждает акустику и capture; их отдельные статусы добавлены в API 27 ниже.
|
||||
|
||||
## Акустика и владение захватом (API 27)
|
||||
|
||||
Текущий pin: `c89c78c47047fcfc0dfb0b8968600c650bf12d2b`. Новые
|
||||
`render.acoustics-status` и `render.capture-owner-status` возвращают поколение,
|
||||
`available`, `enabled`, `request-accepted`, `prepared` и причину. В игре всё это показывает
|
||||
`/airdef capabilities`. Отсутствие запроса, выключение, ожидание backend и ошибка различаются.
|
||||
|
||||
Для акустики `prepared` означает выполненный шаг обработки с геометрией при доступном live/offline
|
||||
микшере. Шаг может поставить worker job или принять результаты; это **не** подтверждение результата
|
||||
для каждого источника, завершения worker, слышимого звука или точного отражения. В режиме no-audio
|
||||
без offline-микшера готовность не наступает. AirDef подтверждает текущее глобальное предпочтение,
|
||||
не меняя его, и сохраняет собственные дальние варианты звука до подтверждённой подготовки.
|
||||
|
||||
Для capture запрос принадлежит конкретному запуску мода и поколению мира. `prepared` соответствует
|
||||
его стадиям Recording/Encoding/Done; состояние файла и ошибка по-прежнему читаются из `capture-status`.
|
||||
AirDef не принимает чужие Recording/Done за свой экспорт. Ожидание первоначальной подготовки
|
||||
ограничено 600 тиками. Остановка проверяет владельца; смена мира отменяет модовый захват и
|
||||
сбрасывает готовность. Уже переданный writer файл на Encoding может всё же завершиться:
|
||||
это запрос отмены, не гарантия удаления файла.
|
||||
|
||||
## Отдельный тяжёлый WASM tier
|
||||
|
||||
```sh
|
||||
python3 tools/airdef.py test-budgets
|
||||
python3 tools/test_budget_report.py
|
||||
python3 tools/test_airdef_build.py
|
||||
```
|
||||
|
||||
Сценарий `airdef-mod/tests/budgets/wasm_budget.toml` запускается в изолированном временном `tests/`,
|
||||
поскольку CLI читает только непосредственные `tests/*.toml`. Обычный `test-wasm` остаётся лёгким.
|
||||
Ручной workflow `.gitea/workflows/wasm-budget.yml` не добавляет нагрузку на каждый push.
|
||||
|
||||
Проверенный профиль: 64 комплекса, две перекрывающиеся волны по 80 целей на 4000 блоках,
|
||||
602 вызова tick и 300 frame, 69 шагов. Это не полный лимит расстановки (2000) и не нагрузочный
|
||||
тест GPU, mixer voices или всех физических world replies: sandbox не выполняет настоящий рендер/звук.
|
||||
Отчёт `.horizon-cache/wasm-budget-report.json` содержит SHA/dirty/diff AirDef, pin/identity движка,
|
||||
API/WIT/артефакт, проверку build identity, сценарий, Wasmtime и исходные memory/fuel limits.
|
||||
`AIRDEF_BUDGET_REPORT` меняет путь отчёта. Stale identity запрещает запуск, ошибки сборки/тестов
|
||||
записываются как failed и дают ненулевой exit code.
|
||||
|
||||
Лимиты берутся из исходников: memory 64 MiB; fuel init/tick/frame/event — 2B/300M/10M/1B.
|
||||
**Фактический расход fuel и peak memory не измеряются этим отчётом.** Сохранённый успешный прогон:
|
||||
[API27 budget report](measurements/api27-wasm-budget.json).
|
||||
|
||||
Проверены реальный WASM guest с переходами состояний/владельца/мира, сборка клиента и два коротких
|
||||
offscreen-профиля Metal. При `HORIZON_ACOUSTICS=1` + `HORIZON_NO_AUDIO=1` в игре получено
|
||||
enabled/request=true, prepared=false, awaiting-backend; HD smoke переходит в ready после подготовки
|
||||
основного кадра. Это не замер производительности и не прослушивание.
|
||||
|
||||
Остаток #102: аналогичные статусы света/камер/источников звука, полные query/voice/peak budgets,
|
||||
GPU/готовый MP4 и платформенная приёмка. Эти результаты текущими тестами не объявляются выполненными.
|
||||
|
||||
Reference in New Issue
Block a user