Factory Droid CLI

Giới thiệu dự án

Dòng lệnh: Tự động hóa trên SDLC. Viết kịch bản và song song hóa Droid tại quy mô lớn cho CI/CD, di chuyển và bảo trì. Từ mã tự động xem xét các bản dựng tự phục hồi, tích hợp các tác nhân vào mọi giai đoạn của phát triển.

Droid CLI là một công cụ dòng lệnh được phát triển bởi Factory AI, được thiết kế để hoạt động như một tác nhân kỹ thuật phần mềm AI. Nó cho phép người dùng tương tác với nhiều mô hình ngôn ngữ lớn khác nhau thông qua thiết bị đầu cuối, mã xây dựng, gỡ lỗi và tái cấu trúc, thậm chí tạo ra các ứng dụng hoàn chỉnh.

Trang chủ chính thức: https://factory.ai/product/cli
Tài liệu chính thức: https://docs.factory.ai/cli/getting-started/quickstart
Phương pháp cài đặt: Xem hướng dẫn bên dưới trên trang này

Minh họa

Đặc trưng

Danh mục	Tính năng	Giá trị/Khả năng	Ví dụ/Ghi chú
Bắt đầu nhanh & CLI	cài đặt 30 giây; khởi chạy phiên tương tác droid trong thư mục dự án; hỗ trợ macOS/Linux và Windows	Tích hợp nhanh chóng vào dự án hiện tại, không cần công cụ mới	Cài đặt Windows: `irm https://app.factory.ai/cli/windows \| iex`; Khởi chạy: `droid`
Phát triển tính năng từ đầu đến cuối	Tự động hóa toàn bộ quá trình từ lập kế hoạch, triển khai đến thử nghiệm; quá trình xem xét minh bạch	Tăng tốc độ giao hàng trong khi vẫn duy trì sự kiểm soát của con người	Quy trình phê duyệt và xem khác biệt gốc (xem "Tính minh bạch và kiểm soát")
Hiểu sâu về cơ sở mã	Tích hợp kiến thức tổ chức được chia sẻ trên các cơ sở mã, tài liệu và theo dõi vấn đề; nhận biết ngữ cảnh, hiệu suất được cải thiện theo thời gian	Đề xuất và thay đổi chính xác hơn	Liên tục tận dụng kiến thức trên các kho lưu trữ và tài liệu
Tích hợp hệ thống kỹ thuật	Tích hợp nguyên bản các công cụ như Jira, Notion, Slack, v.v.; công việc phát triển luôn được đồng bộ hóa với các quy trình của nhóm	Giảm chuyển đổi công cụ và kho chứa thông tin	"vân vân." chỉ ra nhiều tích hợp hơn
Tự động hóa cấp sản xuất	Quy trình làm việc có thể tái sử dụng cục bộ và trong CI/CD; bảo mật và tuân thủ cấp doanh nghiệp tích hợp sẵn	Tính nhất quán và khả năng kiểm toán	Thích ứng với đường ống và môi trường doanh nghiệp
Năng lực doanh nghiệp	Các tùy chọn triển khai riêng tư, tuân thủ SOC-2, môi trường không có khoảng cách	Đáp ứng các yêu cầu về bảo mật và tuân thủ	Ưu tiên bảo mật và chất lượng
Cải tiến công cụ hiện có	Hoạt động trong thiết bị đầu cuối, IDE và môi trường phát triển hiện có; không cần chuyển đổi trình soạn thảo hoặc tìm hiểu giao diện mới	Duy trì thói quen làm việc hiện có, chi phí di chuyển thấp	Tích hợp sâu với các công cụ quen thuộc
Minh bạch và Kiểm soát	Mọi quyết định đều có thể nhìn thấy và xem xét được; duy trì sự giám sát đầy đủ đối với các thay đổi mã; quy trình phê duyệt và xem khác biệt gốc	Giảm rủi ro, tăng cường khả năng kiểm soát	Thân thiện với kiểm toán, có thể truy nguyên
Tính linh hoạt của mô hình	Không bị khóa đối với một nhà cung cấp AI duy nhất; chọn mô hình tốt nhất cho mỗi nhiệm vụ; hành vi tổ chức và trí nhớ nhất quán	Lựa chọn tối ưu giữa hiệu năng và chi phí	Hỗ trợ định tuyến đa mô hình
Các bước tiếp theo và tài nguyên	Bắt đầu nhanh, Các trường hợp sử dụng phổ biến, Tích hợp IDE, Cấu hình, AGENTS.md	Tạo điều kiện thực hiện và thực hành	Xem trang “Các bước tiếp theo/Tài nguyên bổ sung”

Phương pháp cấu hình mô hình AI

Hướng dẫn đồ họa Windows

1. Mở Terminal

windows_open_terminal

2. Cài đặt Factory Droid CLI

Lệnh cài đặt chính thức bằng một cú nhấp chuột:

Lệnh cài đặt bằng một cú nhấp chuột

irm https://app.factory.ai/cli/windows | iex

windows-install

3. Sửa file cấu hình

Droid CLI kết nối API của bên thứ ba thông qua mô hình tùy chỉnh (BYOK). Script một lệnh sẽ ghi các mô hình 88API vào ~/.factory/config.json (tệp hiện có sẽ bị ghi đè và được sao lưu thành config.json.bak.<timestamp>):

Mô hình GPT (gpt-6.1-sol, gpt-6-astra): provider openai, Base URL https://api.88api.ai/v1
Mô hình Claude (claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5): provider anthropic, Base URL https://api.88api.ai (không có /v1)

Lời nhắc của script hiển thị bằng tiếng Trung; các giá trị giống như trong bài viết.

Sửa đổi tệp cấu hình bằng một lệnh

iex (irm 'https://88api.ai/helper/factory-cli-setup.ps1')

Làm theo lời nhắc: tại Base URL chỉ cần nhấn Enter (mặc định https://api.88api.ai, script sẽ tự bổ sung thành https://api.88api.ai/v1); tại API Key, dán khóa đã tạo trong bảng điều khiển 88API (nội dung nhập sẽ không hiển thị dạng rõ).

4. Bắt đầu sử dụng Droid CLI

Bây giờ bạn có thể bắt đầu sử dụng Droid CLI!

# Vào thư mục dự án của bạn (tùy chọn)
cd C:\path\to\your\project
# Khởi chạy Droid CLI
droid

Chuyển sang mô hình 88API

Sau khi khởi động droid, gõ /model và chọn mô hình có nhãn [88API] trong nhóm Custom models ở cuối danh sách (ví dụ GPT-6.1 Sol [88API] hoặc Claude Opus 5.5 [88API]). Nếu không chuyển, Droid sẽ dùng mô hình của Factory và yêu cầu không đi qua 88API. Để dùng mô hình Claude, nhóm của khóa 88API phải bao gồm các mô hình Claude tương ứng.

Droid CLI yêu cầu người dùng đăng nhập tài khoản chính thức (miễn phí) trước khi sử dụng.

5. Khắc phục sự cố thường gặp của Windows

Lỗi permission denied khi cài đặt

Đây thường là vấn đề về quyền. Hãy thử các giải pháp sau:

Chạy PowerShell với tư cách quản trị viên, sau đó chạy lại lệnh cài đặt
Nếu cài đặt bằng npm, hãy cấu hình npm để sử dụng thư mục người dùng: npm config set prefix "$env:APPDATA\npm"

Lỗi chính sách thực thi PowerShell

Nếu bạn gặp phải các hạn chế về chính sách thực thi, hãy chạy: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Hướng dẫn đồ họa macOS/Linux

1. Cài đặt Droid CLI

Cài đặt Droid CLI

Mở terminal và chạy lệnh sau: curl -fsSL https://app.factory.ai/cli | sh

macos-open-terminal

Sửa đổi các biến môi trường theo lời nhắc cài đặt (sao chép trực tiếp mã lời nhắc cài đặt):

Đối với Linux, chọn ~/.bashrc hoặc ~/.zshrc cho phù hợp.

Biến môi trường Droid CLI (Chỉ ví dụ)

echo 'export PATH=/Users/YOUR_USERNAME/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

2. Sửa file cấu hình

Mô hình GPT (gpt-6.1-sol, gpt-6-astra): provider openai, Base URL https://api.88api.ai/v1
Mô hình Claude (claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5): provider anthropic, Base URL https://api.88api.ai (không có /v1)

Sửa đổi tệp cấu hình bằng một lệnh

curl -fsSL https://88api.ai/helper/factory-cli-setup.sh | bash

Lời nhắc của script hiển thị bằng tiếng Trung; các giá trị giống như trong bài viết.

3. Bắt đầu sử dụng Droid CLI

Bây giờ bạn có thể bắt đầu sử dụng Droid CLI!

# Vào thư mục dự án của bạn (tùy chọn)
cd /path/to/your/project
# Khởi chạy Droid CLI
droid

Chuyển sang mô hình 88API

Droid CLI yêu cầu người dùng đăng nhập vào tài khoản chính thức (miễn phí) trước khi sử dụng.

Cấu hình thủ công (tùy chọn)

Nếu không dùng script một lệnh, bạn có thể thêm thủ công các mô hình 88API vào mảng customModels trong ~/.factory/settings.json (trên Windows: %USERPROFILE%\.factory\settings.json). Nếu tệp đã tồn tại, chỉ hợp nhất phần customModels và giữ nguyên các cài đặt khác:

{
  "customModels": [
    {
      "model": "gpt-6.1-sol",
      "displayName": "GPT-6.1 Sol [88API]",
      "baseUrl": "https://api.88api.ai/v1",
      "apiKey": "sk-your-88api-key",
      "provider": "openai",
      "maxOutputTokens": 128000
    },
    {
      "model": "claude-opus-5-5",
      "displayName": "Claude Opus 5.5 [88API]",
      "baseUrl": "https://api.88api.ai",
      "apiKey": "sk-your-88api-key",
      "provider": "anthropic",
      "maxOutputTokens": 32000
    }
  ]
}

Lưu ý: với provider openai, baseUrl bắt buộc có /v1; với provider anthropic, điền https://api.88api.ai (không có /v1). Sau khi lưu, khởi động lại droid và chọn mô hình bằng /model.

Mục lục