AX Code’u edinin · ÜcretsizBelgeler
AX Code.
tr
English繁體中文简体中文日本語한국어FrançaisDeutschBahasa IndonesiaItalianoPortuguês (Brasil)РусскийEspañolTürkçeTiếng Việt
Başlayın

Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Yürütme kanıtı

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-08-25 Sahip: AX Code çalışma zamanı

Her AX Code oturumu çalışırken kaydedilir. Bu sayfa, bu kaydı inceleyebileceğiniz, karşılaştırabileceğiniz, dışa aktarabileceğiniz ve geri alabileceğiniz komutları kapsar.

Bir ajan bittiğinde ve şunları yanıtlamanız gerektiğinde kullanın: ne yaptı, ne kadar riskliydi, başka bir denemeyle nasıl karşılaştırıldı ve nasıl geri dönerim?

Neler kaydedilir

Bir çalıştırma sırasında AX Code iki bağımsız şey yazar:

  • Tipli bir olay günlüğü — yönlendirme kararları, model etkinliği, adım sınırları, araç çağrıları ve araç sonuçları. Bu, graph, replay, compare, trace ve audit için kaynaktır.
  • Dosya anlık görüntüleri — deponuzun dışında, AX Code veri dizini altında, refs/snapshots/<hash> kullanılarak bir Git nesne deposuna alınır. Çalışma ağacınız ve projenizin .git/ dizini onları saklamak için değiştirilmez.

İkisi de yereldir. Hiçbir şey yüklenmez.

Bir çalıştırmayı yeniden kurun

ax-code graph <sessionID>

Oturumu bir yürütme çizgesi olarak yeniden kurar: süre, risk özeti, token sayıları, kullanılan ajanlar ve araç çağrıları ile zamanlamalarıyla her adım.

## 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, çizgeyi başka bir araçta istediğinizde Mermaid ve bir topoloji görünümü dahil alternatif çıktılar seçer.

Bunun oturum yürütme çizgesi olduğuna dikkat edin — ajanın ne yaptığı. Depo kod çizgesi değildir; o ax-code index ve kod zekası katmanıdır.

İki çalıştırmayı karşılaştırın

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

Risk deltasını, değişen dosyaları, araç başarısızlığı sayılarını, her çalıştırmanın izlediği karar yolunu ve olay türü başına sayıları raporlar. --deep yeniden oynatma karşılaştırmasıyla adım düzeyi sapma analizi ekler.

Bu çalıştırmaları karşılaştırır, kaynak kodu değil. “İkinci deneme daha kötü puan aldı — nerede saptı” sorusunu yanıtlar, “kod farkını göster” sorusunu değil.

Tipik bir kullanım, aynı görev için iki strateji arasında karar vermektir:

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

Kaydedilen olay günlüğünü inceleyin

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 kaydedilen günlüğü tutarlılık için denetler. reconstruct olaylardan adım akışını yeniden kurar. export taşınabilir bir yeniden oynatma paketi yazar.

Yeniden oynatma yeniden kurar; yeniden yürütmez. Modelleri yeniden çalıştırmaz, araçları yeniden çağırmaz veya dış durumu yeniden üretmez. execute kipi, özgünle programlı karşılaştırma için yeniden kurulmuş bir akış hazırlar ve işi yeniden çalıştırmak için değil sınama için tasarlanmıştır.

Risk işaretlerini okuyun

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

Puan, kaydedilen işaretlerden türetilen belirleyici bir sezgiseldir; kaç dosyanın değiştiği, değişikliğin birden çok üst düzey alanı kapsayıp kapsamadığı, kaç araç çağrısının başarısız olduğu, doğrulamanın çalışıp çalışmadığı, bir fark anlık görüntüsünün var olup olmadığı, ne kadar API yüzeyinin etkilendiği, çalıştırmanın nasıl bittiği (engellenmiş bir tamamlama kapısı veya adım sınırı/takılmış bir bitiş ikisi de ağırlık ekler) ve güvenliğe duyarlı yollara dokunulup dokunulmadığı dahildir. Katkıda bulunan her sürücü ağırlığıyla listelenir; yanında önerilen azaltmalar vardır.

Bu bir inceleme yardımcısıdır. Bir olasılık, kalibre edilmiş bir güven veya kodun güvenli olduğu yolunda bir ifade değildir. Doğrulanmamış bir değişiklik üzerindeki DÜŞÜK puan, değişikliğin hâlâ doğrulanmamış olduğu anlamına gelir.

Kesin geri alın

Dosya anlık görüntüleri, Git kuruluysa ve snapshot açıksa Git depolarında ve olağan proje dizinlerinde çalışır. AX Code anlık görüntü Git deposunu projenizin dışında tutar; bir proje .git dizini oluşturmaz. Yok sayma kuralları ve desteklenmeyen yol dışlamaları yine uygulanır.

TUI Geri Al, iletileri ve yakalanmış dosya değişikliklerini geri alır. snapshot: false ile veya taban çizgisi hiç yakalanmamış eski turlar için yalnızca iletileri geri alabilir; dosya düzenlemeleri diskte kalır. Anlık görüntüleri şimdi açmak daha önceki dosya içeriklerini yeniden kuramaz. Dosya değişikliği olmayan yakalanmış bir turun da geri yüklenecek bir şeyi yoktur.

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 dayanıklı adım olaylarını yürütme çizgesi ayrıntısıyla birleştirir; böylece tüm çalıştırmayı geri almak yerine belirli bir adımı hedefleyebilirsiniz. --dry-run uygula ile aynı geri alma planlayıcısını kullanır ve dosya defteri sonuca katkıda bulunan devredilmiş oturumları listeler.

Geri alma, üst öğenin tam çalışma dizinine yazdıklarında iç içe çocuk oturumları izler. Sınır sonrası dosya değişikliklerini geri yüklerken dökümlerini korur. Başka bir worktree veya dizinde çalışan torunlar dışlanır ve dahil edilen herhangi bir oturum hâlâ çalışıyorsa geri alma kapalı biçimde başarısız olur.

Güvenmeden önce bilinmesi gereken sınırlar: geri alma, çalıştırma sırasında alınan anlık görüntülerden geri yükler. Hiç anlık görüntülenmemiş bir dosya — oturum dışında değiştirildiği veya kurtarılabilir bir durumda olmadığı için — bu yolla geri yüklenemez. Sonuçları ağır her şeyde önce --dry-run kullanın.

Farklı bir strateji deneyin

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

Oturumun saklanan durumunu çatallar; böylece ikinci bir deneme sıfırdan değil seçilen bir noktadan başlar.

Bu oturum durumunu çatallar — iletiler ve hedefler. Bir Git dalı veya worktree değildir. Yalıtılmış Git adayları için Doğrulanmış çok modelli değişiklikler sayfasına bakın.

Tanı

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

Risk puanlı bir zaman çizelgesiyle yeniden oynatma destekli tanılar. --logs yeniden oynatma olayları yerine eski günlük dosyası analizine geçer; bir değişikliği incelemekten çok operasyonel bir sorunu araştırırken yararlıdır.

Kanıtı dışa aktarın

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 ve OTLP, çalıştırma kaydını kendi inceleme veya gözlemlenebilirlik hattınızın tüketmesini sağlar. Markdown raporu, bir PR’a veya değişiklik kaydına kanıt ekleyen insanlar içindir.

Göz atın

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

Yerel çalıştırma raporunu tarayıcıda açar: çalıştırma özeti, zaman çizelgesi, değişiklikler, doğrulama durumu, risk ayrıntısı, dal bilgisi ve geri alma noktaları. Sunucu yalnızca geri döngüye bağlanır.