AX Code’u edinin · ÜcretsizBelgeler

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

Kararlılık

Durum: Etkin
Kapsam: güncel durum
Son inceleme: 2026-07-18
Sahip: ax-code runtime

AX Code uzun etkileşimli oturumlarda ve başsız çalıştırmalarda nasıl güvenilir kalır.

Katmanlar

Katman Neyin sağlamlaştırıldığı Ana modüller
TUI yaşam döngüsü Askıya alma/sürdürme, çökmede uçbirim geri yükleme, oturum ayrılınca bellek budama ADR-047; cli/tui/util/*
Süreç hataları İptal/kesme/kırık boru yok sayılır; gerçek çökmeler yine çıkar util/harmless-interrupt, TUI çökme işleyicisi, CLI açılış kancaları
Zaman aşımları Araç/LSP/MCP sınırları, unhandledRejection olmadan util/timeout.withTimeout
Akışlar Boşta bekçi, dayanıklı yeniden bağlanma session/llm-impl boşta bekçi; resilient-stream
İzinler Çift gönderim mandalı + yanıt zaman aşımı permission-submit-latch, izin istemi
Depo wiki Yol kapsaması, atomik bildirim-son yazmalar, korunan içerik, yazma öncesi doğrulama packages/ax-wiki; src/wiki/*

Desteklenen TUI yolu

Desteklenen çalışma zamanı yığını:

  • Çalışma zamanı: paketlenmiş Node
  • Arayüz: AX Code TUI + Solid (birincil varsayılan)
  • Görüntüleme: Zig (üretim); yerel kitaplıklar depo içinde tümüyle vendored’dır (bağımsız ax-tui çerçevesinin içinde vendored, vendor/manifest.json ile karma sabitlenmiş) — kurulumda veya çalışma zamanında yukarı akış @opentui/* npm paketi yoktur
  • Yoga seçilebilir bir mod değildir; AX Code TUI’nin yerel görüntüleyicisi varsayılan kalır

İptaller ve çökmeler

Sinyal Beklenen davranış
Kullanıcı iptali / Esc / araç kesmesi (AbortError) İşlenmezse warn düzeyinde günlüğe yaz; TUI’den çıkma
Kabuk kapanınca kırık boru (EPIPE) Zararsız say ve yok say
Yakalanmamış uygulama istisnası Uçbirimi sıfırla, sıfır olmayan çık
Akış fazla uzun boşta Akış boşta bekçisiyle turu kes (yapılandırılabilir)

Akış boşta zaman aşımını AX_CODE_STREAM_IDLE_TIMEOUT_MS ile geçersiz kılın (0 kapatır).

İzin istemleri

İzin yanıtları:

  1. Mandalı — istek kimliği başına uçuşta yalnızca bir yanıt
  2. Sonraki kuyruklu istek etkinleşince yeniden kurulur
  3. 20s sonra zaman aşımına uğrar; böylece asılı bir sunucu «İzin ver» seçeneğini sonsuza dek sıkıştıramaz
  • Sandbox — yürütme yalıtımı
  • Otonom — gözetimsiz çalıştırmalar
  • AX Wiki — kaynağa dayalı anlamsal katman (bir çizge yerine geçmez)