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

Yerel kanıt önbelleği

Durum: Bellek varsayılan olarak açık; RocksDB isteğe bağlı

Kapsam: güncel durum

Son inceleme: 2026-09-13

Sahip: ax-code çalışma zamanı

AX Code varsayılan olarak sınırlı bir bellek içi kanıt önbelleği kullanır; mevcut SQLite deposunun yanında isteğe bağlı RocksDB kalıcılığı vardır. SQLite, tam oturum geçmişini ve doğrulama kayıtlarını tutar. Önbellek, atılabilir işlenmiş metin ve sözdizimsel simgeler içerir; izinleri değiştirmez ve taze doğrulama sayılmaz.

Varsayılan bellek kipi bir RocksDB veritabanı açmaz. Kaynak kurulumunda kalıcılığı seçmek için yerel desteği derleyin ve RocksDB’yi açıkça seçin:

pnpm build:native fs
AX_CODE_EVIDENCE_CACHE=rocksdb pnpm run dev

AX_CODE_EVIDENCE_CACHE=memory, kalıcı depolama olmadan varsayılan sınırlı süreç içi yeniden kullanımı açıkça seçer. RocksDB kipinde eksik yerel destek, başka bir çalışma zamanının tuttuğu veritabanı kilidi veya bir önbellek hatası, bir tanı ile belleğe geri döner. Standart dosya sistemi eklenti derlemeleri, açık seçim için RocksDB içerir. Yayın derlemeleri, paketlenmiş eklentinin önbelleğini yazıp yeniden açabildiğini doğrular. Yerel işlemler JavaScript olay döngüsünün dışında çalışır.

1 MiB’a kadar metin okumaları güncel kaynak baytlarını doğrular ve içerik, yol, aralık ve biçim eşleştiğinde işlenmiş aralığı yeniden kullanır. Daha büyük dosyalar, dış okumalar, dizinler ve ekler okuma önbelleğine girmez. Depo yönergeleri ve dosya okuma damgaları canlı kalır. Sözdizimsel çıkarma, aynı kaynak ve dil için simgeleri yeniden kullanabilir; bu simgeler anlamsal başvurular veya çağıranlar oluşturmaz.

Her iki önbellek kipinde de, geçerli model isteğinde zaten görünen yinelenen tam metin okuma sonuçları ilk sonuca kısa bir başvuru kullanır. Özgün tam araç çıktıları oturum geçmişinde kalır. Sıkıştırma görünürlüğü yeniden kurar; önceki kopya yoksa sonraki okuma tam olarak işlenir. Baytları aynı olan yinelenen sayfalı okuma, grep ve glob görünümleri de ilk tam dönen görünüme başvurabilir. Her başvuru özgün kesilme altbilgisini ve devam yönergesini korur; atlanan kaynak içeriği kullanılamaz kalır. Yönerge taşıyan, ortam, hata, satırı kırpılmış ve tanınmayan kısmi sonuçlar olduğu gibi kalır. Bu, model girdisini değiştirir; kanonik geçmişi veya araç yürütmesini değil. Sağlayıcı faturalamasında bir azalma oluşturmaz.

Önbellek isabetleri işleme veya ayrıştırmayı tasarruf eder; kaynak doğrulama okumalarını veya modelin istediği araç çağrılarını ortadan kaldırmaz. Bağımlı keşfi daha az model gidiş-dönüşünde birleştirmek için mevcut experimental.read_only_recipes seçeneğini açıkça etkinleştirin ve sınırlı seçimlerle read_recipe kullanın. Sınırlı bir yapısal genel bakış için code_intelligence ile operation: "buildContext" kullanın. Önbellek bu seçeneklerin hiçbirini otomatik açmaz.

Seçildiğinde kalıcı önbellek, normal AX Code önbellek dizininde evidence-v1 altında yaşar; her proje örneği dizini için ayrı bir veritabanı vardır. RocksDB kabulü 1024 girdi ve 32 MiB mantıksal değerle sınırlıdır; fiziksel disk kullanımı kodlama, günlükler ve sıkıştırma yükünü de içerir. Her iki kip de süreç başına proje örneği için bellek içi yeniden kullanımı 128 girdi ve 4 MiB serileştirilmiş değerle sınırlar; bu, toplam süreç RAM sınırı değildir. Bellek girdileri örnek atıldığında temizlenir ve süreç çıkışından sonra kalmaz. Girdiler 24 saat sonra sona erer ve aramada doğrulanır. Kapasite tahliyesi atılabilir yerel girdileri toplu olarak temizleyebilir. Mevcut SQLite verisi taşınmaz veya geriye dönük doldurulmaz.

Hem depolama yeniden kullanımını hem de model girdisi tekilleştirmesini kapatmak için AX_CODE_EVIDENCE_CACHE=off ayarlayın ve AX Code’u yeniden başlatın. Ayarlanmamış veya boş bir değer belleği kullanır; tanınmayan boş olmayan bir değer önbelleği kapatır. Yeni varsayılanı uygulamak için mevcut çalışma zamanlarını yeniden başlatın ve belleği kullanmak için açık rocksdb geçersiz kılmasını kaldırın. Mevcut kalıcı önbellek dosyaları saklanır. SQLite geri alması gerekmez. evidence-v1 dizinini elle kaldırmadan önce çalışma zamanlarını durdurun; bir çalışma zamanı önbelleği kullanırken RocksDB kilit dosyalarını kaldırmayın.

Özelliği derledikten sonra yerel nitelendirme için:

cd packages/ax-code
AX_TEST_EVIDENCE_NATIVE=1 AX_TEST_FILES=test/evidence/cache-native.test.ts,test/evidence/cache-eval.test.ts pnpm exec vitest run --retry 0

Sabit fikstür değerlendirmesi istenen okumaları, işleme isabetlerini, atlanan çıktı baytlarını ve geçen süreyi ayrı raporlar. Canlı model kıyaslaması veya sağlayıcı token faturalaması hakkında bir iddia değildir.

Bir sorun bildirirken AX Code sürümünü, işletim sistemi/mimariyi, ax-code doctor çıktısını, off veya memory davranışın değişip değişmediğini ve varsa yinelenebilir bir görevi ekleyin. Doctor, istenen kipi ve yerel yeteneği raporlar; başka bir çalışan sürecin proje önbelleğine sahip olup olmadığını belirleyemez. Proje kilidi/G/Ç geri dönüşü çalışma zamanı günlüğünde görünür. Geri bildirim veya önbelleğe alınmış kaynak içeriği otomatik yüklenmez. Mevcut yayımlanmış ikili dosyalar bu varsayılanları ancak güncellenmiş bir yayın kurulduktan sonra edinir.