Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

feat: completar la experiencia de integración WSL en Ajustes

Aperta
  • Qualcosa non va?
#93 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
react, typescript
Ambito
desktop, developer-experience

Direzione di ricerca

Start with src/Settings.tsx and src/lib/types.ts, then read the existing configuration save/dirty flow and CLI diagnostics; check the contracts in issues #90–#92 and coordinate copy with #66. The scope spans UI, backend integration, accessibility, documentation, and Windows/WSL validation. Done means meeting the listed acceptance criteria, including rendered Windows/WSL checks and evidence for all four milestone units.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

odd type:feature
Pre-flight checks
  • I searched existing issues and found no duplicate.
  • I understand that this proposal requires product review before implementation.

La búsqueda de duplicados abiertos y cerrados fue realizada por el asistente. El mantenedor confirmó el principio de revisión de producto y aprobó la propuesta quorb-wsl-v1 y su publicación. La publicación no inicia implementación ni asigna trabajo.

Problem to solve

Una integración WSL sin controles y estados coherentes deja al usuario interpretando rutas UNC, diagnósticos Windows y logins que pueden operar en otra distribución. La elección debe ser comprensible, persistente y recuperable desde la UI existente.

Proposed solution

Añadir en Ajustes, solo en Windows, «Integración WSL» con toggle, selector de distribución, usuario/home detectados y diagnóstico por proveedor. Mostrar entorno efectivo y excepciones avanzadas, integrar login/reintento y documentar el flujo completo.

Affected area

Application behavior

Scope and non-goals
Objetivo y alcance

Experiencia completa para activar, configurar, comprobar y desactivar WSL desde Ajustes sin escribir rutas UNC en el caso estándar. Reutilizar componentes/estilo de Quorb, estados de guardado y diagnóstico existentes. Documentación integrada con la unidad y comprobación end-to-end del milestone.

Dependencias y decisiones

La integración completa depende de issue-environment, issue-sessions y issue-login; diseño y pruebas con mocks pueden avanzar con el contrato acordado. Coordinar textos propios ES/EN y errores con #66: no crear otro sistema de traducción ni exigir terminar toda la internacionalización para investigar WSL. Preservar la prioridad de #66.

Criterios de aceptación
  • Sección visible solo en Windows; toggle y distribución seleccionada persisten.
  • Se muestran usuario/home y entorno efectivo; cada excepción de ruta avanzada indica explícitamente que tiene prioridad sobre el modo elegido.
  • Estados diferenciados: carga, WSL ausente, sin distribuciones, detenida, no disponible, timeout, CLI ausente, falta login, credenciales encontradas y error. Detectar archivo no se anuncia como sesión autenticada.
  • Acciones de comprobar, reintentar y login reflejan el entorno elegido; informar antes de despertar una distribución detenida.
  • Cambios del toggle/selector son borrador hasta Guardar; cerrarlos sin guardar no cambia el entorno operativo. Diagnóstico del borrador se identifica como tal.
  • Sin cambios no se activa Guardar; reversión, errores de guardado y ediciones durante una operación conservan el comportamiento actual y no pierden cambios.
  • Tras guardar el entorno, diagnósticos/datos de sesión se actualizan sin mostrar otra cuenta como actual; desactivar recupera Windows sin borrar credenciales ni ajustes manuales.
  • No se ofrece una instalación Windows para resolver una CLI WSL ni se muestra fallback silencioso a otra cuenta.
  • Navegación por teclado, labels accesibles, foco y estados de carga/error cumplen el patrón existente. Textos propios coordinados con ES/EN sin traducir rutas, nombres de distribución o contenido del usuario.
  • Guía de uso y solución de problemas en documentación ES/EN: activar/desactivar, distribución detenida, excepciones avanzadas y límites.
  • Tests de UI con mocks más prueba renderizada real Windows/WSL: CLI solo WSL, varias distribuciones, credenciales ausentes, rutas con espacios, cuenta adicional y cambio Windows↔WSL.
  • Cierre del milestone exige aceptación y evidencia de las cuatro unidades; no se acredita WSL desde tests Linux ni se promete una versión/release.
Orientación y ODD progresivo

Entradas: src/Settings.tsx, src/lib/types.ts, flujo de configuración/dirty/save y diagnóstico CLI, README ES/EN y guías vigentes. Observar UX actual → acordar estados y copy con contratos backend → implementar componentes/tests por resultado → verificar accesibilidad, guardado y flujo Windows/WSL real.

Exclusiones

No rediseño general de Ajustes, sistema de traducción paralelo, selección por proveedor de múltiples distribuciones, soporte nativo Linux, Antigravity ni publicación de instaladores/releases.

Coordinación y entrega

Parte de quorb-wsl-v1, milestone «Integración WSL en Windows» e índice #45. Estado: planificada; no anunciar lista para implementar mientras falten las decisiones o dependencias indicadas. Sin assignee inicial. Revalidar issue, comentarios, responsables y PR antes de un inicio explícito; asignación no es un lock. Se conserva la prioridad vigente del roadmap: #66 sigue siendo el primer objetivo nuevo recomendado y WSL puede investigarse independientemente sin desplazar compromisos existentes.

Tests y documentación con cada unidad. Seguir CONTRIBUTING y entregar cambios revisables; checks planificados, no ejecutados durante esta planificación: npm test, npm run typecheck, npm run build y cargo test en src-tauri, según superficie. Linux no acredita ejecución Windows/WSL. Commit, push, PR, merge, firma, release y asignaciones requieren sus autorizaciones propias.

Alternatives considered

Botón aislado de búsqueda y rutas UNC manuales: no expresan un entorno coherente para lectura/login. Un modo independiente por cada proveedor/distribución: amplía innecesariamente la primera integración; las rutas avanzadas actuales siguen como excepciones explícitas.

Lingua principale
TypeScript
Stelle
10
Fork
2
Merge medio
16m
PR unite (30g)
51

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di egdev6/quorb

Tutte le issue di egdev6/quorb

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.