SuperAPI AI 工具集

markstream-nuxt

前端与建站

查看项目

更新于 10-16 05:54

技能介绍

用途:将 markstream-vue 集成到 Nuxt 项目中,同时让水合、仅浏览器依赖、worker 与流式渲染保持在正确的 SSR 边界一侧。适用于 Nuxt 3 或 4 的页面、组件或插件;非 Nuxt 的 Vue 应用应使用 markstream-vue,框架未定时使用 markstream-install。

主要能力与用法:先检查现有包管理器、已安装版本与项目约定,再确认 Nuxt 3 或 4,并只安装被要求的可选依赖。把仅浏览器可用的依赖放到 <ClientOnly>、.client 插件、动态导入或受保护初始化之后。从客户端安全的壳或插件显式引入 markstream-vue/index.css。内容渲染从 mode="chat" 开始用于 AI 流,文档用 docs,轻量非聊天界面用 minimal。SSR 下平滑流式保持 auto,不要对首屏服务端内容强制 true。聊天行完成后保持其 mode 稳定,设置 final,禁用 pacing/cursor,并仅在需要时启用 fade。保持 HTML safe 与 Mermaid strict,把可选的代码、图表与 worker 运行时放到客户端边界之后。最后验证构建/类型检查、水合以及一次增量客户端更新。

限制:仅浏览器可用的依赖无法在 SSR 期间运行;水合依赖正确的主机插件/组件边界;该技能不配置部署适配器。

安全说明:不要把可信 HTML 或宽松的 Mermaid 设置暴露给不可信的模型输出;应针对已安装包而非可变的上游 main 核对 props、导出路径与 peer 范围,并测试部分与完成的流、畸形/不可信 Markdown、链接与图片 URL、取消与 reduced motion。safe HTML 与 strict 图表可降低暴露面,但本身不强制 URL/网络隐私或应用组件权限。