Εγκατάσταση PandaNpc και PandaPaw

Ενημερώθηκε

Μια απομακρυσμένη ρύθμιση πράκτορα κωδικοποίησης έχει δύο ανεξάρτητα μέρη:

  • PandaNpc client — η διεπαφή που χρησιμοποιείτε για να διαβάζετε συνεδρίες, να στέλνετε προτροπές και να εγκρίνετε εργαλεία. Λειτουργεί στον ιστό, iOS, Windows, macOS και Linux.
  • PandaPaw host — η υπηρεσία παρασκηνίου στον υπολογιστή όπου εκτελούνται πραγματικά το Claude Code, το Codex ή το PandaCode.

Εγκαταστήστε μόνο τον πελάτη για συνομιλία PandaNpc και τοπική χρήση επιτραπέζιου υπολογιστή. Εγκαταστήστε και τα δύο μέρη όταν θέλετε να αποκτήσετε πρόσβαση σε έναν πράκτορα κωδικοποίησης που εκτελείται σε άλλο μηχάνημα.

Δείτε το PandaNpc Desktop για το τι προσφέρει η εφαρμογή Windows/macOS/Linux πέρα από τα παρακάτω βήματα εγκατάστασης, συμπεριλαμβανομένου του ιστορικού εκδόσεών της.

Επιλέξτε τι θα εγκαταστήσετε

Σενάριο Πελάτης PandaPaw host
Χρήση συνομιλίας PandaNpc σε πρόγραμμα περιήγησης Ανοίξτε την εφαρμογή ιστού Δεν απαιτείται
Έλεγχος πράκτορα σε αυτόν τον επιτραπέζιο υπολογιστή Εφαρμογή επιτραπέζιου υπολογιστή Εξαρτάται από την επιλεγμένη τοπική/απομακρυσμένη λειτουργία
Έλεγχος υπολογιστή ανάπτυξης από τηλέφωνο ή πρόγραμμα περιήγησης Εγκατάσταση/άνοιγμα πελάτη στη συσκευή προβολής Απαιτείται στον υπολογιστή ανάπτυξης
Εκτέλεση πράκτορων σε διακομιστή χωρίς γραφικό περιβάλλον Ιστός, επιτραπέζιος ή iOS αλλού Απαιτείται στον διακομιστή

Για τη συντομότερη διαδρομή από άκρο σε άκρο, χρησιμοποιήστε τον Οδηγό Γρήγορης Έναρξης.

Εγκατάσταση πελάτη PandaNpc

Χρησιμοποιήστε τη σελίδα λήψης PandaNpc ως την αξιόπιστη πηγή για τα τρέχοντα προγράμματα εγκατάστασης. Αποφύγετε ιστότοπους λήψης τρίτων, καθώς ενδέχεται να παρέχουν παλιά ή τροποποιημένα πακέτα.

Ιστός

Ανοίξτε το pandanpc.com/agent σε ένα τρέχον πρόγραμμα περιήγησης. Δεν εγκαθίσταται τίποτα. Η αποθήκευση του προγράμματος περιήγησης διατηρεί την τοπική κατάσταση σύνδεσης, επομένως τα παράθυρα ιδιωτικής περιήγησης/ανώνυμης περιήγησης ενδέχεται να απαιτούν εκ νέου σύνδεση.

iOS

Ακολουθήστε τον σύνδεσμο App Store στη σελίδα λήψης και εγκαταστήστε το PandaNpc. Το iOS είναι χρήσιμο για έλεγχο προόδου, απαντήσεις σε ερωτήσεις και έγκριση εργαλείων όταν είστε μακριά από τον κεντρικό υπολογιστή. Η διαδικασία κωδικοποίησης εξακολουθεί να εκτελείται στο συνδεδεμένο μηχάνημα κεντρικού υπολογιστή. Δείτε το PandaNpc για iOS για το τι καλύπτει η εφαρμογή, συμπεριλαμβανομένου του ιστορικού εκδόσεών της.

Windows

  1. Κατεβάστε το τρέχον πρόγραμμα εγκατάστασης για Windows.
  2. Εκτελέστε το και ακολουθήστε τις οδηγίες του προγράμματος εγκατάστασης.
  3. Εκκινήστε το PandaNpc από το μενού Έναρξη.
  4. Εάν τα Windows εμφανίσουν προειδοποίηση εκδότη ή φήμης, επαληθεύστε ότι το αρχείο προέρχεται από το pandanpc.com πριν συνεχίσετε.

macOS

  1. Κατεβάστε το .dmg για macOS.
  2. Σύρετε το PandaNpc στον φάκελο Εφαρμογές.
  3. Εκκινήστε το από τις Εφαρμογές και ολοκληρώστε οποιαδήποτε προτροπή ασφαλείας του macOS.

Η έκδοση για macOS είναι καθολική, επομένως το ίδιο πακέτο υποστηρίζει Apple Silicon και Intel Macs.

Linux

Κατεβάστε το AppImage x86_64, κάντε το εκτελέσιμο και εκτελέστε το:

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

Εάν το AppImage δεν ξεκινήσει, εκτελέστε το μία φορά από το τερματικό και κρατήστε την ακριβή έξοδο σφάλματος. Οι παλαιότερες διανομές ενδέχεται να μην περιέχουν κάποια βιβλιοθήκη χρόνου εκτέλεσης που απαιτείται από το κέλυφος του επιτραπέζιου περιβάλλοντος.

Εγκατάσταση PandaPaw στον κεντρικό υπολογιστή του πράκτορα

Το PandaPaw παρέχει επί του παρόντος προγράμματα εγκατάστασης host για Windows x64, macOS universal και Linux x86_64. Εκτελέστε την εντολή στον υπολογιστή που διαθέτει τα αρχεία του έργου και θα πρέπει να εκτελεί τα εργαλεία του πράκτορα.

Η συνιστώμενη διαδρομή είναι οι Συνδεδεμένες Συσκευές: επιλέξτε Προσθήκη συσκευής και, στη συνέχεια, αντιγράψτε την παραγόμενη εντολή μίας χρήσης. Αυτή συνδέει τον host με τον λογαριασμό σας κατά την εγκατάσταση.

macOS ή Linux

Απλό πρόγραμμα εγκατάστασης με εξουσιοδότηση μέσω προγράμματος περιήγησης:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Έτοιμη φόρμα με κλειδί μίας χρήσης:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Απλό πρόγραμμα εγκατάστασης:

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Έτοιμη φόρμα με κλειδί μίας χρήσης:

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Η διοχέτευση iwr | iex του PowerShell δεν μπορεί να μεταφέρει κανονικά ορίσματα σεναρίου, επομένως το πρόγραμμα εγκατάστασης για Windows διαβάζει το κλειδί μίας χρήσης από το PANDANET_KEY.

Τι αλλάζει το πρόγραμμα εγκατάστασης του host

Το πρόγραμμα εγκατάστασης:

  1. Προσθέτει το PandaPaw στον κατάλογο εφαρμογών/εκτελέσιμων του τρέχοντος χρήστη και ενημερώνει το PATH του χρήστη όταν χρειάζεται.
  2. Καταχωρίζει τις κατάλληλες υπηρεσίες παρασκηνίου ώστε να ξεκινούν αυτόματα.
  3. Εγκαθιστά τις υποστηριζόμενες μηχανές κωδικοποίησης που λείπουν, όταν η πλατφόρμα το επιτρέπει.
  4. Παρέχει ένα ιδιωτικό περιβάλλον εκτέλεσης Node.js όταν το σύστημα δεν διαθέτει κατάλληλη έκδοση.
  5. Ξεκινά την εξουσιοδότηση λογαριασμού ή εξαργυρώνει το προετοιμασμένο κλειδί συσκευής.
  6. Καταγράφει ποια αρχεία δημιούργησε, ώστε η απεγκατάσταση να μπορεί να διατηρήσει συμβατά εργαλεία που υπήρχαν ήδη.

Η εγκατάσταση μιας μηχανής δεν αγοράζει ούτε πιστοποιεί αυτόματα μια συνδρομή μοντέλου. Το Claude Code και το Codex μπορούν ακόμα να ζητήσουν τη δική τους σύνδεση παρόχου την πρώτη φορά που θα εκτελεστούν.

Επαληθεύστε την εγκατάσταση

Ανοίξτε ένα νέο τερματικό μετά την εγκατάσταση και εκτελέστε:

bash
pandapaw status

Στη συνέχεια, ανοίξτε το PandaNpc Agent. Ο host θα πρέπει να εμφανίζεται σε σύνδεση. Ξεκινήστε μια συνεδρία σε ένα δοκιμαστικό έργο και ζητήστε του να αναφέρει τον τρέχοντα κατάλογο εργασίας χωρίς να αλλάξει αρχεία. Αυτό επαληθεύει το δυαδικό αρχείο, την υπηρεσία παρασκηνίου, τη σύζευξη λογαριασμού, τη σύνδεση ρελέ, τη μηχανή και τον επιλεγμένο κατάλογο—όχι μόνο το βήμα λήψης.

Ενημέρωση

Οι επιτραπέζιοι πελάτες σας ειδοποιούν όταν υπάρχει διαθέσιμη ενημέρωση. Το iOS ενημερώνεται μέσω του App Store.

Ενημερώστε το PandaPaw και επανεκκινήστε τις διαχειριζόμενες υπηρεσίες του με:

bash
pandapaw update --restart

Το πρόγραμμα ενημέρωσης επαληθεύει το ληφθέν δυαδικό αρχείο με τη δημοσιευμένη σύνοψη ελέγχου SHA-256 πριν αντικαταστήσει το εγκατεστημένο αντίγραφο. Η σύζευξη λογαριασμού και η υπάρχουσα ταυτότητα σύνδεσής σας διατηρούνται. Η εκ νέου εκτέλεση της εντολής εγκατάστασης υποστηρίζεται επίσης όταν το ίδιο το πρόγραμμα ενημέρωσης δεν είναι διαθέσιμο.

Απεγκατάσταση

  • Πελάτης Windows: Ρυθμίσεις → Εφαρμογές → Εγκατεστημένες εφαρμογές → PandaNpc → Κατάργηση εγκατάστασης.
  • Πελάτης macOS: κλείστε το PandaNpc και, στη συνέχεια, μετακινήστε το από τις Εφαρμογές στον Κάδο.
  • Πελάτης Linux: αφαιρέστε το AppImage και οποιονδήποτε εκκινητή δημιουργήσατε για αυτό.
  • PandaPaw host: εκτελέστε pandapaw uninstall στον host.

Το μανιφέστο απεγκατάστασης του PandaPaw διακρίνει τα εργαλεία που δημιούργησε το πρόγραμμα εγκατάστασης από συμβατά εργαλεία που υπήρχαν ήδη. Είναι σκόπιμα συντηρητικό και δεν διαγράφει μια προϋπάρχουσα εγκατάσταση Claude Code, Codex, PandaCode ή Node.

Προβλήματα εγκατάστασης

Η εντολή ολοκληρώθηκε αλλά ο host δεν είναι συνδεδεμένος

Εκτελέστε pandapaw login. Η εγκατάσταση host και η εξουσιοδότηση λογαριασμού είναι ξεχωριστά στάδια και το πρόγραμμα εγκατάστασης μπορεί να ολοκληρωθεί ακόμα κι αν η εξουσιοδότηση μέσω προγράμματος περιήγησης καθυστερήσει ή διακοπεί.

Το κέλυφος δεν μπορεί να βρει το `pandapaw`

Ανοίξτε ένα νέο τερματικό. Σε macOS/Linux, ελέγξτε το ~/.local/bin· στα Windows, ελέγξτε το %LOCALAPPDATA%\Programs\pandapaw. Μην επανεγκαθιστάτε επανειλημμένα έως ότου επιβεβαιώσετε αν το εκτελέσιμο υπάρχει και ότι μόνο το PATH είναι ξεπερασμένο.

Μια μηχανή κωδικοποίησης δεν εγκαταστάθηκε

Το πρόγραμμα εγκατάστασης host αντιμετωπίζει τις προαιρετικές λήψεις μηχανών ως "καλύτερη προσπάθεια", έτσι ώστε μια διακοπή λειτουργίας παρόχου να μην αφαιρεί μια λειτουργική εγκατάσταση PandaPaw. Εγκαταστήστε ή επισκευάστε αυτή τη μηχανή χρησιμοποιώντας το επίσημο πρόγραμμα εγκατάστασης, πιστοποιήστε την κανονικά και, στη συνέχεια, εκτελέστε ξανά το pandapaw status.

Το AppImage ή η εφαρμογή επιτραπέζιου υπολογιστή δεν ανοίγει

Επιβεβαιώστε ότι κατεβάσατε το πακέτο για τη σωστή αρχιτεκτονική και, στη συνέχεια, εκκινήστε το από τερματικό για να καταγράψετε το πρώτο σφάλμα. Συμπεριλάβετε αυτό το σφάλμα και την έκδοση του λειτουργικού σας συστήματος όταν επικοινωνήσετε με την υποστήριξη· τα στιγμιότυπα οθόνης ενός κλειστού παραθύρου συνήθως δεν αρκούν για τη διάγνωση μιας ελλιπούς βιβλιοθήκης χρόνου εκτέλεσης.

Για ελέγχους σύνδεσης ειδικούς για τον host, συνεχίστε με τον οδηγό PandaPaw ή τις Συχνές Ερωτήσεις (FAQ).