PandaPaw biến một máy Windows, macOS hoặc Linux mà bạn kiểm soát thành một máy chủ tác tử PandaNpc. Công cụ mã hóa, tệp dự án, shell và các công cụ vẫn nằm trên máy chủ đó; các ứng dụng khách PandaNpc cung cấp cho bạn giao diện đồng bộ từ điện thoại, trình duyệt hoặc một máy tính để bàn khác.
Sử dụng PandaPaw khi máy thực hiện công việc khác với thiết bị bạn đang cầm, khi bạn muốn máy chủ tiếp tục hoạt động ngay cả khi ứng dụng khách bị ngắt kết nối, hoặc khi nhiều công cụ mã hóa cần chia sẻ cùng một thiết lập dựa trên tài khoản và cấu hình Trung tâm tác tử.
PandaPaw quản lý những gì
- Kết nối tác tử từ xa cho Claude Code, OpenAI Codex và PandaCode.
- Dịch vụ nền và tự động khởi động để máy chủ có thể trở lại sau khi khởi động lại bình thường.
- Ủy quyền máy dựa trên tài khoản mà không cần sao chép thủ công Bridge ID, token hoặc khóa ký dài hạn.
- Hỗ trợ cài đặt công cụ khi một công cụ mã hóa được hỗ trợ bị thiếu.
- Các phản chiếu Trung tâm tác tử hiển thị hướng dẫn, kỹ năng, bộ nhớ và định nghĩa tác tử của mỗi công cụ theo bố cục gốc của nó.
- Mạng thiết bị riêng tư cho các máy được kết nối qua luồng Thiết bị đã kết nối.
- Theo dõi cập nhật và gỡ cài đặt để các công cụ đã tồn tại trước PandaPaw được bảo toàn.
PandaPaw không tự cung cấp gói đăng ký mô hình. Claude Code, Codex và PandaCode vẫn sử dụng thông tin xác thực nhà cung cấp và giới hạn được cấu hình cho công cụ của chúng.
Cách hoạt động của thực thi từ xa
Cả hai phía đều khởi tạo kết nối gửi ra, vì vậy một thiết lập gia đình hoặc văn phòng bình thường không cần quy tắc tường lửa gửi vào, địa chỉ IP công khai, chuyển tiếp cổng trên router hoặc máy chủ SSH phơi bày công khai. Bộ chuyển tiếp vận chuyển tin nhắn, trạng thái và phê duyệt; việc thực thi công cụ diễn ra trên máy chủ.
Nếu máy chủ ở chế độ ngủ, tắt nguồn hoặc mất đường kết nối mạng gửi ra, kết nối đã lưu vẫn nằm trong tài khoản của bạn nhưng không thể thực thi công việc cho đến khi máy chủ trở lại.
Nền tảng máy chủ được hỗ trợ
| Nền tảng máy chủ | Gói | Ghi chú |
|---|---|---|
| Windows x64 | Tệp thực thi gốc và dịch vụ cấp người dùng | Chạy trình cài đặt trong PowerShell |
| macOS, Apple Silicon hoặc Intel | Ứng dụng/tệp nhị phân PandaPaw phổ quát | Cùng một gói hỗ trợ cả hai kiến trúc |
| Linux x86_64 | Tệp nhị phân gốc và dịch vụ người dùng | Dành cho các bản phân phối dựa trên glibc phổ biến |
Ứng dụng khách xem PandaNpc có ma trận nền tảng rộng hơn. Xem Cài đặt PandaNpc và PandaPaw khi chọn gói ứng dụng khách và máy chủ.
Cài đặt được khuyến nghị
- Đăng nhập vào PandaNpc.
- Mở Thiết bị đã kết nối.
- Chọn Thêm thiết bị. Một khóa dùng một lần được cấp và hộp thoại hiển thị một lệnh cho hệ điều hành đã phát hiện.
- Sao chép lệnh đó vào máy chủ và chạy nó ở đó.
- Để hộp thoại mở nếu bạn muốn nó tự động phát hiện máy mới.
Khóa đã chuẩn bị chỉ dùng một lần. Sao chép toàn bộ lệnh, giữ kín nó và tạo khóa mới nếu nó hết hạn hoặc đã được sử dụng.
Trình cài đặt macOS/Linux đơn giản
Sử dụng mẫu này khi bạn muốn ủy quyền qua trình duyệt thay vì khóa đã chuẩn bị:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shTrình cài đặt PowerShell Windows đơn giản
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexTrình cài đặt đơn giản chạy pandapaw login. Phê duyệt máy trong trang trình duyệt mà nó mở ra. Nếu quá trình ủy quyền bị gián đoạn, tệp nhị phân và các dịch vụ vẫn có thể được cài đặt; chạy pandapaw login sau đó để hoàn tất kết nối tài khoản.
Xác minh máy chủ
Đầu tiên hãy kiểm tra chính máy chủ:
pandapaw statusSau đó mở PandaNpc Tác tử và xác nhận máy có đèn trạng thái trực tuyến màu xanh lục. Bắt đầu một phiên trong thư mục thử nghiệm dùng một lần hoặc chỉ đọc và hỏi:
Lời nhắc thử nghiệm: In ra thư mục làm việc hiện tại và liệt kê các tệp ở cấp cao nhất. Không sửa đổi bất cứ điều gì.
Một phản hồi thành công chứng minh nhiều hơn một đèn trạng thái xanh: nó xác minh việc ghép nối tài khoản, kết nối bộ chuyển tiếp, công cụ đã chọn, xác thực nhà cung cấp và ánh xạ thư mục làm việc.
Đối với một dự án Trung tâm tác tử, hãy chạy:
pandapaw agent status --root /absolute/path/to/projectĐiều này hiển thị liệu dự án đã được liên kết hay chưa và liệu cấu hình được quản lý có sẵn cục bộ hay không. Một kho lưu trữ Git ổn định giúp PandaPaw xác định cùng một dự án trên nhiều máy.
Ủy quyền tài khoản và định danh kết nối
pandapaw login sử dụng một phiên ủy quyền thiết bị qua trình duyệt. Sau khi bạn phê duyệt, máy chủ nhận thông tin xác thực phạm vi thiết bị và một khóa xác minh Trung tâm tác tử qua TLS, ghi cấu hình máy của nó dưới ~/.pandapaw/, đăng ký các kết nối công cụ được hỗ trợ và liên kết các dự án Git có thể nhận diện.
Chỉ chạy pandapaw login --force khi cố ý chuyển đổi tài khoản hoặc thay thế thông tin xác thực máy chủ đã hết hạn. Việc cấp quyền lại cho một máy khỏe mạnh mà không có lý do có thể tạo ra các định danh trùng lặp hoặc bị thay thế gây nhầm lẫn.
pandapaw qr vẫn tạo một liên kết kết nối thủ công ngắn hạn cho các trường hợp tương thích và đặc biệt. Đây không phải là luồng chính cho một máy chủ mới; Thiết bị đã kết nối dễ kiểm tra hơn và không yêu cầu người dùng hiểu về ID cầu nối.
Đồng bộ hóa Trung tâm tác tử
Trung tâm tác tử hoạt động theo sự kiện ở trạng thái ổn định:
- Các thay đổi tệp được quản lý cục bộ được phát hiện và xuất bản lên dự án đã liên kết.
- Các bản phát hành có chữ ký đến qua một luồng sự kiện.
- Các tệp kê khai và khối nội dung không thay đổi được tái sử dụng thay vì tải xuống lại.
- Một kiểm tra phục hồi định kỳ bắt các sự kiện bị bỏ lỡ trong thời gian mất kết nối tạm thời.
Claude Code, Codex và PandaCode nhận các phản chiếu riêng biệt vì chúng mong đợi các thư mục và định dạng hướng dẫn khác nhau. PandaCode chuẩn bị bản phát hành đã xác minh mới nhất trước khi lắp ráp một lời nhắc phiên mới, vì vậy cấu hình được kéo khi khởi động có thể ảnh hưởng đến chính phiên đó.
Nếu Trung tâm tác tử tạm thời không khả dụng, công cụ tiếp tục với bản phát hành cục bộ đã xác minh gần nhất. Sự cố mạng không nên âm thầm thay thế cấu hình đã ký bằng nội dung chưa được xác minh.
Các lệnh hữu ích
pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall| Lệnh | Sử dụng để |
|---|---|
pandapaw login |
Ủy quyền cho một máy đã cài đặt nhưng chưa kết nối với tài khoản |
pandapaw status |
Kiểm tra các dịch vụ đã cài đặt, kết nối máy và tình trạng cơ bản |
pandapaw agent status --root … |
Kiểm tra trạng thái Trung tâm tác tử cho một dự án |
pandapaw update --restart |
Xác minh, cài đặt và kích hoạt bản phát hành PandaPaw mới nhất |
pandapaw uninstall |
Gỡ bỏ các dịch vụ và tệp do PandaPaw quản lý một cách thận trọng |
Kiểm tra lịch sử phiên bản PandaPaw khi một lệnh hoặc giao diện người dùng khác với ảnh chụp màn hình hoặc hướng dẫn cũ hơn.
Ranh giới bảo mật
- Một người vận hành từ xa có thể sử dụng bất kỳ công cụ và thư mục làm việc nào mà phiên tác tử đã chọn cho phép. Truy cập từ xa không tự động ở chế độ chỉ đọc.
- Giữ các lệnh thiết bị dùng một lần, liên kết kết nối thủ công, khóa nhà cung cấp và mã thông báo tài khoản tránh xa nhật ký và ảnh chụp màn hình.
- Không mở cổng router gửi vào chỉ để làm cho PandaPaw có thể truy cập được.
- Xóa các máy chủ bạn không còn sở hữu khỏi Thiết bị đã kết nối.
- Xem xét các phê duyệt công cụ và xác minh thư mục làm việc trước khi cho phép chỉnh sửa hoặc lệnh shell.
- Khi chia sẻ một kết nối trực tiếp, người nhận tiêu thụ hạn mức công cụ của chủ sở hữu máy chủ và có thể thao tác trên máy chủ. Đọc Chia sẻ kết nối trước tiên.
Xử lý sự cố
Không tìm thấy `pandapaw` sau khi cài đặt
Mở một thiết bị đầu cuối mới để nó tải lại PATH của người dùng. Các vị trí thông thường là ~/.local/bin trên macOS/Linux và %LOCALAPPDATA%\Programs\pandapaw trên Windows. Xác nhận tệp tồn tại trước khi chạy lại trình cài đặt.
Cài đặt thành công nhưng không thấy máy nào xuất hiện
Chạy pandapaw status. Nếu máy không có ủy quyền tài khoản, hãy chạy pandapaw login. Nếu đã sử dụng khóa dùng một lần đã chuẩn bị, hãy tạo khóa mới thay vì thử lại một lệnh đã được sử dụng.
Máy hiển thị nhưng vẫn ngoại tuyến
Xác nhận máy chủ đang bật và có kết nối internet. Kiểm tra trạng thái PandaPaw cục bộ. Một proxy hoặc tường lửa của công ty phải cho phép đường dẫn HTTPS/WebSocket gửi ra; một cổng gửi vào không giải quyết được kết nối gửi ra bị chặn.
Máy chủ trực tuyến nhưng Claude Code hoặc Codex không trả lời
Việc ghép nối máy chủ không xác thực mọi nhà cung cấp mô hình. Mở công cụ cục bộ hoặc làm theo yêu cầu đăng nhập hiển thị trong phiên từ xa. Đồng thời xác nhận rằng mô hình đã chọn tồn tại cho tài khoản đó và hạn mức sử dụng của nó chưa bị cạn kiệt.
Phiên mở sai dự án
Kết thúc bài kiểm tra, chọn thư mục làm việc tuyệt đối mong muốn và yêu cầu tác tử in ra nó trước khi phê duyệt các công cụ. PandaPaw không đoán bạn muốn kho lưu trữ nào và không thêm một hộp cát hệ thống tệp ngoài mô hình phân quyền của chính công cụ.
Các thay đổi trong Trung tâm tác tử không xuất hiện
Chạy pandapaw agent status --root /path/to/project từ thư mục gốc Git chính xác. Xác nhận dự án đã được liên kết, máy chủ đã đăng nhập và tệp cục bộ là một phần của phản chiếu được quản lý. Giữ bản phát hành đã xác minh cuối cùng tại chỗ trong khi điều tra thay vì xóa các thư mục được quản lý.
Cập nhật và gỡ cài đặt
pandapaw update --restart tải xuống tệp nhị phân hiện tại, xác minh tổng kiểm tra SHA-256 của nó, thay thế bản sao đã cài đặt và khởi động lại các dịch vụ được quản lý để phiên bản trở nên hoạt động. Việc ghép nối tài khoản hiện có được bảo toàn.
pandapaw uninstall sử dụng tệp kê khai cài đặt để loại bỏ các mục do PandaPaw tạo ra. Các cài đặt Claude Code, Codex, PandaCode hoặc Node tương thích đã có sẵn được bảo toàn một cách có chủ đích. Sau khi gỡ cài đặt, hãy xóa máy chủ khỏi Thiết bị đã kết nối nếu nó không còn được tin cậy.