AX Code holen · KostenlosDokumentation
AX Code.
de
English繁體中文简体中文日本語한국어FrançaisDeutschBahasa IndonesiaItalianoPortuguês (Brasil)РусскийEspañolTürkçeTiếng Việt
Loslegen

Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Ausführungsnachweise

Status: Aktiv Umfang: aktueller Stand Zuletzt geprüft: 2026-08-25 Verantwortlich: AX-Code-Laufzeit

Jede AX-Code-Sitzung wird aufgezeichnet, während sie läuft. Diese Seite behandelt die Befehle, die aus dieser Aufzeichnung etwas machen, das Sie prüfen, vergleichen, exportieren und rückgängig machen können.

Verwenden Sie sie, wenn ein Agent fertig ist und Sie beantworten müssen: Was hat er getan, wie riskant war es, wie verglich es sich mit einem anderen Versuch, und wie komme ich zurück?

Was aufgezeichnet wird

Während eines Laufs schreibt AX Code zwei unabhängige Dinge:

  • Ein typisiertes Ereignisprotokoll — Routing-Entscheidungen, Modellaktivität, Schrittgrenzen, Toolaufrufe und Toolergebnisse. Das ist die Quelle für graph, replay, compare, trace und audit.
  • Dateischnappschüsse — erfasst in einem Git-Objektspeicher, der außerhalb Ihres Repositorys liegt, unter dem Datenverzeichnis von AX Code, mit refs/snapshots/<hash>. Ihr Arbeitsbaum und das .git/ Ihres Projekts werden nicht verändert, um sie zu speichern.

Beides ist lokal. Nichts wird hochgeladen.

Einen Lauf rekonstruieren

ax-code graph <sessionID>

Baut die Sitzung als Ausführungsgraphen neu auf: Dauer, Risikozusammenfassung, Tokenzahlen, verwendete Agenten und jeden Schritt mit seinen Toolaufrufen und Zeiten.

## 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 wählt alternative Ausgaben, einschließlich Mermaid und einer Topologieansicht, wenn Sie den Graphen in einem anderen Werkzeug wollen.

Beachten Sie, dass dies der Ausführungsgraph der Sitzung ist — was der Agent getan hat. Es ist nicht der Codegraph des Repositorys. Das sind ax-code index und die Schicht der Codeintelligenz.

Zwei Läufe vergleichen

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

Meldet das Risikodelta, geänderte Dateien, Zählungen von Toolfehlern, den Entscheidungspfad jedes Laufs und Zählungen je Ereignistyp. --deep fügt eine Divergenzanalyse auf Schrittebene durch Wiedergabevergleich hinzu.

Das vergleicht Läufe, nicht Quellcode. Es beantwortet „der zweite Versuch schnitt schlechter ab — wo ist er abgewichen“, nicht „zeig mir den Code-Diff“.

Eine typische Nutzung ist die Entscheidung zwischen zwei Strategien für dieselbe Aufgabe:

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

Das aufgezeichnete Ereignisprotokoll prüfen

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 prüft das aufgezeichnete Protokoll auf Konsistenz. reconstruct baut den Schrittstrom aus Ereignissen neu auf. export schreibt ein portables Wiedergabepaket.

Die Wiedergabe rekonstruiert und führt nicht erneut aus. Modelle werden nicht erneut ausgeführt, Tools nicht erneut aufgerufen, und äußerer Zustand wird nicht reproduziert. Der Modus execute bereitet einen rekonstruierten Strom für den programmatischen Vergleich mit dem Original vor und ist zum Testen gedacht, nicht zum erneuten Ausführen von Arbeit.

Die Risikosignale lesen

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

Die Punktzahl ist eine deterministische Heuristik aus aufgezeichneten Signalen, darunter wie viele Dateien sich geändert haben, ob die Änderung mehrere Bereiche der obersten Ebene überspannt, wie viele Toolaufrufe fehlschlugen, ob eine Validierung lief, ob ein Diff-Schnappschuss existiert, wie viel API-Oberfläche betroffen ist, wie der Lauf endete (eine blockierte Abschlussschranke oder ein Ende an der Schrittgrenze oder durch Stillstand erhöhen beide das Gewicht) und ob sicherheitsempfindliche Pfade berührt wurden. Jeder beitragende Treiber wird mit seinem Gewicht aufgeführt, zusammen mit vorgeschlagenen Abmilderungen.

Die Punktzahl ist eine Prüfhilfe, keine Wahrscheinlichkeit, kein kalibriertes Vertrauen und keine Aussage, dass der Code sicher ist. Eine niedrige Punktzahl bei einer ungeprüften Änderung bedeutet weiterhin, dass die Änderung ungeprüft ist.

Genau rückgängig machen

Dateischnappschüsse funktionieren in Git-Repositories und gewöhnlichen Projektverzeichnissen, wenn Git installiert ist und snapshot aktiv ist. AX Code hält seinen Schnappschuss-Git-Speicher außerhalb Ihres Projekts. Es erzeugt kein Projektverzeichnis .git. Ignorierregeln und Ausschlüsse nicht unterstützter Pfade gelten weiterhin.

TUI-Revert macht Nachrichten und erfasste Dateiänderungen rückgängig. Mit snapshot: false oder bei älteren Runden, die nie eine Basislinie erfasst haben, kann es nur Nachrichten rückgängig machen. Dateibearbeitungen bleiben auf der Platte. Schnappschüsse jetzt zu aktivieren kann frühere Dateiinhalte nicht rekonstruieren. Eine erfasste Runde ohne Dateiänderungen hat ebenfalls nichts wiederherzustellen.

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 kombiniert dauerhafte Schrittereignisse mit dem Detail des Ausführungsgraphen, damit Sie einen bestimmten Schritt ansteuern können, statt den gesamten Lauf zurückzunehmen. --dry-run verwendet denselben Rücknahmeplaner wie das Anwenden und listet delegierte Sitzungen, deren Dateibuch dazu beiträgt.

Die Rücknahme folgt verschachtelten Kindersitzungen, wenn sie in das genaue Arbeitsverzeichnis des Elternteils geschrieben haben, stellt deren Dateiänderungen nach der Grenze wieder her und behält ihre Transkripte. Nachfahren, die in einem anderen Worktree oder Verzeichnis laufen, sind ausgeschlossen, und die Rücknahme scheitert geschlossen, wenn eine eingeschlossene Sitzung noch läuft.

Grenzen, die Sie kennen sollten, bevor Sie sich darauf verlassen: Die Rücknahme stellt aus Schnappschüssen wieder her, die während des Laufs genommen wurden. Eine Datei, die nie erfasst wurde — weil sie außerhalb der Sitzung geändert wurde oder nicht in einem wiederherstellbaren Zustand war — lässt sich so nicht wiederherstellen. Verwenden Sie --dry-run zuerst bei allem Folgenreichen.

Eine andere Strategie versuchen

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

Forkt den gespeicherten Zustand der Sitzung, damit ein zweiter Versuch von einem gewählten Punkt startet statt von vorn.

Das forkt den Sitzungszustand — Nachrichten und Ziele. Es ist kein Git-Branch und kein Worktree. Für isolierte Git-Kandidaten siehe Geprüfte Änderungen mit mehreren Modellen.

Diagnostizieren

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

Wiedergabegestützte Diagnosen mit einer risikobewerteten Zeitlinie. --logs wechselt zur Analyse älterer Protokolldateien statt Wiedergabeereignissen, was nützlich ist, wenn Sie ein Betriebsproblem untersuchen statt eine Änderung zu prüfen.

Die Nachweise exportieren

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 und OTLP machen den Laufdatensatz für Ihre eigene Prüf- oder Beobachtungspipeline verbrauchbar. Der Markdown-Bericht ist für Menschen gedacht, die Nachweise an einen PR oder einen Änderungsdatensatz anhängen.

Es durchsuchen

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

Öffnet den lokalen Laufbericht in einem Browser mit Laufzusammenfassung, Zeitlinie, Änderungen, Validierungszustand, Risikodetail, Branch-Information und Rücknahmepunkten. Der Server bindet nur an Loopback.