21 — Por dentro
Cobertura y fuentes
Una matriz auditable de capacidades, referencias y versión. Cómo mantener esta documentación al evolucionar OEC.
En esta página
Método de revisión
La documentación revisa OEC 0.2.41 y plugin 0.3.4 en snapshots independientes: SVG, filtro por contenido, Markdown, seguridad de documentos, paneles adaptables y paleta. El estado de cada publicación y su evidencia se registran por separado; las pruebas del tarball no equivalen a instalación pública por nombre.
El catálogo autónomo mantiene 28 IDs configurables y 36 entradas lógicas de paleta. Opciones, atajos y metadatos del plugin se auditan por separado. Los enlaces públicos de fuentes y evidencia se habilitan solo tras confirmar la publicación.
Actualizar con cada versión
- Fija versión y commit nuevos en product.ts después de revisar su diff con la versión anterior.
- Compara useKeyboardShortcuts, la paleta de useWorkbench, CLI, defaults/schema, tipos de documento, Git y scripts de distribución.
- Actualiza fichas, secciones y snapshot de defaults en ambos idiomas. Cada capacidad nueva debe tener capítulo y fuente.
- Revisa hallazgos: si se corrigen, cambia su descripción con evidencia. No mezcles planes pendientes con funcionalidades disponibles.
- Ejecuta el build del sitio y verify:docs: valida identidad, enlaces internos, traducciones estructurales, catálogo, configuración y sitemap generado.
Qué significa cobertura
Esta matriz muestra dónde se explica cada área revisada. No afirma cobertura de pruebas del 100%, ausencia de defectos ni compatibilidad certificada con todos los terminales. Los comportamientos heredados se identifican como tales y los hallazgos estáticos conservan su estado.
Matriz de cobertura
Cada fila tiene documentación equivalente en español e inglés. El plugin fija sus fuentes al commit publicado, independiente del snapshot autónomo.
Instalación y actualización →
Elige el canal adecuado para Windows x64 o Linux x64 glibc, incluida una distribución WSL compatible.
package.json ↗ES ✓ / EN ✓Plugin para OpenCode 2 →
Del chat al archivo: instalación, capturas reales, Git local, diffs en pestañas, Markdown, imágenes y todos los atajos del editor integrado.
plugins/opencode-editor/README.md ↗ES ✓ / EN ✓Referencia CLI →
Todos los argumentos públicos del editor y el comportamiento exacto del arranque.
src/bootstrap/cli.ts ↗ES ✓ / EN ✓Interfaz y navegación →
Tres paneles, documentos centrales y prioridad de teclado. Entiende dónde actúa cada tecla.
src/workbench/AppLayout.tsx ↗ES ✓ / EN ✓Explorador y archivos →
Recorre el proyecto, crea y elimina archivos, y entiende el árbol y sus exclusiones.
src/explorer/tree.ts ↗ES ✓ / EN ✓Editor y pestañas →
Edición, guardado, cambios externos, portapapeles y ciclo de vida de los documentos.
src/documents/useDocuments.ts ↗ES ✓ / EN ✓Búsquedas y exclusiones →
Distingue contenido del buffer, archivos indexados y texto guardado en el proyecto.
src/search/useSearch.ts ↗ES ✓ / EN ✓Cambios locales y remotos →
Revisar, preparar, confirmar y sincronizar desde el panel Git.
src/git/status.ts ↗ES ✓ / EN ✓Historial y ramas Git →
Explora commits y versiones sin cambiar la rama de trabajo.
src/git/history.ts ↗ES ✓ / EN ✓Leer diffs →
Qué compara cada vista y cómo volver al archivo actual sin restaurar una revisión.
src/git/diff.ts ↗ES ✓ / EN ✓Markdown, imágenes y manual →
Vistas de lectura dentro de pestañas y sus diferencias frente al editor fuente.
src/documents/previews.ts ↗ES ✓ / EN ✓Todos los comandos →
Acciones de OEC, paleta, diálogos, Vim básico y teclas heredadas. Busca por nombre, tecla, contexto o ID configurable.
src/workbench/useKeyboardShortcuts.ts ↗ES ✓ / EN ✓Configuración completa →
Defaults, propiedades, ámbitos, aplicación y ejemplos válidos de configuración global y por proyecto.
src/config/defaults.ts ↗ES ✓ / EN ✓Formateo →
Prettier integrado y ejecutables externos, con sus reglas de selección y guardado.
src/editor/format.ts ↗ES ✓ / EN ✓Perfil Vim básico →
El subconjunto realmente implementado, sus modos y diferencias frente a Vim completo.
src/editor/useEditor.ts#L131-L161 ↗ES ✓ / EN ✓Diagnóstico y hallazgos →
Soluciones operativas, registro de sesión y diferencias detectadas al contrastar documentación e implementación.
src/logs/useLogs.ts ↗ES ✓ / EN ✓Límites y compatibilidad →
Plataformas, dependencias del terminal, límites de análisis y alcance real de las protecciones.
package.json ↗ES ✓ / EN ✓Arquitectura del editor →
Arranque, composición por capacidades, estado, infraestructura y dependencias.
src/bootstrap/executable.ts ↗ES ✓ / EN ✓Desarrollo y pruebas →
Preparar el entorno, ejecutar comprobaciones y entender qué evidencia aporta cada suite.
package.json ↗ES ✓ / EN ✓Compilación y publicación →
Cómo se producen los binarios, se empaqueta npm y se publica una release del editor.
build.ts ↗ES ✓ / EN ✓Fuentes del capítulo
Enlaces fijados al commit revisado; no siguen main.