原生 JavaScript 客户端 SDK

ModelRiver Vanilla JS SDK 是整个客户端库的基础。它是一个轻量、无依赖的类,负责管理 WebSocket 生命周期、事件分发和状态持久化。对于不使用大型框架的项目,或你希望自己封装集成层时,这是最直接的方案。

安装

npm

Bash
npm install @modelriver/client

CDN

对于静态站点或快速原型,你也可以直接通过 CDN 引入:

HTML
1<script src="https://cdn.modelriver.com/client/latest/modelriver.min.js"></script>

实现示例(Vanilla JS)

核心流程如下:

  1. 初始化 ModelRiverClient
  2. 监听 responsesteperror 等事件
  3. 调用你自己的后端获取 ws_token
  4. client.connect() 启动实时 AI 流

关键 API 方法

client.connect(options)

建立 WebSocket 连接。需要 wsToken,可选 channelId

client.on(eventName, callback)

订阅 SDK 事件。可用事件包括:connectingconnecteddisconnectedresponseerrorstep

client.getState()

返回客户端当前状态,包括 statusresponsesteps,以及是否存在待完成请求。

client.disconnect()

安全关闭 WebSocket 连接并清理监听器。

Vanilla JS 的 SEO 优势

  1. 最小包体积:零依赖可以保持页面足够轻量,提升 Core Web Vitals
  2. 更快交互:没有框架初始化开销,HTML 解析后即可尽快可用
  3. 广泛兼容:可嵌入任何 CMS、传统站点或遗留系统中,为其补充现代 AI 能力

下一步