Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Cache bukti lokal

Status: Memori diaktifkan secara bawaan; RocksDB ikut serta

Cakupan: kondisi terkini

Terakhir ditinjau: 2026-09-13

Pemilik: runtime ax-code

AX Code memakai cache bukti dalam memori yang dibatasi secara bawaan, dengan persistensi RocksDB opsional di samping penyimpanan SQLite yang sudah ada. SQLite mempertahankan riwayat sesi lengkap dan catatan verifikasi. Cache berisi teks yang dirender sekali pakai dan simbol sintaktis; ia tidak mengubah izin atau dihitung sebagai verifikasi baru.

Mode memori bawaan tidak membuka basis data RocksDB. Untuk ikut serta ke persistensi pada pemasangan sumber, bangun dukungan bawaannya dan pilih RocksDB secara eksplisit:

pnpm build:native fs
AX_CODE_EVIDENCE_CACHE=rocksdb pnpm run dev

AX_CODE_EVIDENCE_CACHE=memory secara eksplisit memilih pemakaian ulang dalam proses yang dibatasi secara bawaan tanpa penyimpanan menetap. Dalam mode RocksDB, dukungan bawaan yang hilang, kunci basis data yang dipegang runtime lain, atau kegagalan cache jatuh kembali ke memori dengan diagnostik. Build addon sistem berkas standar menyertakan RocksDB untuk ikut serta eksplisit. Build rilis memverifikasi addon terkemas dapat menulis dan membuka kembali cache-nya. Operasi bawaan berjalan di luar putaran peristiwa JavaScript.

Pembacaan teks hingga 1 MiB memvalidasi bita sumber saat ini dan memakai ulang rentang yang dirender bila konten, jalur, rentang, dan formatnya cocok. Berkas yang lebih besar, pembacaan eksternal, direktori, dan lampiran tidak masuk cache baca. Instruksi repositori dan stempel baca berkas tetap langsung. Ekstraksi sintaktis dapat memakai ulang simbol untuk sumber dan bahasa yang identik; simbol ini tidak menetapkan rujukan semantik atau pemanggil.

Dengan salah satu mode cache, hasil pembacaan teks lengkap yang berulang dan sudah terlihat dalam permintaan model saat ini memakai rujukan pendek ke hasil pertama. Keluaran alat penuh yang asli tetap dalam riwayat sesi. Pemadatan membangun ulang visibilitas; pembacaan kemudian dirender penuh jika salinan sebelumnya tidak ada. Tampilan baca berhalaman, grep, dan glob yang bita-identik dan berulang juga dapat merujuk tampilan penuh pertama yang dikembalikan. Setiap rujukan mempertahankan kaki pemotongan asli dan panduan kelanjutannya; konten sumber yang dihilangkan tetap tidak tersedia. Hasil yang membawa instruksi, media, kesalahan, terpotong baris, dan parsial yang tidak dikenali tetap apa adanya. Ini mengubah masukan model, bukan riwayat kanonis atau eksekusi alat, dan tidak menetapkan pengurangan penagihan penyedia.

Kena cache menghemat perenderan atau penguraian; mereka tidak menghilangkan pembacaan validasi sumber atau panggilan alat yang diminta model. Untuk menggabungkan penemuan yang bergantung menjadi lebih sedikit perjalanan pulang-pergi model, aktifkan secara eksplisit opsi experimental.read_only_recipes yang sudah ada dan pakai read_recipe dengan pilihan yang dibatasi. Pakai code_intelligence dengan operation: "buildContext" untuk ikhtisar struktural yang dibatasi. Tidak satu pun opsi diaktifkan otomatis oleh cache.

Bila dipilih, cache menetap berada di bawah direktori cache AX Code biasa di evidence-v1, dengan basis data terpisah per direktori instans proyek. Penerimaan RocksDB dibatasi 1024 entri dan 32 MiB nilai logis; pemakaian disk fisik juga mencakup pengodean, log, dan overhead pemadatan. Kedua mode membatasi pemakaian ulang dalam memori ke 128 entri dan 4 MiB nilai terserialisasi per instans proyek per proses; ini bukan batas RAM proses total. Entri memori dibersihkan saat instans dibuang dan tidak bertahan setelah proses keluar. Entri kedaluwarsa setelah 24 jam dan divalidasi saat pencarian. Penggusuran kapasitas dapat membersihkan entri bawaan sekali pakai sebagai satu kelompok. Tidak ada data SQLite yang ada yang dimigrasi atau diisi ulang.

Untuk menonaktifkan pemakaian ulang penyimpanan maupun deduplikasi masukan model, setel AX_CODE_EVIDENCE_CACHE=off dan mulai ulang AX Code. Nilai yang tidak disetel atau kosong memakai memori; nilai tidak kosong yang tidak dikenali menonaktifkan cache. Mulai ulang runtime yang ada untuk menerapkan bawaan baru, dan hapus penimpaan rocksdb eksplisit apa pun untuk memakai memori. Berkas cache menetap yang ada dipertahankan. Tidak perlu pengembalian SQLite. Hentikan runtime sebelum menghapus evidence-v1 secara manual; jangan menghapus berkas kunci RocksDB saat runtime sedang memakai cache.

Untuk kualifikasi bawaan lokal setelah membangun fitur:

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

Evaluasi fixture tetap melaporkan pembacaan yang diminta, kena perenderan, bita keluaran yang dihilangkan, dan waktu yang berlalu secara terpisah. Ini bukan tolok ukur model langsung atau klaim tentang penagihan token penyedia.

Saat melaporkan masalah, sertakan versi AX Code, OS/arsitektur, keluaran ax-code doctor, apakah off atau memory mengubah perilaku, dan tugas yang dapat direproduksi jika ada. Doctor melaporkan mode yang diminta dan kemampuan bawaan; ia tidak dapat menentukan apakah proses lain yang berjalan memiliki cache proyek. Cadangan kunci/I/O proyek muncul di log runtime. Tidak ada umpan balik atau konten sumber ter-cache yang diunggah secara otomatis. Biner terbitan yang ada memperoleh bawaan ini hanya setelah rilis yang diperbarui dipasang.