版本与验证范围
npm 1.0.7
发布日期:2026-11-10。增加游戏房间,latest 指向 1.0.7。
npm install @deeprespond/im-server-sdk@1.0.7- 增加
im.game:listRegions、createRoom、getRoom、listRooms/iterRooms、listMembers、issueTickets、startRoom、closeRoom、removeMember。建房、开局、结束自动重试;签票据不自动重试(重新签发会作废旧票据);移出玩家没有给operation_id时自动生成,重试时不变。结果中的created、accepted、removed由状态码得出。接口说明见游戏房间 · 服务端接口。 - 回调增加 7 种
game_room.*事件的类型,game_room.closed带每个玩家的在线时长和计费分钟数,见游戏回调事件。 moderation.checkText默认关键词和智能审核一起检查,结果增加provider_skipped;只查关键词时传with_provider: false。- 修正单元测试中 Express 适配器超大请求体用例在 Node.js 24 下的
write EPIPE失败(测试用例本身的问题,SDK 行为不变)。 - 通过生成代码一致性、ESLint、类型检查、单元与类型测试(153 项)、构建和包级检查;连本地服务的游戏房间集成测试通过。
npm 1.0.6
发布日期:2026-11-03。增加 AI 对话,latest 指向 1.0.6。源码版本 1.0.5 只用于 2026-10-23 的测试版构建,没有发布到 npm。
npm install @deeprespond/im-server-sdk@1.0.6im.ai增加机器人管理和流式回复:startStream开始一条回复,writeText、writeReasoning、writeImage、writeFile、writeTool写入,finish、fail结束;pipeOpenAI、pipeOpenAIResponses、pipeAnthropic、pipeGemini直接对接模型的流。用法见调用接口。- 回调处理器增加
onAIMessage、onAIStreamStopped;收到ai.stream_stopped时自动触发本进程中对应流的signal。 - 通过生成代码一致性、类型检查、构建和包级检查;公开安装后连本地服务跑 AI 流式回复的端到端测试 18 项通过。单元测试中 Express 适配器的两个用例在 Node.js 24 下因
write EPIPE失败(测试用例本身的问题,与本版本的改动无关),其余通过。
npm 1.0.1
发布日期:2026-10-23。这是回调模块导出修复版本,latest 指向 1.0.1。
npm install @deeprespond/im-server-sdk@1.0.1- 补齐
/callback的EVENT_REQUIRED、EVENT_RAW_PATHS、HOOK_ACTIONS、HOOK_RAW_PATHS运行时导出,ESM 与 CommonJS 均可读取。 - 主入口的 Service 保持纯类型导出,修正声明打包后误呈现为运行时构造函数的问题。
- 增加全部公开入口的声明值与运行时导出一致性检查,覆盖 ESM、CommonJS 及 NodeNext 使用方。
- 通过生成代码一致性、类型检查、单元测试、构建和包级检查;4 项可选 Redis 测试因未配置测试地址而跳过。业务接口协议不变,无需为此更新 IM 服务端。
npm 1.0.0
发布日期:2026-10-22。公共包为 @deeprespond/im-server-sdk,首次发布时 latest 指向 1.0.0。包保留 UNLICENSED 授权标记,具体使用授权请联系深应智能。
npm install @deeprespond/im-server-sdk@1.0.0| 项目 | 1.0.0 的内容 |
|---|---|
| 环境 | Node.js 22.17.0 以上;ESM/CommonJS 与 TypeScript 声明;零运行时依赖 |
| 应用接口 | 用户、好友、黑名单、群组、消息、会话、聊天室、文件、推送、内容安全、在线状态、IM 通话与独立 RTC 频道 |
| 请求能力 | App Token 换取与刷新、按接口分类重试、限流等待、本地限速、取消、超时、分页、批量拆分及原始 JSON 保留 |
| 回调 | 签名和防重放检查、事件去重、同步回调、密钥轮换;Node HTTP、Express、Koa、Fastify 与 Node.js 环境的标准 Request 适配 |
| 共享存储 | ioredis 与 node-redis 的 App Token、随机数及事件去重适配 |
| 包内容 | 运行与类型产物、README、package.json;脚本和框架示例由源码仓库提供,访问需要仓库权限 |
发布时验证
本轮发布在 Node.js 22.22.2 上完成以下检查:
| 检查 | 结果 |
|---|---|
| 生成代码一致性、ESLint、Prettier、TypeScript | 通过 |
| 单元与类型测试 | 126 项通过,4 项可选 Redis 测试跳过,无类型错误 |
| 本机一致性测试服务的集成与回调端到端 | 15 项通过,未跳过 |
| ESM/CommonJS 构建与打包 | 通过;12 项打包检查覆盖 publint、attw、NodeNext 类型、双模块互操作及进程退出 |
| 公共 npm 安装 | 在独立工程从官方 registry 安装成功;ESM/CommonJS 各 9 个入口、双模块互操作及 NodeNext strict 类型检查通过 |
| 制品完整性 | npm registry 的 SHA-1、SHA-512 与受检发布包一致 |
这些结果覆盖本机测试服务和包接入,不代表所有部署环境的完整业务验收。发布时未配置可选测试 Redis,未补做 TypeScript 5.2、NestJS 10 兼容专项,也未替代真实云端应用下权限隔离、客户端收发和回调全流程的专项验收。接入后按快速开始、回调联调在自己的测试应用验证。
从本地 tgz 切换到 npm
之前使用源码构建的 deeprespond-im-server-sdk-1.0.0.tgz 时,在同一业务工程执行本页最新版本的 npm 安装命令即可将依赖来源切换到公共包。提交更新后的 package.json 和 lockfile,部署时沿用项目锁定依赖的安装方式。
确认实际版本与来源:
npm ls @deeprespond/im-server-sdk
node -p "require('@deeprespond/im-server-sdk/package.json').version"lockfile 中的制品地址应来自 registry.npmjs.org,或来自项目明确配置并信任的镜像。私有镜像尚未同步时可为本次安装指定 --registry=https://registry.npmjs.org/。
后续升级
业务项目可固定 @deeprespond/im-server-sdk@1.0.7 并提交 lockfile。升级时先阅读对应版本说明,在测试应用验证接口、回调和框架配置后更新依赖。自行构建的源码包需要重新构建再安装,不会随公共 npm 包自动变化。
独立 RTC 频道 API 和九种频道事件已包含在 1.0.0 中。频道管理与用户媒体加入分工见频道方法和使用独立频道。
