SDK 与网关
| 组件 | 建议 |
|---|---|
@routerbrain/sdk | 锁定主版本(如 ^1.0.32),升级前在非生产环境回归 chat 流式与 files |
| 网关 | 由 连连智枢 侧升级;破坏性变更通过发布说明通知 |
SDK 封装范围与 产品能力 中的 HTTP API 一致;网关新增字段通常向后兼容。
Node.js
- 最低 Node 18;推荐 20 LTS。
- 推荐使用 ESM(
import/export,package.json中"type": "module")。 - 若项目是 CommonJS(
require),请用动态import('@routerbrain/sdk')加载。
TypeScript
包自带 .d.ts。chatRequest 类型对齐 OpenAI Chat 请求的子集 + 连连智枢 扩展(如 plugins.pdf)。
升级清单
- 阅读 npm changelog / 发布说明
- 非生产环境跑通非流式 + 流式 + 文件上传
- 确认
baseURL仍含/v1 - 检查是否误用已移除的 stub API(SDK 限制)