CHANGELOG
持续交付，不藏进度
按服务端版本与客户端平台，追踪每一次新增、优化与修复。
服务端/产品
按版本查看每个可售版本收到了哪些更新。
- 服务端 v1.17.0：加入认证会话持久化与管理员撤销、消息 envelope 与组合详情读取、社区频道治理、推送策略、运行时配置审计和可观测性；AI 流支持取消、持久化最终 envelope 与受授权的大回复对象交付，并完成消息大小治理和多数据库迁移验证。
- 客户端 SDK 1.13.0 发布并开放版本化下载，新增 React Native 与微信小程序适配；服务端能力与 1.15.0 保持兼容。
- 坐席协作能力进入全部版本：坐席可把客户转交给指定同事，或按团队自动分配（在线且最闲优先），主管可强制改派；群客服支持认领 / 释放 / 改派；新增仅对内可见的客户备注与团队话术库。转接自带上下文简报，接手的同事不必从头翻记录。
- 富交互消息：机器人与坐席可发送快捷回复按钮组与信息卡片，客户点选即以本人身份进入正常对话流并结构化留痕；Web 与 Flutter UIKit 均已内置渲染，不认识新类型的旧客户端自动降级为纯文本。
- 热路径性能优化：消息负载单次解析、编解码器复用、群与房间扇出减少临时分配，高并发下 CPU 与内存开销下降，行为无变化。
- 随客户端套件(SDK 1.11.1 / Flutter UIKit 二期)同步发版;服务端无行为变更。
- chat-studio 演示追加:微信式消息时间分隔条(≥5 分钟才显示,气泡不再逐条带时间)、更紧凑的自适应输入框。(客户端套件同版发布 SDK 1.11.0 与 Flutter UIKit,详见 SDK 轨。)
- chat-studio 演示视觉升级:中性微信风皮肤 + 品牌 teal、确定性首字头像、消息气泡头像列 + AI 流式光标、微信式人性化时间、微动效(遵守 reduced-motion)、product-mode 首屏品牌化。(客户端套件同版首发 Web UIKit,详见 SDK 轨。)
- 消息体限额治理：入站请求统一闸门（websocket.max_request_bytes，默认 256KB）——超限返回新错误码 1011 Message too large（此前是断连或静默入库）且不消耗频控预算；消息段 26 个字符串字段通用字节预算（URL/路径类 4096、名称/ID 类 1024，错误信息带字段名）；新增 imcore_msg_oversize_total 指标、/stat 字段与 Prometheus 告警规则；双语限额总表 docs/LIMITS.md 收口全部限额与超限行为。
- Kubernetes umbrella chart：Helm 部署可选捆绑 PostgreSQL / Redis / RabbitMQ / MinIO 子 chart（values-bundled.yaml 一键拉起全栈），并编排数据库迁移 Job；chart appVersion 即默认镜像 tag。
- 部署体验补丁：发行包新增 demo_token（一条命令生成测试 JWT，配合快速开始的连通验证）；配置模板默认数据库改为 PostgreSQL，database.driver 开关说明补全（migrate 与服务端同读一个开关）；修复 MySQL 部署路径——ai_tools 建表语句在 MySQL 8 无法应用、融云建库脚本误入迁移目录导致 bin/migrate 中断、运营趋势 DATE 列时区偏移；CI 新增 MySQL 集成测试作业，双数据库持续兜底。
- 消息扩展 Key/Value：为单条消息附加可增改删的 KV 扩展（chat_{dm,group,room}_expand），投票、接龙、问卷、任务状态的通用底座。u:<userID>: 私有前缀仅本人可写删（防篡改），公共 key 仅消息发送者；每 key last-write-wins，服务端逐消息串行化防并发丢写；实时广播 + 多端同步 + 离线历史回源，零 DDL。
- Typed @提及目标：@用户 / @角色 / @here / @all 结构化提及（服务端解析与鉴权），配套按提及级别的推送偏好。
- 群成员标记：群主/管理员可为成员设置仅工作人员可见的标记（客服场景的客户备注）。
- 连接注册表锁分片：ClientManager 连接集与在线索引分片化（默认 32 片，2 的幂），高并发下消除全局锁竞争。
- 正确性修复：会话摘要以权威未读列覆盖（防漂移）· 房间 mark-read 全区间补发已读回执 · OpenAPI 入站接口不再向调用方泄露原始数据库错误文本。
- 会话体验三件套（服务端 + 四端 SDK）：手动标记未读（每会话、多端同步、真读自动清除）· 草稿跨端同步（last-write-wins）· 定时免打扰/静默时段（配置时段内抑制离线推送）。四端（JS/TS、Dart、Swift、Kotlin）提供 typed 封装 operations.markUnread、drafts.set/clear、push.getDnd/setDnd。
- 独立 consumer 观测：persist consumer 可选开放 /metrics 与 /healthz·/livez·/readyz。
- 凭证卫生：CI 新增被跟踪文件密钥扫描。
- 完整服务端 OpenAPI 3.1 契约：所有面向客户的 HTTP 路由均被描述，经 /openapi.{yaml,json} 提供，并在 CI 中防漂移。
- WebSocket 命令全部 SDK 化：最后 25 个命令进入协议目录；四端 SDK 新增 operations API。
- 官网依赖安全升级：Astro 升级越过已报 npm 告警，静态构建保持通过。
- 四端弱网恢复：建连超时、无入站流量连接退役、带抖动的指数重连退避。
- 双向历史分页：historyPage() 支持 before/after/seq 游标；原数组返回的 history() 保持兼容。
- 生产级健康探针：仅查进程的 /livez 与依赖感知的 /readyz（Redis / 数据库 / 消息代理），并保留 /healthz。
- 对象存储（S3 兼容 + 内置 MinIO）。
- SDK relations helper。
- 多人通话上限。
- 移动端语音消息。
- 位置与名片消息。
- 移动端 H5 聊天与扫码 Demo。
- 只读在线 Demo（含 RAG 助手）。
- 首个正式版本——免费基础版、Docker Compose 一键启动、Docker Hub 与阿里云双镜像，amd64 / arm64 / loong64 三架构二进制与离线镜像包。
- /openapi/v1 入站推送 API。
- 企业通讯录。
- 基础版连接数上限提至 1,000。
- 文档与打包：SDK 文档与中英双语的产品 / 安全 / 解决方案页面；统一为 4 个可售版本（基础 / 专业 / 企业 / 客服），由单一事实源生成。
- 服务端 v1.17.0：加入认证会话持久化与管理员撤销、消息 envelope 与组合详情读取、社区频道治理、推送策略、运行时配置审计和可观测性；AI 流支持取消、持久化最终 envelope 与受授权的大回复对象交付，并完成消息大小治理和多数据库迁移验证。
- 客户端 SDK 1.13.0 发布并开放版本化下载，新增 React Native 与微信小程序适配；服务端能力与 1.15.0 保持兼容。
- 坐席协作能力进入全部版本：坐席可把客户转交给指定同事，或按团队自动分配（在线且最闲优先），主管可强制改派；群客服支持认领 / 释放 / 改派；新增仅对内可见的客户备注与团队话术库。转接自带上下文简报，接手的同事不必从头翻记录。
- 富交互消息：机器人与坐席可发送快捷回复按钮组与信息卡片，客户点选即以本人身份进入正常对话流并结构化留痕；Web 与 Flutter UIKit 均已内置渲染，不认识新类型的旧客户端自动降级为纯文本。
- 热路径性能优化：消息负载单次解析、编解码器复用、群与房间扇出减少临时分配，高并发下 CPU 与内存开销下降，行为无变化。
- 随客户端套件(SDK 1.11.1 / Flutter UIKit 二期)同步发版;服务端无行为变更。
- chat-studio 演示追加:微信式消息时间分隔条(≥5 分钟才显示,气泡不再逐条带时间)、更紧凑的自适应输入框。(客户端套件同版发布 SDK 1.11.0 与 Flutter UIKit,详见 SDK 轨。)
- chat-studio 演示视觉升级:中性微信风皮肤 + 品牌 teal、确定性首字头像、消息气泡头像列 + AI 流式光标、微信式人性化时间、微动效(遵守 reduced-motion)、product-mode 首屏品牌化。(客户端套件同版首发 Web UIKit,详见 SDK 轨。)
- 消息体限额治理：入站请求统一闸门（websocket.max_request_bytes，默认 256KB）——超限返回新错误码 1011 Message too large（此前是断连或静默入库）且不消耗频控预算；消息段 26 个字符串字段通用字节预算（URL/路径类 4096、名称/ID 类 1024，错误信息带字段名）；新增 imcore_msg_oversize_total 指标、/stat 字段与 Prometheus 告警规则；双语限额总表 docs/LIMITS.md 收口全部限额与超限行为。
- Kubernetes umbrella chart：Helm 部署可选捆绑 PostgreSQL / Redis / RabbitMQ / MinIO 子 chart（values-bundled.yaml 一键拉起全栈），并编排数据库迁移 Job；chart appVersion 即默认镜像 tag。
- 部署体验补丁：发行包新增 demo_token（一条命令生成测试 JWT，配合快速开始的连通验证）；配置模板默认数据库改为 PostgreSQL，database.driver 开关说明补全（migrate 与服务端同读一个开关）；修复 MySQL 部署路径——ai_tools 建表语句在 MySQL 8 无法应用、融云建库脚本误入迁移目录导致 bin/migrate 中断、运营趋势 DATE 列时区偏移；CI 新增 MySQL 集成测试作业，双数据库持续兜底。
- 消息扩展 Key/Value：为单条消息附加可增改删的 KV 扩展（chat_{dm,group,room}_expand），投票、接龙、问卷、任务状态的通用底座。u:<userID>: 私有前缀仅本人可写删（防篡改），公共 key 仅消息发送者；每 key last-write-wins，服务端逐消息串行化防并发丢写；实时广播 + 多端同步 + 离线历史回源，零 DDL。
- Typed @提及目标：@用户 / @角色 / @here / @all 结构化提及（服务端解析与鉴权），配套按提及级别的推送偏好。
- 群维度个人推送级别：每用户每群可设 all / mentions / direct / none，离线推送按级别过滤。
- 群成员标记：群主/管理员可为成员设置仅工作人员可见的标记（客服场景的客户备注）。
- 连接注册表锁分片：ClientManager 连接集与在线索引分片化（默认 32 片，2 的幂），高并发下消除全局锁竞争。
- 正确性修复：会话摘要以权威未读列覆盖（防漂移）· 房间 mark-read 全区间补发已读回执 · OpenAPI 入站接口不再向调用方泄露原始数据库错误文本。
- 会话体验三件套（服务端 + 四端 SDK）：手动标记未读（每会话、多端同步、真读自动清除）· 草稿跨端同步（last-write-wins）· 定时免打扰/静默时段（配置时段内抑制离线推送）。四端（JS/TS、Dart、Swift、Kotlin）提供 typed 封装 operations.markUnread、drafts.set/clear、push.getDnd/setDnd。
- 独立 consumer 观测：persist consumer 可选开放 /metrics 与 /healthz·/livez·/readyz。
- 凭证卫生：CI 新增被跟踪文件密钥扫描。
- 完整服务端 OpenAPI 3.1 契约：所有面向客户的 HTTP 路由均被描述，经 /openapi.{yaml,json} 提供，并在 CI 中防漂移。
- WebSocket 命令全部 SDK 化：最后 25 个命令进入协议目录；四端 SDK 新增 operations API。
- 官网依赖安全升级：Astro 升级越过已报 npm 告警，静态构建保持通过。
- 四端弱网恢复：建连超时、无入站流量连接退役、带抖动的指数重连退避。
- 双向历史分页：historyPage() 支持 before/after/seq 游标；原数组返回的 history() 保持兼容。
- 生产级健康探针：仅查进程的 /livez 与依赖感知的 /readyz（Redis / 数据库 / 消息代理），并保留 /healthz。
- 对象存储（S3 兼容 + 内置 MinIO）。
- SDK relations helper。
- 多人通话上限。
- 移动端语音消息。
- 位置与名片消息。
- 移动端 H5 聊天与扫码 Demo。
- 只读在线 Demo（含 RAG 助手）。
- 首个正式版本——免费基础版、Docker Compose 一键启动、Docker Hub 与阿里云双镜像，amd64 / arm64 / loong64 三架构二进制与离线镜像包。
- /openapi/v1 入站推送 API。
- 企业通讯录。
- 内置中文敏感词词库。
- 基础版连接数上限提至 1,000。
- 文档与打包：SDK 文档与中英双语的产品 / 安全 / 解决方案页面；统一为 4 个可售版本（基础 / 专业 / 企业 / 客服），由单一事实源生成。
- 服务端 v1.17.0：加入认证会话持久化与管理员撤销、消息 envelope 与组合详情读取、社区频道治理、推送策略、运行时配置审计和可观测性；AI 流支持取消、持久化最终 envelope 与受授权的大回复对象交付，并完成消息大小治理和多数据库迁移验证。
- 数据治理覆盖消息全生命周期：可按会话或群设置保留策略，过期消息支持归档、恢复与安全删除；完整数据导出、注销匿名化、Legal Hold、审计完整性校验和备份恢复演练进入统一管理闭环。
- 客户端 SDK 1.13.0 发布并开放版本化下载，新增 React Native 与微信小程序适配；服务端能力与 1.15.0 保持兼容。
- 坐席协作能力进入全部版本：坐席可把客户转交给指定同事，或按团队自动分配（在线且最闲优先），主管可强制改派；群客服支持认领 / 释放 / 改派；新增仅对内可见的客户备注与团队话术库。转接自带上下文简报，接手的同事不必从头翻记录。
- 富交互消息：机器人与坐席可发送快捷回复按钮组与信息卡片，客户点选即以本人身份进入正常对话流并结构化留痕；Web 与 Flutter UIKit 均已内置渲染，不认识新类型的旧客户端自动降级为纯文本。
- 热路径性能优化：消息负载单次解析、编解码器复用、群与房间扇出减少临时分配，高并发下 CPU 与内存开销下降，行为无变化。
- 随客户端套件(SDK 1.11.1 / Flutter UIKit 二期)同步发版;服务端无行为变更。
- chat-studio 演示追加:微信式消息时间分隔条(≥5 分钟才显示,气泡不再逐条带时间)、更紧凑的自适应输入框。(客户端套件同版发布 SDK 1.11.0 与 Flutter UIKit,详见 SDK 轨。)
- chat-studio 演示视觉升级:中性微信风皮肤 + 品牌 teal、确定性首字头像、消息气泡头像列 + AI 流式光标、微信式人性化时间、微动效(遵守 reduced-motion)、product-mode 首屏品牌化。(客户端套件同版首发 Web UIKit,详见 SDK 轨。)
- 消息体限额治理：入站请求统一闸门（websocket.max_request_bytes，默认 256KB）——超限返回新错误码 1011 Message too large（此前是断连或静默入库）且不消耗频控预算；消息段 26 个字符串字段通用字节预算（URL/路径类 4096、名称/ID 类 1024，错误信息带字段名）；新增 imcore_msg_oversize_total 指标、/stat 字段与 Prometheus 告警规则；双语限额总表 docs/LIMITS.md 收口全部限额与超限行为。
- Kubernetes umbrella chart：Helm 部署可选捆绑 PostgreSQL / Redis / RabbitMQ / MinIO 子 chart（values-bundled.yaml 一键拉起全栈），并编排数据库迁移 Job；chart appVersion 即默认镜像 tag。
- 部署体验补丁：发行包新增 demo_token（一条命令生成测试 JWT，配合快速开始的连通验证）；配置模板默认数据库改为 PostgreSQL，database.driver 开关说明补全（migrate 与服务端同读一个开关）；修复 MySQL 部署路径——ai_tools 建表语句在 MySQL 8 无法应用、融云建库脚本误入迁移目录导致 bin/migrate 中断、运营趋势 DATE 列时区偏移；CI 新增 MySQL 集成测试作业，双数据库持续兜底。
- 消息扩展 Key/Value：为单条消息附加可增改删的 KV 扩展（chat_{dm,group,room}_expand），投票、接龙、问卷、任务状态的通用底座。u:<userID>: 私有前缀仅本人可写删（防篡改），公共 key 仅消息发送者；每 key last-write-wins，服务端逐消息串行化防并发丢写；实时广播 + 多端同步 + 离线历史回源，零 DDL。
- Typed @提及目标：@用户 / @角色 / @here / @all 结构化提及（服务端解析与鉴权），配套按提及级别的推送偏好。
- 群维度个人推送级别：每用户每群可设 all / mentions / direct / none，离线推送按级别过滤。
- 群成员标记：群主/管理员可为成员设置仅工作人员可见的标记（客服场景的客户备注）。
- 连接注册表锁分片：ClientManager 连接集与在线索引分片化（默认 32 片，2 的幂），高并发下消除全局锁竞争。
- 正确性修复：会话摘要以权威未读列覆盖（防漂移）· 房间 mark-read 全区间补发已读回执 · OpenAPI 入站接口不再向调用方泄露原始数据库错误文本。
- 会话体验三件套（服务端 + 四端 SDK）：手动标记未读（每会话、多端同步、真读自动清除）· 草稿跨端同步（last-write-wins）· 定时免打扰/静默时段（配置时段内抑制离线推送）。四端（JS/TS、Dart、Swift、Kotlin）提供 typed 封装 operations.markUnread、drafts.set/clear、push.getDnd/setDnd。
- 独立 consumer 观测：persist consumer 可选开放 /metrics 与 /healthz·/livez·/readyz。
- 数据治理控制面（企业版）：数据清单、访问/导出/删除案件、法律保留、保留清理预览/执行，以及独立的 governance:read / governance:write 权限。
- 默认失败关闭：删除与保留清理默认关闭，须显式配置方可执行；尊重有效法律保留，并持久记录运行证据。
- 治理 OpenAPI 与运行手册：11 个类型化接口，附映射到个保法/GDPR 的双语法律审查指南（不作认证承诺）。
- 凭证卫生：CI 新增被跟踪文件密钥扫描。
- 完整服务端 OpenAPI 3.1 契约：所有面向客户的 HTTP 路由均被描述，经 /openapi.{yaml,json} 提供，并在 CI 中防漂移。
- WebSocket 命令全部 SDK 化：最后 25 个命令进入协议目录；四端 SDK 新增 operations API。
- 官网依赖安全升级：Astro 升级越过已报 npm 告警，静态构建保持通过。
- 四端弱网恢复：建连超时、无入站流量连接退役、带抖动的指数重连退避。
- 双向历史分页：historyPage() 支持 before/after/seq 游标；原数组返回的 history() 保持兼容。
- 生产级健康探针：仅查进程的 /livez 与依赖感知的 /readyz（Redis / 数据库 / 消息代理），并保留 /healthz。
- 对象存储（S3 兼容 + 内置 MinIO）。
- SDK relations helper。
- 多人通话上限。
- 移动端语音消息。
- 位置与名片消息。
- 移动端 H5 聊天与扫码 Demo。
- 只读在线 Demo（含 RAG 助手）。
- 首个正式版本——免费基础版、Docker Compose 一键启动、Docker Hub 与阿里云双镜像，amd64 / arm64 / loong64 三架构二进制与离线镜像包。
- /openapi/v1 入站推送 API。
- 企业通讯录。
- 内置中文敏感词词库。
- 基础版连接数上限提至 1,000。
- 文档与打包：SDK 文档与中英双语的产品 / 安全 / 解决方案页面；统一为 4 个可售版本（基础 / 专业 / 企业 / 客服），由单一事实源生成。
- 社区（超级群 + 频道）。
- 服务端 v1.17.0：加入认证会话持久化与管理员撤销、消息 envelope 与组合详情读取、社区频道治理、推送策略、运行时配置审计和可观测性；AI 流支持取消、持久化最终 envelope 与受授权的大回复对象交付，并完成消息大小治理和多数据库迁移验证。
- 客服版完成运营闭环升级：统一客服会话、工单、全渠道接入、智能路由、客户 360、AI 知识质量与经营报表，网站客服组件也可与宿主业务深度联动。
- 客服管理后台新增会话中心、实时运营、客户 360、全渠道与统计报表；可按业务线配置营业时间、离线接待、路由方式和首响 SLA，邮件渠道已支持统一收发，团队话术支持审核发布、版本回溯与效果分析。
- 智能路由可同时匹配坐席的接待状态、技能、语言、班次与并发容量，主团队繁忙时按顺序进入溢出团队；转接、主管改派和自动分配遵循同一套可用性规则，运营人员可实时查看排队等待与坐席负载。
- 新增完整工单流程：客服会话可一键转为工单，按优先级、分类、责任人和状态推进，分别跟踪首响与解决 SLA；工单可关联多次会话、订单及其他业务对象，解决或关闭时沉淀标准解决结果。
- AI 知识质量形成持续改进闭环：低置信回答可选择继续回答、礼貌拒答或转人工，并可向客户展示来源；真实无命中问题自动进入审查队列，运营人员可纠正答案、管理机器人版本与评测集，并用评分验证上线效果。
- 网站客服组件新增宿主集成能力：业务页面可控制组件打开、隐藏与销毁，传入访客资料和当前页面上下文，并监听连接、消息、未读数与转人工状态；管理后台同时提供标准安装和高级集成示例。
- 数据治理覆盖消息全生命周期：可按会话或群设置保留策略，过期消息支持归档、恢复与安全删除；完整数据导出、注销匿名化、Legal Hold、审计完整性校验和备份恢复演练进入统一管理闭环。
- 客户端 SDK 1.13.0 发布并开放版本化下载，新增 React Native 与微信小程序适配；服务端能力与 1.15.0 保持兼容。
- AI 客服子系统（AI 机器人、知识库检索、人机切换、通话分析）现在 NATS JetStream 下同样可用，不再仅限 RabbitMQ；内嵌单二进制模式也已打通，最小部署无需外接消息中间件。已有 NATS 部署升级需一次人工步骤，见备份恢复运行手册。
- 服务过程可度量：每次服务自动划分会话边界并生成 AI 小结，记录时长、消息数与首次响应时间，人工会话与群客服会话同样适用；管理后台新增通话后 AI 质检页，回看通话分析与质量评分。
- 客户满意度评价：会话结束后自动发送评分卡，客户一键打分；管理后台提供满意度明细复盘、内部标注与催评，运营趋势同步展示问卷发送量、回收率与满意率。默认关闭，需显式开启。
- AI 长期记忆升级：客户档案字段可按业务自定义，模型自动抽取、运营手工修正优先，并与跨会话摘要、长尾事实召回一同进入对话。AI 转人工时自动生成交接简报（只推给坐席），人工的处置结论也会回写进该客户的长期记忆。客户档案与滚动摘要现已支持 MySQL 部署。
- 坐席协作能力进入全部版本：坐席可把客户转交给指定同事，或按团队自动分配（在线且最闲优先），主管可强制改派；群客服支持认领 / 释放 / 改派；新增仅对内可见的客户备注与团队话术库。转接自带上下文简报，接手的同事不必从头翻记录。
- 富交互消息：机器人与坐席可发送快捷回复按钮组与信息卡片，客户点选即以本人身份进入正常对话流并结构化留痕；Web 与 Flutter UIKit 均已内置渲染，不认识新类型的旧客户端自动降级为纯文本。
- 热路径性能优化：消息负载单次解析、编解码器复用、群与房间扇出减少临时分配，高并发下 CPU 与内存开销下降，行为无变化。
- 官网 Demo 新增访客侧客服入口：页面右下角客服气泡，默认与 AI 客服对话，一键转人工后进入坐席队列，可与坐席工作台配对演示完整流程。默认关闭。
- 客服作业面完整上线：独立坐席工作台（企业 SSO 登录、仅启用坐席可进）、实时服务队列、首响 SLA 倒计时、会话历史与当日统计；IM 管理后台新增“客服与 AI 客服管理”，统一维护坐席、团队、客服群与话术，并复用管理员权限与审计。
- 随客户端套件(SDK 1.11.1 / Flutter UIKit 二期)同步发版;服务端无行为变更。
- chat-studio 演示追加:微信式消息时间分隔条(≥5 分钟才显示,气泡不再逐条带时间)、更紧凑的自适应输入框。(客户端套件同版发布 SDK 1.11.0 与 Flutter UIKit,详见 SDK 轨。)
- chat-studio 演示视觉升级:中性微信风皮肤 + 品牌 teal、确定性首字头像、消息气泡头像列 + AI 流式光标、微信式人性化时间、微动效(遵守 reduced-motion)、product-mode 首屏品牌化。(客户端套件同版首发 Web UIKit,详见 SDK 轨。)
- 消息体限额治理：入站请求统一闸门（websocket.max_request_bytes，默认 256KB）——超限返回新错误码 1011 Message too large（此前是断连或静默入库）且不消耗频控预算；消息段 26 个字符串字段通用字节预算（URL/路径类 4096、名称/ID 类 1024，错误信息带字段名）；新增 imcore_msg_oversize_total 指标、/stat 字段与 Prometheus 告警规则；双语限额总表 docs/LIMITS.md 收口全部限额与超限行为。
- Kubernetes umbrella chart：Helm 部署可选捆绑 PostgreSQL / Redis / RabbitMQ / MinIO 子 chart（values-bundled.yaml 一键拉起全栈），并编排数据库迁移 Job；chart appVersion 即默认镜像 tag。
- 部署体验补丁：发行包新增 demo_token（一条命令生成测试 JWT，配合快速开始的连通验证）；配置模板默认数据库改为 PostgreSQL，database.driver 开关说明补全（migrate 与服务端同读一个开关）；修复 MySQL 部署路径——ai_tools 建表语句在 MySQL 8 无法应用、融云建库脚本误入迁移目录导致 bin/migrate 中断、运营趋势 DATE 列时区偏移；CI 新增 MySQL 集成测试作业，双数据库持续兜底。
- 消息扩展 Key/Value：为单条消息附加可增改删的 KV 扩展（chat_{dm,group,room}_expand），投票、接龙、问卷、任务状态的通用底座。u:<userID>: 私有前缀仅本人可写删（防篡改），公共 key 仅消息发送者；每 key last-write-wins，服务端逐消息串行化防并发丢写；实时广播 + 多端同步 + 离线历史回源，零 DDL。
- Typed @提及目标：@用户 / @角色 / @here / @all 结构化提及（服务端解析与鉴权），配套按提及级别的推送偏好。
- 群维度个人推送级别：每用户每群可设 all / mentions / direct / none，离线推送按级别过滤。
- 群成员标记：群主/管理员可为成员设置仅工作人员可见的标记（客服场景的客户备注）。
- 连接注册表锁分片：ClientManager 连接集与在线索引分片化（默认 32 片，2 的幂），高并发下消除全局锁竞争。
- 正确性修复：会话摘要以权威未读列覆盖（防漂移）· 房间 mark-read 全区间补发已读回执 · OpenAPI 入站接口不再向调用方泄露原始数据库错误文本。
- 会话体验三件套（服务端 + 四端 SDK）：手动标记未读（每会话、多端同步、真读自动清除）· 草稿跨端同步（last-write-wins）· 定时免打扰/静默时段（配置时段内抑制离线推送）。四端（JS/TS、Dart、Swift、Kotlin）提供 typed 封装 operations.markUnread、drafts.set/clear、push.getDnd/setDnd。
- 独立 consumer 观测：persist consumer 可选开放 /metrics 与 /healthz·/livez·/readyz。
- 凭证卫生：CI 新增被跟踪文件密钥扫描。
- 完整服务端 OpenAPI 3.1 契约：所有面向客户的 HTTP 路由均被描述，经 /openapi.{yaml,json} 提供，并在 CI 中防漂移。
- WebSocket 命令全部 SDK 化：最后 25 个命令进入协议目录；四端 SDK 新增 operations API。
- 官网依赖安全升级：Astro 升级越过已报 npm 告警，静态构建保持通过。
- 四端弱网恢复：建连超时、无入站流量连接退役、带抖动的指数重连退避。
- 双向历史分页：historyPage() 支持 before/after/seq 游标；原数组返回的 history() 保持兼容。
- 生产级健康探针：仅查进程的 /livez 与依赖感知的 /readyz（Redis / 数据库 / 消息代理），并保留 /healthz。
- 对象存储（S3 兼容 + 内置 MinIO）。
- AI 通话后分析（客服版）。
- SDK ai 流式。
- SDK relations helper。
- 多人通话上限。
- 移动端语音消息。
- 位置与名片消息。
- 移动端 H5 聊天与扫码 Demo。
- 只读在线 Demo（含 RAG 助手）。
- 首个正式版本——免费基础版、Docker Compose 一键启动、Docker Hub 与阿里云双镜像，amd64 / arm64 / loong64 三架构二进制与离线镜像包。
- /openapi/v1 入站推送 API。
- 企业通讯录。
- 内置中文敏感词词库。
- 基础版连接数上限提至 1,000。
- 文档与打包：SDK 文档与中英双语的产品 / 安全 / 解决方案页面；统一为 4 个可售版本（基础 / 专业 / 企业 / 客服），由单一事实源生成。
客户端 SDK
按平台查看四端 SDK 的更新记录。
- 四端 SDK 与 UIKit 升级：新增消息 envelope/组合消息类型、服务端消息限额动态刷新、认证撤销后的重认证状态与离线队列保护，并补齐社区治理、AI 流取消和大回复对象引用能力；Web 与 Flutter UIKit 同步更新会话列表和消息流的一致性处理。
- 四端 SDK 新增类型化客服工作台 API，覆盖工作台启动、客户转接、客户档案、内部备注、群客服认领，以及路由变化通知，可直接用于构建自定义坐席端。
- JavaScript / TypeScript SDK 新增 React Native 与微信小程序平台入口。React Native 适配 AsyncStorage、AppState、NetInfo 与移动端 WebSocket；微信小程序适配 SocketTask、异步存储、前后台与网络重连，以及 wx.uploadFile。两个入口均包含在同一份版本化 JS SDK 安装包中。
- 新增 PC / Electron 适配层：IM 连接、JWT、缓存、离线队列和媒体上传留在主进程；preload 仅暴露受限 transport，renderer 继续使用完整 typed API。双入口隔离 Node 文件能力，IPC 校验来源窗口与协议命令，并提供 userData 原子文件存储。
- 四端 SDK 新增客服作业协议：工作台启动信息、服务队列、会话历史与统计，以及群客服认领 / 释放 / 改派与路由变更通知，可直接接入自定义坐席界面。新增交互消息回答接口（Web 与 Dart 提供 typed 封装），Web 与 Flutter UIKit 内置快捷回复按钮渲染与已答状态同步。
- Flutter UIKit 二期——生产可用:历史分页(上滑加载更早消息,进入会话稳定落底)、已读上报(进入会话/新消息/回到前台自动清未读,含会话列表本地清零接线)、乐观发送与失败重试(消息即时上屏,失败可重发/删除)、多媒体消息渲染(图片含全屏查看器,视频/语音/文件卡片经 onOpenMedia 交宿主)、撤回/编辑/删除/表情回应实时同步与长按操作菜单(按权限与消息状态显隐)、暗色主题(ImcoreTheme.dark(),值集即双端主题规范)。修复:四端 SDK(TS/Kotlin/Swift/Dart)媒体上传路径纠正为 /user/chat/upload(此前对服务端恒 404)。已知限制:Flutter Web 上图片加载受浏览器 CORS 限制,移动端与桌面端不受影响。
- Flutter UIKit 组件库 imcore_uikit(首期):与 Web 版同一套组件契约与主题令牌——ImcoreScope/会话列表/消息流/输入框/连接状态横幅 + headless 控制器(可自绘 UI),基于 imcore_sdk(兄弟目录 path 依赖),内置 example 应用,所有 edition 均含,发布产物 imcore-uikit-dart-<ver>.tar.gz。Dart ChatMessage.messageId 类型由 int? 改为 String?(服务端消息 ID 为 UUIDv7 字符串,旧类型解析必崩——Dart 源码级不兼容变更);Web UIKit 三处修复(历史加载与在途推送合并不丢消息、发送失败不覆盖新输入的草稿、认证完成后自动重拉会话与历史)。
- Web UIKit 组件库 @imcore/uikit(首发):基于 @imcore/sdk 的 React 聊天 UI——会话列表 / 消息流 / 输入框 / 连接状态横幅,开箱即用,所有 edition 均含;主题走 CSS 变量(--imcore-* 及与 chat-studio 共用的 --bubble-* 令牌),另有 headless hooks(useConnectionState/useConversations/useMessages)供自建 UI。
- 客户端 SDK 1.10.0：四端新增 maxRequestBytes 发送前自检（默认 262144，<=0 关闭）——超限请求本地即返 RequestError 1011（message 含 local precheck 与实际字节数），不产生网络请求、不留挂起项；错误码常量组（ErrorCodes 等，含 1011）由 clients/protocol.yaml 统一生成，四端可程序化识别服务端错误。
- 客户端 SDK 1.9.0：四端新增群成员禁言/踢人 typed 封装（group.muteMember / group.kickMember）；新增 chat_{dm,group,room}_expand（消息扩展）、typed @提及、群推送级别、成员标记命令常量与 API 参考。
- 客户端 SDK 1.5.0：群治理（muteAll、角色、转让、解散、入群申请、历史策略）与定向可见 group.send。
- 客户端 SDK 1.4.0：实时信令（RTC）—— 四端 typed 封装（仅信令；媒体/peer connection 由你的 App 持有）。
- 客户端 SDK 1.3.0：消息生命周期（编辑 / 撤回 / 删除、typing、已读回执）与四端企业目录；SDK 版本与服务端解耦。
- 四端 SDK 版本化下载。
- 四个官方类型化 SDK：JavaScript/TypeScript、Dart/Flutter、Swift/iOS、Kotlin/Android（v1）。
- 四端 SDK 与 UIKit 升级：新增消息 envelope/组合消息类型、服务端消息限额动态刷新、认证撤销后的重认证状态与离线队列保护，并补齐社区治理、AI 流取消和大回复对象引用能力；Web 与 Flutter UIKit 同步更新会话列表和消息流的一致性处理。
- 四端 SDK 新增类型化客服工作台 API，覆盖工作台启动、客户转接、客户档案、内部备注、群客服认领，以及路由变化通知，可直接用于构建自定义坐席端。
- 四端 SDK 新增客服作业协议：工作台启动信息、服务队列、会话历史与统计，以及群客服认领 / 释放 / 改派与路由变更通知，可直接接入自定义坐席界面。新增交互消息回答接口（Web 与 Dart 提供 typed 封装），Web 与 Flutter UIKit 内置快捷回复按钮渲染与已答状态同步。
- Flutter UIKit 二期——生产可用:历史分页(上滑加载更早消息,进入会话稳定落底)、已读上报(进入会话/新消息/回到前台自动清未读,含会话列表本地清零接线)、乐观发送与失败重试(消息即时上屏,失败可重发/删除)、多媒体消息渲染(图片含全屏查看器,视频/语音/文件卡片经 onOpenMedia 交宿主)、撤回/编辑/删除/表情回应实时同步与长按操作菜单(按权限与消息状态显隐)、暗色主题(ImcoreTheme.dark(),值集即双端主题规范)。修复:四端 SDK(TS/Kotlin/Swift/Dart)媒体上传路径纠正为 /user/chat/upload(此前对服务端恒 404)。已知限制:Flutter Web 上图片加载受浏览器 CORS 限制,移动端与桌面端不受影响。
- Flutter UIKit 组件库 imcore_uikit(首期):与 Web 版同一套组件契约与主题令牌——ImcoreScope/会话列表/消息流/输入框/连接状态横幅 + headless 控制器(可自绘 UI),基于 imcore_sdk(兄弟目录 path 依赖),内置 example 应用,所有 edition 均含,发布产物 imcore-uikit-dart-<ver>.tar.gz。Dart ChatMessage.messageId 类型由 int? 改为 String?(服务端消息 ID 为 UUIDv7 字符串,旧类型解析必崩——Dart 源码级不兼容变更);Web UIKit 三处修复(历史加载与在途推送合并不丢消息、发送失败不覆盖新输入的草稿、认证完成后自动重拉会话与历史)。
- 客户端 SDK 1.10.0：四端新增 maxRequestBytes 发送前自检（默认 262144，<=0 关闭）——超限请求本地即返 RequestError 1011（message 含 local precheck 与实际字节数），不产生网络请求、不留挂起项；错误码常量组（ErrorCodes 等，含 1011）由 clients/protocol.yaml 统一生成，四端可程序化识别服务端错误。
- 客户端 SDK 1.9.0：四端新增群成员禁言/踢人 typed 封装（group.muteMember / group.kickMember）；新增 chat_{dm,group,room}_expand（消息扩展）、typed @提及、群推送级别、成员标记命令常量与 API 参考。
- 客户端 SDK 1.5.0：群治理（muteAll、角色、转让、解散、入群申请、历史策略）与定向可见 group.send。
- 客户端 SDK 1.4.0：实时信令（RTC）—— 四端 typed 封装（仅信令；媒体/peer connection 由你的 App 持有）。
- 客户端 SDK 1.3.0：消息生命周期（编辑 / 撤回 / 删除、typing、已读回执）与四端企业目录；SDK 版本与服务端解耦。
- 四端 SDK 版本化下载。
- 四个官方类型化 SDK：JavaScript/TypeScript、Dart/Flutter、Swift/iOS、Kotlin/Android（v1）。
- 四端 SDK 与 UIKit 升级：新增消息 envelope/组合消息类型、服务端消息限额动态刷新、认证撤销后的重认证状态与离线队列保护，并补齐社区治理、AI 流取消和大回复对象引用能力；Web 与 Flutter UIKit 同步更新会话列表和消息流的一致性处理。
- 四端 SDK 新增类型化客服工作台 API，覆盖工作台启动、客户转接、客户档案、内部备注、群客服认领，以及路由变化通知，可直接用于构建自定义坐席端。
- 四端 SDK 新增客服作业协议：工作台启动信息、服务队列、会话历史与统计，以及群客服认领 / 释放 / 改派与路由变更通知，可直接接入自定义坐席界面。新增交互消息回答接口（Web 与 Dart 提供 typed 封装），Web 与 Flutter UIKit 内置快捷回复按钮渲染与已答状态同步。
- Flutter UIKit 二期——生产可用:历史分页(上滑加载更早消息,进入会话稳定落底)、已读上报(进入会话/新消息/回到前台自动清未读,含会话列表本地清零接线)、乐观发送与失败重试(消息即时上屏,失败可重发/删除)、多媒体消息渲染(图片含全屏查看器,视频/语音/文件卡片经 onOpenMedia 交宿主)、撤回/编辑/删除/表情回应实时同步与长按操作菜单(按权限与消息状态显隐)、暗色主题(ImcoreTheme.dark(),值集即双端主题规范)。修复:四端 SDK(TS/Kotlin/Swift/Dart)媒体上传路径纠正为 /user/chat/upload(此前对服务端恒 404)。已知限制:Flutter Web 上图片加载受浏览器 CORS 限制,移动端与桌面端不受影响。
- Flutter UIKit 组件库 imcore_uikit(首期):与 Web 版同一套组件契约与主题令牌——ImcoreScope/会话列表/消息流/输入框/连接状态横幅 + headless 控制器(可自绘 UI),基于 imcore_sdk(兄弟目录 path 依赖),内置 example 应用,所有 edition 均含,发布产物 imcore-uikit-dart-<ver>.tar.gz。Dart ChatMessage.messageId 类型由 int? 改为 String?(服务端消息 ID 为 UUIDv7 字符串,旧类型解析必崩——Dart 源码级不兼容变更);Web UIKit 三处修复(历史加载与在途推送合并不丢消息、发送失败不覆盖新输入的草稿、认证完成后自动重拉会话与历史)。
- 客户端 SDK 1.10.0：四端新增 maxRequestBytes 发送前自检（默认 262144，<=0 关闭）——超限请求本地即返 RequestError 1011（message 含 local precheck 与实际字节数），不产生网络请求、不留挂起项；错误码常量组（ErrorCodes 等，含 1011）由 clients/protocol.yaml 统一生成，四端可程序化识别服务端错误。
- Swift SDK 破坏性变更：ImcoreClient.send(_:_:) 由 async -> Int 改为 async throws -> Int（发送前自检需要抛错，Swift 的 checked-error 模型无法不改签名）；现有调用方需加 try。SDK 尚未上架包管理器，趁首发前窗口落地。
- 客户端 SDK 1.9.0：四端新增群成员禁言/踢人 typed 封装（group.muteMember / group.kickMember）；新增 chat_{dm,group,room}_expand（消息扩展）、typed @提及、群推送级别、成员标记命令常量与 API 参考。
- 客户端 SDK 1.5.0：群治理（muteAll、角色、转让、解散、入群申请、历史策略）与定向可见 group.send。
- 客户端 SDK 1.4.0：实时信令（RTC）—— 四端 typed 封装（仅信令；媒体/peer connection 由你的 App 持有）。
- 客户端 SDK 1.3.0：消息生命周期（编辑 / 撤回 / 删除、typing、已读回执）与四端企业目录；SDK 版本与服务端解耦。
- 四端 SDK 版本化下载。
- 四个官方类型化 SDK：JavaScript/TypeScript、Dart/Flutter、Swift/iOS、Kotlin/Android（v1）。
- 四端 SDK 与 UIKit 升级：新增消息 envelope/组合消息类型、服务端消息限额动态刷新、认证撤销后的重认证状态与离线队列保护，并补齐社区治理、AI 流取消和大回复对象引用能力；Web 与 Flutter UIKit 同步更新会话列表和消息流的一致性处理。
- 四端 SDK 新增类型化客服工作台 API，覆盖工作台启动、客户转接、客户档案、内部备注、群客服认领，以及路由变化通知，可直接用于构建自定义坐席端。
- 四端 SDK 新增客服作业协议：工作台启动信息、服务队列、会话历史与统计，以及群客服认领 / 释放 / 改派与路由变更通知，可直接接入自定义坐席界面。新增交互消息回答接口（Web 与 Dart 提供 typed 封装），Web 与 Flutter UIKit 内置快捷回复按钮渲染与已答状态同步。
- Flutter UIKit 二期——生产可用:历史分页(上滑加载更早消息,进入会话稳定落底)、已读上报(进入会话/新消息/回到前台自动清未读,含会话列表本地清零接线)、乐观发送与失败重试(消息即时上屏,失败可重发/删除)、多媒体消息渲染(图片含全屏查看器,视频/语音/文件卡片经 onOpenMedia 交宿主)、撤回/编辑/删除/表情回应实时同步与长按操作菜单(按权限与消息状态显隐)、暗色主题(ImcoreTheme.dark(),值集即双端主题规范)。修复:四端 SDK(TS/Kotlin/Swift/Dart)媒体上传路径纠正为 /user/chat/upload(此前对服务端恒 404)。已知限制:Flutter Web 上图片加载受浏览器 CORS 限制,移动端与桌面端不受影响。
- Flutter UIKit 组件库 imcore_uikit(首期):与 Web 版同一套组件契约与主题令牌——ImcoreScope/会话列表/消息流/输入框/连接状态横幅 + headless 控制器(可自绘 UI),基于 imcore_sdk(兄弟目录 path 依赖),内置 example 应用,所有 edition 均含,发布产物 imcore-uikit-dart-<ver>.tar.gz。Dart ChatMessage.messageId 类型由 int? 改为 String?(服务端消息 ID 为 UUIDv7 字符串,旧类型解析必崩——Dart 源码级不兼容变更);Web UIKit 三处修复(历史加载与在途推送合并不丢消息、发送失败不覆盖新输入的草稿、认证完成后自动重拉会话与历史)。
- 客户端 SDK 1.10.0：四端新增 maxRequestBytes 发送前自检（默认 262144，<=0 关闭）——超限请求本地即返 RequestError 1011（message 含 local precheck 与实际字节数），不产生网络请求、不留挂起项；错误码常量组（ErrorCodes 等，含 1011）由 clients/protocol.yaml 统一生成，四端可程序化识别服务端错误。
- 客户端 SDK 1.9.0：四端新增群成员禁言/踢人 typed 封装（group.muteMember / group.kickMember）；新增 chat_{dm,group,room}_expand（消息扩展）、typed @提及、群推送级别、成员标记命令常量与 API 参考。
- Kotlin SDK：共享 OkHttp 客户端弱网加固（显式 connectTimeout / pingInterval；fastFallback 待 OkHttp 5）。
- 客户端 SDK 1.5.0：群治理（muteAll、角色、转让、解散、入群申请、历史策略）与定向可见 group.send。
- 客户端 SDK 1.4.0：实时信令（RTC）—— 四端 typed 封装（仅信令；媒体/peer connection 由你的 App 持有）。
- 客户端 SDK 1.3.0：消息生命周期（编辑 / 撤回 / 删除、typing、已读回执）与四端企业目录；SDK 版本与服务端解耦。
- 四端 SDK 版本化下载。
- 四个官方类型化 SDK：JavaScript/TypeScript、Dart/Flutter、Swift/iOS、Kotlin/Android（v1）。