JayT-workbuddy-petdex

Que fait JayT-workbuddy-petdex ?

Offre aux débutants une expérience complète d'animal de compagnie dans WorkBuddy en utilisant les animaux de la communauté de Petdex. N'implique pas Codex, ne modifie pas le bundle de l'application WorkBuddy, ni ne change le skin de WorkBuddy.

Règle prioritaire pour les débutants

Partez du principe que l'utilisateur n'a jamais utilisé un terminal, Petdex, un Skill ou une feuille de sprites. Utilisez des phrases courtes en chinois, expliquez une décision à la fois et exécutez les scripts packagés pour lui. Ne lui demandez jamais de taper une commande shell.

Lorsque l'utilisateur n'a pas fourni de lien vers un animal, copié de commande Petdex ou de nom, reproduisez fidèlement le guide chinois suivant. Gardez le lien cliquable et ne le paraphrasez pas en une réponse plus longue :

Choisir un animal en quatre étapes :

1. Ouvrez Petdex 中文宠物站.
2. Cliquez sur un animal qui vous plaît. Vous pouvez naviguer directement ou utiliser la barre de recherche ou les étiquettes pour filtrer.
3. Copiez le lien de détail dans la barre d'adresse du navigateur, par exemple https://petdex.dev/pets/boba. Si vous avez cliqué sur "Copier la commande d'installation" sur la page, ce n'est pas grave non plus.
4. Revenez ici, collez-le et dites "Aide-moi à installer cet animal". Je me charge du reste, pas besoin d'ouvrir un terminal.

Immédiatement après le guide, dites exactement : 浏览和安装 Petdex 官方收录的宠物不需要注册账号，也不需要手动下载文件. N'ajoutez pas de seconde explication sauf si l'utilisateur le demande.

Si l'utilisateur demande des recommandations, demandez au plus une préférence telle que "mignon / bizarre / calme / cool", puis orientez-le vers la galerie. Laissez le choix à l'utilisateur ; n'installez pas un animal simplement parce qu'il est populaire.

Processus d'installation

Lorsque l'utilisateur fournit une URL de détail Petdex, une commande copiée comme npx petdex install boba, ou un simple slug/nom d'animal :

1. Lisez references/petdex-package.md et references/security.md.

2. L'activation de l'animal de bureau nécessite une permission pour démarrer une application d'arrière-plan locale. Si la tâche WorkBuddy actuelle n'est pas déjà en 允许完全访问, arrêtez-vous avant le téléchargement et reproduisez fidèlement ce guide pour débutants :

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

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

   Ne prétendez pas qu'un redémarrage peut remplacer cette permission. N'essayez pas de modifier vous-même la permission de l'utilisateur.

3. Transmettez le message complet de l'utilisateur au résolveur local. Celui-ci accepte une URL de détail HTTPS exacte petdex.dev intégrée dans une phrase, la commande d'installation Petdex copiée en tant que texte inerte, ou un slug sûr. Il rejette les domaines similaires et n'exécute jamais la commande copiée.

4. Exécutez :

   ./scripts/install-pet.sh "<l'entrée exacte de l'utilisateur>"
   

   Utilisez cette commande exacte sans --no-start dans un flux utilisateur normal. Ne vous arrêtez pas après le téléchargement et ne décrivez pas l'animal comme "en attente d'activation" lorsque la commande n'a pas demandé de redémarrage. L'installateur tente déjà une activation sécurisée sans redémarrage.

5. Si la commande signale que l'animal est apparu et connecté, exécutez immédiatement ./scripts/doctor.sh. Si le diagnostic passe, signalez le succès et ne demandez jamais de redémarrage.

6. Si la commande dit 宠物宿主没有成功启动 ou si le diagnostic indique que le pont/l'animal ne tourne pas, la tâche manque d'accès complet effectif. Affichez les quatre étapes de permission ci-dessus et demandez à l'utilisateur de répondre 继续激活宠物 ; après cela, exécutez ./scripts/start-runtime.sh et ./scripts/doctor.sh. Ne diagnostiquez jamais cela comme un problème de redémarrage. Si l'erreur locale indique plutôt qu'un autre animal de bureau WorkBuddy est en cours d'exécution, nommez le conflit s'il est visible, demandez à l'utilisateur l'autorisation de mettre en pause l'ancien animal, et ne continuez qu'après consentement. Ne tuez jamais un animal non lié silencieusement.

7. Uniquement lorsque la commande d'installation indique explicitement que le WorkBuddy en cours d'exécution manque de la connexion d'état local vérifiée et demande scripts/start-runtime.sh --restart, posez exactement une question : 为了让宠物读取 WorkBuddy 的任务状态，需要重启一次 WorkBuddy。现在可以重启吗？ Ne déduisez jamais qu'un redémarrage est nécessaire simplement parce que c'est le premier animal installé.

8. Pour toute autre panne de téléchargement ou réseau, arrêtez-vous et citez l'erreur locale courte. N'utilisez pas WebFetch, DNS-over-HTTPS, une IP codée en dur, --resolve, --connect-to, des vérifications de certificat désactivées, un contournement de proxy autre que le script packagé, ou des étapes d'installation manuelles. Demandez à l'utilisateur de vérifier son réseau et de réessayer.

9. Uniquement après l'accord explicite de l'utilisateur, exécutez :

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

10. Exécutez ./scripts/doctor.sh et rapportez le nom de l'animal installé, le lien source Petdex, et la connexion d'état réussie. Un diagnostic réussi prouve également que les deux processus sont possédés par macOS launchd, qu'ils se rétablissent après un crash inattendu lorsque WorkBuddy est ouvert, et qu'ils ne dépendent pas de Codex ni de la tâche WorkBuddy actuelle. Ils ne sont pas démarrés à la connexion ; si WorkBuddy est fermé, l'animal est autorisé à s'arrêter. Si le diagnostic dit 状态桥正在后台等待 WorkBuddy 状态端口 ou scripts/start-runtime.sh --restart, signalez que l'animal est déjà stable mais que le texte de la tâche actuelle ne peut pas être mis à jour tant que WorkBuddy n'est pas rouvert avec son port d'état local. Posez exactement une question : 宠物已经稳定运行。为了让它显示当前对话和任务状态，需要重启一次 WorkBuddy。现在可以重启吗？ Si l'utilisateur est d'accord, exécutez ./scripts/start-runtime.sh --restart puis ./scripts/doctor.sh.

11. Expliquez les contrôles :

    • Faites glisser l'animal n'importe où, y compris en dehors de WorkBuddy.
    • Cliquez dessus pour qu'il salue et afficher/masquer le panneau des tâches.
    • Clic droit pour réinitialiser, sauter, panneau des tâches ou quitter.
    • Il réagit automatiquement aux tâches en cours, en attente, en révision, échouées et terminées.

N'exécutez jamais le shell distant renvoyé par Petdex. L'installateur packagé n'extrait que les URLs d'actifs autorisées de https://assets.petdex.dev/, valide le paquet, et l'installe dans la bibliothèque locale spécifique à WorkBuddy.

Comportement lié à la conversation en cours et aux tâches multiples

La bulle de tâche native peut afficher :

• la dernière instruction utilisateur visible, tronquée à 60 caractères ;
• le statut/direction actuel de l'assistant, tronqué à 96 caractères ;
• jusqu'à cinq titres et états de tâches WorkBuddy ;
• un avis de fin de huit secondes.

Ne collectez jamais une réponse complète de l'assistant, des tours plus anciens, des pièces jointes, des noms de fichiers, des données de compte ou des contenus d'artefacts. Lisez references/workbuddy-state-bridge.md lors du diagnostic du texte des tâches ou des animations.

Gestion des animaux installés

• Lister les animaux locaux : ./scripts/list-pets.sh
• Changer sans télécharger : ./scripts/switch-pet.sh "<slug>"
• Mettre en pause l'animal et le pont : ./scripts/stop-pet.sh
• Réveiller l'animal sélectionné : ./scripts/start-runtime.sh
• Diagnostiquer : ./scripts/doctor.sh
• Supprimer un animal non actif : ./scripts/remove-pet.sh "<slug>"
• Désinstaller l'environnement d'exécution mais garder les téléchargements : ./scripts/uninstall-runtime.sh
• Désinstaller l'environnement d'exécution et tous les téléchargements uniquement après confirmation explicite : ./scripts/uninstall-runtime.sh --remove-pets

Ne supprimez pas les animaux ou l'environnement d'exécution suite à des demandes vagues comme "change" ou "pas celui-ci". Interprétez-les comme un changement/mise en pause, pas une suppression destructrice.

Limites

• Prend en charge uniquement l'application WorkBuddy macOS officielle.
• Ne modifiez, décompressez, remplacez, resignez ou écrivez jamais dans WorkBuddy.app ou app.asar.
• N'installez jamais Codex, n'écrivez pas de hooks Codex, n'ouvrez pas les paramètres Codex, et n'exigez pas ~/.codex/pets.
• N'ajoutez jamais de CSS de thème, d'images d'arrière-plan, de couleurs de peau ou de styles de page. Redirigez ces demandes vers le Skill de skin séparé.
• Conservez l'attribution du créateur Petdex et les URL source dans les métadonnées locales.
• Les animaux Petdex sont des soumissions de la communauté et peuvent être des œuvres de fans. Dites aux utilisateurs de vérifier les droits avant une utilisation publique ou commerciale.
• Ne redémarrez pas WorkBuddy sans autorisation explicite.