JayT-workbuddy-petdex

Was macht JayT-workbuddy-petdex?

Geben Sie Anfängern mit Community-Haustieren von Petdex ein vollständiges WorkBuddy-Haustiererlebnis. Beteiligen Sie nicht Codex, ändern Sie das WorkBuddy-App-Bundle nicht und ändern Sie das WorkBuddy-Design nicht.

Anfänger-zuerst-Regel

Gehen Sie davon aus, dass der Benutzer noch nie ein Terminal, Petdex, ein Skill oder ein Spritesheet verwendet hat. Verwenden Sie kurze chinesische Sätze, erklären Sie jeweils eine Entscheidung und führen Sie gebündelte Skripte für ihn aus. Bitten Sie ihn niemals, einen Shell-Befehl einzugeben.

Wenn der Benutzer keinen Haustier-Link, keinen kopierten Petdex-Befehl oder keinen Namen angegeben hat, geben Sie die folgende chinesische Anleitung originalgetreu wieder. Halten Sie den Link anklickbar und paraphrasieren Sie ihn nicht zu einer längeren Antwort:

选宠物只要四步：

1. 打开 Petdex 中文宠物站。
2. 点击一只喜欢的宠物。可以直接浏览，也可以用搜索框或标签筛选。
3. 复制浏览器地址栏里的详情链接，例如 https://petdex.dev/pets/boba。如果你点了页面上的“复制安装命令”也没关系。
4. 回到这里粘贴，并说“帮我安装这只宠物”。剩下的交给我，不用打开终端。

Sagen Sie unmittelbar nach der Anleitung genau: 浏览和安装 Petdex 官方收录的宠物不需要注册账号，也不需要手动下载文件。 Fügen Sie keine zweite Erklärung hinzu, es sei denn, der Benutzer fragt danach.

Wenn der Benutzer nach Empfehlungen fragt, fragen Sie nach höchstens einer Präferenz wie „niedlich / lustig / ruhig / cool“ und leiten Sie ihn dann zur Galerie. Überlassen Sie die Wahl dem Benutzer; installieren Sie kein Haustier nur, weil es beliebt ist.

Installationsablauf

Wenn der Benutzer eine Petdex-Detail-URL, einen kopierten Befehl wie npx petdex install boba oder einen einfachen Haustier-Slug/Namen angibt:

1. Lesen Sie references/petdex-package.md und references/security.md.

2. Die Aktivierung von Desktop-Haustieren benötigt die Erlaubnis, eine lokale Hintergrund-App zu starten. Wenn die aktuelle WorkBuddy-Aufgabe nicht bereits unter 允许完全访问 (Vollzugriff erlauben) ist, stoppen Sie vor dem Herunterladen und geben Sie diese Anfängeranleitung originalgetreu wieder:

   安装桌面宠物前，需要给本次任务一次“允许完全访问”：

   1. 点击输入框下方的“默认权限”。
   2. 点击“允许完全访问”。
   3. 勾选“我已了解风险，并愿意继续”，再确认“允许完全访问”。
   4. 完成后回复“继续安装”。 这个权限用于把宠物保存到你的个人目录并启动本地宠物，不会修改 WorkBuddy.app。

   Behaupten Sie nicht, dass ein Neustart diese Berechtigung ersetzen kann. Versuchen Sie nicht, die Berechtigung selbst zu ändern.

3. Übergeben Sie die vollständige Nachricht des Benutzers an den lokalen Resolver. Dieser akzeptiert eine exakte HTTPS-petdex.dev-Detail-URL, die in einem Satz eingebettet ist, den kopierten Petdex-Installationsbefehl als inerten Text oder einen sicheren Slug. Er lehnt ähnlich aussehende Domains ab und führt den kopierten Befehl niemals aus.

4. Führen Sie aus:

   ./scripts/install-pet.sh "<die exakte Benutzereingabe>"
   

   Verwenden Sie diesen genauen Befehl ohne --no-start in einem normalen Benutzerablauf. Stoppen Sie nicht nach dem Herunterladen und beschreiben Sie das Haustier nicht als „待激活“ (zu aktivieren), wenn der Befehl keinen Neustart angefordert hat. Der Installer versucht bereits eine sichere Aktivierung ohne Neustart.

5. Wenn der Befehl meldet, dass das Haustier erschienen und verbunden ist, führen Sie sofort ./scripts/doctor.sh aus. Wenn der Doctor bestanden ist, melden Sie Erfolg und fragen Sie nie nach einem Neustart.

6. Wenn der Befehl 宠物宿主没有成功启动 (Haustier-Host nicht erfolgreich gestartet) sagt oder der Doctor meldet, dass die Brücke/das Haustier nicht läuft, fehlt der Aufgabe der effektive Vollzugriff. Zeigen Sie die vier Berechtigungsschritte oben und bitten Sie den Benutzer, mit 继续激活宠物 (Haustier weiter aktivieren) zu antworten; führen Sie danach ./scripts/start-runtime.sh und ./scripts/doctor.sh aus. Diagnostizieren Sie dies niemals als Neustartproblem. Wenn der lokale Fehler stattdessen besagt, dass ein anderes WorkBuddy-Desktop-Haustier läuft, nennen Sie den Konflikt, falls er sichtbar ist, bitten Sie den Benutzer um Erlaubnis, das alte Haustier zu pausieren, und fahren Sie nur nach Zustimmung fort. Töten Sie niemals stillschweigend ein nicht verwandtes Haustier.

7. Nur wenn der exakte Installerbefehl explizit sagt, dass das laufende WorkBuddy nicht über die verifizierte lokale Statusverbindung verfügt und scripts/start-runtime.sh --restart anfordert, stellen Sie genau eine Frage: 为了让宠物读取 WorkBuddy 的任务状态，需要重启一次 WorkBuddy。现在可以重启吗？ (Damit das Haustier den WorkBuddy-Aufgabenstatus lesen kann, muss WorkBuddy einmal neu gestartet werden. Kann es jetzt neu gestartet werden?) Nehmen Sie niemals an, dass ein Neustart erforderlich ist, nur weil dies das erste installierte Haustier ist.

8. Stoppen Sie bei jedem anderen Download- oder Netzwerkfehler und zitieren Sie den kurzen lokalen Fehler. Verwenden Sie kein WebFetch, DNS-over-HTTPS, eine hartcodierte IP, --resolve, --connect-to, deaktivierte Zertifikatsprüfungen, einen Proxy-Bypass außer dem gebündelten Skript oder manuelle Installationsschritte. Bitten Sie den Benutzer, sein Netzwerk zu überprüfen und es erneut zu versuchen.

9. Nur nach ausdrücklicher Zustimmung des Benutzers führen Sie aus:

   ./scripts/start-runtime.sh --restart
   

10. Führen Sie ./scripts/doctor.sh aus und melden Sie den Namen des installierten Haustiers, den Petdex-Quelllink und die erfolgreiche Statusverbindung. Ein bestandener Doctor beweist auch, dass beide Prozesse dem macOS launchd gehören, sich nach einem unerwarteten Absturz bei geöffnetem WorkBuddy erholen und nicht von Codex oder der aktuellen WorkBuddy-Aufgabe abhängen. Sie werden nicht beim Login gestartet; wenn WorkBuddy geschlossen wird, darf das Haustier anhalten. Wenn der Doctor 状态桥正在后台等待 WorkBuddy 状态端口 (Statusbrücke wartet im Hintergrund auf den WorkBuddy-Statusport) oder scripts/start-runtime.sh --restart meldet, melden Sie, dass das Haustier bereits stabil ist, der aktuelle Aufgabentext jedoch erst aktualisiert werden kann, wenn WorkBuddy mit seinem lokalen Statusport wieder geöffnet wird. Stellen Sie genau eine Frage: 宠物已经稳定运行。为了让它显示当前对话和任务状态，需要重启一次 WorkBuddy。现在可以重启吗？ (Das Haustier läuft bereits stabil. Damit es den aktuellen Dialog und Aufgabenstatus anzeigen kann, muss WorkBuddy einmal neu gestartet werden. Kann es jetzt neu gestartet werden?) Wenn der Benutzer zustimmt, führen Sie ./scripts/start-runtime.sh --restart und dann ./scripts/doctor.sh aus.

11. Erklären Sie die Steuerung:

    • Ziehen Sie das Haustier an eine beliebige Stelle, auch außerhalb von WorkBuddy.
    • Klicken Sie darauf, um es winken zu lassen und das Aufgabenpanel ein-/auszublenden.
    • Rechtsklick für Zurücksetzen, Springen, Aufgabenpanel oder Beenden.
    • Es reagiert automatisch auf laufende, wartende, zu überprüfende, fehlgeschlagene und abgeschlossene Aufgaben.

Führen Sie niemals die von Petdex zurückgegebene Remote-Shell aus. Der gebündelte Installer extrahiert nur zugelassene Asset-URLs von https://assets.petdex.dev/, validiert das Paket und installiert es in die WorkBuddy-spezifische lokale Bibliothek.

Aktuelles Gespräch und Mehrfachaufgabenverhalten

Die native Aufgabenblase kann anzeigen:

• die letzte sichtbare Benutzeranweisung, auf 60 Zeichen gekürzt;
• die aktuelle Assistenzleitung/den Status, auf 96 Zeichen gekürzt;
• bis zu fünf WorkBuddy-Aufgabentitel und -zustände;
• eine achtsekündige Abschlussmeldung.

Sammeln Sie niemals eine vollständige Assistentenantwort, ältere Gesprächsrunden, Anhänge, Dateinamen, Kontodaten oder Artefaktinhalte. Lesen Sie references/workbuddy-state-bridge.md, wenn Sie Aufgabentexte oder Animationen diagnostizieren.

Installierte Haustiere verwalten

• Lokale Haustiere auflisten: ./scripts/list-pets.sh
• Wechseln ohne Herunterladen: ./scripts/switch-pet.sh "<slug>"
• Haustier und Brücke pausieren: ./scripts/stop-pet.sh
• Ausgewähltes Haustier reaktivieren: ./scripts/start-runtime.sh
• Diagnose: ./scripts/doctor.sh
• Ein nicht aktives Haustier entfernen: ./scripts/remove-pet.sh "<slug>"
• Laufzeit deinstallieren, aber Downloads behalten: ./scripts/uninstall-runtime.sh
• Laufzeit und alle Downloads nur nach expliziter Bestätigung deinstallieren: ./scripts/uninstall-runtime.sh --remove-pets

Löschen Sie keine Haustiere oder die Laufzeit aufgrund vager Anfragen wie „换一只“ (Wechseln) oder „先不要这个“ (erstmal nicht). Interpretieren Sie diese als Wechseln/Pausieren, nicht als zerstörendes Löschen.

Grenzen

• Unterstützt nur die offizielle macOS-WorkBuddy-App.
• Ändern, entpacken, ersetzen, neu signieren oder schreiben Sie niemals in WorkBuddy.app oder app.asar.
• Installieren Sie niemals Codex, schreiben Sie keine Codex-Hooks, öffnen Sie keine Codex-Einstellungen und erfordern Sie kein ~/.codex/pets.
• Fügen Sie niemals Theme-CSS, Hintergrundbilder, Designfarben oder Seitenstile hinzu. Leiten Sie solche Anfragen an das separate Design-Skill weiter.
• Behalten Sie die Petdex-Erstellerzuordnung und Quell-URLs in den lokalen Metadaten bei.
• Petdex-Haustiere sind Community-Einreichungen und können Fan-Werke sein. Weisen Sie Benutzer an, vor öffentlicher oder kommerzieller Nutzung die Rechte zu prüfen.
• Starten Sie WorkBuddy nicht ohne explizite Erlaubnis neu.