PandaPaw promění počítač se systémem Windows, macOS nebo Linux, který ovládáte, v hostitele agentů PandaNpc. Kódovací engine, soubory projektu, shell a nástroje zůstávají na tomto hostiteli; klienti PandaNpc vám poskytují synchronizované rozhraní z telefonu, prohlížeče nebo jiného počítače.
PandaPaw použijte, když se stroj vykonávající práci liší od zařízení, které držíte v ruce, když chcete, aby hostitel přežil odpojení klienta, nebo když má několik kódovacích enginů sdílet stejné nastavení založené na účtu a konfiguraci Centra Agentů.
Co PandaPaw spravuje
- Vzdálená připojení agentů pro Claude Code, OpenAI Codex a PandaCode.
- Služby na pozadí a automatické spuštění, aby se hostitel mohl vrátit po běžném restartu.
- Autorizace počítače na základě účtu bez ručního kopírování dlouhodobého ID mostu (Bridge ID), tokenu nebo podpisového klíče.
- Pomoc s instalací enginu, když chybí podporovaný kódovací engine.
- Projekce Centra Agentů, které vykreslují pokyny, dovednosti, paměť a definice agentů každého enginu v jeho nativním rozložení.
- Soukromé síťování zařízení pro počítače připojené prostřednictvím postupu Připojená zařízení.
- Správa aktualizací a odinstalace, aby byly zachovány nástroje, které existovaly před PandaPaw.
PandaPaw sám neposkytuje předplatné modelu. Claude Code, Codex a PandaCode nadále používají přihlašovací údaje poskytovatele a limity nakonfigurované pro jejich engine.
Jak funguje vzdálené spouštění
Obě strany navazují odchozí připojení, takže běžné domácí nebo kancelářské nastavení nevyžaduje příchozí pravidlo brány firewall, veřejnou IP adresu, přesměrování portů na routeru ani veřejně vystavený server SSH. Relé přenáší zprávy, stav a schválení; spouštění nástrojů probíhá na hostiteli.
Pokud hostitel usne, vypne se nebo ztratí odchozí síťovou cestu, uložené připojení zůstane ve vašem účtu, ale nebude moci vykonávat práci, dokud se hostitel nevrátí.
Podporované platformy hostitele
| Platforma hostitele | Balíček | Poznámky |
|---|---|---|
| Windows x64 | Nativní spustitelný soubor a uživatelské služby | Spusťte instalátor v PowerShellu |
| macOS, Apple Silicon nebo Intel | Univerzální aplikace/binární soubor PandaPaw | Stejný balíček podporuje obě architektury |
| Linux x86_64 | Nativní binární soubor a uživatelská služba | Určeno pro běžné distribuce založené na glibc |
Klientská aplikace pro prohlížení PandaNpc má širší matici platforem. Při výběru balíčků pro klienta a hostitele viz Instalace PandaNpc a PandaPaw.
Doporučená instalace
- Přihlaste se do PandaNpc.
- Otevřete Připojená zařízení.
- Zvolte Přidat zařízení. Je vydán jednorázový klíč a dialog zobrazí jeden příkaz pro zjištěný operační systém.
- Zkopírujte tento příkaz na hostitele a spusťte jej tam.
- Pokud chcete, aby dialog automaticky zjistil nový počítač, nechte jej otevřený.
Připravený klíč je jednorázový. Zkopírujte celý příkaz, uchovávejte jej v soukromí a vygenerujte nový, pokud vyprší nebo byl již použit.
Obyčejný instalátor pro macOS/Linux
Tento formulář použijte, když chcete autorizaci prohlížečem místo připraveného klíče:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shObyčejný instalátor pro Windows PowerShell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iexObyčejný instalátor spustí pandapaw login. Schvalte počítač na stránce prohlížeče, kterou otevře. Pokud je autorizace přerušena, binární soubor a služby lze stále nainstalovat; později spusťte pandapaw login pro dokončení připojení účtu.
Ověření hostitele
Nejprve zkontrolujte samotného hostitele:
pandapaw statusPoté otevřete PandaNpc Agent a ověřte, že má počítač zelený indikátor online. Spusťte relaci v dočasném nebo pouze pro čtení určeném testovacím adresáři a zeptejte se:
Testovací výzva: Vytiskněte aktuální pracovní adresář a vypište soubory v nejvyšší úrovni. Nic neměňte.
Úspěšná odpověď dokazuje více než zelený indikátor stavu: ověřuje párování účtu, připojení k relé, vybraný engine, autentizaci poskytovatele a mapování pracovního adresáře.
Pro projekt Centra Agentů spusťte:
pandapaw agent status --root /absolute/path/to/projectToto ukazuje, zda je projekt vázán a zda je spravovaná konfigurace dostupná lokálně. Stabilní vzdálený repozitář Git pomáhá PandaPaw identifikovat stejný projekt napříč počítači.
Autorizace účtu a identita připojení
pandapaw login používá relaci autorizace zařízení v prohlížeči. Po jejím schválení hostitel obdrží přihlašovací údaje vázané na zařízení a ověřovací klíč Centra Agentů přes TLS, zapíše konfiguraci počítače do ~/.pandapaw/, zaregistruje připojení podporovaných enginů a sváže rozpoznatelné projekty Git.
Spouštějte pandapaw login --force pouze při záměrném přepnutí účtu nebo nahrazení prošlého přihlašovacího údaje hostitele. Opětovná autorizace zdravého počítače bez důvodu může vytvořit matoucí duplicitní nebo nahrazené identity.
pandapaw qr stále vytváří krátkodobý ruční odkaz pro připojení kvůli kompatibilitě a zvláštním případům. Není to primární postup pro nového hostitele; Připojená zařízení se snáze kontrolují a nevyžadují, aby uživatelé rozuměli ID mostů (Bridge ID).
Synchronizace Centra Agentů
Centrum Agentů je v ustáleném stavu řízeno událostmi:
- Lokální změny spravovaných souborů jsou zjištěny a publikovány do vázaného projektu.
- Podepsané verze přicházejí prostřednictvím datového proudu událostí.
- Nezměněné manifesty a obsahové bloby se znovu použijí, místo aby se znovu stahovaly.
- Pravidelná kontrola obnovy zachytí události zmeškané během dočasného odpojení.
Claude Code, Codex a PandaCode dostávají samostatné projekce, protože očekávají různé adresáře a formáty instrukcí. PandaCode připraví nejnovější ověřenou verzi před sestavením výzvy nové relace, takže konfigurace načtená při spuštění může ovlivnit tuto samou relaci.
Pokud je Centrum Agentů dočasně nedostupné, engine pokračuje s poslední ověřenou lokální verzí. Selhání sítě by nemělo tiše nahradit podepsanou konfiguraci neověřeným obsahem.
Užitečné příkazy
pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall| Příkaz | Použití |
|---|---|
pandapaw login |
Autorizace nainstalovaného počítače, který ještě není připojen k účtu |
pandapaw status |
Kontrola nainstalovaných služeb, připojení počítače a základního stavu |
pandapaw agent status --root … |
Prozkoumání stavu Centra Agentů pro jeden projekt |
pandapaw update --restart |
Ověření, instalace a aktivace nejnovější verze PandaPaw |
pandapaw uninstall |
Opatrné odstranění služeb a souborů spravovaných PandaPaw |
Podívejte se na historii verzí PandaPaw, pokud se příkaz nebo uživatelské rozhraní liší od staršího snímku obrazovky nebo návodu.
Bezpečnostní hranice
- Vzdálený operátor může používat jakékoli nástroje a pracovní adresář, které vybraná relace agenta umožňuje. Vzdálený přístup není automaticky pouze pro čtení.
- Uchovávejte jednorázové příkazy zařízení, ruční odkazy pro připojení, klíče poskytovatele a tokeny účtu mimo protokoly a snímky obrazovky.
- Neotevírejte příchozí porty na routeru jen proto, aby byl PandaPaw dostupný.
- Odstraňte hostitele, které již nevlastníte, z Připojených zařízení.
- Zkontrolujte schválení nástrojů a ověřte pracovní adresář, než povolíte úpravy nebo příkazy shellu.
- Při sdílení živého připojení spotřebovává příjemce kvótu enginu vlastníka hostitele a může na hostiteli jednat. Nejprve si přečtěte Sdílení připojení.
Řešení problémů
`pandapaw` není po instalaci nalezen
Otevřete nový terminál, aby se znovu načetla uživatelská proměnná PATH. Obvyklá umístění jsou ~/.local/bin na macOS/Linux a %LOCALAPPDATA%\Programs\pandapaw na Windows. Před opětovným spuštěním instalátoru ověřte, že soubor existuje.
Instalace proběhla úspěšně, ale neobjeví se žádný počítač
Spusťte pandapaw status. Pokud počítač nemá autorizaci účtu, spusťte pandapaw login. Pokud byl použit připravený jednorázový klíč, vytvořte nový klíč, místo abyste znovu zkoušeli použitý příkaz.
Počítač se objeví, ale zůstává offline
Ověřte, že je hostitel zapnutý a má přístup k internetu. Lokálně zkontrolujte stav PandaPaw. Firemní proxy nebo firewall musí povolit odchozí cestu HTTPS/WebSocket; příchozí port nevyřeší blokované odchozí připojení.
Hostitel je online, ale Claude Code nebo Codex neodpovídá
Párování hostitele neautentizuje každého poskytovatele modelu. Otevřete engine lokálně nebo postupujte podle výzvy k přihlášení zobrazené ve vzdálené relaci. Také ověřte, že vybraný model pro tento účet existuje a že není vyčerpán jeho limit používání.
Relace se otevře v nesprávném projektu
Ukončete test, vyberte zamýšlený absolutní pracovní adresář a požádejte agenta, aby jej vytiskl, než schválíte nástroje. PandaPaw nehádá, který repozitář jste mysleli, a nepřidává sandbox souborového systému nad rámec modelu oprávnění enginu.
Změny Centra Agentů se nezobrazují
Spusťte pandapaw agent status --root /path/to/project ze správného kořene Git. Ověřte, že je projekt vázán, hostitel je přihlášen a lokální soubor je součástí spravované projekce. Při vyšetřování ponechte poslední ověřenou verzi na místě, místo abyste mazali spravované adresáře.
Aktualizace a odinstalace
pandapaw update --restart stáhne aktuální binární soubor, ověří jeho kontrolní součet SHA-256, nahradí nainstalovanou kopii a restartuje spravované služby, aby se verze aktivovala. Stávající párování účtu je zachováno.
pandapaw uninstall používá instalační manifest k odstranění položek, které PandaPaw vytvořil. Kompatibilní instalace Claude Code, Codex, PandaCode nebo Node, které již byly přítomny, jsou záměrně zachovány. Po odinstalaci odeberte hostitele z Připojených zařízení, pokud by už neměl být důvěryhodný.