16 — Por dentro
Diagnóstico y hallazgos
Soluciones operativas, registro de sesión y diferencias detectadas al contrastar documentación e implementación.
En esta página
Usar el registro
F12 abre una pestaña seleccionable de solo lectura con hora, origen, operación, resumen y detalles. Selecciona texto y cópialo con Ctrl+C vía OSC 52; la edición y el pegado están bloqueados. Guarda hasta 200 entradas y 12.000 caracteres de detalles por entrada. Se pierde al cerrar; no hay exportación, filtro o persistencia.
No todos los errores se registran: algunos solo actualizan el pie. Además de limpiar controles ANSI, se redactan patrones conocidos de claves privadas, tokens, credenciales en URLs y campos sensibles. Es protección de mejor esfuerzo: revisa rutas y datos antes de compartir un diagnóstico.
Problemas frecuentes
| Síntoma | Qué comprobar |
|---|---|
| No encuentra oec | PATH y canal instalado; en Linux directo reabre el shell o añade ~/.local/bin. |
| Falta binario npm | Plataforma x64 admitida y dependencias opcionales instaladas. |
| No aparece Git | Ejecutable Git disponible y carpeta dentro de un repositorio. F5 no crea un repositorio. |
| No abre un archivo | Ruta dentro de raíz, archivo regular, UTF-8, sin NUL y hasta 2 MiB; imágenes usan otro límite. |
| No coincide un atajo | Foco, overlay activo, bindings globales y qué modificadores transmite el terminal. |
| Búsqueda no encuentra cambios | Guarda primero para búsqueda global; revisa exclusiones y límites de índice/resultados. |
Hallazgos y correcciones del snapshot
- La pérdida de contenido al guardar Markdown en preview y los riesgos al cambiar pestaña durante save/reload se corrigieron con identidad por documento y pruebas de regresión. No es necesario volver a fuente para guardar.
- El filtro inline pertenece al foco del Explorador: cambiar al editor no le deja capturar sus teclas. Consultas nuevas cancelan resultados de contenido anteriores.
- Ctrl+F en preview/imagen puede activar búsqueda sin panel visible; Esc la cierra. La búsqueda local tiene UI en fuente. Cambiar la consulta avanzada global mientras está pendiente sigue requiriendo revisión específica.
- La configuración de proyecto valida rutas físicas y rechaza escapes por symlinks. El launcher no migra silenciosamente a otro prefijo si no puede resolver npm de la instalación activa.
Diferencias verificables en el código
- Ctrl+Alt+W está anunciado en una entrada pero no tiene handler. Usa Ctrl+L o la propia entrada de paleta.
- El schema JSON distribuido no expresa todas las restricciones de schema.ts. Los bindings de proyecto y algunos mapas dinámicos están restringidos.
- En 0.2.39 se corrigió la altura de imágenes del editor autónomo y el pie dejó de anunciar F4 de Markdown sobre imágenes. Los encabezados [Masivos]/[Árbol] del Explorador siguen en español.
Fuentes del capítulo
Enlaces fijados al commit revisado; no siguen main.
src/logs/useLogs.ts↗src/logs/redact.ts↗src/documents/ImagePreview.tsx↗src/workbench/AppLayout.tsx↗src/documents/useDocuments.ts#L101-L112↗src/documents/useDocuments.ts#L222-L254↗src/editor/useEditor.ts#L183-L224↗src/search/useSearch.ts↗src/workbench/useWorkbench.ts#L288-L318↗src/config/schema.ts↗