Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris
Bukti eksekusi
Status: Aktif Cakupan: kondisi terkini Terakhir ditinjau: 2026-08-25 Pemilik: runtime AX Code
Setiap sesi AX Code dicatat saat berjalan. Halaman ini mencakup perintah yang mengubah rekaman itu menjadi sesuatu yang dapat Anda tinjau, bandingkan, ekspor, dan batalkan.
Pakai saat agen selesai dan Anda perlu menjawab: apa yang dilakukannya, seberapa berisiko, bagaimana perbandingannya dengan percobaan lain, dan bagaimana saya kembali?
Yang tercatat
Selama jalankan AX Code menulis dua hal yang independen:
- Log peristiwa bertipe — keputusan perutean, aktivitas model, batas langkah, panggilan alat, dan hasil alat. Ini sumber untuk
graph,replay,compare,trace, danaudit. - Cuplikan berkas — ditangkap ke penyimpanan objek Git yang berada di luar repositori Anda, di bawah direktori data AX Code, memakai
refs/snapshots/<hash>. Pohon kerja Anda dan.git/proyek Anda tidak diubah untuk menyimpannya.
Keduanya lokal. Tidak ada yang diunggah.
Rekonstruksi jalankan
ax-code graph <sessionID>
Membangun ulang sesi sebagai graf eksekusi: durasi, ringkasan risiko, jumlah token, agen yang dipakai, dan setiap langkah dengan panggilan alat serta waktunya.
## 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 memilih keluaran alternatif, termasuk Mermaid dan tampilan topologi, bila Anda ingin graf di alat lain.
Perhatikan bahwa ini adalah graf eksekusi sesi — apa yang dilakukan agen. Ini bukan graf kode repositori; itu adalah ax-code index dan lapisan kecerdasan kode.
Bandingkan dua jalankan
ax-code session compare <sessionA> <sessionB>
ax-code session compare <sessionA> <sessionB> --deep
Melaporkan delta risiko, berkas yang berubah, jumlah kegagalan alat, jalur keputusan yang diambil setiap jalankan, dan hitungan per jenis peristiwa. --deep menambahkan analisis divergensi tingkat langkah melalui perbandingan pemutaran ulang.
Ini membandingkan jalankan, bukan kode sumber. Ia menjawab “percobaan kedua mencetak lebih buruk — di mana ia menyimpang,” bukan “tunjukkan diff kode.”
Pemakaian yang khas adalah memutuskan di antara dua strategi untuk tugas yang sama:
Risk Comparison
----------------------------------------
Score: 53 → 93 (+40) ↑
Level: HIGH → CRITICAL
Files: 8 → 25
Failures: 0 → 15
Periksa log peristiwa tercatat
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 memeriksa log tercatat untuk konsistensi. reconstruct membangun ulang aliran langkah dari peristiwa. export menulis paket pemutaran ulang yang portabel.
Pemutaran ulang merekonstruksi; ia tidak mengeksekusi ulang. Ia tidak menjalankan ulang model, memanggil ulang alat, atau mereproduksi keadaan eksternal. Mode execute menyiapkan aliran yang direkonstruksi untuk perbandingan terprogram terhadap yang asli dan ditujukan untuk pengujian, bukan untuk menjalankan ulang pekerjaan.
Baca sinyal risiko
ax-code risk <sessionID>
ax-code risk <sessionID> --explain
ax-code risk <sessionID> --json
Skor adalah heuristik deterministik yang diturunkan dari sinyal tercatat, termasuk berapa banyak berkas yang berubah, apakah perubahan menjangkau beberapa area tingkat atas, berapa banyak panggilan alat yang gagal, apakah validasi berjalan, apakah cuplikan diff ada, seberapa banyak permukaan API yang terpengaruh, bagaimana jalankan berakhir (gerbang penyelesaian yang diblokir atau selesai karena batas langkah/macet sama-sama menambah bobot), dan apakah jalur yang sensitif keamanan tersentuh. Setiap pendorong yang berkontribusi dicantumkan dengan bobotnya, bersama mitigasi yang disarankan.
Ini bantuan tinjauan. Bukan probabilitas, keyakinan yang dikalibrasi, atau pernyataan bahwa kode aman. Skor LOW pada perubahan yang belum diverifikasi tetap berarti perubahan itu belum diverifikasi.
Batalkan secara tepat
Cuplikan berkas berfungsi di repositori Git dan direktori proyek biasa bila Git
terpasang dan snapshot diaktifkan. AX Code menjaga penyimpanan Git cuplikannya
di luar proyek Anda; ia tidak membuat direktori .git proyek. Aturan abaikan
dan pengecualian jalur yang tidak didukung tetap berlaku.
Kembalikan di TUI membatalkan pesan dan perubahan berkas yang ditangkap. Dengan snapshot: false, atau
untuk giliran yang lebih lama yang tidak pernah menangkap garis dasar, ia hanya dapat membatalkan pesan; suntingan
berkas tetap di disk. Mengaktifkan cuplikan sekarang tidak dapat merekonstruksi isi berkas
yang lebih awal. Giliran yang ditangkap tanpa perubahan berkas juga tidak memiliki apa pun untuk dipulihkan.
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 menggabungkan peristiwa langkah yang tahan lama dengan detail graf eksekusi, jadi Anda dapat menargetkan langkah tertentu alih-alih mengembalikan seluruh jalankan. --dry-run memakai perencana pengembalian yang sama seperti penerapan dan mencantumkan sesi yang didelegasikan yang buku berkasnya berkontribusi pada hasil.
Pengembalian mengikuti sesi anak bersarang bila mereka menulis ke direktori kerja induk yang persis. Ia memulihkan perubahan berkas pasca-batas mereka sambil mempertahankan transkripnya. Keturunan yang berjalan di pohon kerja atau direktori lain dikecualikan, dan pengembalian gagal tertutup jika sesi yang disertakan masih berjalan.
Batas yang perlu diketahui sebelum Anda mengandalkannya: pengembalian memulihkan dari cuplikan yang diambil selama jalankan. Berkas yang tidak pernah dicuplik — karena diubah di luar sesi, atau tidak berada dalam keadaan yang dapat dipulihkan — tidak dapat dipulihkan dengan cara ini. Pakai --dry-run terlebih dahulu pada apa pun yang berkonsekuensi.
Coba strategi lain
ax-code session branch <sessionID>
ax-code session branch <sessionID> --from <messageID>
Mencabangkan keadaan tersimpan sesi agar percobaan kedua mulai dari titik yang dipilih alih-alih dari awal.
Ini mencabangkan keadaan sesi — pesan dan tujuan. Bukan cabang Git dan bukan pohon kerja. Untuk kandidat Git terisolasi, lihat Perubahan multi-model yang terverifikasi.
Diagnosis
ax-code session trace <sessionID>
ax-code session trace <sessionID> --logs
Diagnostik yang didukung pemutaran ulang dengan linimasa berskor risiko. --logs beralih ke analisis berkas log lama alih-alih peristiwa pemutaran ulang, yang berguna saat Anda menyelidiki masalah operasional alih-alih meninjau perubahan.
Ekspor bukti
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 dan OTLP membuat catatan jalankan dapat dipakai oleh alur tinjauan atau observabilitas Anda sendiri. Laporan Markdown ditujukan bagi manusia yang melampirkan bukti ke PR atau catatan perubahan.
Jelajahi
ax-code run-report # latest session
ax-code run-report --index # session index
Membuka laporan jalankan lokal di peramban dengan ringkasan jalankan, linimasa, perubahan, keadaan validasi, detail risiko, informasi cabang, dan titik pengembalian. Server hanya mengikat ke loopback.
Terkait
- Jaminan tujuan — pemeriksaan penerimaan yang dapat dieksekusi dan kesegaran sumber untuk tujuan panjang
- Mengapa AX Code — untuk apa lapisan bukti ini
- Perubahan multi-model yang terverifikasi — menghasilkan kandidat yang layak dibandingkan
- Lapisan semantik — amplop asal pada jawaban graf dan LSP
- Laporan jalankan — tampilan tingkat ruang kerja dan laporan per sesi