Documentación del código BLX

Bienvenido a los documentos de BLXCode. Las guías del usuario explican cómo ejecutar y utilizar la aplicación; Las guías para desarrolladores explican cómo crear, ampliar y contribuir.

Copia publicada: GitHub Wiki (sincronizado automáticamente desde esta carpeta al enviar a main que toca docs/**). Edite la documentación aquí en el repositorio, no en la interfaz de usuario web wiki.

Mapa médico

Empiece aquí: Introducción → Espacios de trabajo → Agent Harness

Documentos de usuario

• Introducción: requisitos previos, ejecutar BLXCode, primer espacio de trabajo, donde residen los datos, pantalla de bienvenida Crear espacio de trabajo, modelo por agente/flota de esfuerzo.
• Configuración: configuración de la pestaña central acoplada, Claves API, Agente BLXCode (texto/imagen/voz), MCP, HeartBeat, Memoria, Editor de código (Vim), Espacio de trabajo, Apariencia/temas, Ayuda/Acerca de, Registro de aplicaciones, Notificaciones.
• Apariencia y temas: selector de temas, ajustes preestablecidos, persistencia, excepciones, tamaño de fuente.
• Espacios de trabajo: creación, cuadrículas de terminales, explorador de barra lateral, diferenciación de archivos (etapa/compromiso/empuje), gráfico Git (búsqueda/extracción), transferencia, persistencia, línea de estado de la aplicación, arrastrar y soltar en el contexto de la barra lateral (archivos/carpetas/diferencias/compromisos), cuadro de diálogo de instalación de gancho, terminales con nombre.
• Remoto (SSH) — Configuración → Ajustes preestablecidos de conexión remota (contraseña/clave/agente, secretos cifrados), creación de espacios de trabajo remotos, terminales remotas + archivo/git + reanudación de sesión (tmux vs keepalive).
• Vista previa del archivo: vistas previas en la pestaña central de imágenes (incluido SVG), videos, Markdown renderizado, código fuente resaltado con sintaxis y diagramas de sirena. Modo Vim a través de @replit/codemirror-vim. Los documentos de políticas del repositorio (LICENSE, CONTRIBUTING, SECURITY, CHANGELOG,…) se representan como Markdown con un banner de héroe específico del tipo, con o sin una extensión .md.
• Memoria y tareas: panel de memoria (archivos, gráfico, búsqueda), mapa de arquitectura, categorías dinámicas, tareas, herramientas de memoria del agente, Indexador de memoria (HeartBeat), panel de configuración de memoria.
• Planes — .agents/plans/<slug>/plan.md, índice PLANS.md mantenido automáticamente, espacio de trabajo Multi-Kanban, Galería de diagramas de sirena, sintaxis de tareas, panel de Planes, herramientas de agente.
• Reglas y habilidades: tarjetas de reglas/habilidades ampliables, habilidades básicas frente a habilidades de usuario, cuadro de diálogo de instalación.
• Agent Harness: habilidades básicas (incl. MCP, generación de mensajes), avisos delgados, entorno/shell/git/web, claves de API web.
• Subagentes: ejecuciones paralelas, roles, cronograma, grupos de herramientas, límites.
• Atajos de teclado: prefijo tmux versus acordes heredados, notificaciones, Crear espacio de trabajo, Pulsar para hablar.
• Modo de imagen: genera imágenes desde el panel del agente, configuración, límites, persistencia.
• Proveedores de agentes: OpenRouter, Anthropic, compatible con OpenAI + Ollama / LM Studio / Hugging Face / Cloudflare / Together / Portkey / personalizado, servidores MCP, apodo del agente, incorporación, tipos de contexto de barra lateral.
• Voz — STT, TTS, micrófono, Pulsar para hablar (susurro local/nube).
• Idioma de la interfaz de usuario: configuraciones regionales, selector de idioma, localización EULA.
• Edificio: compilaciones de lanzamiento de Linux, macOS y Windows.
• Solución de problemas: problemas de inicio, compilación, navegador, llavero y terminal.

Documentos para desarrolladores

• Configuración: entorno local y comandos de verificación.
• Arquitectura: división frontend/backend, agente, memoria, planes, transferencia, diagramas, HeartBeat, Memory Indexer, MCP, Kanban, Mermaid, Notificaciones, Registro de aplicaciones, Línea de estado de aplicaciones, arrastrar y soltar en el contexto de la barra lateral.
• Agent Harness: habilidades básicas (incluido MCP, generación de mensajes), distribución de herramientas, configuración web, registro de proveedores de texto, módulo MCP, guía de extensión.
• Subagentes — subagents.run, corredor, protocolo, grupos de herramientas, nuevos roles.
• Tauri IPC: registro de comandos, contenedores, grupos de comandos, comandos HeartBeat / Memory Indexer / MCP / Kanban / Mermaid / Notificaciones / Registro de aplicaciones.
• Transporte remoto SSH: terminales envueltos-ssh, canal ejecutivo persistente, enrutamiento remoto fs/git, secretos, currículum, desmontaje, seguimiento ruso.
• Arquitectura de voz: módulos y flujos STT/TTS.
• Internacionalización: configuraciones regionales, contenido EULA, flujo de trabajo de traducción.
• Temas — tokens, ThemeService, agregar temas, reglas de pelusa.
• Contribuyendo: estilo de código, reglas, pruebas, lista de verificación de solicitudes de extracción.

Principios del proyecto

BLXCode es un banco de trabajo de escritorio local. Los espacios de trabajo, las terminales, la memoria, los planes, las tareas y el contexto del agente permanecen juntos sin ocultar dónde se encuentran los datos en el disco. Cuando el comportamiento cambie, actualice los documentos junto al código para que los usuarios y contribuyentes puedan seguir adelante sin realizar ingeniería inversa en la aplicación.

Notas de la versión

Las notas para el usuario de cada versión se encuentran en docs/releases/ (por ejemplo, v0.5.0.md). Las presentaciones también utilizan su nombre de archivo de etiqueta exacto, como v0.5.1-pre.ed4dc.md. Impulsan el cuadro de diálogo Novedades de la aplicación después de las actualizaciones y no deben ser técnicos. El registro de cambios técnicos permanece en CHANGELOG.md en la raíz del repositorio.