Base de conocimientos de sesiones

Esta página trata de la «Base de conocimientos de sesiones», el «Historial de organización» y las «Sesiones archivadas». La gestión, la edición y la importación de archivos Markdown locales se describen en Bases de conocimientos locales.

La base de conocimientos de sesiones almacena conocimientos, decisiones, restricciones y lecciones aprendidas, organizados según la jerarquía proyecto → sesión → artículo. Los artículos generados se almacenan por separado: no cambian cuando cambia su sesión de origen, y usted puede editarlos a mano. La base de conocimientos de sesiones pertenece al servidor de VelaTerm al que está conectado y es común a todos sus proyectos y sesiones; si se conecta a otro servidor, verá la base de conocimientos de ese servidor.

Es independiente de la búsqueda en el contenido de las sesiones. La búsqueda de sesiones encuentra texto en las conversaciones originales, mientras que la base de conocimientos solo busca en los artículos guardados. VelaTerm organiza, almacena y muestra artículos cuando usted lo solicita; no añade artículos automáticamente a las sesiones nuevas.

Organización de una sesión

1. Haga clic con el botón derecho en una sesión de la barra lateral o en su pestaña y elija «Organizar en la base de conocimientos de sesiones». La misma acción está disponible para las sesiones archivadas.
2. Elija el «Agente»: Claude, Codex, Grok Build, OpenCode, Pi u OMP. VelaTerm usa la ruta del ejecutable definida en Ajustes ▸ Agentes o busca el programa en el PATH. Un agente que no se encuentra aparece como «Sin instalar o configurar» y no se puede seleccionar.
3. Si lo desea, elija un «Modelo (opcional)» y un «Esfuerzo de razonamiento». «Modelo predeterminado» y «Valor predeterminado del agente» dejan la elección a la configuración propia del agente. La lista de modelos es la misma que se usa al crear una sesión, y los niveles de esfuerzo solo aparecen en los modelos que los ofrecen. VelaTerm recuerda el último agente, modelo y esfuerzo que usó. El agente debe tener la sesión iniciada y acceso al modelo elegido.
4. Haga clic en «Organizar y guardar». El agente seleccionado recibe el texto de la sesión y lo procesa con su propia configuración de modelo.
5. Siga la tarea en «Historial de organización». Cerrar el cuadro de diálogo no detiene la tarea.

VelaTerm lee el registro de conversación del agente cuando existe. En caso contrario, usa la grabación del terminal de la sesión (consulte Uso del terminal) sin los códigos de control del terminal. Si no puede leer ninguno de los dos, indica «Esta sesión no tiene una conversación que se pueda leer». Una grabación del terminal contiene el texto visible en pantalla y puede incluir contenido redibujado, por lo que el agente que organiza la sesión no debe tratar esa salida como un hecho comprobado.

Una instantánea de origen almacena el texto que se leyó para la organización. Los nombres del proyecto y de la sesión se guardan cuando la sesión se añade por primera vez y no se actualizan si más adelante el proyecto o la sesión se renombran, se mueven, se archivan o se eliminan en otro lugar.

Al volver a organizar una sesión, esta se lee de nuevo y se sustituyen los artículos generados anteriormente a partir de ella, incluidas sus ediciones manuales; esto ocurre aunque el texto y la configuración del modelo no hayan cambiado. Si la sesión ya tiene una tarea sin terminar, la nueva tarea la sustituye. Si la tarea anterior ya está en ejecución, la nueva comienza automáticamente cuando el proceso anterior se haya detenido («Esta tarea comenzará automáticamente cuando se haya detenido la anterior de esta sesión»); la tarea anterior permanece en el historial.

Cómo funciona la organización

La organización tiene tres fases, que se muestran como progreso de la tarea:

• Extrayendo temas: la sesión se lee por secciones y se extrae el conocimiento reutilizable. Los temas solo se combinan dentro de esta tarea; no se usan los artículos de otras sesiones ni las ediciones manuales anteriores.
• Integrando conocimientos: se combinan las aportaciones de cada tema y se conservan el conocimiento, las restricciones y la incertidumbre. Se indica al agente que tenga en cuenta las correcciones y contradicciones posteriores y que no invente conclusiones.
• Guardando artículos: VelaTerm comprueba los campos, las fuentes, los vínculos y las versiones, y sustituye los artículos generados de la sesión en una sola transacción de base de datos. Un artículo con el mismo título conserva su identidad y recibe una nueva revisión. Los artículos que ya no se generan se eliminan junto con su historial de revisiones, y se quitan los vínculos que apuntan a ellos. Si la organización termina correctamente pero no encuentra nada reutilizable, se eliminan los artículos generados anteriormente para la sesión («No se extrajo conocimiento reutilizable. Se han eliminado las entradas generadas anteriormente para esta sesión»). Si falla una comprobación, se cancela la tarea o se produce un conflicto de versiones, los artículos anteriores se mantienen sin cambios y no se guarda ningún resultado parcial.

El agente devuelve contenido estructurado, y VelaTerm realiza todos los cambios en la base de datos. Los artículos se vinculan entre sí, y las listas «Enlaces a este artículo» se calculan automáticamente. Las instantáneas de origen y el historial de revisiones siguen disponibles aunque se elimine la sesión original.

La calidad del conocimiento organizado sigue dependiendo de su criterio. Si algo es incorrecto, edite el artículo o restaure una revisión anterior; al restaurar se crea una nueva revisión y se conserva la versión sustituida.

Historial de organización

«Historial de organización» enumera las tareas de organización, 40 por página. Cada tarea muestra el agente, el modelo («Modelo predeterminado» si no se eligió ninguno), el esfuerzo de razonamiento y la hora; una tarea en ejecución muestra además su fase actual («Extrayendo temas», «Integrando conocimientos» o «Guardando artículos»). El estado de una tarea puede ser «Pendiente de inicio», «En curso», «Cancelando», «Completado», «Error» o «Cancelado», y desde la lista se pueden abrir su «Instantánea de origen» y los artículos resultantes.

• «Cancelar» detiene una tarea pendiente o en ejecución. Una tarea en ejecución muestra «Cancelando» hasta que se detiene el proceso del agente. La cancelación no elimina la instantánea de origen.
• «Reintentar» vuelve a iniciar una tarea fallida o cancelada con la misma instantánea de origen, el mismo modelo y el mismo esfuerzo de razonamiento. El historial muestra la configuración con la que se creó la tarea; una opción predeterminada significa que decidió el agente, no que VelaTerm determinara un modelo concreto.

Se pueden organizar varias sesiones en paralelo. Cada sesión ejecuta una sola tarea a la vez, y al volver a enviarla solo se conserva la tarea pendiente más reciente, en lugar de formarse una cola. Las tareas pendientes se guardan en la base de datos y continúan después de reiniciar la aplicación. Una tarea en ejecución que no informa de su progreso durante dos minutos se marca como interrumpida («El proceso se interrumpió. Puedes reintentarlo con la instantánea de origen guardada»). El tiempo de espera no cuenta para el límite de tiempo de la tarea.

Puede editar artículos mientras se ejecuta la organización. Si alguien edita o elimina los artículos generados de la sesión durante una tarea, la tarea informa de un conflicto de versiones, sus cambios se conservan y puede reintentarla después. Distintas sesiones pueden usar el mismo título de artículo; dentro de una misma sesión, los títulos deben ser únicos.

Consulta y mantenimiento de artículos

Abra la base de conocimientos desde el panel derecho (consulte Bases de conocimientos locales) y expanda «Base de conocimientos de sesiones» por proyecto, sesión y artículo. Haga clic en un proyecto o una sesión para ver la lista de sus artículos, y en un artículo para leerlo. El botón «Subir un nivel» vuelve a la página superior.

• La página de lista ofrece búsqueda («Buscar en títulos y contenido…»), un filtro por etiqueta («Todas las etiquetas»), ordenación por «Actualización reciente» o «Título» y actualización. La búsqueda abarca títulos, resúmenes, cuerpos y etiquetas, admite varias palabras (deben coincidir todas) y sitúa primero las coincidencias en el título; cada resultado enumera además sus artículos directamente relacionados. Cuando no hay coincidencias exactas, se muestran coincidencias aproximadas, como en la búsqueda de las bases de conocimientos locales.
• Los artículos de una sesión se muestran de 40 en 40 por página; las listas de proyectos y sesiones no están sujetas a este límite, y las listas largas del árbol ofrecen «Cargar más».
• La página de un artículo muestra el cuerpo en Markdown, «Artículos relacionados», «Enlaces a este artículo», «Fuentes» e «Historial de revisiones». Puede editar el cuerpo en la propia página y guardarlo con ⌘S / Ctrl+S, usar «Editar» para cambiar el título, el resumen y las etiquetas, «Exportar Markdown», «Copiar a un cuaderno local» o «Eliminar». Al eliminar un artículo también se elimina su historial de revisiones, pero se conservan la sesión de origen y sus instantáneas.
• «Nuevo artículo» crea un artículo a mano; estos artículos aparecen en el grupo «Creación manual».

El árbol también admite acciones de gestión:

• Haga clic con el botón derecho en un artículo para renombrarlo o eliminarlo; arrástrelo a otra sesión para reasignarlo.
• Haga clic con el botón derecho en un grupo de proyecto o de sesión para renombrarlo o eliminar sus artículos. Al renombrar un grupo también se renombra el proyecto o la sesión real. Al eliminar un grupo solo se eliminan sus artículos de conocimiento: «¿Eliminar los N artículos de conocimiento de este grupo? El proyecto o la sesión se conservan».
• Al arrastrar una sesión a otro proyecto, la sesión real se mueve a ese proyecto.
• Los grupos «Creación manual», «Entradas fusionadas anteriormente» y «Proyecto de origen desconocido» no se pueden renombrar.

Las páginas de artículo, los formularios de edición, las instantáneas de origen, las revisiones, el cuadro de diálogo de organización y el historial de organización tienen sus propias URL, y el proyecto, la sesión, la búsqueda, el filtro, la ordenación y la página seleccionados forman parte de la URL.

Sesiones archivadas

Las sesiones archivadas se gestionan en la base de conocimientos. «Sesiones archivadas» aparece en el árbol de la base de conocimientos junto a la «Base de conocimientos de sesiones» y agrupa las sesiones archivadas según el proyecto del que proceden; el botón «Sesiones archivadas» del encabezado de la barra lateral abre la misma vista.

• El área principal enumera todas las sesiones archivadas por proyecto. Una sesión abierta tiene dos pestañas: «Conversación» muestra la conversación completa y «Artículos de conocimiento» muestra los artículos generados a partir de ella.
• «Buscar en archivadas…» busca solo en el texto completo de las sesiones archivadas y agrupa las coincidencias por sesión.
• Una sesión archivada abierta ofrece «Restaurar como sesión normal», «Organizar en la base de conocimientos de sesiones», «Exportar contexto completo como Markdown» (en sesiones de Claude y Codex) y «Eliminar permanentemente (incluida la grabación)». La eliminación permanente se aplica de inmediato, sin paso de confirmación.
• Archivar, restaurar y eliminar una sesión no modifica los artículos de conocimiento existentes, porque los artículos y las instantáneas de origen se almacenan por separado. Una sesión restaurada puede continuar su conversación.

Datos de versiones anteriores

Cuando VelaTerm actualizó los datos antiguos, los artículos con una sola sesión de origen se asignaron a esa sesión. Los artículos que ya combinaban varias sesiones se conservaron intactos en el grupo «Entradas fusionadas anteriormente»; no se dividen y nunca se sustituyen al volver a organizar una de esas sesiones. Los artículos sin origen pasaron a «Creación manual». La información de proyecto que todavía existía se completó una sola vez durante la actualización; las fuentes cuyo proyecto no se pudo determinar aparecen en «Proyecto de origen desconocido» con sus nombres de sesión y sus instantáneas originales.

Datos y límites

La base de conocimientos de sesiones se almacena en la base de datos SQLite de la aplicación (tablas memory_*), separada del índice de búsqueda de sesiones. La interfaz solo conserva lo que muestra y los datos de formulario sin guardar; la validación, las comprobaciones de versión, la detección de duplicados y todas las escrituras se realizan en el servidor.

• Una fuente puede contener hasta 2 000 000 de caracteres; cada sección de extracción, hasta 24 000; el texto que recibe el modelo en una llamada, hasta 350 000, y el cuerpo de un artículo, hasta 200 000.
• Cada llamada al agente puede durar hasta 10 minutos, y cada uno de sus flujos de salida puede producir hasta 8 MiB.
• En OpenCode, Pi y OMP, el texto que se pasa en una llamada está limitado a 128 KiB.
• Si un agente devuelve una salida que no se ajusta a la estructura esperada, VelaTerm se lo vuelve a pedir, hasta tres veces.

Todo lo que supere estos límites falla de forma explícita («La fuente, el contexto o la salida supera el tamaño admitido. No se ha recortado ni guardado contenido»); no se recorta ni se guarda nada.

La organización queda registrada en logs/runtime-*.log, en el directorio de datos de la aplicación. Cuando VLX_LOG_DIR no está definida, VLX_MEMORY_LOG_DIR establece el directorio. VLX_MEMORY_LOG_LEVEL=error registra solo los errores, y off desactiva el registro de este módulo. El registro recoge las tareas y fases, los recuentos de entrada y salida, las duraciones, los recuentos de caracteres, los resúmenes SHA-256 y las cifras de uso de tokens. Nunca recoge las instrucciones completas enviadas al modelo, el texto de origen, las respuestas del modelo, las credenciales ni la salida de errores; el material original se conserva en las instantáneas de origen.

Vínculos con el grafo de código

Los artículos de conocimiento se pueden vincular a símbolos de código, y «Referencias al código», en la página de un artículo, lleva al grafo de código. Cuando cambia el archivo vinculado, el artículo indica que requiere revisión; confirmar la revisión no modifica el texto del artículo. Los agentes de una sesión pueden consultar el código y los artículos con vkb. Consulte Grafo de código y base de conocimientos.