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

Xem bằng chứng Wiki trong trình duyệt

Trạng thái: Đang hoạt động

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

Xem xét lần cuối: 2026-10-02

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

Chạy lệnh này từ một dự án đã có AX Wiki:

ax-code wiki viz

Lệnh in một liên kết trình duyệt cục bộ và ở lại tiền cảnh. Nhấp liên kết để khám phá các quan hệ đã ghi giữa trang Wiki và tệp nguồn của chúng. Dùng --open để tự mở trình duyệt hệ thống. Nhấn Ctrl+C để dừng trình xem cục bộ.

Những gì bạn thấy

Các đường là trích dẫn đã ghi, không phải lời gọi hàm. Ba hình này là wiki của chính AX Code. Cùng ảnh chụp có bốn bố cục chuyển được; cung và bản đồ cây là hai bố cục còn lại và không được hiện ở đây.

Khung nhìn xuyên tâm. Ba trang wiki nằm trong một vòng các tệp chúng trích dẫn.

Xuyên tâm. Cái gì bao quanh mỗi trang? Architecture Overview, Development Workflows và mô-đun Ax Code Intel nằm trong một vòng các tệp được trích dẫn. Liên kết chéo gom qua tâm. Vòng được suy từ trang trích dẫn đầu tiên của mỗi tệp. Nó không mã hóa khoảng cách hay độ dài nhánh.

Bố cục lực. Các tệp tụ lại cạnh trang trích dẫn chúng.

Lực. Ai trích dẫn cái gì? Trang, tệp và ký hiệu được đặt theo kết nối của chúng, nên các tệp được trích dẫn tụ cạnh trang ghi chúng.

Ax Code Intel được chọn. Các tệp được trích dẫn sáng lên, và 39 trong 80 tham chiếu được hiện.

Một trang, đã mở. Chọn Ax Code Intel (modules/ax-code-intel.md) làm sáng các tệp mà trang đó trích dẫn, gồm nguồn CLI, máy chủ và trình xử lý của nó. Bảng chi tiết báo độ mới là không xác định, vì ảnh chụp không đọc lại nguồn hiện tại, và hiện 39 trong 80 tham chiếu đã ghi. Tối đa 200 nút và 500 quan hệ được vẽ. Số bị bỏ vẫn nhìn thấy được.

ax-code wiki viz --open
ax-code wiki viz --directory /path/to/project --dir .ax-wiki
ax-code wiki viz --export ./wiki-evidence.html

--export tạo một tệp HTML khép kín, mở được ngoại tuyến, không cần AX Code, máy chủ hay tài sản bên ngoài. Nó từ chối ghi đè một tệp sẵn có. Thư mục cha của nó phải tồn tại. --open và --export không kết hợp được.

Trình xem hỗ trợ tìm kiếm, bộ lọc trang/nguồn, chọn một bước, chi tiết bằng chứng và điều khiển phóng to/kéo. Danh sách kề hoạt động bằng bàn phím: Tab tới một mục rồi nhấn Enter; Escape trả tiêu điểm về ô tìm. Đặt lại khôi phục tổng quan. Tối đa 200 nút và 500 quan hệ được đưa vào, với số bị bỏ được hiển thị. Tìm kiếm bao phủ ảnh chụp đã đưa vào, không phải các mục bị bỏ.

Đồ thị CLI là một ảnh chụp cố định của .manifest.json. Nó không sinh Wiki, không chạy mô hình, không lập chỉ mục lại mã, và không tự làm mới. Nó hiện tư cách thành viên trang-tới-nguồn đã ghi, không phải lời gọi hàm hay một đồ thị phụ thuộc đầy đủ. Nội dung nguồn hiện tại không được đọc, nên độ mới được nêu rõ là không xác định. Đường dẫn xác định vị trí đã ghi và không mở hay đọc tệp nguồn.

Liên kết cục bộ cấp quyền truy cập ảnh chụp đó cho đến khi tiến trình dừng. Máy chủ chỉ gắn vào 127.0.0.1 và chỉ phục vụ ảnh chụp. Tệp đã xuất chứa tiêu đề trang, đường dẫn nguồn tương đối và hash nội dung đã ghi; hãy xem lại những thứ này trước khi chia sẻ. Không đoạn mã nguồn, gốc dự án tuyệt đối hay cài đặt mô hình nào được xuất.

Mở từ TUI

Trong một phiên, dùng Đồ thị Wiki gần đường dẫn dự án ở cuối thanh bên phải, hoặc nhập /wiki-viz. Cùng hành động có trong bảng lệnh khi thanh bên bị ẩn. Nó mở trình duyệt hệ thống; nếu thất bại, một hộp thoại đưa liên kết cục bộ để sao chép và một hành động thử lại.

Trình duyệt mở ngay, kể cả khi dự án chưa có Wiki. Nó hiện trạng thái chờ, tiến trình sinh hoặc thất bại, và tải đồ thị trang/nguồn khi một ảnh chụp sẵn có. Mở đồ thị yêu cầu sinh hoặc cập nhật tăng dần; nó bỏ qua độ trễ nhàn rỗi thông thường nhưng chờ các phiên đang hoạt động, công việc đang xếp hàng và một bản nháp TUI không rỗng. Một lần mở trình duyệt thất bại đưa ra liên kết có thể sao chép.

AX Code tương tác bật bảo trì Wiki nền theo mặc định. Sau 30 giây yên, nó sinh Wiki còn thiếu hoặc cập nhật các tạo tác đã cũ. Nó dùng mô hình Wiki đã cấu hình (hoặc mô hình mặc định của AX Code), ngân sách nguồn và trang, cùng quyền đọc/ghi của tác nhân hiện tại. Công việc tiền cảnh hủy bảo trì; các bản dựng chưa xong không phát hành bản kê một phần. Các sửa tay và nội dung được bảo vệ được giữ nguyên. Bảo trì không cập nhật AGENTS.md hay CLAUDE.md. Các lệnh không tương tác không bật bộ lập lịch này.

Dự án Git dùng gốc worktree chuẩn, kể cả phiên bắt đầu bên trong một gói. Thư mục không phải Git hỗ trợ một yêu cầu đồ thị tường minh nhưng không sinh khi khởi động. Chính sách kết nối môi trường chạy chỉ cục bộ sẵn có vẫn áp dụng. Cả TUI và môi trường chạy phải hỗ trợ các điểm cuối này. Đóng TUI sẽ đóng cầu nối trình duyệt của nó. Thanh bên hiện trạng thái bảo trì Wiki và tiến trình trang.

Chỉ tắt bảo trì nền bằng "wiki": { "auto": false } trong cấu hình AX Code; một yêu cầu đồ thị tường minh vẫn có thể sinh Wiki. Đặt enabled thành false để tắt việc sinh và việc tiêm lời nhắc Wiki. Các ảnh chụp sẵn có vẫn xem được. Việc thất bại thử lại với lùi thời gian tới ba lần tự động, rồi chờ một thay đổi nguồn/cấu hình hoặc một yêu cầu đồ thị tường minh.

Nhúng vào một dự án khác

Các gói không gian làm việc có thể được dựng và đóng gói cho một bên tiêu thụ độc lập: @ax-code/ax-wiki/graph cung cấp hợp đồng an toàn cho trình duyệt và phép chiếu bản kê; @ax-code/ax-wiki-viewer cung cấp giao diện trình duyệt. Nhập trình xem không khởi động AX Code hay một máy chủ.

import { projectWikiManifest } from "@ax-code/ax-wiki/graph"
import { mount } from "@ax-code/ax-wiki-viewer"

const graph = projectWikiManifest(manifest, { snapshot: contentIdentity })
const viewer = mount(document.getElementById("map")!, graph)
viewer.update(nextGraph)
viewer.dispose()

Dùng một danh tính nội dung do máy chủ tạo cho snapshot. Danh tính đổi sẽ xóa lựa chọn. Bản cập nhật không hợp lệ ném lỗi và giữ khung nhìn sẵn có; việc hủy là lũy đẳng. Dùng { injectStyles: false } và chuỗi viewerCss đã xuất khi máy chủ quản lý kiểu. Máy chủ Node có thể nhập renderWikiGraphHtml từ @ax-code/ax-wiki-viewer/node; kết quả của nó chứa html và csp khớp.