feat: completar la experiencia de integración WSL en Ajustes
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- react, typescript
- Lĩnh vực
- desktop, developer-experience
Hướng nghiên cứu
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.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- TypeScript
- Star
- 10
- Fork
- 2
- Merge trung bình
- 21 phút
- Pull request đã merge (30 ngày)
- 52
Chuẩn bị môi trường
Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của egdev6/quorb
-
fix(ui): corregir el enlace oficial de uso de ChatGPT/CodexCó thể làm lại được Pull request cho issue này đã bị đóng mà không được merge. Đang mởstatus:approved type:bug
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 70/100
egdev6/quorb#109 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
feat(widget): dockear al monitor principal por defecto y avisar si el widget queda en otro displayĐang mở
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 35/100
egdev6/quorb#113 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
odd type:feature
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 15/100
Maintainer thường phản hồi trong vòng 1 ngày
-
odd type:feature
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 15/100
Maintainer thường phản hồi trong vòng 1 ngày
-
odd type:feature
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100
Maintainer thường phản hồi trong vòng 1 ngày
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
QuantumNous/new-api#7839 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug p2 triaged
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
getpaseo/paseo#7071 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
test: make the #3408 Claude OAuth token fixture obviously fake so secret scanners stop flagging itĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
code-yeongyu/senpi#3436 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 78/100
lingdojo/kana-dojo#32505 · 1 bình luận · 5 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày