Communitygithub.com

Agent-Draco/WhyskAI-CustomInstaller-Maker

Este repositorio muestra una SKILL para modelos de agente como Claude Code, Antigravity, Cursor, Kiro y otros, capaz de convertir una aplicación React simple en una aplicación nativa de Windows con su propio instalador moderno y personalizado.

¿Qué es WhyskAI-CustomInstaller-Maker?

Esta skill permite transformar automáticamente una aplicación React/Vite en un instalador `.exe` nativo de Windows, altamente personalizado y con una interfaz de 5 pasos tipo asistente cinematográfico. Está diseñada para agentes de IA como Claude Code, Cursor o Kiro, y se encarga de todo el ciclo: desde empaquetar la aplicación con Electron y ocultar el marco nativo de la ventana, hasta generar accesos directos, registrar la aplicación en el panel de desinstalación de Windows y gestionar fallbacks de iconos mediante IA. Su arquitectura modular separa la capa de fondo (Node.js con IPC seguro) de la capa frontal (React con Tailwind CSS), garantizando seguridad con `contextIsolation` y `nodeIntegration: false`. Es ideal para desarrolladores que buscan una solución llave en mano para distribuir aplicaciones web como software de escritorio profesional en Windows.

Compatible con✓Claude Code~Codex CLI✓Cursor✓Antigravity
npx skills add Agent-Draco/WhyskAI-CustomInstaller-Maker

Preguntar en tu IA favorita

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

Documentación

🎯 Objetivo

Transformar una compilación de producción estándar de React/Vite en un instalador .exe nativo de Windows, independiente y altamente personalizado. El wrapper omite el marco de ventana estándar del SO para presentar una interfaz determinista y cinematográfica de instalador en 5 pasos.

🛠️ Módulos de Ingeniería Principal

1. Intercepción del Ciclo de Vida y Estilo de Ventana (electron.js)

Inicializar una huella de ventana fija y codificada ($760 \times 480\text{px}$) con las siguientes propiedades nativas estrictas:

  • frame: false (Deshabilitar todos los bordes/marcos de ventana nativos del SO)
  • resizable: false (Bloquear dimensiones)
  • transparent: true (Habilitar fondo transparente para estilos web personalizados)

Exponer una arquitectura IPC (Comunicación entre Procesos) asíncrona, aislada y segura a través de preload.js. Esto pasa datos limpiamente entre el runtime de fondo y la capa de renderizado React sin provocar fallos de seguridad por acceso al sandbox.

2. Despliegue de Activos del Sistema (Capa de Fondo Node.js)

  • Mapeo de Directorios: Analizar dinámicamente rutas de cadena del espacio de trabajo para construir carpetas destino de manera segura usando fs-extra.
  • Inyección de Accesos Directos: Activar un proceso hijo en segundo plano que ejecuta comandos de PowerShell de Windows para construir accesos directos .lnk directamente en el entorno del Escritorio del usuario.
  • Población del Registro de Lista de Aplicaciones del SO: Inyectar directamente la telemetría requerida de la aplicación de software en la ruta del índice del registro de la máquina local: HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\[NombreApp] Asegurar la población correcta de DisplayName, DisplayIcon, directorios de instalación y cadenas de desinstalación operativas para vincular limpiamente la aplicación a la utilidad Agregar o quitar programas de Windows.

🎨 Arquitectura Frontend y Máquina de Estados (React)

La interfaz del instalador ejecuta una máquina de estados React determinista de 5 pasos, estilizada con primitivas azul pizarra profundas y minimalistas (#0a0f1d, #111827) utilizando Tailwind CSS:

  1. Fase de Bienvenida: Cabecera tipográfica mínima que muestra la versión del software y banderas de configuración.
  2. Explorador de Directorios de Tema Personalizado: Un diálogo modal de selección de carpetas personalizado que se ejecuta directamente dentro del contexto DOM de la aplicación web (evitando el explorador de archivos nativo de Windows, que no coincide).
  3. Alternancia de Espacio de Trabajo: Componente de casilla de verificación con estado (activada por defecto) que gobierna la creación e implementación de archivos de acceso directo en el escritorio.
  4. Fase de Progreso Cinematográfico: Diseño sin bordes a sangre completa que renderiza micro-interacciones y animaciones CSS suaves sincronizadas con una animación de progreso lineal de exactamente 3.5 segundos, que coincide con la ejecución de copia del sistema de archivos.
  5. Opciones de Finalización: Pantalla de salida con bifurcación dual que ofrece un disparador de salida estándar o la ejecución inmediata del sistema mediante "Iniciar aplicación".

🖼️ Protocolo de Resolución del Logotipo de la Aplicación

El instalador requiere primitivas gráficas de alta fidelidad (icon.ico y un logo.png transparente). Resuelve los componentes visuales faltantes usando esta secuencia de respaldo:

  1. Protocolo A: Marca Suministrada por el Usuario (Nivel Alto): Si se proporciona un activo personalizado a través de la pantalla de configuración del asistente, captura el objeto del archivo, valida las dimensiones, transmítelo a las capas de la interfaz de usuario y compila la variante .ico directamente en los metadatos del encabezado del ejecutable final.
  2. Protocolo B: Respaldo Contextual Impulsado por IA (Nivel de Conocimiento Cero): Si no se proporciona marca, analiza los metadatos de la aplicación (nombre, descripción, sector industrial). Realiza una búsqueda vectorial o de repositorio para extraer un icono de código abierto limpio, geométrico y minimalista. Barrera de seguridad: Prohibir absolutamente diseños caóticos, decorativos o clip-art literales. Solo son válidas estructuras vectoriales abstractas y de alta gama.

⚠️ Restricciones y Barreras de Seguridad

  • Direccionamiento de Activos Relativo: Asegurar que todos los activos de salida dentro de las configuraciones de compilación utilicen rutas relativas (./static/...). Las referencias de resolución web absolutas romperán dentro del sistema de archivos empaquetado, causando un error de pantalla blanca en tiempo de ejecución.
  • Aislamiento de Seguridad: Mantener nodeIntegration: false y contextIsolation: true activos en todo momento. Todas las operaciones de la plataforma en segundo plano deben transitar de manera segura a través de la capa contextBridge.

📝 Ejemplos

Ejemplo: Inyección de Destinos de Manifiesto en package.json

"build": {
  "appId": "com.whyskai.custominstaller",
  "productName": "WhyskAI-CustomInstaller-Maker",
  "win": {
    "target": ["nsis"],
    "icon": "assets/icon.ico"
  },
  "nsis": {
    "oneClick": false,
    "allowToChangeInstallationDirectory": true,
    "installerIcon": "assets/icon.ico",
    "uninstallerIcon": "assets/icon.ico",
    "createDesktopShortcut": true,
    "runAfterFinish": true
  }
}

Skills relacionados