用途:把 Markstream 流式 Markdown 渲染器集成到已有的前端应用,适用于为 AI 聊天或文档界面添加流式 Markdown、替换其他 Markdown 渲染器,或修复样式缺失、框架包选错、SSR 失败等问题。
主要能力:先检查宿主应用的框架与版本、锁文件、是否使用 SSR、样式方案及所需可选功能,再依据场景表选择框架专属包;只安装一个框架包并保留现有包管理器,按需添加可选 peer。安装示例:npm install markstream-vue、markstream-react、markstream-svelte、markstream-angular、markstream-vue2。Vue 2.6 需另装并注册 @vue/composition-api,Vue 2.7 有内置 Composition API,不应安装。
使用方式:样式需在应用 reset 之后显式导入;Tailwind/UnoCSS 用 @import 'markstream-vue/index.css' layer(components);,启用数学渲染再导入 @import 'katex/dist/katex.min.css';。Webpack 4 的 Vue 2 项目使用 import 'markstream-vue2/dist/index.css'。静态文档和多数流式聊天优先用 content,已有 AST 解析层时用 nodes 加 final。Next.js 中用 'use client' 包裹根组件,SSR 场景用 markstream-react/next 或 markstream-react/server;Nuxt 把浏览器专属 peer 放在客户端边界;Svelte 仅支持 Svelte 5。Vue 3 支持 mode="chat"、"docs"、"minimal"。
限制:不负责应用视觉风格或聊天架构设计;浏览器重的可选依赖可能需要框架专属客户端边界与打包配置;Vue 2.6 和旧 Webpack 需要额外兼容步骤;安装前须核对宿主锁文件与 Markstream 文档的当前版本要求。HTML 默认安全策略和 Mermaid 严格模式不应为不可信模型输出放宽。安装只在目标项目目录内、沿用其包管理器进行,改动依赖前应预览并获得用户确认。