历史版本归档

更新内容

• 半开 WebSocket 检测（核心修复）：v1.2.4 仅做了「客户端发 ping」却没校验 server 是否回 pong。当底层 TCP 已断但 onclose 未触发时，client 完全感知不到，导致服务端→访客的消息默默丢失最长 75 秒。v1.2.5 客户端记录 lastPongAt，60 秒未收到 pong 主动 ws.close(4001, 'pong-timeout') 触发重连，最坏情况 60 秒内必定恢复。
• wsFlushOutbox 中途失败丢消息：v1.2.4 实现下若离线队列 [m1, m2, m3, m4] 在发送 m2 时抛异常，m3 / m4 永久丢失（被 splice 走但未退回）。现改为把当前及之后所有未发的消息整体退回队列前端。
• 消息 ack/echo 双重兜底：v1.2.4 ack 来了就清 8s 发送 timer，若服务端 ack 后但 echo 因半开 ws 丢失，pending 永远不变。v1.2.5 改为：清 8s timer 后启动 12s「echo 兜底 timer」，到时仍未收到 echo 则触发 reconcile（admin 端）或标失败（widget 端）。
• 服务端 clientMsgId 幂等去重：30 秒内同一发送方同 cid 重复请求只持久化与广播一次。修复重发场景下数据库出现两条相同消息、对端收到两次的问题。
• 重连后历史校对（admin 端）：重连成功立即调用 /api/v1/sessions/{id}/messages 比对所有 pending 项的 client_msg_id，存在则替换为已确认状态，缺失则保留 pending 由 timer 兜底。
• 客户端 ping 间隔 25s → 20s，配合 60s pong 超时，更快发现半开。
• 服务端 IDLE_TIMEOUT 75s → 50s，更快回收僵死 ws。
• messages 表新增 client_msg_id 列（迁移 0008），用于 reconcile 校对。

使用建议

推荐生产环境使用最新版本：桌面版双击安装即可启动后台，便携版适合受限环境，服务器版用于多人在线 / 公网部署。所有版本均提供 30 天免费试用。

更新内容

• 「关于」页面新增更新检测：启动时自动调用 https://xunmeiai.com/api/version/latest 比对版本号；版本一致显示「已是最新版本」，发现新版给出版本号 / 发布日期 / 更新摘要 + 「立即下载」按钮。
• 客户端心跳：admin / widget 两端均改为双向心跳——客户端 25s 主动 ping，服务端仍 30s 推 ping，覆盖"半开连接"场景。
• 离线发送队列：网络断开时，agent 端 reply 与 visitor message 暂存到内存队列，重连成功后自动按原顺序、原 clientMsgId 补发。
• 网络感知重连：监听 online / visibilitychange 事件，网络恢复或标签切回时立即触发重连。
• WebSocket 重连改为指数退避：1s → 2s → 4s → 8s → 15s → 30s 上限（原固定 5s），避免雷暴恢复时雪崩。
• 服务端 fastify-websocket 启用 perMessageDeflate，长文本与历史回放消息体压缩 ≥ 70%。
• 服务端 reply / visitor message 在持久化与广播之前先发 { type: 'ack', clientMsgId, serverMsgId } 给原发送方，端到端反馈延迟从 100~300ms 缩短到 5~15ms。
• 「个人设置」侧边栏菜单与卡片标题统一改为「设置」。

使用建议

推荐生产环境使用最新版本：桌面版双击安装即可启动后台，便携版适合受限环境，服务器版用于多人在线 / 公网部署。所有版本均提供 30 天免费试用。

更新内容

• 后台 / 访客发消息偶发"输入清空但不显示"问题：原依赖服务端回送渲染，半开 WebSocket 时数据进入本地缓冲不报错但服务端从未收到。现改为乐观插入 + clientMsgId 关联 + 8s 超时回退，失败可点击消息条目重发。
• 后台会话窗口最新消息有时被挤到 viewport 之外：.chat-main 缺 min-height:0; overflow:hidden，grid 子项被内容撑开，.msgs 的 flex:1 失效。已修复高度链路。
• 服务端 reply / visitor message 回送由 sendJSON(ws, …) 改为按 ID 群发到该用户所有 ws（多 tab 同步；半开 ws 由活 ws 兜底）。
• 服务端把请求方的 clientMsgId 透传到回送 / 错误 payload，客户端用以替换乐观插入项或标失败。
• 后台聊天区"↓ 回到底部"浮动按钮 + 新消息计数（向上翻历史时不强制滚屏）。
• 后台访客列表自定义滚动条 + "↑ 回到顶部" sticky 按钮 + 选中会话自动 scrollIntoView。

使用建议

推荐生产环境使用最新版本：桌面版双击安装即可启动后台，便携版适合受限环境，服务器版用于多人在线 / 公网部署。所有版本均提供 30 天免费试用。

更新内容

• 本版本未提供详细更新说明，请参考下载页和软件文档。

使用建议

推荐生产环境使用最新版本：桌面版双击安装即可启动后台，便携版适合受限环境，服务器版用于多人在线 / 公网部署。所有版本均提供 30 天免费试用。