Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Bộ nhớ đệm bằng chứng cục bộ

Trạng thái: Bộ nhớ được bật theo mặc định; RocksDB là tùy chọn bật

Phạm vi: trạng thái hiện tại

Xem xét lần cuối: 2026-09-13

Chủ sở hữu: môi trường chạy ax-code

AX Code dùng một bộ nhớ đệm bằng chứng trong bộ nhớ có giới hạn theo mặc định, với tùy chọn lưu bền RocksDB cạnh kho SQLite sẵn có. SQLite giữ lịch sử phiên đầy đủ và các bản ghi xác minh. Bộ nhớ đệm chứa văn bản đã kết xuất dùng một lần và ký hiệu cú pháp; nó không đổi quyền và không được tính là xác minh mới.

Chế độ bộ nhớ mặc định không mở cơ sở dữ liệu RocksDB. Để chọn lưu bền trong một bản cài nguồn, hãy dựng hỗ trợ gốc của nó và chọn RocksDB một cách tường minh:

pnpm build:native fs
AX_CODE_EVIDENCE_CACHE=rocksdb pnpm run dev

AX_CODE_EVIDENCE_CACHE=memory chọn tường minh việc tái sử dụng trong tiến trình có giới hạn, mặc định, không có kho bền. Ở chế độ RocksDB, thiếu hỗ trợ gốc, một khóa cơ sở dữ liệu do môi trường chạy khác giữ, hoặc một lỗi bộ nhớ đệm sẽ quay về bộ nhớ kèm chẩn đoán. Các bản dựng tiện ích hệ thống tệp chuẩn gồm RocksDB để bật tùy chọn tường minh. Bản dựng phát hành xác minh tiện ích đã đóng gói có thể ghi và mở lại bộ nhớ đệm của nó. Các thao tác gốc chạy ngoài vòng sự kiện JavaScript.

Các lần đọc văn bản tới 1 MiB xác thực byte nguồn hiện tại và tái sử dụng phạm vi đã kết xuất khi nội dung, đường dẫn, phạm vi và định dạng khớp. Tệp lớn hơn, lần đọc bên ngoài, thư mục và tệp đính kèm không vào bộ nhớ đệm đọc. Chỉ dẫn kho và dấu đọc tệp vẫn trực tiếp. Trích xuất cú pháp có thể tái sử dụng ký hiệu cho nguồn và ngôn ngữ giống hệt; các ký hiệu này không thiết lập tham chiếu ngữ nghĩa hay bên gọi.

Với một trong hai chế độ bộ nhớ đệm, các kết quả đọc văn bản đầy đủ lặp lại đã nhìn thấy trong yêu cầu mô hình hiện tại dùng một tham chiếu ngắn tới kết quả đầu. Các đầu ra công cụ đầy đủ gốc vẫn nằm trong lịch sử phiên. Việc nén dựng lại khả năng nhìn thấy; một lần đọc sau được kết xuất đầy đủ nếu bản sao trước đó vắng. Các khung đọc, grep và glob phân trang giống hệt byte lặp lại cũng có thể tham chiếu khung đầy đủ được trả về đầu tiên. Mỗi tham chiếu giữ chân cắt cụt gốc và hướng dẫn tiếp tục; nội dung nguồn bị bỏ vẫn không sẵn có. Kết quả mang chỉ dẫn, phương tiện, lỗi, bị cắt dòng, và kết quả một phần không nhận ra vẫn nguyên văn. Việc này đổi đầu vào mô hình, không đổi lịch sử chuẩn hay thực thi công cụ, và không thiết lập một mức giảm hóa đơn nhà cung cấp.

Lần trúng bộ nhớ đệm tiết kiệm kết xuất hoặc phân tích; chúng không loại các lần đọc xác thực nguồn hay lời gọi công cụ do mô hình yêu cầu. Để gộp khám phá phụ thuộc thành ít vòng mô hình hơn, hãy bật tường minh tùy chọn experimental.read_only_recipes sẵn có và dùng read_recipe với các lựa chọn có giới hạn. Dùng code_intelligence với operation: "buildContext" cho một tổng quan cấu trúc có giới hạn. Không tùy chọn nào được bộ nhớ đệm tự bật.

Khi được chọn, bộ nhớ đệm bền nằm dưới thư mục bộ nhớ đệm AX Code thông thường trong evidence-v1, với một cơ sở dữ liệu riêng cho mỗi thư mục thực thể dự án. Việc nhận RocksDB giới hạn 1024 mục và 32 MiB giá trị logic; mức dùng đĩa vật lý cũng gồm mã hóa, nhật ký và chi phí nén. Cả hai chế độ giới hạn tái sử dụng trong bộ nhớ ở 128 mục và 4 MiB giá trị đã tuần tự hóa cho mỗi thực thể dự án mỗi tiến trình; đây không phải giới hạn RAM toàn tiến trình. Mục bộ nhớ được xóa khi hủy thực thể và không sống sót khi tiến trình thoát. Mục hết hạn sau 24 giờ và được xác thực khi tra. Việc loại vì dung lượng có thể xóa các mục gốc dùng một lần theo lô. Không dữ liệu SQLite sẵn có nào được di chuyển hay lấp lại.

Để tắt cả tái sử dụng lưu trữ lẫn khử trùng đầu vào mô hình, hãy đặt AX_CODE_EVIDENCE_CACHE=off và khởi động lại AX Code. Giá trị chưa đặt hoặc rỗng dùng bộ nhớ; giá trị không rỗng không nhận ra sẽ tắt bộ nhớ đệm. Hãy khởi động lại các môi trường chạy sẵn có để áp dụng mặc định mới, và gỡ mọi ghi đè rocksdb tường minh để dùng bộ nhớ. Các tệp bộ nhớ đệm bền sẵn có được giữ. Không cần quay lui SQLite. Hãy dừng môi trường chạy trước khi gỡ thủ công evidence-v1; đừng gỡ tệp khóa RocksDB khi một môi trường chạy đang dùng bộ nhớ đệm.

Để đánh giá gốc cục bộ sau khi dựng tính năng:

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

Đánh giá bộ thử cố định báo các lần đọc được yêu cầu, lần trúng kết xuất, byte đầu ra bị bỏ và thời gian đã trôi một cách riêng. Nó không phải đo chuẩn mô hình trực tiếp hay một tuyên bố về hóa đơn token nhà cung cấp.

Khi báo một vấn đề, hãy gồm phiên bản AX Code, hệ điều hành/kiến trúc, đầu ra ax-code doctor, liệu off hoặc memory có đổi hành vi hay không, và một tác vụ tái lập được nếu có. Doctor báo chế độ được yêu cầu và khả năng gốc; nó không thể xác định một tiến trình đang chạy khác có sở hữu bộ nhớ đệm dự án hay không. Phương án dự phòng khóa/I/O dự án hiện trong nhật ký môi trường chạy. Không phản hồi hay nội dung nguồn đã đệm nào được tải lên tự động. Các tệp nhị phân đã công bố sẵn có chỉ nhận các mặc định này sau khi một bản phát hành đã cập nhật được cài.