ModelRiver Vanilla JS SDK 是整个客户端库的基础。它是一个轻量、无依赖的类,负责管理 WebSocket 生命周期、事件分发和状态持久化。对于不使用大型框架的项目,或你希望自己封装集成层时,这是最直接的方案。
安装
npm
Bash
npm install @modelriver/clientCDN
对于静态站点或快速原型,你也可以直接通过 CDN 引入:
HTML
1<script src="https://cdn.modelriver.com/client/latest/modelriver.min.js"></script>实现示例(Vanilla JS)
核心流程如下:
- 初始化
ModelRiverClient - 监听
response、step、error等事件 - 调用你自己的后端获取
ws_token - 用
client.connect()启动实时 AI 流
关键 API 方法
client.connect(options)
建立 WebSocket 连接。需要 wsToken,可选 channelId。
client.on(eventName, callback)
订阅 SDK 事件。可用事件包括:connecting、connected、disconnected、response、error、step。
client.getState()
返回客户端当前状态,包括 status、response、steps,以及是否存在待完成请求。
client.disconnect()
安全关闭 WebSocket 连接并清理监听器。
Vanilla JS 的 SEO 优势
- 最小包体积:零依赖可以保持页面足够轻量,提升 Core Web Vitals
- 更快交互:没有框架初始化开销,HTML 解析后即可尽快可用
- 广泛兼容:可嵌入任何 CMS、传统站点或遗留系统中,为其补充现代 AI 能力