Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал
Устойчивость
Статус: активно
Область: текущее состояние
Последняя проверка: 2026-07-18
Владелец: среда выполнения ax-code
Как AX Code остаётся надёжным в долгих интерактивных сессиях и безголовых запусках.
Слои
| Слой | Что усилено | Ключевые модули |
|---|---|---|
| Жизненный цикл TUI | Приостановка и возобновление, восстановление терминала после сбоя, очистка памяти при уходе из сессии | ADR-047; cli/tui/util/* |
| Сбои процессов | Прерывание, отмена и broken pipe игнорируются; настоящие сбои всё равно завершают процесс | util/harmless-interrupt, обработчик сбоев TUI, хуки загрузки CLI |
| Тайм-ауты | Границы инструментов, LSP и MCP без необработанного unhandledRejection | util/timeout.withTimeout |
| Потоки | Сторож простоя, устойчивое переподключение | сторож простоя session/llm-impl; resilient-stream |
| Разрешения | Защёлка двойной отправки и тайм-аут ответа | permission-submit-latch, запрос разрешения |
| Вики репозитория | Удержание путей, атомарная запись манифеста последней, защищённое содержимое, проверка перед записью | packages/ax-wiki; src/wiki/* |
Поддерживаемый путь TUI
Поддерживаемый стек среды выполнения:
- Среда выполнения: Node в комплекте
- Интерфейс: AX Code TUI + Solid (основной вариант по умолчанию)
- Отрисовка: Zig (производственная); нативные библиотеки полностью включены в репозиторий
(внутри автономного каркаса ax-tui, закреплено хешем в его
vendor/manifest.json) — вышестоящие пакеты npm@opentui/*не участвуют ни при установке, ни во время выполнения - Yoga не является выбираемым режимом; нативный отрисовщик AX Code TUI остаётся вариантом по умолчанию
Отмены и сбои
| Сигнал | Ожидаемое поведение |
|---|---|
Прерывание пользователем / Esc / отмена инструмента (AbortError) |
Журнал на уровне warn, если не обработано; не завершать TUI |
Обрыв канала (EPIPE), когда оболочка закрывается |
Игнорировать как безвредное |
| Неперехваченное исключение приложения | Сбросить терминал, выйти с ненулевым кодом |
| Поток слишком долго простаивает | Прервать ход через сторож простоя потока (настраивается) |
Переопределите тайм-аут простоя потока через AX_CODE_STREAM_IDLE_TIMEOUT_MS (0 отключает).
Запросы разрешений
Ответы на разрешения:
- Зафиксированы защёлкой — только один ответ в полёте на идентификатор запроса
- Снова взводятся, когда следующий запрос в очереди становится активным
- Истекают через 20 с, чтобы зависший сервер не мог навсегда заблокировать «Разрешить»
Связанные документы
- Песочница — изоляция выполнения
- Автономный режим — работа без присмотра
- AX Wiki — семантический слой с опорой на источники (не замена графа)