Το PandaPaw μετατρέπει ένα μηχάνημα Windows, macOS ή Linux που ελέγχετε σε κεντρικό υπολογιστή πρακτόρων PandaNpc. Ο μηχανισμός κώδικα, τα αρχεία έργου, το κέλυφος και τα εργαλεία παραμένουν σε αυτόν τον κεντρικό υπολογιστή· οι πελάτες PandaNpc σας δίνουν μια συγχρονισμένη διεπαφή από ένα τηλέφωνο, πρόγραμμα περιήγησης ή άλλο επιτραπέζιο υπολογιστή.
Χρησιμοποιήστε το PandaPaw όταν το μηχάνημα που εκτελεί την εργασία είναι διαφορετικό από τη συσκευή που κρατάτε, όταν θέλετε έναν κεντρικό υπολογιστή να επιβιώνει από αποσυνδέσεις πελατών, ή όταν πολλοί μηχανισμοί κώδικα πρέπει να μοιράζονται την ίδια ρύθμιση βάσει λογαριασμού και τη διαμόρφωση του Κέντρου Πρακτόρων.
Τι διαχειρίζεται το PandaPaw
- Απομακρυσμένες συνδέσεις πρακτόρων για το Claude Code, το OpenAI Codex και το PandaCode.
- Υπηρεσίες παρασκηνίου και αυτόματη εκκίνηση ώστε ο κεντρικός υπολογιστής να επανέρχεται μετά από μια κανονική επανεκκίνηση.
- Εξουσιοδότηση μηχανήματος βάσει λογαριασμού χωρίς χειροκίνητη αντιγραφή ενός μακρόβιου Αναγνωριστικού γέφυρας, διακριτικού ή κλειδιού υπογραφής.
- Βοήθεια εγκατάστασης μηχανισμού όταν λείπει ένας υποστηριζόμενος μηχανισμός κώδικα.
- Προβολές Κέντρου Πρακτόρων που αποδίδουν τις οδηγίες, τις δεξιότητες, τη μνήμη και τους ορισμούς πρακτόρων κάθε μηχανισμού στην εγγενή του διάταξη.
- Ιδιωτική δικτύωση συσκευών για μηχανήματα που συνδέονται μέσω της ροής Συνδεδεμένες Συσκευές.
- Λογιστική ενημέρωσης και απεγκατάστασης ώστε να διατηρούνται τα εργαλεία που υπήρχαν πριν από το PandaPaw.
Το PandaPaw δεν παρέχει από μόνο του συνδρομή μοντέλου. Το Claude Code, το Codex και το PandaCode εξακολουθούν να χρησιμοποιούν τα διαπιστευτήρια παρόχου και τα όρια που έχουν διαμορφωθεί για τον μηχανισμό τους.
Πώς λειτουργεί η απομακρυσμένη εκτέλεση
Και οι δύο πλευρές ξεκινούν εξερχόμενες συνδέσεις, οπότε μια κανονική εγκατάσταση σπιτιού ή γραφείου δεν απαιτεί κανόνα εισερχόμενου τείχους προστασίας, δημόσια διεύθυνση IP, προώθηση θυρών στο δρομολογητή ή δημόσια εκτεθειμένο διακομιστή SSH. Το ρελέ μεταφέρει μηνύματα, κατάσταση και εγκρίσεις· η εκτέλεση εργαλείων γίνεται στον κεντρικό υπολογιστή.
Εάν ο κεντρικός υπολογιστής τεθεί σε αναστολή λειτουργίας, απενεργοποιηθεί ή χάσει τη διαδρομή εξερχόμενου δικτύου του, η αποθηκευμένη σύνδεση παραμένει στον λογαριασμό σας αλλά δεν μπορεί να εκτελέσει εργασία έως ότου επιστρέψει ο κεντρικός υπολογιστής.
Υποστηριζόμενες πλατφόρμες κεντρικού υπολογιστή
| Πλατφόρμα κεντρικού υπολογιστή | Πακέτο | Σημειώσεις |
|---|---|---|
| Windows x64 | Εγγενές εκτελέσιμο και υπηρεσίες επιπέδου χρήστη | Εκτελέστε το πρόγραμμα εγκατάστασης στο PowerShell |
| macOS, Apple Silicon ή Intel | Καθολική εφαρμογή/δυαδικό PandaPaw | Το ίδιο πακέτο υποστηρίζει και τις δύο αρχιτεκτονικές |
| Linux x86_64 | Εγγενές δυαδικό και υπηρεσία χρήστη | Προορίζεται για κοινές διανομές που βασίζονται σε glibc |
Ο πελάτης προβολής PandaNpc έχει ευρύτερη μήτρα πλατφορμών. Δείτε Εγκατάσταση PandaNpc και PandaPaw όταν επιλέγετε πακέτα πελάτη και κεντρικού υπολογιστή.
Συνιστώμενη εγκατάσταση
- Συνδεθείτε στο PandaNpc.
- Ανοίξτε τις Συνδεδεμένες Συσκευές.
- Επιλέξτε Προσθήκη συσκευής. Εκδίδεται ένα εφάπαξ κλειδί και ο διάλογος εμφανίζει μία εντολή για το ανιχνευμένο λειτουργικό σύστημα.
- Αντιγράψτε αυτήν την εντολή στον κεντρικό υπολογιστή και εκτελέστε την εκεί.
- Αφήστε τον διάλογο ανοιχτό εάν θέλετε να ανιχνεύσει αυτόματα το νέο μηχάνημα.
Το προετοιμασμένο κλειδί είναι μίας χρήσης. Αντιγράψτε ολόκληρη την εντολή, κρατήστε την ιδιωτική και δημιουργήστε ένα νέο εάν λήξει ή έχει ήδη χρησιμοποιηθεί.
Απλό πρόγραμμα εγκατάστασης macOS/Linux
Χρησιμοποιήστε αυτή τη μορφή όταν θέλετε εξουσιοδότηση μέσω προγράμματος περιήγησης αντί για προετοιμασμένο κλειδί:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shΑπλό πρόγραμμα εγκατάστασης Windows PowerShell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexΤο απλό πρόγραμμα εγκατάστασης εκτελεί pandapaw login. Εγκρίνετε το μηχάνημα στη σελίδα του προγράμματος περιήγησης που ανοίγει. Εάν η εξουσιοδότηση διακοπεί, το δυαδικό αρχείο και οι υπηρεσίες μπορούν ακόμα να εγκατασταθούν· εκτελέστε αργότερα pandapaw login για να ολοκληρώσετε τη σύνδεση λογαριασμού.
Επαληθεύστε τον κεντρικό υπολογιστή
Πρώτα ελέγξτε τον ίδιο τον κεντρικό υπολογιστή:
pandapaw statusΣτη συνέχεια, ανοίξτε τον PandaNpc Agent και επιβεβαιώστε ότι το μηχάνημα έχει ένδειξη πράσινης σύνδεσης. Ξεκινήστε μια συνεδρία σε έναν προσωρινό ή μόνο για ανάγνωση κατάλογο δοκιμών και ρωτήστε:
Δοκιμαστική προτροπή: Εκτυπώστε τον τρέχοντα κατάλογο εργασίας και παραθέστε τα αρχεία ανώτερου επιπέδου. Μην τροποποιήσετε τίποτα.
Μια επιτυχημένη απάντηση αποδεικνύει κάτι περισσότερο από μια πράσινη ένδειξη κατάστασης: επαληθεύει τη σύζευξη λογαριασμού, τη συνδεσιμότητα ρελέ, τον επιλεγμένο μηχανισμό, την αυθεντικοποίηση παρόχου και την αντιστοίχιση καταλόγου εργασίας.
Για ένα έργο Κέντρου Πρακτόρων, εκτελέστε:
pandapaw agent status --root /absolute/path/to/projectΑυτό δείχνει εάν το έργο είναι δεσμευμένο και εάν η διαχειριζόμενη διαμόρφωση είναι διαθέσιμη τοπικά. Ένα σταθερό απομακρυσμένο αποθετήριο Git βοηθά το PandaPaw να αναγνωρίσει το ίδιο έργο σε διαφορετικά μηχανήματα.
Εξουσιοδότηση λογαριασμού και ταυτότητα σύνδεσης
Το pandapaw login χρησιμοποιεί μια συνεδρία εξουσιοδότησης συσκευής μέσω προγράμματος περιήγησης. Αφού την εγκρίνετε, ο κεντρικός υπολογιστής λαμβάνει διαπιστευτήρια με εμβέλεια συσκευής και ένα κλειδί επαλήθευσης Κέντρου Πρακτόρων μέσω TLS, γράφει τη διαμόρφωση του μηχανήματός του στο ~/.pandapaw/, καταχωρίζει τις υποστηριζόμενες συνδέσεις μηχανισμών και δεσμεύει αναγνωρίσιμα έργα Git.
Εκτελέστε pandapaw login --force μόνο όταν αλλάζετε σκόπιμα λογαριασμούς ή αντικαθιστάτε ένα ληγμένο διαπιστευτήριο κεντρικού υπολογιστή. Η εκ νέου εξουσιοδότηση ενός υγιούς μηχανήματος χωρίς λόγο μπορεί να δημιουργήσει συγκεχυμένες διπλότυπες ή αντικατεστημένες ταυτότητες.
Το pandapaw qr εξακολουθεί να δημιουργεί ένα βραχύβιο χειροκίνητο σύνδεσμο σύνδεσης για συμβατότητα και ειδικές περιπτώσεις. Δεν είναι η κύρια ροή για έναν νέο κεντρικό υπολογιστή· οι Συνδεδεμένες Συσκευές είναι ευκολότερες στην ελεγξιμότητα και δεν απαιτούν από τους χρήστες να κατανοούν τα Αναγνωριστικά γέφυρας.
Συγχρονισμός Κέντρου Πρακτόρων
Το Κέντρο Πρακτόρων είναι βασισμένο σε συμβάντα σε σταθερή κατάσταση:
- Οι τοπικές αλλαγές σε διαχειριζόμενα αρχεία ανιχνεύονται και δημοσιεύονται στο δεσμευμένο έργο.
- Οι υπογεγραμμένες εκδόσεις φτάνουν μέσω μιας ροής συμβάντων.
- Τα αμετάβλητα μανιφέστα και τα αντικείμενα περιεχομένου επαναχρησιμοποιούνται αντί να μεταφορτώνονται ξανά.
- Ένας περιοδικός έλεγχος ανάκτησης εντοπίζει συμβάντα που χάθηκαν κατά τη διάρκεια μιας προσωρινής αποσύνδεσης.
Το Claude Code, το Codex και το PandaCode λαμβάνουν ξεχωριστές προβολές επειδή αναμένουν διαφορετικούς καταλόγους και μορφές οδηγιών. Το PandaCode προετοιμάζει την τελευταία επαληθευμένη έκδοση πριν συναρμολογήσει μια νέα προτροπή συνεδρίας, οπότε η διαμόρφωση που αντλείται κατά την εκκίνηση μπορεί να επηρεάσει αυτήν τη συνεδρία.
Εάν το Κέντρο Πρακτόρων είναι προσωρινά μη διαθέσιμο, ο μηχανισμός συνεχίζει με την τελευταία επαληθευμένη τοπική έκδοση. Μια αστοχία δικτύου δεν πρέπει να αντικαθιστά σιωπηλά την υπογεγραμμένη διαμόρφωση με μη επαληθευμένο περιεχόμενο.
Χρήσιμες εντολές
pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall| Εντολή | Χρήση |
|---|---|
pandapaw login |
Εξουσιοδοτήστε ένα εγκατεστημένο μηχάνημα που δεν είναι ακόμη συνδεδεμένο σε λογαριασμό |
pandapaw status |
Ελέγξτε τις εγκατεστημένες υπηρεσίες, τη σύνδεση μηχανήματος και τη βασική υγεία |
pandapaw agent status --root … |
Επιθεωρήστε την κατάσταση του Κέντρου Πρακτόρων για ένα έργο |
pandapaw update --restart |
Επαληθεύστε, εγκαταστήστε και ενεργοποιήστε την πιο πρόσφατη έκδοση του PandaPaw |
pandapaw uninstall |
Αφαιρέστε συντηρητικά τις υπηρεσίες και τα αρχεία που διαχειρίζεται το PandaPaw |
Ελέγξτε το ιστορικό εκδόσεων PandaPaw όταν μια εντολή ή διεπαφή διαφέρει από μια παλαιότερη εικόνα ή σεμινάριο.
Όρια ασφαλείας
- Ένας απομακρυσμένος χειριστής μπορεί να χρησιμοποιήσει όσα εργαλεία και κατάλογο εργασίας επιτρέπει η επιλεγμένη συνεδρία πράκτορα. Η απομακρυσμένη πρόσβαση δεν είναι αυτόματα μόνο για ανάγνωση.
- Κρατήστε τις εφάπαξ εντολές συσκευής, τους χειροκίνητους συνδέσμους σύνδεσης, τα κλειδιά παρόχου και τα διακριτικά λογαριασμού μακριά από αρχεία καταγραφής και στιγμιότυπα οθόνης.
- Μην ανοίγετε θύρες εισερχόμενων συνδέσεων στο δρομολογητή μόνο και μόνο για να είναι προσβάσιμο το PandaPaw.
- Αφαιρέστε από τις Συνδεδεμένες Συσκευές τους κεντρικούς υπολογιστές που δεν κατέχετε πλέον.
- Εξετάστε τις εγκρίσεις εργαλείων και επαληθεύστε τον κατάλογο εργασίας πριν επιτρέψετε επεξεργασίες ή εντολές κελύφους.
- Όταν μοιράζεστε μια ζωντανή σύνδεση, ο παραλήπτης καταναλώνει το όριο μηχανισμού του ιδιοκτήτη του κεντρικού υπολογιστή και μπορεί να ενεργήσει στον κεντρικό υπολογιστή. Διαβάστε πρώτα το Διαμοιρασμός σύνδεσης.
Αντιμετώπιση προβλημάτων
Το `pandapaw` δεν βρίσκεται μετά την εγκατάσταση
Ανοίξτε ένα νέο τερματικό ώστε να επαναφορτώσει το PATH του χρήστη. Οι συνήθεις τοποθεσίες είναι ~/.local/bin σε macOS/Linux και %LOCALAPPDATA%\Programs\pandapaw σε Windows. Επιβεβαιώστε ότι το αρχείο υπάρχει πριν εκτελέσετε ξανά το πρόγραμμα εγκατάστασης.
Η εγκατάσταση ήταν επιτυχής, αλλά δεν εμφανίζεται κανένα μηχάνημα
Εκτελέστε pandapaw status. Εάν το μηχάνημα δεν έχει εξουσιοδότηση λογαριασμού, εκτελέστε pandapaw login. Εάν χρησιμοποιήθηκε ένα προετοιμασμένο εφάπαξ κλειδί, δημιουργήστε ένα νέο κλειδί αντί να επαναλάβετε μια εντολή που έχει ήδη χρησιμοποιηθεί.
Το μηχάνημα εμφανίζεται αλλά παραμένει εκτός σύνδεσης
Επιβεβαιώστε ότι ο κεντρικός υπολογιστής είναι ενεργός και έχει πρόσβαση στο διαδίκτυο. Ελέγξτε τοπικά την κατάσταση του PandaPaw. Ένα εταιρικό διακομιστή μεσολάβησης ή τείχος προστασίας πρέπει να επιτρέπει την εξερχόμενη διαδρομή HTTPS/WebSocket· μια εισερχόμενη θύρα δεν λύνει μια μπλοκαρισμένη εξερχόμενη σύνδεση.
Ο κεντρικός υπολογιστής είναι σε σύνδεση, αλλά το Claude Code ή το Codex δεν απαντά
Η σύζευξη του κεντρικού υπολογιστή δεν πιστοποιεί κάθε πάροχο μοντέλου. Ανοίξτε τον μηχανισμό τοπικά ή ακολουθήστε την προτροπή σύνδεσης που εμφανίζεται στην απομακρυσμένη συνεδρία. Επιβεβαιώστε επίσης ότι το επιλεγμένο μοντέλο υπάρχει για αυτόν τον λογαριασμό και ότι το όριο χρήσης του δεν έχει εξαντληθεί.
Η συνεδρία ανοίγει σε λάθος έργο
Τερματίστε τη δοκιμή, επιλέξτε τον επιδιωκόμενο απόλυτο κατάλογο εργασίας και ζητήστε από τον πράκτορα να τον εκτυπώσει πριν εγκρίνετε εργαλεία. Το PandaPaw δεν μαντεύει ποιο αποθετήριο εννοείτε και δεν προσθέτει sandbox συστήματος αρχείων πέρα από το μοντέλο αδειών του ίδιου του μηχανισμού.
Οι αλλαγές στο Κέντρο Πρακτόρων δεν εμφανίζονται
Εκτελέστε pandapaw agent status --root /path/to/project από τη σωστή ρίζα Git. Επιβεβαιώστε ότι το έργο είναι δεσμευμένο, ο κεντρικός υπολογιστής έχει συνδεθεί και το τοπικό αρχείο αποτελεί μέρος μιας διαχειριζόμενης προβολής. Διατηρήστε την τελευταία επαληθευμένη έκδοση στη θέση της ενώ ερευνάτε αντί να διαγράφετε διαχειριζόμενους καταλόγους.
Ενημέρωση και απεγκατάσταση
Το pandapaw update --restart κατεβάζει το τρέχον δυαδικό αρχείο, επαληθεύει το άθροισμα ελέγχου SHA-256, αντικαθιστά το εγκατεστημένο αντίγραφο και επανεκκινεί τις διαχειριζόμενες υπηρεσίες ώστε η έκδοση να γίνει ενεργή. Η υπάρχουσα σύζευξη λογαριασμού διατηρείται.
Το pandapaw uninstall χρησιμοποιεί το μανιφέστο εγκατάστασης για να αφαιρέσει στοιχεία που δημιούργησε το PandaPaw. Οι συμβατές εγκαταστάσεις Claude Code, Codex, PandaCode ή Node που υπήρχαν ήδη διατηρούνται σκόπιμα. Μετά την απεγκατάσταση, αφαιρέστε τον κεντρικό υπολογιστή από τις Συνδεδεμένες Συσκευές εάν δεν θα πρέπει πλέον να θεωρείται αξιόπιστος.