CommunityProgramación y desarrollogithub.com

JayHome137/Win-Codex-Fix

🧰 Una reparación rápida, única y basada en evidencia para Windows Codex Desktop tras una actualización.

¿Qué es Win-Codex-Fix?

Esta skill proporciona un script de reparación rápida y dirigida para Windows Codex Desktop después de una actualización. Está diseñada para ejecutarse una sola vez por actualización, usando un enfoque basado en evidencia donde un verificador rápido identifica el componente específico que falló. El script ofrece múltiples rutas de reparación conocidas, como la reparación del mirror CLI, del runtime cua_node/node_repl, del descubrimiento del navegador, de la caché del navegador, del host nativo del navegador (Chrome y Edge), del bootstrap de la AppX de Chrome, de la caché de Computer Use y problemas del marketplace temporal. Cada ruta se ejecuta de forma aislada; si una falla, se detiene sin encadenar otras rutas. La skill también maneja escenarios donde los archivos están bloqueados por procesos en ejecución, preguntando al usuario si desea cerrar Codex para continuar la reparación automáticamente después de que el proceso termine. Soporta Codex Desktop en Windows y está implementada en PowerShell, con scripts ubicados en el directorio `scripts` del repositorio. La skill se centra en la precisión y la mínima intervención, evitando reparaciones completas innecesarias o cierres de aplicaciones no esenciales.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add JayHome137/Win-Codex-Fix

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Codex Desktop Reparación Rápida

Desde el directorio scripts del proyecto de mantenimiento, ejecute Invoke-CodexDesktopQuickRepair.ps1 -Route Auto.

Ejecute Auto solo una vez por cada actualización: sincroniza el mirror CLI de la AppX actual, ejecuta un verificador rápido una vez; si falla, seleccione una ruta conocida según la salida y realice la verificación mínima correspondiente después de esa ruta. Si una ruta falla, se detiene, sin encadenar otras capas ni repetir la ejecución.

Rutas conocidas:

  • CliMirrorOnly**: Solo repara el mirror CLI. El código de salida 30 indica que el archivo de destino está en uso; espere a que termine naturalmente y vuelva a ejecutar la misma ruta.
  • RuntimeOnly**: Solo repara el runtime cua_node/node_repl.
  • BrowserDiscoveryOnly**: Solo repara el enlace de descubrimiento de Browser latest y .codex-plugin.
  • BrowserCacheOnly**: Solo restaura la caché del navegador de la AppX actual.
  • BrowserNativeHostOnly**: Utilizando los IDs de extensión múltiples de la AppX actual como fuente verdadera, solo repara el manifiesto heredado, la asignación de Chrome HKCU y dos copias del manifiesto v2; reparación rápida por defecto, sin cerrar Codex, Chrome o Edge. Guarda una copia de seguridad de la misma transacción antes de escribir, y restaura si algún paso falla.
  • EdgeNativeHostOnly**: Solo cuando el perfil actual de Edge tiene instalada la extensión de destino y la clave HKCU NativeMessagingHosts específica de Edge falta o está desviada, completa la asignación del registro de Edge por separado; no modifica las claves de Chrome, el manifiesto compartido, la caché, el runtime ni los procesos.
  • ChromeAppxBootstrapOnly**: Omite el nombre de marketplace openai-bundled ya reservado, materializa la caché de Chrome directamente desde la AppX actual, y llama a installManifest.mjs incluido en la AppX para reconstruir el sidecar, el manifiesto heredado, la asignación de HKCU, y luego actualiza el manifiesto v2; no toca la caché de Browser/Computer Use, no cierra Codex, Chrome ni Edge.
  • ComputerUseCacheOnly**: Omite el marketplace, sincroniza la caché del plugin Computer Use y el enlace de descubrimiento directamente desde la AppX actual; no modifica el runtime cua_node, la configuración ni otros plugins.
  • TmpRuntimeMarketplaceOnly**: Solo repara el problema de propiedad del marketplace temporal antiguo confirmado.
  • Verify**: Solo ejecuta el verificador rápido una vez.

No concatene manualmente varias rutas. Cuando Auto no puede identificar un propietario único a partir de la salida del verificador, devuelve manual-required, sin adivinar ni escalar a una reparación completa.

Reglas de cierre/reinicio

Por defecto, no cierra, mata, recarga ni reinicia ninguna aplicación. Solo cuando se devuelve pending-natural-exit (o código de salida 20/30) y se indica explícitamente que el archivo de destino está ocupado por un proceso, se pregunta una vez en la sesión actual si se autoriza a cerrar Codex para continuar la reparación automáticamente. Tras la autorización explícita, use la misma ruta con -ArmAfterExit; esto solo registra el ocupante actual y establece una ejecución única posterior, esperando el evento de salida de ese proceso específico para volver a ejecutar la misma ruta una vez y autolimpiarse. Si no se autoriza, no se crea ninguna tarea; el cierre normal de Codex no activa nada. Chrome/Edge no necesitan cerrarse por defecto.

Límites

Este paquete solo contiene el punto de entrada oficial actual, sus dependencias directas y el script de verificación rápida. No contiene rutas específicas de la máquina, IPs, cuentas, instantáneas de auditoría ni registros de ejecución; el directorio raíz del proyecto y el directorio de instalación de la Skill se derivan de los parámetros de instalación o del entorno de usuario de Windows.

Skills relacionados