SuperAPI AI 工具集

markstream-svelte

前端与建站

查看项目

更新于 10-16 06:51

技能介绍

用途:在 Svelte 5 或 SvelteKit 中集成 markstream-svelte 渲染器,处理流式状态、worker 和局部自定义组件;Svelte 4 不受支持,该包为 beta。

主要能力与用法:先确认 Svelte 5 与接受 beta 包;检查现有包管理器、已安装版本和项目约定。仅安装所需 peer 依赖;在 reset 样式之后导入包 CSS,数学公式才需 KaTeX CSS。基础用法为 <MarkdownRender {content} /> 配合 smoothStreaming 设为 auto。实时聊天可关闭 fade 并启用 cursor;完成后设置 final、关闭 pacing/cursor,并按需启用 fade。仅在 worker 解析或共享 AST 状态时使用 nodes。使用 $props() 与回调;按需配置 KaTeX 或 Mermaid worker。优先使用渲染器局部 customComponents,仅在有意共享时用 scoped 注册。浏览器专用 worker 须放在 SvelteKit 客户端边界后;用 svelte-check、build 或 e2e 验证。示例中通过 import MarkdownRender from 'markstream-svelte' 和 import 'markstream-svelte/index.css' 引入,并传 content、final、fade、typewriter、smoothStreaming、htmlPolicy 等 props。

限制:Svelte 4 不支持且包为 beta;worker 与较重的 peer 依赖需要客户端打包器支持;本技能不迁移无关的 Svelte 架构。安全方面保持 safe HTML 与严格 Mermaid 默认值,审查依赖,SSR 期间不得运行浏览器专用 peer;应针对已安装包而非可变上游 main 核对 props、导出路径和 peer 范围,并测试部分与完成流、异常/不可信 Markdown、链接与图片 URL、取消与减少动效。安全 HTML 与严格图表不能单独强制 URL/网络隐私或应用组件权限。