Получить AX Code · БесплатноДокументация
AX Code.
ru
English繁體中文简体中文日本語한국어FrançaisDeutschBahasa IndonesiaItalianoPortuguês (Brasil)РусскийEspañolTürkçeTiếng Việt
Начать

Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Свидетельства выполнения

Статус: действует Область: текущее состояние Последняя проверка: 2026-08-25 Владелец: среда выполнения AX Code

Каждый сеанс AX Code записывается, пока идёт. Эта страница описывает команды, которые превращают запись в то, что можно рецензировать, сравнивать, экспортировать и отменять.

Пользуйтесь ею, когда агент закончил и нужно ответить: что он сделал, насколько это было рискованно, как это сравнивается с другой попыткой и как вернуться назад.

Что записывается

Во время прогона AX Code пишет две независимые вещи:

  • Типизированный журнал событий — решения маршрутизации, активность модели, границы шагов, вызовы инструментов и результаты инструментов. Это источник для graph, replay, compare, trace и audit.
  • Снимки файлов — попадают в хранилище объектов Git, которое живёт вне вашего репозитория, в каталоге данных AX Code, через refs/snapshots/<hash>. Рабочее дерево и .git/ проекта для их хранения не меняются.

Оба локальны. Ничего не отправляется.

Восстановление прогона

ax-code graph <sessionID>

Собирает сеанс как граф выполнения: длительность, сводка риска, счётчики токенов, использованные агенты и каждый шаг с вызовами инструментов и таймингами.

## Session ses_01H8XK

Duration: 9m 54s | Risk: HIGH (53/100) | Tokens: 167,650 in / 18,494 out
Agents: architect

### Step 1 (8s) | tokens: 12263/587

- read: api.ts → ok (5ms)
- grep: rateLimit → ok (12ms)

--format выбирает другие виды вывода, включая Mermaid и вид топологии, когда граф нужен в другом инструменте.

Заметьте: это граф выполнения сеанса — что сделал агент. Это не граф кода репозитория. Тот — ax-code index и слой разведки кода.

Сравнение двух прогонов

ax-code session compare <sessionA> <sessionB>
ax-code session compare <sessionA> <sessionB> --deep

Сообщает дельту риска, изменённые файлы, число неудач инструментов, путь решений каждого прогона и счётчики по типам событий. --deep добавляет анализ расхождения на уровне шагов через сравнение воспроизведения.

Это сравнивает прогоны, а не исходный код. Ответ на вопрос «вторая попытка оценена хуже — где она разошлась», а не «покажи diff кода».

Типичное применение — выбор между двумя стратегиями одной задачи:

  Risk Comparison
  ----------------------------------------
  Score: 53 → 93 (+40) ↑
  Level: HIGH → CRITICAL
  Files: 8 → 25
  Failures: 0 → 15

Осмотр записанного журнала событий

ax-code session replay <sessionID> --mode summary
ax-code session replay <sessionID> --mode verify
ax-code session replay <sessionID> --mode reconstruct
ax-code session replay <sessionID> --mode export

verify проверяет записанный журнал на согласованность. reconstruct восстанавливает поток шагов из событий. export пишет переносимый пакет воспроизведения.

Воспроизведение восстанавливает, а не выполняет заново. Оно не перезапускает модели, не вызывает инструменты снова и не воспроизводит внешнее состояние. Режим execute готовит восстановленный поток для программного сравнения с оригиналом и предназначен для проверок, а не для повторного выполнения работы.

Чтение сигналов риска

ax-code risk <sessionID>
ax-code risk <sessionID> --explain
ax-code risk <sessionID> --json

Оценка — детерминированная эвристика, выведенная из записанных сигналов: сколько файлов изменилось, охватывает ли изменение несколько областей верхнего уровня, сколько вызовов инструментов не удалось, запускалась ли валидация, есть ли снимок diff, насколько затронута поверхность API, как закончился прогон (заблокированный шлюз завершения или финиш по пределу шагов либо зависанию добавляют вес) и затронуты ли пути, чувствительные к безопасности. Каждый вносящий фактор перечислен со своим весом и предлагаемыми смягчениями.

Это помощь рецензии. Это не вероятность, не калиброванная уверенность и не заявление, что код безопасен. Низкая оценка непроверенного изменения всё ещё значит, что изменение не проверено.

Точная отмена

Снимки файлов работают в репозиториях Git и обычных каталогах проекта, когда Git установлен и snapshot включён. AX Code держит своё хранилище снимков Git вне проекта и не создаёт каталог проекта .git. Правила игнорирования и исключения неподдерживаемых путей всё ещё действуют.

Откат TUI отменяет сообщения и захваченные изменения файлов. С snapshot: false или для более старых ходов, которые никогда не захватили базовую линию, он может отменить только сообщения. Правки файлов остаются на диске. Включение снимков сейчас не восстановит прежнее содержимое файлов. У захваченного хода без изменений файлов тоже нечего восстанавливать.

ax-code session rollback <sessionID> --list      # show recoverable points
ax-code session rollback <sessionID> --dry-run   # show what would change
ax-code session rollback <sessionID> --step 4    # restore one step
ax-code session rollback <sessionID>             # restore the whole session

--list сочетает устойчивые события шагов с подробностями графа выполнения, чтобы можно было целиться в конкретный шаг, а не откатывать весь прогон. --dry-run использует тот же планировщик отката, что и применение, и перечисляет делегированные сеансы, чей журнал файлов входит в результат.

Откат следует за вложенными дочерними сеансами, когда они писали в точный рабочий каталог родителя. Он восстанавливает их изменения файлов после границы и сохраняет их расшифровки. Потомки, работающие в другом рабочем дереве или каталоге, исключены, а откат закрывается при сбое, если любой включённый сеанс ещё идёт.

Границы, которые стоит знать, прежде чем на это полагаться. Откат восстанавливает из снимков, сделанных во время прогона. Файл, который никогда не снимали — потому что его изменили вне сеанса или он не был в восстановимом состоянии, — этим способом не вернуть. Для всего существенного сначала используйте --dry-run.

Другая стратегия

ax-code session branch <sessionID>
ax-code session branch <sessionID> --from <messageID>

Ответвляет сохранённое состояние сеанса, чтобы вторая попытка началась с выбранной точки, а не с нуля.

Это ответвляет состояние сеанса — сообщения и цели. Это не ветвь Git и не рабочее дерево. Об изолированных кандидатах Git см. проверенные изменения несколькими моделями.

Диагностика

ax-code session trace <sessionID>
ax-code session trace <sessionID> --logs

Диагностика на воспроизведении со шкалой времени, оценённой по риску. --logs переключается на анализ устаревшего файла журнала вместо событий воспроизведения. Это полезно, когда вы разбираете операционную проблему, а не рецензируете изменение.

Экспорт свидетельств

ax-code audit export --all --since 2026-08-01     # JSON Lines
ax-code audit export --all --risk HIGH            # filter by minimum risk
ax-code audit report <sessionID>                  # Markdown report
ax-code audit otlp <sessionID>                    # OpenTelemetry spans
ax-code audit prune --days 90                     # delete old events

JSONL и OTLP делают запись прогона пригодной для вашего конвейера рецензии или наблюдаемости. Отчёт Markdown предназначен людям, которые прикладывают свидетельства к запросу на изменение или к записи об изменении.

Просмотр

ax-code run-report                 # latest session
ax-code run-report --index         # session index

Открывает локальный отчёт о прогоне в браузере: сводка прогона, шкала времени, изменения, состояние валидации, подробности риска, сведения о ветви и точки отката. Сервер привязывается только к loopback.