用途:为 AI 聊天类界面提供实现模式与参考代码,适用于构建 ChatGPT 风格对话界面、AI 助手/协作者/聊天机器人,以及流式文本、多模态输入、上下文与错误处理等场景。
主要能力:消息气泡(用户/AI/系统)与流式渲染;输入组件(附件、语音、自适应文本框);响应控制(停止、重新生成、继续、编辑);反馈机制(点赞/点踩、复制、分享);流式 UX(自动滚动启发式、防止用户阅读时被打断);上下文管理(token 用量友好展示与剩余消息估算);多模态(图片上传预览、文件、语音);AI 专属错误处理(拒答、速率限制倒计时);工具/函数调用可视化;无障碍支持(aria-live、role=log);安全需对 LLM 输出做 DOMPurify 清洗;性能优化(memo、防抖、虚拟滚动);设计 token 主题化。
使用方式:按推荐依赖安装,例如 npm install ai @ai-sdk/react @ai-sdk/openai、npm install @vercel/streamdown、npm install react-syntax-highlighter、npm install dompurify。可使用 useChat 快速搭建最小接口,并参考 examples 与 references 目录中的示例和文档;脚本 scripts/parse_stream.js、scripts/calculate_tokens.py、scripts/format_messages.js 可分别用于流式不完整 markdown 解析、token 估算与消息历史导出。
适用场景:聊天界面、代码助手、多模态对话、带工具调用的 AI 产品等。
限制:资料未提供具体收费、价格、平台支持范围或实测效果数据;部分依赖库版本与兼容性需自行验证;示例代码需结合项目环境调整。