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

Tài liệu AX Code

Trạng thái: Đang hoạt động Phạm vi: công khai, trạng thái hiện tại Xem xét lần cuối: 2026-10-09 Chủ sở hữu: người bảo trì AX Code

AX Code là runtime tác nhân lập trình cho công việc có thể rà soát và đảo ngược: mỗi phiên được ghi thành nhật ký sự kiện có cấu trúc kèm ảnh chụp tệp, các bản triển khai ứng viên có thể được xác minh bằng chính các kiểm tra của kho, và không có gì tự hợp nhất. Vì sao dùng AX Code giải thích điều đó tối ưu cho điều gì, dành cho ai, và những gì nó cố ý không tuyên bố.

README ở gốc là đường ngắn nhất để cài và khởi chạy AX Code. Dùng hub này khi bạn cần cấu hình một quy trình, hiểu một ranh giới runtime, hoặc tích hợp AX Code với hệ thống khác.

Hồ sơ quy trình nội bộ (PRD, ADR, đặc tả, lộ trình, kế hoạch triển khai, rà soát cạnh tranh và tệp làm việc kiểm toán) nằm dưới .internal/, không nằm trong cây công khai này — xem “Ranh giới tài liệu” bên dưới. Các trang công khai là những trang được liên kết tại đây.

Website công khai: ax-code.app/vi/docs/. Với các bản cài đã có, hãy bắt đầu từ Nâng cấp và khôi phục. Truy cập mã nguồn và bản tải công khai là hai việc tách biệt; xem Truy cập mã nguồn.

Chọn theo việc cần làm

Để điều hướng terminal dùng chung, chọn tham gia, qua một máy khách MCP bên ngoài, xem Chia sẻ TUI trực tiếp qua MCP.

Để dùng cầu trình duyệt thử nghiệm (đọc trang, tùy chọn nhấp và điền), xem Cầu trình duyệt WebMCP.

Để hỏi độc lập về các tệp đã chọn qua bộ nhớ đệm AX Trust, xem Câu hỏi ngữ cảnh cố định.

Tôi muốn…	Bắt đầu tại đây
Quyết định AX Code có hợp với việc của tôi không	Vì sao dùng AX Code
Hiểu AX Code trước khi cài	Bắt đầu tại đây
Rà soát, so sánh hoặc hoàn tác việc một tác nhân đã làm	Bằng chứng thực thi
Để nhiều mô hình thử cùng một thay đổi	Thay đổi đa mô hình đã xác minh
Chọn kênh cài hoặc runtime	Kênh cài đặt và runtime
Kết nối nhà cung cấp được lưu trữ, CLI, tùy chỉnh hoặc cục bộ	Nhà cung cấp và mô hình được hỗ trợ
Bật suy luận cục bộ được quản lý trên Apple Silicon	Chọn mô hình AX Engine
Đọc các số tốc độ Tiel so với MTPLX hiện tại	Tóm tắt ngang hàng Tiel (20 tháng 9 năm 2026)
Thử AX Code với API mô hình bậc miễn phí	Bắt đầu nhanh API bậc miễn phí
Chạy tác nhân với ranh giới hệ thống tệp và mạng an toàn	Chế độ Sandbox
Quản trị hạ tầng đám mây hoặc mạng một cách an toàn	Chế độ vận hành đám mây
Chạy không giám sát hoặc trong CI	Chế độ tự chủ
Gọi CLI một lần `ax-code run` từ tập lệnh hoặc CI	CLI không giao diện
Chạy lời nhắc lặp lại hoặc lên lịch tác vụ bền	Chế độ lặp và tác vụ đã lên lịch
Nghe âm thanh hoặc cảnh báo nói khi một lần chạy cần chú ý	Thông báo âm thanh
Giữ việc đã lên lịch chạy qua lúc tiến trình hoặc máy chủ thoát	Thao tác chạy dài
Chọn thực thi cục bộ, đám mây, lai, council hoặc arena	Chế độ thực thi
Kết nối công cụ và dữ liệu bên ngoài	Tích hợp MCP
Để tác nhân đọc và hành động trong Chrome qua WebMCP	Cầu trình duyệt WebMCP
Nhúng AX Code vào một ứng dụng	`@defai-digital/ax-code-sdk`
Sinh máy khách cho ngôn ngữ khác	Tương thích HTTP và OpenAPI
Dựng máy chủ desktop hoặc gốc	Truyền tải SDK gốc

Bắt đầu

Standard và Business — Standard mã nguồn mở, dùng thương mại miễn phí, Business độc quyền đã lên kế hoạch, và trạng thái truy cập công khai.
Vì sao dùng AX Code — AX Code tối ưu cho điều gì, đối tượng dự kiến, khác biệt ra sao, và những gì nó không tuyên bố.
Bắt đầu tại đây — mô hình tư duy sản phẩm và các đường ngắn nhất theo tình huống sử dụng.
Kênh cài đặt và runtime — nền tảng được hỗ trợ, gói, cập nhật và trình khởi chạy của người đóng góp.

Hướng dẫn runtime

Trực quan hóa bằng chứng Wiki — mở đồ thị cục bộ của quan hệ trang/nguồn Wiki đã ghi, hoặc xuất HTML ngoại tuyến. Gồm ảnh chụp bố cục xuyên tâm, lực và tập trung trang từ chính wiki của AX Code.
Tóm tắt hội thoại — bắt kịp việc gần đây với /recap và cấu hình biểu ngữ khi rảnh.
Thông báo âm thanh — âm hệ thống và cảnh báo nói chọn tham gia khi một lần chạy cần bạn chú ý.
Bằng chứng thực thi — đồ thị, so sánh, phát lại, rủi ro, hoàn tác, nhánh, vết và xuất kiểm toán.
Thay đổi đa mô hình đã xác minh — quy trình council và arena từ đầu đến cuối.
Chế độ Sandbox — chế độ cô lập, đường dẫn được bảo vệ, điều khiển mạng và thứ tự ưu tiên.
Chế độ vận hành đám mây — quy trình lập kế hoạch/phê duyệt/áp dụng, token phê duyệt và tư thế tác nhân cloudops.
Chế độ tự chủ — thực thi không giám sát, phê duyệt, dùng không giao diện và các chốt an toàn.
CLI không giao diện — lệnh một lần ax-code run cho tập lệnh, CI và bên gọi tác nhân.
Ngôn ngữ và thiết lập TUI — ngôn ngữ giao diện và hội thoại, thiết lập lần đầu.
Hoạt ảnh TUI — cặp mở và kết, khả năng terminal và đường lùi kết xuất.
Chế độ lặp và tác vụ đã lên lịch — lời nhắc lặp lại, lịch bền và giới hạn chạy dài.
Thao tác chạy dài — ví dụ dịch vụ có giám sát, ngữ nghĩa khôi phục và các kiểm tra vận hành.
Chế độ thực thi — hành vi agent, lai, council và arena.
Thực hành tốt khi định tuyến đa mô hình — tách suy luận cao cấp và việc hỗ trợ chi phí thấp hơn mà không làm yếu âm thầm các tác vụ nhạy với tính đúng.
Khôi phục mô hình — chọn mô hình chính xác, cấu hình dự phòng tường minh và chẩn đoán.
Định tuyến tự động — định tuyến chuyên gia và định tuyến độ phức tạp tùy chọn.
Mức nỗ lực mô hình — mức suy nghĩ và hành vi riêng của từng nhà cung cấp.
Hiệu năng — hồ sơ công cụ lập trình và chẩn đoán thời gian yêu cầu cục bộ.
Mức dùng bộ nhớ — hồ sơ bộ nhớ, giữ bộ nhớ đệm và giới hạn đầu ra nền.
Bộ nhớ đệm bằng chứng cục bộ — tái dùng bằng chứng SQLite và RocksDB tùy chọn, điều kiện đạt và hoàn tác.
Móc vòng đời — sự kiện móc và các gói chính sách được đóng gói.
Báo cáo lần chạy — mức dùng không gian làm việc, hoạt động, phân rã mô hình/công cụ và báo cáo theo phiên.

Nhà cung cấp

Nhà cung cấp và mô hình được hỗ trợ — mã nhà cung cấp, thông tin xác thực và khám phá mô hình.
Bắt đầu nhanh API bậc miễn phí — các đường không mất phí tương thích, ràng buộc và đánh giá an toàn.
Nhà cung cấp tùy chỉnh và cổng — điểm cuối tương thích OpenAI và Anthropic.
Thiết lập MTPLX và oMLX — preset cục bộ từ bản checkout, khám phá, công cụ và xác thực.
Tóm tắt ngang hàng Tiel (20 tháng 9 năm 2026) — số API gốc hiện tại của Tiel / Cyber-Tiel so với MTPLX; mặc định hoàn thành 194.88, đỉnh giải mã 249.01.
Kiểm tra lại máy khách AX Code/OpenCode — sáu tổ hợp máy khách/runtime, MTP đang hoạt động, thời gian lần đầu/lặp lại và kiểm tra mã.
Đo suy luận cục bộ — kiểm thử AX Code/OpenCode và runtime có ngày, kèm giới hạn thời gian và khả năng so sánh.
Chọn mô hình AX Engine — xếp hạng mô hình cục bộ và hướng dẫn bộ nhớ.

Tích hợp

Tích hợp MCP — tin cậy, quyền, tài nguyên và bảo mật máy chủ.
ACP — đường thuận của Agent Client Protocol cho máy chủ IDE.
AX Wiki — tri thức kho có nguồn chống lưng và quy trình CI.
Tích hợp VS Code — lệnh trình soạn thảo, thiết lập và quy trình. Cài từ trang marketplace.

SDK và ranh giới dịch vụ

@defai-digital/ax-code-sdk — nhúng TypeScript và JavaScript bên thứ nhất.
Truyền tải SDK gốc — ranh giới desktop/gốc dạng gRPC và hành vi dự phòng.
Tương thích HTTP và OpenAPI — chế độ máy chủ và máy khách sinh cho ngôn ngữ khác.
Ảnh chụp OpenAPI — hợp đồng tuyến HTTP và lược đồ có thẩm quyền.

Kiến trúc và độ tin cậy

Tầng ngữ nghĩa — nguồn gốc đồ thị và LSP, kiểm toán và ranh giới phát lại.
Kiến trúc engine cục bộ — vì sao AX Code dùng sidecar AX Engine.
Độ ổn định runtime — hợp đồng độ tin cậy về hủy, sự cố, luồng, thời gian chờ và TUI.

Tham chiếu

Lược đồ JSON cấu hình — hợp đồng đầu vào cấu hình đã sinh.
Hỗ trợ TypeScript gốc — trình biên dịch nguồn, dịch vụ ngôn ngữ, chẩn đoán và tương thích.
Danh mục kỹ năng và plugin — kỹ năng đóng gói, kỹ năng dự án, plugin và eval.
Gói chính sách cô lập — ví dụ chính sách đọc được bằng máy.
Xác minh phát hành — khóa công khai minisign chuẩn và lệnh xác minh.
Tính toàn vẹn runtime trên Windows — chữ ký, xác minh tệp đã cài và bằng chứng diệt virus.
Chính sách bảo mật — mô hình đe dọa, lưu trữ thông tin xác thực và phiên bản được hỗ trợ.

Ranh giới tài liệu

docs/ chứa hướng dẫn công khai cho hành vi đã có trong một runtime đã phát hành. Tài liệu lập kế hoạch, mục tiêu phát hành, chính sách triển khai và phân tích tạm thời không thuộc về đây:

Nội dung	Vị trí
Quyết định kiến trúc	`.internal/adr/`
Yêu cầu sản phẩm và đặc tả kỹ thuật	`.internal/prd/` và `.internal/spec/`
Lộ trình, kế hoạch triển khai, mục tiêu phát hành, rà soát và kiểm toán	`.internal/reports/`
Hành vi đã phát hành và hướng dẫn tích hợp công khai	`docs/`

Mỗi trang Markdown công khai nên khai báo trạng thái, phạm vi, ngày xem xét lần cuối và chủ sở hữu gần đầu trang. Hãy ưu tiên liên kết tới hợp đồng đã sinh hoặc nguồn triển khai hơn là sao chép danh sách tuyến và các ảnh chụp dễ lệch khác.

Danh sách kiểm tra bảo trì

Trước một bản phát hành hoặc một thay đổi tài liệu đáng kể:

Đối chiếu lệnh, mặc định, cờ, mã nhà cung cấp và nhãn runtime với phần triển khai của chúng.
Cập nhật hướng dẫn có thẩm quyền hẹp nhất thay vì lặp cùng hành vi trên nhiều trang cửa trước.
Chạy pnpm run test:scripts để bắt liên kết cục bộ gãy, trang mồ côi và siêu dữ liệu trang bị thiếu.
Cập nhật manifest xuất đã phê duyệt và chạy node script/export-public-docs.mjs --website /path/to/ax-code.app, rồi chạy kiểm tra website, dựng và kiểm tra khói Workers. Bản dựng website dùng ảnh chụp đã commit và không cần quyền truy cập mã nguồn. Trang và tài sản công khai mới phải được phê duyệt tường minh trong manifest.
Giữ đề xuất, ghi chú phát triển dự án, mục tiêu phát hành và hồ sơ quyết định lịch sử dưới .internal/, không đưa vào điều hướng công khai.