Bề mặt lệnh CLI
Hiểu cách binary alti được cung cấp định tuyến dòng lệnh, namespace nào có thể truy cập trong bản phát hành này, ý nghĩa từng mã thoát và nơi mỗi lệnh thực sự chạy.
Tổng quan
Trang này lập chỉ mục CLI native, action manifest khách hàng và các kết nối theo backend. Dùng Lệnh engine cho công việc thiết kế cục bộ và Lệnh job và Cloud cho thao tác dịch vụ. Các ví dụ áp dụng cho giao diện 0.1.9.
Hai bộ phân tích, một binary
Bộ phân tích native xử lý release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls, và compute. Nó cũng xử lý analyze run và các dạng Evolve rõ ràng capabilities, analyze, run, cx-search, measured-ppa, và artifact. Các lệnh khách hàng còn lại dùng action manifest tích hợp. mcp serve khởi động máy chủ MCP stdio.
Những điều cách định tuyến này loại trừ
eda inspect, reports parse, ide init, và các dạng Evolve được liệt kê là lệnh được định tuyến native. Tính khả dụng của chúng không còn bị giới hạn bởi thiếu sót điều phối của tệp nén cũ. Khả năng engine vẫn quyết định đầu vào hoặc thao tác nào được hỗ trợ.
Action khách hàng một từ evolve tách biệt với evolve run và compute rtl-evolve native. Schema yêu cầu của chúng không thay thế lẫn nhau. Action một từ trace của manifest vẫn bị namespace trace native che; dùng lệnh con native thay vì giả định liệt kê manifest bảo đảm cách viết CLI tương ứng.
Cờ toàn cục
Dùng --json ở đầu để có đầu ra cấu trúc native, ví dụ alti --json xls capabilities. Đặt trước namespace hoặc sau toàn bộ lệnh con native, không đặt giữa các từ của dạng Evolve được định tuyến. Dùng alti --help cho tóm tắt cấp cao nhất và --help trên thao tác lá để biết đối số và giới hạn được chấp nhận. Các lệnh lá native cũng chấp nhận -h.
Đầu ra JSON tùy theo lệnh. Envelope engine chứa kết quả tiến trình con dưới dạng chuỗi, lệnh dịch vụ trả biên nhận và gắn terminal truyền byte liên tục. Xem Tham khảo lệnh.
Lệnh meta và tài khoản
Lệnh | Hành vi |
|---|---|
| In phiên bản CLI |
| In action manifest khách hàng có 25 mục |
| Kiểm tra bản cài đã xác thực và khả năng của nó |
| Báo cấu hình môi trường mà không xác minh định danh máy chủ |
| Các lệnh cấp cao nhất cũ từ chối định danh chưa xác minh với mã thoát |
| Lệnh cũ không thể xóa thông tin xác thực kế thừa từ tiến trình cha |
| Bắt đầu quy trình PKCE trình duyệt native và lưu phiên CLI riêng |
| Hỏi máy chủ về định danh phiên hiện tại |
| Làm mới hoặc thu hồi phiên CLI native |
| Phục vụ MCP stdio trong chế độ khách hàng hoặc XLS cục bộ được chọn |
Phiên Cloud và thông tin xác thực môi trường cũ là riêng biệt. Xem Xác thực CLI.
Mã thoát
Xem mọi kết quả khác không là lỗi trừ khi hợp đồng lệnh cụ thể định nghĩa thao tác khôi phục. Phân tích/chấp nhận thường trả 2, lỗi runtime và HTTP trả 1, engine không khả dụng trả 127, và thực thi đã cài không hợp lệ hoặc lỗi khởi chạy trả 126. Engine có thể truyền trạng thái riêng. Manifest khách hàng dùng riêng 3 cho từ chối lớp và 4 cho từ chối trước điều phối. Chỉ số trạng thái không xác định nguồn của nó.
Thao tác chạy ở đâu
Giao diện | Thực thi và thẩm quyền |
|---|---|
| Engine native đóng gói trên máy hiện tại |
| Các công cụ Google XLS cài riêng và được ghim trên máy Linux hiện tại |
| Thư mục cục bộ được chọn, bao gồm khôi phục và các thao tác thay đổi native được tuần tự hóa |
| Các tuyến API native với phiên bearer do trình duyệt cấp và quyền tổ chức/dự án do máy chủ kiểm tra |
| Dịch vụ HTTP DDS cũ được người vận hành chọn với hợp đồng bí mật dịch vụ hiện có |
| Chỉ xác thực mã nguồn và envelope ngoại tuyến |
| Dịch vụ job Cloud được cấu hình, chịu điều kiện sẵn sàng và quyền |
MCP khách hàng mặc định | Điều phối Cloud client; truyền tải stdio không làm thực thi trở thành cục bộ |
| Công cụ XLS cục bộ cố định, không điều phối Cloud khách hàng |
Những lệnh con có –runner
Các lệnh tương thích rtl compile, rtl synthesize, physical run, px analyze, và isa run mặc định dùng local. Chọn cloud hoặc private trên những lệnh đó xuất kế hoạch điều phối khung; không phải thực thi từ xa. Đối số engine -- của chúng chỉ được chấp nhận cho điều phối cục bộ.
Trong họ lệnh job, --runner chọn Job Service và là hợp đồng khác. Adapter alti-engine-job đã ngừng dùng không nằm trong danh mục phát hành 24 runner; không diễn giải cú pháp local/private được chấp nhận thành dịch vụ đã cung cấp.
Cách tìm engine cục bộ
Giữ nguyên bản phát hành đã cài. XLS, compute, RTL đóng gói, DDS native và các đường PX/CX có kiểu dữ liệu yêu cầu executable anh em theo tên. Kiểm tra tin cậy đã cài ràng buộc runner được bảo vệ với hash danh mục và biên nhận; không có dự phòng PATH hoặc biên nhận người dùng cung cấp nào sửa được ranh giới đó. Các resolver tương thích cũ có thể báo sibling hoặc path; kiểm tra biên nhận cho thao tác thực sự đã chạy. Công cụ ngoài như Icarus có cấu hình máy chủ riêng.
Engine nào đứng sau namespace nào
Payload chứa alti, alti-mcp và 24 engine runner này:
Lệnh | Engine đóng gói |
|---|---|
RTL, phân tích, SV, kiểm chứng |
|
ISA, Evolve |
|
Vật lý, PX |
|
Trace, Labs |
|
Tcl, EIDB, EDA, báo cáo |
|
XLS và compute |
|
DDS native |
|
alti-rtl-runner không được đóng gói. Các lệnh tương thích định danh đã commit yêu cầu nó không được hỗ trợ chỉ vì có trợ giúp. Executable desktop dùng bởi ide open được phân phối riêng.
Envelope biên nhận
Schema hoặc đầu ra | Diễn giải |
|---|---|
| Với |
| Xác thực ngoại tuyến; |
| Kết quả đánh giá Tcl đã cài có giới hạn |
| Trạng thái khởi chạy tiến trình desktop, không chứng minh dự án đã tải xong |
| Trạng thái HTTP dịch vụ cũ và nội dung phản hồi có giới hạn |
| Trạng thái hoàn thành trình cài/gỡ cùng chẩn đoán helper trên stderr |
stdout terminal Cloud | Byte terminal được truyền liên tục, không phải một biên nhận JSON đơn lẻ |
Trường stdout của envelope engine là chuỗi chứa kết quả native. Không có --json, có thể lưu trực tiếp đầu ra native đó và truyền nguyên vẹn cho lệnh apply DDS tương ứng. Tuyệt đối không rút kế hoạch tạo nội dung thành chỉ hash.
Biến môi trường
Biến | Phạm vi |
|---|---|
| Thông tin xác thực client action/job khách hàng cũ và phạm vi tổ chức |
| Ghi đè origin API cũ; mặc định |
| Chọn loại principal cũ; không phải quyền thực thi |
| Chấp thuận tải mã nguồn lên cho action MCP khách hàng |
|
|
| Origin dịch vụ DDS cũ rõ ràng; Cloud native dùng đối số endpoint/phiên riêng |
| Xác thực dịch vụ cũ hiện có; không phải phiên bearer Cloud native |
| Vị trí công cụ Icarus ngoài thuộc máy chủ cho bộ đánh giá RTL native |
Cloud native dùng --session-dir, mặc định là ~/.local/state/altifigence/cloud-cli. Không sao chép tệp phiên desktop vào đó, ghi token vào log hoặc gửi bí mật dịch vụ đến endpoint tùy ý.
Kết quả engine
Đọc kết quả engine thực tế và giới hạn của nó. Khám phá GPU không phải thực thi GPU, digest nội dung không phải chữ ký và ước tính timing không dùng cho signoff không phải signoff hiện thực hóa. Trang tiếp theo liệt kê các lệnh engine liên quan.
Xác định lệnh trước khi viết script
alti --version
alti --help
alti ide cloud --help
alti xls run --help
Kiểm tra trợ giúp trên đúng lệnh lá bạn dự định gọi. Tên khớp trong alti commands không thay thế trợ giúp parser native, khả năng đã cài hoặc tính khả dụng runtime. Giữ phiên bản CLI cùng script vì schema yêu cầu và biên nhận có phiên bản.