SuperAPI AI 工具集

markstream-install

前端与建站

查看项目

更新于 10-16 01:06

技能介绍

用途:当任务为“给应用添加 markstream”或“修复损坏的 markstream 安装”时使用。开始前先阅读 references/scenarios.md 再决定依赖。

主要能力与流程:检测目标框架与 CSS 栈,检查 package.json、应用入口、Tailwind 或 UnoCSS 配置,以及仓库是否面向 SSR 或流式渲染;按宿主应用选择 markstream-vue、markstream-vue2、markstream-react、markstream-angular 或 markstream-svelte,其中 markstream-svelte 仅用于 Svelte 5。只安装与所需功能匹配的最小 peer 集合,不要默认安装全部可选 peer。Vue 3 围栏代码自动使用内置渲染器;需要增强 File/Diff 界面时加 stream-diffs,否则可省略以回退到 <pre><code>,或用 render-code-blocks-as-pre 强制走普通路径。仅在需要 infographic 围栏时添加 @antv/infographic 并调用 setInfographicLoader(...)。Vue 3 增强代码块预加载使用 preloadCodeBlockRuntime;若应用自行管理运行时控制器,则直接从 stream-diffs 导入该高级 API。

CSS 与用法:重置样式放在 Markstream 样式之前;Tailwind 或 UnoCSS 项目使用 @import 'markstream-*/index.css' layer(components);。不要依赖渲染器导入注入 CSS,需显式导入包 CSS 子路径;启用数学时导入 katex/dist/katex.min.css。静态或低频渲染用 content。Vue 3 长 AI 对话、历史恢复或已有消息虚拟化(如 vue-virtual-scroller)时,使用 MarkstreamVirtualTimeline 或 useMarkstreamVirtualAdapter(),并参考 docs/guide/performance.md。Vue 3 按界面选模式:mode="chat" 用于 AI 聊天或 SSE 输出,mode="docs" 为默认富文档,mode="minimal" 用于轻量非聊天界面。smooth-streaming 控制输出节奏,fade 控制透明度,可同时启用。其他包流式聊天从 content 与内置平滑流开始,auto 为默认。

限制与注意:保留默认加固,HTML 策略默认 safe,Mermaid 默认严格模式;除非用户明确需要可信旧兼容,不要放宽。自定义优先用 customId 加作用域 setCustomComponents(...)。完成后运行最小相关构建、类型检查、测试或文档构建,并报告安装了哪些 peer、CSS 位置及是否应改用 nodes。SSR 场景需将仅浏览器 peer 置于 client-only 边界。增强代码块在各包中均使用 stream-diffs,当前版本没有 stream-monaco 或 Shiki 直接集成。Vue 3 大代码块可通过 setStreamDiffsWorkerPool(...) 注入上游 @pierre/diffs WorkerPoolManager 实现主线程外高亮,此为 Vue 3 独有。