Notas de la Versión v0.9.3
Aspectos Destacados
docmd v0.9.3 ofrece empaquetado local y sin conexión de diagramas Mermaid, soporte para ejemplos de peticiones y respuestas OpenAPI con contención de esquemas en desplazamiento horizontal aislado, análisis universal de herramientas de IA con docmd-assistant v0.1.14 y mejoras de estabilidad en la sanitización de URLs.
Diagramas Mermaid Locales y Desconectados (@docmd/plugin-mermaid)
- Empaquetado Local Autónomo: El complemento Mermaid empaqueta el entorno de ejecución completo localmente mediante
esbuildcomo un script IIFE clásico, eliminando por completo las dependencias de CDNs externas (jsdelivr.net). - Compatibilidad con Entornos Aislados y
file://: Los diagramas se renderizan de forma totalmente autónoma en entornos sin conexión a internet y al abrir los archivos compilados mediante el protocolofile://.
Mejoras en el Complemento OpenAPI (@docmd/plugin-openapi)
- Ejemplos y Tipos de Medios: Soporte exhaustivo para ejemplos de cuerpo de solicitud y respuesta en OpenAPI 3.x, así como bloques de datos de muestra multiesquema.
- Contención de Tablas y Desplazamiento Horizontal:
- Las tablas de parámetros y esquemas están encapsuladas en contenedores
.oa-table-wrapcon desplazamiento horizontal aislado (overflow-x: auto). - Expandir árboles de esquemas complejos ya no distorsiona el diseño global de la página.
- Los encabezados, insignias de métodos, resúmenes y descripciones permanecen fijos con ajuste de línea seguro.
- Las tablas de parámetros y esquemas están encapsuladas en contenedores
Asistente de IA y Motor (@docmd/plugin-ai y docmd-assistant v0.1.14)
- Analizador Universal Multiformato:
docmd-assistantextrae con precisión objetos JSON equilibrados, bloques de código Markdown (```json), sintaxis entre corchetes ([Tool Call: name(...)]) y llamadas sin argumentos (get_site_structure()). - Cero Fuga de Cadenas de Herramientas: Las cadenas sin procesar nunca se muestran en el chat del usuario; las herramientas se ejecutan de forma autónoma y se sintetizan en respuestas Markdown fundamentadas en hechos.
- Ejecución como Script Clásico: Los recursos de cliente se compilan como scripts IIFE clásicos, asegurando compatibilidad total con
file://.
Correcciones del Analizador y Núcleo (@docmd/parser y @docmd/core)
- Sanitización de URLs: Corrección del colapso de barras iniciales
//ensanitizeUrlpara prevenir rutas rotas en subsitios. - Protección de Service Worker: Se agregaron comprobaciones de protocolo para omitir consultas a
navigator.serviceWorkeren orígenesfile://sin generar excepciones de seguridad.
Problemas y Solicitudes de Extracción Resueltos
- Issue #198: Permitir el uso del plugin Mermaid en sitios desconectados y modo offline (reportado por @cboitel).
- Issue #199 / PR #200: Añadir soporte para ejemplos en el plugin OpenAPI (contribuido por @w666).
- PR #203: Colapsar barras iniciales
//ensanitizeUrl(contribuido por @eeshsaxena). - Issue #205: Flujo de verificación inestable (reportado por @w666).
- Issue #206: El chat de IA devuelve la cadena de llamada a herramienta en lugar de respuestas reales (reportado por @mewc).
Paridad Global de Documentación
- Sincronización Multilingüe: Actualización 1:1 de todas las notas de versión y documentación técnica en inglés (
en), alemán (de), español (es) y chino (zh).