SuperAPI AI 工具集

markstream-react

前端与建站

查看项目

更新于 10-16 05:54

技能介绍

用途:把 beta 版 markstream-react 渲染器接入 React 18+ 或 Next.js,避免跨越客户端/服务端边界,并尽量不直接操作 AST。适用于 React/Next 初始化、根/next/server 入口、流式渲染、组件覆盖或迁移;替换渲染器时可配合 markstream-migration。

主要能力:提供根入口用于客户端渲染,/next 用于 Next 专用组件,/server 用于不含客户端钩子的服务端渲染;支持 content 与 smoothStreaming="auto",支持 nodes 加 final(仅当解析由其他层负责),支持 streamingComponents、htmlComponents、作用域注册表覆盖内置节点,以及 htmlPolicy="safe" 与 Mermaid 严格模式。

使用方式:先检查包管理器、已装版本与项目约定。确认 React 18+ 并接受 beta 包。仅安装所请求的 peer 依赖,并导入 markstream-react/index.css。客户端渲染用根入口,Next 用 /next,服务端用 /server。实时聊天可关闭 fade 并启用光标;完成时设置 final、关闭 pacing/cursor,按需启用 fade。仅浏览器可用的 peer 需放在 'use client' 或 dynamic ssr:false 边界内。

限制:包为 beta,需 React 18+;SSR 下浏览器专用 peer 需要客户端边界;复杂解析器一致性需单独迁移审查。安全上应审查依赖,不将不可信模型输出接入可信 HTML 或宽松图表渲染;应对部分与完成的流、畸形或不可信 Markdown、链接与图片 URL、取消与减少动效进行验证。安全 HTML 与严格图表不能单独保证 URL/网络隐私或应用组件权限。