Ejecuta y configura la shell

Guía paso a paso para principiantes

Requisitos previos: lea las dos guías para principiantes que aparecen a continuación y finalice la configuración local del escritorio, incluidos Rust y los requisitos previos del sistema operativo. El bloque de código inicia tanto la aplicación web como Tauri en el monorepo; en un pago solo de escritorio, use su comando filtrado solo después de iniciar un backend web accesible por separado. Tauri carga ese backend.

Términos breves: un espacio de trabajo son los usuarios, datos y configuraciones separados de un equipo. El servidor es el backend confiable; Mantenga las claves del proveedor fuera del código del navegador y del teléfono. Una migración es un cambio de base de datos versionada que crea o actualiza tablas. Un modelo de IA es el motor que responde; el catálogo de modelos es la lista del servidor de ID de modelos disponibles y precios. Un proveedor es un servicio externo, como inteligencia artificial, correo electrónico o servicio de facturación. Un derecho es una concesión que permite que un espacio de trabajo utilice una función. Un webhook es un mensaje que un servicio envía al URL de otro servicio.

1. Abra apps/desktop/src-tauri/src/lib.rs; Pídale a su agente que cambie solo el comportamiento de la ventana/bandeja/tecla de acceso rápido con nombre y mantenga la interfaz de usuario del producto en la aplicación web.

2. Ejecute el shell y pruebe cerca de la bandeja, Salir y CmdOrCtrl+Shift+Space; prueba supastack:///settings/appearance?preview=1#main.

3. Debería centrarse en la ventana existente y preservar la ruta/consulta/fragmento. Si abre la página incorrecta, compare el origen configurado y la ruta exacta.

Para obtener código personalizado, comience con el prompts/README.md proporcionado y copie el mensaje más cercano: prompts/new-app-screen.md para una pantalla de aplicación o prompts/new-landing-page.md para una página pública. Para trabajos de servidor, base de datos o proveedor, asigne a su agente de codificación la tarea de esta guía y pídale que lea AGENTS.md, .ai/PROJECT_CONTEXT.md y los espejos .ai/ correspondientes; inspeccionar los archivos fuente exactos nombrados aquí; enumerar archivos y verificaciones antes de editarlos; preservar la propiedad del espacio de trabajo y los secretos exclusivos del servidor; y mostrarte la diferencia. Dígale el comportamiento que desea, los campos de entrada y salida, los roles permitidos, los éxitos y errores esperados y la cuenta, proveedor o dispositivo de prueba. Utilice valores de muestra; Nunca pegues un verdadero secreto.

• Antes de comenzar
• Conceptos básicos de terminales
• Configuración local de escritorio
• Mensajes del agente y memoria del proyecto

# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop

# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop dev

Mantén el comportamiento del shell en Rust

src-tauri/src/lib.rs crea la ventana webview principal de 1200×800. Al cerrar, se oculta en la bandeja; Salir termina la aplicación. Los menús nativos ofrecen Inicio/Atrás/Adelante/Recargar, zoom/pantalla completa y acciones de ventana. La restauración del estado conserva tamaño/posición.

Gestiona los enlaces y la invocación

El shell acepta rutas supastack:// y las resuelve con el origen HTTP(S) exacto configurado para la aplicación. Por ejemplo, supastack:///settings/appearance?preview=1#main se convierte en /workspace/settings?tab=billing#plans; supastack:///auth/callback?code=... se asigna a /auth/callback?code=.... Se conservan las consultas y los fragmentos.

Los enlaces de inicio se aplican antes de mostrar la primera ventana. Los enlaces recibidos durante la ejecución en macOS usan on_open_url de Tauri; los argumentos de una segunda instancia en Windows y Linux pasan por el callback de instancia única con la función deep-link habilitada. Los enlaces válidos enfocan y navegan la ventana existente.

Solo permanecen dentro del shell los enlaces HTTP(S) sin credenciales cuyo esquema, host y puerto efectivo coincidan exactamente con la configuración. Los enlaces HTTP(S) sin credenciales, mailto: y tel: pueden abrirse externamente; se rechazan los enlaces mal formados, las credenciales, los esquemas no admitidos, los puertos en enlaces personalizados y los intentos de atravesar rutas. La URL de backend configurada también rechaza credenciales y utiliza el siguiente origen válido o predeterminado.

SUPASTACK_APP_URL=https://your-app.example
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space

supastack:///settings/appearance?preview=1#main
# Opens https://your-app.example/workspace/settings?tab=billing#plans

Verifica el comportamiento específico de cada plataforma

La superposición sin conexión inyectada ofrece Reintentar, se oculta al volver a estar en línea y recarga la aplicación web. Prueba el foco, los atajos, el zoom de menú, la bandeja y la invocación de enlaces profundos en cada sistema operativo de destino; las comprobaciones unitarias de URL por sí solas no demuestran esas interacciones nativas.

• Aceptación de escritorio

Configuración y ajustes

Instale las dependencias del espacio de trabajo y la cadena de herramientas Rust más los requisitos previos por sistema operativo de Tauri (WebView2 se envía con Windows; macOS y Linux necesitan sus paquetes documentados). corepack pnpm --filter @supastack/desktop dev ejecuta tauri dev: construye el núcleo de Rust, muestra la interfaz de usuario del marcador de posición y carga la aplicación resuelta URL.

SUPASTACK_APP_URL se lee primero en tiempo de ejecución y, si no existe, usa el valor incluido durante la compilación. Solo se aceptan URL HTTP(S) sin credenciales; si no, se prueba el siguiente valor. SUPASTACK_DESKTOP_HOTKEY sustituye el atajo predeterminado CmdOrCtrl+Shift+Space. Un valor no válido vuelve al atajo predeterminado y no impide el inicio.

corepack pnpm --filter @supastack/desktop dev
corepack pnpm --filter @supastack/desktop typecheck

SUPASTACK_APP_URL=https://app.example.com \
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space \
corepack pnpm --filter @supastack/desktop dev

Flujo de implementación

La ventana principal solo navega por el origen configurado exacto, incluido el protocolo y el puerto. Los enlaces HTTP(S) sin credenciales, mailto y tel pueden abrirse en el navegador del sistema; los protocolos no aprobados se cancelan.

Los enlaces supastack:// registrados trasladan su ruta, consulta y fragmento al origen configurado de la app. El inicio, los eventos del sistema al abrir una URL y las llamadas de una segunda instancia aplican la misma validación, de modo que un enlace profundo no puede redirigir la shell a otro host.

El icono de la bandeja y el atajo global muestran y enfocan la única ventana principal. Si el atajo no se registra, otra aplicación suele estar usando la combinación; elige otro SUPASTACK_DESKTOP_HOTKEY.

Verificación y solución de problemas

Después de cambiar src-tauri, ejecuta cargo check y cargo test mediante los scripts del paquete. A continuación, verifica la navegación al origen exacto, la apertura de enlaces externos permitidos, una ruta supastack:// en el origen configurado de la app, la bandeja y el atajo, y la persistencia del inicio de sesión tras reiniciar.