Skip to content

vi AI AGENTS

github-actions[bot] edited this page Nov 17, 2026 · 6 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


Các tác nhân AI trên thiết bị của bạn

Một điểm cuối SSH thường trực biến điện thoại của bạn thành thứ mà một tác nhân AI tự động có thể vận hành trực tiếp. Bất kỳ tác nhân nào có thể điều khiển một shell hoặc một kết nối SSH (Claude Code, aider, một script có LLM trong vòng lặp, quy trình tự động của riêng bạn) đều có được một phiên root thực sự trên thiết bị, qua mạng, không cần cáp USB và không có cờ gỡ lỗi tự phơi bày nào của ADB.

Trang này mở rộng ý tưởng đã được giới thiệu trong README.

Vì sao dùng SSH chứ không phải ADB cho các tác nhân

ADB tự thông báo về mình: adb_enabled và development_settings_enabled ai cũng đọc được, kết nối được ghi nhật ký, và không có cách nào được hỗ trợ để che giấu việc gỡ lỗi đang (hoặc đã) được bật. Một tác nhân làm việc qua ADB để lại dấu vết đó trên thiết bị cho bất kỳ ứng dụng hoặc SDK chống gian lận nào đọc được. VD Dropbear là lựa chọn riêng tư thay thế: một lần đăng nhập SSH bình thường, với thông tin xác thực do bạn kiểm soát và một banner không tiết lộ điều gì.

Những gì một tác nhân có thể làm

Qua một kết nối, tác nhân thấy một shell kiểu Linux bình thường và có thể:

  • đọc và sửa tệp, thay đổi thiết lập, và quản lý mô-đun, gói và dịch vụ;
  • phân loại nhật ký, kéo về các artifact, và chạy chẩn đoán hoặc điều tra pháp y theo nhu cầu;
  • di chuyển và đồng bộ tệp theo cả hai chiều qua scp / sftp / rsync: sao lưu, di trú, cấp phát;
  • điều khiển cả một đội thiết bị đã root từ một nơi, mỗi thiết bị truy cập được bằng khóa riêng của nó.

Vì dự án được xây dựng để thân thiện với AI (một tệp cấu hình có tài liệu, một hợp đồng env thời gian chạy rõ ràng, các đường dẫn có thể đoán trước và trạng thái ở dạng văn bản thuần) một tác nhân có thể tự tìm ra cách dùng nó mà không cần phỏng đoán.

Làm điều đó một cách an toàn

Đây là root, nên hãy đối xử với nó như root:

  • cấp cho tác nhân thông tin xác thực riêng của nó, không phải của cá nhân bạn, và trỏ nó tới một tài khoản có đặc quyền thấp hơn (shell) nếu bạn muốn giới hạn tầm với của nó;
  • giới hạn các bind vào những mạng bạn tin cậy: loopback hoặc một VPN thay vì Internet mở (xem Cấu hình);
  • giữ xác thực bằng mật khẩu tắt; một khóa có thể thu hồi và không bao giờ phải gõ ra;
  • bạn có thể thu hồi một khóa hoặc dừng daemon bất cứ lúc nào từ WebUI;
  • hãy nhớ một kết nối mặc định là một phiên root đầy đủ. Chỉ trao cho tác nhân phạm vi mà nó cần.

Một thiết lập tối thiểu

  1. Tạo một cặp khóa chỉ dành cho tác nhân.
  2. Thêm khóa công khai của nó trong WebUI (Authorized keys).
  3. Chỉ bind vào loopback hoặc VPN của bạn, trên một cổng không mặc định.
  4. Trỏ cấu hình SSH của tác nhân vào thiết bị và để nó làm việc.

Qua USB, không ADB: bật chia sẻ kết nối USB và bind vào địa chỉ USB để có liên kết chỉ qua cáp, tiện cho một agent trên laptop đã kết nối. Xem hướng dẫn người dùng.


Tài liệu này được tạo bằng Claude (Anthropic) và được duy trì bởi VD171. Chúng tôi hoan nghênh các chỉnh sửa và cải tiến; xem CONTRIBUTING.md.

Clone this wiki locally