JayT-workbuddy-petdex

¿Qué hace JayT-workbuddy-petdex?

Proporciona a los principiantes una experiencia completa de mascota en WorkBuddy usando mascotas de la comunidad de Petdex. No involucra Codex, modifica el paquete de la aplicación WorkBuddy ni cambia la apariencia de WorkBuddy.

Regla de prioridad para principiantes

Asume que el usuario nunca ha usado un terminal, Petdex, una habilidad o un spritesheet. Usa oraciones cortas en chino, explica una decisión a la vez y ejecuta los scripts incluidos por ellos. Nunca les pidas que escriban un comando de shell.

Cuando el usuario no haya proporcionado un enlace de mascota, un comando copiado de Petdex o un nombre, reproduce fielmente la siguiente guía en chino. Mantén el enlace cliqueable y no lo parafrasees en una respuesta más larga:

选宠物只要四步：

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

Inmediatamente después de la guía, di exactamente: 浏览和安装 Petdex 官方收录的宠物不需要注册账号，也不需要手动下载文件。 No agregues una segunda explicación a menos que el usuario lo pida.

Si el usuario pide recomendaciones, pregunta como máximo una preferencia como “可爱 / 搞怪 / 安静 / 酷” y luego dirígelo a la galería. Deja la elección al usuario; no instales una mascota solo porque sea popular.

Flujo de instalación

Cuando el usuario proporcione una URL de detalle de Petdex, un comando copiado como npx petdex install boba, o un slug/nombre de mascota simple:

1. Lee references/petdex-package.md y references/security.md.

2. La activación de la mascota de escritorio necesita permiso para iniciar una aplicación local en segundo plano. Si la tarea actual de WorkBuddy no está ya en 允许完全访问, detente antes de descargar y reproduce fielmente esta guía para principiantes:

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

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

   No afirmes que un reinicio puede reemplazar este permiso. No intentes cambiar el permiso por ti mismo.

3. Pasa el mensaje completo del usuario al resolvedor local. Acepta una URL de detalle HTTPS exacta de petdex.dev incrustada en una oración, el comando de instalación de Petdex copiado como texto inerte, o un slug seguro. Rechaza dominios similares y nunca ejecuta el comando copiado.

4. Ejecuta:

   ./scripts/install-pet.sh "<la entrada exacta del usuario>"
   

   Usa este comando exacto sin --no-start en un flujo de usuario normal. No te detengas después de la descarga ni describas la mascota como “待激活” cuando el comando no haya solicitado un reinicio. El instalador ya intenta una activación segura sin reinicio.

5. Si el comando informa que la mascota apareció y se conectó, ejecuta inmediatamente ./scripts/doctor.sh. Cuando el doctor pase, informa éxito y nunca pidas un reinicio.

6. Si el comando dice 宠物宿主没有成功启动 o el doctor dice que el puente/mascota no se está ejecutando, la tarea carece de Acceso Total efectivo. Muestra los cuatro pasos de permisos anteriores y pide al usuario que responda 继续激活宠物; después de eso, ejecuta ./scripts/start-runtime.sh y ./scripts/doctor.sh. Nunca diagnostiques esto como un problema de reinicio. Si el error local en cambio dice que otra mascota de escritorio de WorkBuddy se está ejecutando, nombra el conflicto si es visible, pide permiso al usuario para pausar la mascota anterior y solo continúa después del consentimiento. Nunca mates una mascota no relacionada en silencio.

7. Solo cuando el comando del instalador indique explícitamente que la instancia en ejecución de WorkBuddy carece de la conexión de estado local verificada y solicite scripts/start-runtime.sh --restart, haz exactamente una pregunta: 为了让宠物读取 WorkBuddy 的任务状态，需要重启一次 WorkBuddy。现在可以重启吗？ Nunca deduzcas que se necesita un reinicio solo porque esta es la primera mascota instalada.

8. Para cualquier otro fallo de descarga o red, detente y cita el breve error local. No uses WebFetch, DNS-over-HTTPS, una IP hardcodeada, --resolve, --connect-to, comprobaciones de certificado deshabilitadas, un bypass de proxy distinto al script incluido, o pasos de instalación manual. Pide al usuario que verifique su red y lo intente de nuevo.

9. Solo después de que el usuario acepte explícitamente, ejecuta:

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

10. Ejecuta ./scripts/doctor.sh e informa el nombre de la mascota instalada, el enlace de origen de Petdex y la conexión de estado exitosa. Un doctor que pasa también prueba que ambos procesos son propiedad de macOS launchd, se recuperan después de un bloqueo inesperado mientras WorkBuddy está abierto, y no dependen de Codex ni de la tarea actual de WorkBuddy. No se inician con el inicio de sesión; si WorkBuddy se cierra, se permite que la mascota se detenga. Si el doctor dice 状态桥正在后台等待 WorkBuddy 状态端口 o scripts/start-runtime.sh --restart, informa que la mascota ya es estable pero el texto de la tarea actual no puede actualizarse hasta que se reabra WorkBuddy con su puerto de estado local. Haz exactamente una pregunta: 宠物已经稳定运行。为了让它显示当前对话和任务状态，需要重启一次 WorkBuddy。现在可以重启吗？ Si el usuario acepta, ejecuta ./scripts/start-runtime.sh --restart y luego ./scripts/doctor.sh.

11. Explica los controles:

• Arrastra la mascota a cualquier lugar, incluso fuera de WorkBuddy.
• Haz clic en ella para saludar y mostrar/ocultar el panel de tareas.
• Haz clic derecho para restablecer, saltar, panel de tareas o salir.
• Reacciona automáticamente a tareas en ejecución, espera, revisión, fallidas y completadas.

Nunca ejecutes el shell remoto devuelto por Petdex. El instalador incluido solo extrae URLs de activos permitidos de https://assets.petdex.dev/, valida el paquete y lo instala en la librería local específica de WorkBuddy.

Comportamiento de conversación actual y tareas múltiples

La burbuja de tarea nativa puede mostrar:

• la última instrucción visible del usuario, truncada a 60 caracteres;
• el estado/liderazgo actual del asistente, truncado a 96 caracteres;
• hasta cinco títulos y estados de tareas de WorkBuddy;
• un aviso de finalización de ocho segundos.

Nunca recopiles una respuesta completa del asistente, turnos anteriores, archivos adjuntos, nombres de archivo, datos de cuenta o contenidos de artefactos. Lee references/workbuddy-state-bridge.md al diagnosticar texto de tarea o animaciones.

Gestionar mascotas instaladas

• Listar mascotas locales: ./scripts/list-pets.sh
• Cambiar sin descargar: ./scripts/switch-pet.sh "<slug>"
• Pausar mascota y puente: ./scripts/stop-pet.sh
• Reactivar la mascota seleccionada: ./scripts/start-runtime.sh
• Diagnosticar: ./scripts/doctor.sh
• Eliminar una mascota no activa: ./scripts/remove-pet.sh "<slug>"
• Desinstalar el runtime pero mantener las descargas: ./scripts/uninstall-runtime.sh
• Desinstalar runtime y todas las descargas solo después de confirmación explícita: ./scripts/uninstall-runtime.sh --remove-pets

No elimines mascotas ni el runtime a partir de solicitudes vagas como “换一只” o “先不要这个”. Interprétalas como cambio/pausa, no como eliminación destructiva.

Límites

• Soporta solo la aplicación oficial de WorkBuddy para macOS.
• Nunca modifiques, desempaques, reemplaces, vuelvas a firmar ni escribas dentro de WorkBuddy.app o app.asar.
• Nunca instales Codex, escribas hooks de Codex, abras la Configuración de Codex ni requieras ~/.codex/pets.
• Nunca agregues CSS de tema, imágenes de fondo, colores de piel ni estilos de página. Redirige esas solicitudes a la habilidad de skin separada.
• Mantén la atribución del creador de Petdex y las URL de origen en los metadatos locales.
• Las mascotas de Petdex son envíos de la comunidad y pueden ser trabajos de fans. Indica a los usuarios que verifiquen los derechos antes del uso público o comercial.
• No reinicies WorkBuddy sin permiso explícito.