Unity CLI: Công cụ dòng lệnh và C# REPL trực tiếp cho tác tử AI

Unity phát hành CLI độc lập để quản lý editor, dự án và xác thực từ terminal, cùng gói Pipeline thử nghiệm biến Editor hoặc Player đang chạy thành mục tiêu tự động hóa có thể lập trình với đánh giá C# trực tiếp.

July 23, 2026· 3 min read· Nguồn: Unity

Unity đã phát hành một tệp nhị phân CLI độc lập cho phép nhà phát triển quản lý editor, module, dự án và xác thực hoàn toàn từ terminal — không cần giao diện Unity Hub. CLI là một tệp nhị phân tự chứa duy nhất, cài đặt qua curl hoặc PowerShell, hỗ trợ đầu ra JSON/TSV có cấu trúc và sử dụng mã thoát có thể dự đoán (0, 1, 130) cho quy trình CI. Nó cũng xử lý xác thực tài khoản dịch vụ qua biến môi trường, phù hợp cho các tác nhân xây dựng không đầu.

CLI làm được gì

Lệnh unity thay thế đường dẫn không đầu cũ của Unity Hub (--headless) bằng một tệp nhị phân gốc khởi động nhanh hơn nhiều. Bạn có thể cài đặt editor với các module cụ thể trong một dòng:

unity install 6000.2.10f1 -m android ios webgl

Các lệnh khác bao gồm unity editors để liệt kê các phiên bản đã cài đặt, unity open để khởi chạy dự án với editor phù hợp và unity auth login để xác thực. Lệnh unity doctor chẩn đoán các vấn đề về môi trường và thông tin xác thực.

Điều khiển Editor đang chạy bằng gói Pipeline

Gói thử nghiệm com.unity.pipeline (Unity 6.0 LTS trở lên) cho phép CLI giao tiếp với Editor đang chạy hoặc bản dựng Player phát triển qua API cục bộ. Sau khi cài đặt qua unity pipeline install, bất kỳ phương thức tĩnh nào được đánh dấu bằng [CliCommand] đều trở thành lệnh có thể gọi từ terminal:

unity command greet --name World

Gói này cũng hỗ trợ trỏ CLI vào bản dựng Player đang chạy với --runtime <tên thực thi player>, cho phép truy vấn log trực tiếp, kiểm tra trạng thái runtime và tải lại mã nóng trong bản dựng phát triển.

Đánh giá C# trực tiếp

Tính năng đột phá là unity command eval, biên dịch và thực thi các biểu thức C# tùy ý bên trong Editor hoặc Player đang chạy bằng Roslyn, trả về kết quả trong mili giây. Không cần biên dịch lại hoặc tải lại miền:

unity command eval "return Application.version;"
unity command eval "return UnityEditor.EditorApplication.isPlaying;" --json

Eval được bảo vệ bằng mã thông báo bảo mật để ngăn chặn lạm dụng.

Nền tảng cho tác tử AI

Cùng nhau, CLI và gói Pipeline cung cấp cho tác tử AI một vòng phản hồi chặt chẽ: chúng có thể mở dự án, kiểm tra scene, áp dụng thay đổi, chạy kiểm thử, vào Chế độ Play và xác minh kết quả — tất cả mà không cần can thiệp thủ công. Đầu ra JSON có cấu trúc và danh sách lệnh tự mô tả giúp các mô hình gọi hàm hoặc máy chủ MCP dễ dàng tiêu thụ.