Aspectos destacados

docmd v0.9.0 introduce el motor asistente de docmd, proporcionando búsqueda de documentación con IA sin configuración y chat interactivo en entornos de espacios de trabajo de un solo proyecto y multiproyecto. Esta versión también ofrece una renovación limpia de TUI minimalista, seguridad estricta de origen en la nube, enrutamiento contextual relativo a la página para una portabilidad completa del sitio, un modo de compilación fuera de línea y correcciones clave de estabilidad del motor.

Renovación de TUI minimalista

  • Salida sin bordes: Se eliminaron por completo las tuberías verticales (), los marcos de dibujo de cajas (┌─, └─) y el ruido visual pesado de la ejecución de CLI, la salida del servidor de desarrollo y las canalizaciones de prueba de mantenimiento (pnpm prep).
  • Ritmo visual estandarizado: Se reemplazaron los bordes con sangría con una jerarquía visual limpia alineada a la izquierda con encabezados de sección en mayúsculas en negrita y espaciado de línea en blanco estándar entre grupos.
  • Renovación de marca: Se actualizó el logotipo de la marca principal a azul vibrante (chalk.blue) en todos los encabezados de la CLI.
  • Registro de plugins simplificado: Se redujo la verbosidad del registro en los plugins internos (como OKF) a resúmenes de estado limpios de una sola línea.

Asistente de IA y seguridad en la nube (@docmd/plugin-ai)

El asistente de documentación de IA ahora está integrado de forma nativa en docmd:

  • Motor Asistente de docmd: Impulsado por docmd-assistant (v0.1.6), que lleva orientación técnica conversacional directamente a los sitios de documentación.
  • Validación estricta de origen de dominio: Se endurecieron los extremos de retransmisión del asistente de IA en la nube con comprobaciones estrictas de origen con respecto al registro del dominio del proyecto para evitar el uso no autorizado de terceros.
  • Conmutador de Localhost gestionado por la plataforma: Se introdujo una configuración a nivel de proyecto en el panel de control de docmd Cloud para habilitar las pruebas de vista previa local (127.0.0.1 / localhost) sin exponer los parámetros de configuración del lado del cliente.
  • Traiga su propia clave (BYOK): Admite proveedores OpenAI, Anthropic, Gemini, DeepSeek y Ollama enrutados de forma segura a través del retransmisor en la nube de docmd.
  • Configuración en la nube: Configure las credenciales del asistente y las opciones del proyecto a través de docmd cloud.
  • RAG de espacio de trabajo multiproyecto: Permite el descubrimiento global de documentación a través de índices de búsqueda hermanos (_docmd-search/search-index.json) en configuraciones de espacios de trabajo multiproyecto.
  • Resolución de enlaces canónicos: Sanea y resuelve automáticamente los hipervínculos internos a rutas exactas del sitio en servidores de vista previa local y despliegues de producción de subrutas.
  • Renderizado de respuestas formateadas: Soporte nativo para tablas GFM Markdown, bloques de código en línea y temas de interfaz adaptables claros/oscuros.
  • Enrutamiento relativo a la página: Los conmutadores de versión, idioma y proyecto ahora priorizan las rutas relativas (./, ../), garantizando una portabilidad completa del sitio en entornos de raíz, subruta y vista previa local.
  • Intercambio de diseño de SPA: La barra de menú superior, el banner de anuncios y los elementos de consentimiento de cookies se actualizan dinámicamente durante las transiciones de SPA para mantener los enlaces relativos correctos a cualquier profundidad de directorio.
  • Corrección de enrutamiento del servidor de desarrollo: Se resolvieron los desacoples de redirección de subrutas al ejecutar servidores de desarrollo local en configuraciones de espacios de trabajo personalizados.

Modo de compilación fuera de línea de CLI (--offline)

Se introdujo el marcador de CLI --offline para compilar paquetes de documentación autónomos adecuados para la distribución fuera de línea:

  • Omite la indexación de búsqueda y la obtención de datos de redes externas.
  • Aplica el sufijo de enlace .html para compatibilidad directa con el protocolo file://.
  • Inyecta un aviso localizado dentro de la interfaz de búsqueda que indica el estado fuera de línea.

Correcciones del motor y de errores

  • Correcciones del motor y del analizador principal (#186, #187, #188, #189, #190): Se resolvieron problemas en el análisis sintáctico de contenedores AST, la normalización de rutas y los límites de ejecución en tiempo de ejecución de plugins.
  • API de puente de búsqueda: Se expuso window.docmdSearch.search para la integración de RAG del lado del cliente.
  • Requisito del motor Node.js: Se actualizó el requisito mínimo de Node.js a >=20.0.0 en todos los paquetes del espacio de trabajo.

Actualización

upgrade
npx @docmd/core@0.9.0 build