hướng dẫn

Kho mã nguồn của bạn, sẵn sàng cho agent trong ba câu lệnh.

Bản dịch có sự hỗ trợ của AI agent. Nếu có khác biệt, trang tiếng Anh là bản có hiệu lực. Nếu bạn thấy vấn đề nào trong văn bản, rất mong bạn mở một issue hoặc gửi một pull request.

Có lẽ bạn đã tới đây qua một huy hiệu. Huy hiệu đó đánh dấu kho mã nguồn có một lớp ngữ cảnh mà agent có thể khởi động từ đó, được kiểm tra và chấm điểm ngay trên máy của người bảo trì theo hình thức tự khai. Việc giúp kho mã nguồn của bạn cũng sẵn sàng cho agent gói gọn trong ba câu lệnh dưới đây.

Huy hiệu khai điều gì ↓

leji start mở một lớp ngữ cảnh có sẵn, vì vậy kho mã nguồn chưa có lớp này cần áp dụng trước. Bước 02 sẽ thực hiện việc đó; nếu đã có leji.json, bạn có thể đi thẳng tới bước 03. Trang bắt đầu nhanh trình bày quy trình đầy đủ hơn, từ áp dụng Leji cho kho mã nguồn hiện có đến chấm đúng mức mà kho mã nguồn tuyên bố.

01 · Cài CLI

npm install -g @leji-org/leji

02 · Áp dụng cho kho mã nguồn

leji adopt

03 · Bước vào lớp ngữ cảnh

leji start

Vừa rồi đã xảy ra chuyện gì

  • leji start đã mở một agent host phát hiện được, ngay từ gốc kho mã nguồn, kèm đúng một chỉ dẫn: hãy đọc boot profile trước tiên, để ngữ cảnh mở đầu của agent đến từ nhóm chứ không phải do nó tự suy ra từ cây tệp. Đó là một chỉ dẫn, không phải một phép kiểm: leji trỏ agent tới tệp đó chứ không bao giờ xác minh rằng agent đã đọc. Nếu không phát hiện được host nào, hoặc khi chạy trong một script, sẽ không có gì được mở và câu lệnh in ra dòng lệnh để bạn tự chạy.
  • Trước khi khởi chạy, leji start in một khối Setup cho bản clone này: hệ thống có tìm được CLI Leji mà kho mã nguồn khai báo, đúng phiên bản nhánh đặc tả của lớp ngữ cảnh yêu cầu hay không; liệu MCP server đã được đăng ký cho host mà nó chọn hay chưa, liệu một tệp .mcp.json dùng chung đã được commit hay chưa, và liệu hook pre-commit đã được cài hay chưa. Mỗi chỗ thiếu đều được báo kèm câu lệnh khắc phục, và không chỗ nào trong số đó chặn bạn bước vào.
  • Việc kiểm chính lớp ngữ cảnh thì tách riêng: leji validate cho schema và các quy tắc lint, leji conformance cho mức mà nó tuyên bố. Cả hai đều chạy từ đúng gói bạn vừa cài, ngay trên máy của bạn, không có dịch vụ nào xen vào.
  • Công cụ không tự mở kết nối nào, và phía sau nó không có tài khoản, không có sổ đăng ký, cũng không có dịch vụ nào. Những gì chạm tới mạng đều do bạn tự gọi: các lệnh tải về của federation liên hệ đúng kho mã nguồn bạn đã nêu tên, còn bước khai báo phụ thuộc trong leji initleji adopt thì chạy chính trình quản lý gói của bạn khi bạn đồng ý rõ ràng. Agent mà leji khởi chạy chính là agent bạn vốn đã dùng, với hành vi mạng của riêng nó.

Huy hiệu khai điều gì

Huy hiệu được tạo ngay trên máy: leji badge chấm điểm kho mã nguồn bằng leji conformance, ghi ra tệp SVG cho đúng mức mà lần chạy offline đó đã xác minh, rồi in ra một dòng markdown nhúng nó vào.

leji badge

Với một lớp ngữ cảnh được xác minh ở mức governed, huy hiệu trông như thế này:

Leji 1.0 · governed · self-attested Leji 1.0 governed

Dòng markdown nhúng nó vào một README:

[![Leji 1.0 · governed · self-attested](leji-badge.svg)](https://leji.org/agent-ready/)

Các mức là core, indexed, governedfederated, mức sau bao hàm mức trước. Danh sách kiểm mức tuân thủ nói mỗi mức đòi hỏi gì ở một nhóm, và mọi mức đều đạt tới được chỉ với bản đặc tả mở và công cụ tham chiếu.

Vì vậy, điều đáng xem là kết quả kiểm tra chứ không phải hình huy hiệu: hãy chạy leji conformance ngay trong kho mã nguồn đó và xem nó báo cáo gì. Trang Tin cậy nói về ai duy trì Leji, nhánh 1.0 hứa hẹn điều gì, và chuyện gì xảy ra nếu đơn vị quản thủ biến mất.