CHANGELOG
持續交付，看得見的進展
追蹤伺服器各版本與共用用戶端 SDK 版本線的每項新增、改進與修正。
伺服器 / 產品
按版本查看每個可售版本收到哪些更新。
v1.24.0: customer-service intelligence meets operational reliability — the AI-voice fix chain lands (multi-turn deafness, echo interruptions, final-echo), Auto-QA closes its loop (agent appeals, error retry, QA stats), knowledge-gap mining ships, Copilot gains draft rewrite and live session summary, KPI reporting moves to precomputed database aggregation, proactive invites become behavior-triggered rules, and SOP procedures orchestrate multi-step bot actions. Infrastructure completes the timezone contract (TIMESTAMPTZ everywhere + UTC-pinned sessions). The upgrade includes hot-table schema changes — schedule a maintenance window and run database migrations first.
優化- The timezone contract lands end to end: all 176 timestamp columns convert to TIMESTAMPTZ (MySQL DATETIME eliminated) and every pooled session pins UTC — deployments and dev boxes outside UTC no longer see silently shifted timestamps. Upgrade note: hot tables (messages, sessions) are altered under an exclusive lock, so run the migration in a maintenance window (raise the migrate timeout on large databases); the migration interprets existing rows correctly under the deploying server's timezone.
A dual-track server and customer-service release: CS adds WhatsApp and WeChat-ecosystem channels with a fully redesigned agent workbench; read reporting upgrades to readUpTo cursors and message search gains global scope and AI source filters.
新增- Read reporting upgrades to readUpTo cursors: clients report how far they actually read, the server confirms, and multi-device unread counts converge; offline pushes already covered by the cursor are cancelled — read on one device stops the buzzing on the others.
- AI additions: text-to-speech for bot messages (speech.synthesize webhook), in-flight expansion key-values for streaming messages, and tool-approval outcomes posted back into the conversation.
- Login gains a single-device policy: the newest login kicks the previous one.
優化- Message search gains AI/human source filters, full-text matching on oversized AI replies, and cross-conversation global search.
- The beforeChat webhook gains HMAC signing and a delivery audit trail, plus two metadata lifecycle events (message persistence, group join).
- Xiaomi push adapts to the 2026 message-classification rules.
伺服器端季度升級：訊息熱路徑全面提速，四段關鍵旅程導入延遲指標與警示，管理後台迎來完整深色模式。
新增- 為登入、載入歷史、傳送、AI 首次回應四段關鍵旅程導入延遲指標與警示，問題定位更快
- 管理後台帶來完整深色模式與四端介面整體打磨
優化- 伺服器端季度升級：訊息熱路徑全面提速——大群與直播房間尖峰收發更順暢、記憶體佔用更低，並新增適合低階環境的輕量執行模式
- 發布包安全再升級——每個安裝包附帶簽章完整性清單，服務啟動自我檢查、可發現被竄改替換的程式
- Data-consistency hardening on MySQL for group-message timestamps and customer-service record fields.
基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，交付與升級文件補齊。
新增- 基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，內建簽章完整性清單與執行階段竄改偵測
優化- 發布包 README 與官網快速開始補齊下載驗證、設定、移轉、啟動和升級流程。
Server v1.20.0 is the largest customer-service expansion since the module shipped: agent Copilot reply suggestions with adoption tracking, Auto-QA session inspection with a human review queue, self-serve agent availability plus proactive first-response SLA alerts, case materialization (call-analysis drafts and channel conversations land as cases), report metrics (answer-within-30s rate, FCR, queue wait, agent status durations), omnichannel customer journey with writable tags, and email channel completion (bot auto-reply, channel SLA); the AI platform hardens in step (turn-level trace correlation, DPACT approval time-boxing, per-bot token budgets).
- Transfer-brief authorization strengthened: the customer-profile section renders only for verified agents; the note and history sections are unaffected.
（用戶端 SDK 1.17.0）伺服器端 v1.19.0 帶來數位人客服、媒體內容審核、廠商推播與 VoIP、客服更新監控，以及新的行銷線索和管理能力；建置與多架構發布流程也得到加固。
- 媒體審核接入可替換的外部 provider，圖片、影片和音訊結果統一回寫審核狀態與證據；推播新增廠商直連、iOS VoIP token 和更完整的裝置註冊模型。
- CJK search handling and multi-architecture image builds are hardened; both MySQL and PostgreSQL deployments are under continuous automated verification.
（用戶端 SDK 1.16.0）伺服器端 v1.18.0 完成訊息體驗與生產營運能力升級：全域搜尋、引用編輯、合併轉寄和訊息置頂進入統一協定；多端推播、OpenAPI 服務憑證、通話狀態、客服語音及工作行程可觀測性同步增強。
- 訊息體驗升級：支援跨私訊與群聊的全域搜尋，並為中英文與 CJK 內容建立可用索引；引用、編輯、單條與合併轉寄、對話層級訊息置頂形成完整鏈路。Chat Studio 同步加入多選轉寄、已讀名單、機器人 Markdown 與亮色 / 暗色 / 跟隨系統佈景主題。
- 群聊新增原使用者群組，可建立、搜尋並維護成員；使用者資料與好友關係變更透過版本化實體和即時事件在多裝置間收斂，SDK 對話快取同時加強重連、亂序事件與歷史回源的一致性處理。
- RTC 通話狀態可存入 Redis，在多執行個體間共享並安全處理振鈴逾時、ICE 參與者驗證與異常斷線清理；新增工作行程心跳、佇列積壓 / 延遲和資料庫阻塞探針、抓取設定與警示規則，滾動發布和故障定位更可控。
伺服器端 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 軌。)
（用戶端 SDK 1.10.0）訊息大小限額治理：入站請求統一閘門（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 欄時區偏移；MySQL 與 PostgreSQL 兩種資料庫此後均有持續自動化驗證兜底。
（用戶端 SDK 1.9.0）訊息擴充 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 1.8.0）對話體驗三件套（伺服器端 + 四端 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。
- 憑證衛生：發布流程新增金鑰洩漏掃描，防止憑證意外混入儲存庫與發布物。
（用戶端 SDK 同步至 1.7.0）完整伺服器端 OpenAPI 3.1 契約：所有面向客戶的 HTTP 路由均被描述，經 /openapi.{yaml,json} 提供，並與實際實作持續保持一致。
- WebSocket 指令全部 SDK 化：最後 25 個指令進入協定目錄；四端 SDK 新增 operations API。
- 官網相依性安全升級：Astro 升級越過已回報的 npm 警示，靜態建置保持通過。
（用戶端 SDK 同步至 1.6.0）四端弱網路復原：連線建立逾時、無入站流量連線退役、帶抖動的指數重連退避。
- 雙向歷史分頁：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.24.0: customer-service intelligence meets operational reliability — the AI-voice fix chain lands (multi-turn deafness, echo interruptions, final-echo), Auto-QA closes its loop (agent appeals, error retry, QA stats), knowledge-gap mining ships, Copilot gains draft rewrite and live session summary, KPI reporting moves to precomputed database aggregation, proactive invites become behavior-triggered rules, and SOP procedures orchestrate multi-step bot actions. Infrastructure completes the timezone contract (TIMESTAMPTZ everywhere + UTC-pinned sessions). The upgrade includes hot-table schema changes — schedule a maintenance window and run database migrations first.
優化- The timezone contract lands end to end: all 176 timestamp columns convert to TIMESTAMPTZ (MySQL DATETIME eliminated) and every pooled session pins UTC — deployments and dev boxes outside UTC no longer see silently shifted timestamps. Upgrade note: hot tables (messages, sessions) are altered under an exclusive lock, so run the migration in a maintenance window (raise the migrate timeout on large databases); the migration interprets existing rows correctly under the deploying server's timezone.
A dual-track server and customer-service release: CS adds WhatsApp and WeChat-ecosystem channels with a fully redesigned agent workbench; read reporting upgrades to readUpTo cursors and message search gains global scope and AI source filters.
新增- Read reporting upgrades to readUpTo cursors: clients report how far they actually read, the server confirms, and multi-device unread counts converge; offline pushes already covered by the cursor are cancelled — read on one device stops the buzzing on the others.
- AI additions: text-to-speech for bot messages (speech.synthesize webhook), in-flight expansion key-values for streaming messages, and tool-approval outcomes posted back into the conversation.
- Login gains a single-device policy: the newest login kicks the previous one.
優化- Message search gains AI/human source filters, full-text matching on oversized AI replies, and cross-conversation global search.
- The beforeChat webhook gains HMAC signing and a delivery audit trail, plus two metadata lifecycle events (message persistence, group join).
- Xiaomi push adapts to the 2026 message-classification rules.
伺服器端季度升級：訊息熱路徑全面提速，四段關鍵旅程導入延遲指標與警示，管理後台迎來完整深色模式。
新增- 為登入、載入歷史、傳送、AI 首次回應四段關鍵旅程導入延遲指標與警示，問題定位更快
- 管理後台帶來完整深色模式與四端介面整體打磨
優化- 伺服器端季度升級：訊息熱路徑全面提速——大群與直播房間尖峰收發更順暢、記憶體佔用更低，並新增適合低階環境的輕量執行模式
- 發布包安全再升級——每個安裝包附帶簽章完整性清單，服務啟動自我檢查、可發現被竄改替換的程式
- Data-consistency hardening on MySQL for group-message timestamps and customer-service record fields.
基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，交付與升級文件補齊。
新增- 基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，內建簽章完整性清單與執行階段竄改偵測
優化- 發布包 README 與官網快速開始補齊下載驗證、設定、移轉、啟動和升級流程。
Server v1.20.0 is the largest customer-service expansion since the module shipped: agent Copilot reply suggestions with adoption tracking, Auto-QA session inspection with a human review queue, self-serve agent availability plus proactive first-response SLA alerts, case materialization (call-analysis drafts and channel conversations land as cases), report metrics (answer-within-30s rate, FCR, queue wait, agent status durations), omnichannel customer journey with writable tags, and email channel completion (bot auto-reply, channel SLA); the AI platform hardens in step (turn-level trace correlation, DPACT approval time-boxing, per-bot token budgets).
- Transfer-brief authorization strengthened: the customer-profile section renders only for verified agents; the note and history sections are unaffected.
（用戶端 SDK 1.17.0）伺服器端 v1.19.0 帶來數位人客服、媒體內容審核、廠商推播與 VoIP、客服更新監控，以及新的行銷線索和管理能力；建置與多架構發布流程也得到加固。
- 媒體審核接入可替換的外部 provider，圖片、影片和音訊結果統一回寫審核狀態與證據；推播新增廠商直連、iOS VoIP token 和更完整的裝置註冊模型。
- CJK search handling and multi-architecture image builds are hardened; both MySQL and PostgreSQL deployments are under continuous automated verification.
（用戶端 SDK 1.16.0）伺服器端 v1.18.0 完成訊息體驗與生產營運能力升級：全域搜尋、引用編輯、合併轉寄和訊息置頂進入統一協定；多端推播、OpenAPI 服務憑證、通話狀態、客服語音及工作行程可觀測性同步增強。
- 訊息體驗升級：支援跨私訊與群聊的全域搜尋，並為中英文與 CJK 內容建立可用索引；引用、編輯、單條與合併轉寄、對話層級訊息置頂形成完整鏈路。Chat Studio 同步加入多選轉寄、已讀名單、機器人 Markdown 與亮色 / 暗色 / 跟隨系統佈景主題。
- 群聊新增原使用者群組，可建立、搜尋並維護成員；使用者資料與好友關係變更透過版本化實體和即時事件在多裝置間收斂，SDK 對話快取同時加強重連、亂序事件與歷史回源的一致性處理。
- 離線推播升級為可靠的多裝置投遞：同一訊息按裝置獨立認領與重試，權杖預設歸屬最新帳號；新增華為、榮耀、小米、OPPO 與 vivo 廠商通道，可與 APNs / FCM 統一設定並持續觀測投遞結果。
- RTC 通話狀態可存入 Redis，在多執行個體間共享並安全處理振鈴逾時、ICE 參與者驗證與異常斷線清理；新增工作行程心跳、佇列積壓 / 延遲和資料庫阻塞探針、抓取設定與警示規則，滾動發布和故障定位更可控。
伺服器端 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 軌。)
（用戶端 SDK 1.10.0）訊息大小限額治理：入站請求統一閘門（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 欄時區偏移；MySQL 與 PostgreSQL 兩種資料庫此後均有持續自動化驗證兜底。
（用戶端 SDK 1.9.0）訊息擴充 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 1.8.0）對話體驗三件套（伺服器端 + 四端 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。
- 憑證衛生：發布流程新增金鑰洩漏掃描，防止憑證意外混入儲存庫與發布物。
（用戶端 SDK 同步至 1.7.0）完整伺服器端 OpenAPI 3.1 契約：所有面向客戶的 HTTP 路由均被描述，經 /openapi.{yaml,json} 提供，並與實際實作持續保持一致。
- WebSocket 指令全部 SDK 化：最後 25 個指令進入協定目錄；四端 SDK 新增 operations API。
- 官網相依性安全升級：Astro 升級越過已回報的 npm 警示，靜態建置保持通過。
（用戶端 SDK 同步至 1.6.0）四端弱網路復原：連線建立逾時、無入站流量連線退役、帶抖動的指數重連退避。
- 雙向歷史分頁：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.24.0: customer-service intelligence meets operational reliability — the AI-voice fix chain lands (multi-turn deafness, echo interruptions, final-echo), Auto-QA closes its loop (agent appeals, error retry, QA stats), knowledge-gap mining ships, Copilot gains draft rewrite and live session summary, KPI reporting moves to precomputed database aggregation, proactive invites become behavior-triggered rules, and SOP procedures orchestrate multi-step bot actions. Infrastructure completes the timezone contract (TIMESTAMPTZ everywhere + UTC-pinned sessions). The upgrade includes hot-table schema changes — schedule a maintenance window and run database migrations first.
優化- The timezone contract lands end to end: all 176 timestamp columns convert to TIMESTAMPTZ (MySQL DATETIME eliminated) and every pooled session pins UTC — deployments and dev boxes outside UTC no longer see silently shifted timestamps. Upgrade note: hot tables (messages, sessions) are altered under an exclusive lock, so run the migration in a maintenance window (raise the migrate timeout on large databases); the migration interprets existing rows correctly under the deploying server's timezone.
A dual-track server and customer-service release: CS adds WhatsApp and WeChat-ecosystem channels with a fully redesigned agent workbench; read reporting upgrades to readUpTo cursors and message search gains global scope and AI source filters.
新增- Read reporting upgrades to readUpTo cursors: clients report how far they actually read, the server confirms, and multi-device unread counts converge; offline pushes already covered by the cursor are cancelled — read on one device stops the buzzing on the others.
- AI additions: text-to-speech for bot messages (speech.synthesize webhook), in-flight expansion key-values for streaming messages, and tool-approval outcomes posted back into the conversation.
- Login gains a single-device policy: the newest login kicks the previous one.
優化- Message search gains AI/human source filters, full-text matching on oversized AI replies, and cross-conversation global search.
- The beforeChat webhook gains HMAC signing and a delivery audit trail, plus two metadata lifecycle events (message persistence, group join).
- Xiaomi push adapts to the 2026 message-classification rules.
伺服器端季度升級：訊息熱路徑全面提速，四段關鍵旅程導入延遲指標與警示，管理後台迎來完整深色模式。
新增- 為登入、載入歷史、傳送、AI 首次回應四段關鍵旅程導入延遲指標與警示，問題定位更快
- 管理後台帶來完整深色模式與四端介面整體打磨
優化- 伺服器端季度升級：訊息熱路徑全面提速——大群與直播房間尖峰收發更順暢、記憶體佔用更低，並新增適合低階環境的輕量執行模式
- 發布包安全再升級——每個安裝包附帶簽章完整性清單，服務啟動自我檢查、可發現被竄改替換的程式
- Data-consistency hardening on MySQL for group-message timestamps and customer-service record fields.
基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，交付與升級文件補齊。
新增- 基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，內建簽章完整性清單與執行階段竄改偵測
優化- 發布包 README 與官網快速開始補齊下載驗證、設定、移轉、啟動和升級流程。
Server v1.20.0 is the largest customer-service expansion since the module shipped: agent Copilot reply suggestions with adoption tracking, Auto-QA session inspection with a human review queue, self-serve agent availability plus proactive first-response SLA alerts, case materialization (call-analysis drafts and channel conversations land as cases), report metrics (answer-within-30s rate, FCR, queue wait, agent status durations), omnichannel customer journey with writable tags, and email channel completion (bot auto-reply, channel SLA); the AI platform hardens in step (turn-level trace correlation, DPACT approval time-boxing, per-bot token budgets).
- Transfer-brief authorization strengthened: the customer-profile section renders only for verified agents; the note and history sections are unaffected.
（用戶端 SDK 1.17.0）伺服器端 v1.19.0 帶來數位人客服、媒體內容審核、廠商推播與 VoIP、客服更新監控，以及新的行銷線索和管理能力；建置與多架構發布流程也得到加固。
- 媒體審核接入可替換的外部 provider，圖片、影片和音訊結果統一回寫審核狀態與證據；推播新增廠商直連、iOS VoIP token 和更完整的裝置註冊模型。
- CJK search handling and multi-architecture image builds are hardened; both MySQL and PostgreSQL deployments are under continuous automated verification.
（用戶端 SDK 1.16.0）伺服器端 v1.18.0 完成訊息體驗與生產營運能力升級：全域搜尋、引用編輯、合併轉寄和訊息置頂進入統一協定；多端推播、OpenAPI 服務憑證、通話狀態、客服語音及工作行程可觀測性同步增強。
- 訊息體驗升級：支援跨私訊與群聊的全域搜尋，並為中英文與 CJK 內容建立可用索引；引用、編輯、單條與合併轉寄、對話層級訊息置頂形成完整鏈路。Chat Studio 同步加入多選轉寄、已讀名單、機器人 Markdown 與亮色 / 暗色 / 跟隨系統佈景主題。
- 群聊新增原使用者群組，可建立、搜尋並維護成員；使用者資料與好友關係變更透過版本化實體和即時事件在多裝置間收斂，SDK 對話快取同時加強重連、亂序事件與歷史回源的一致性處理。
- 離線推播升級為可靠的多裝置投遞：同一訊息按裝置獨立認領與重試，權杖預設歸屬最新帳號；新增華為、榮耀、小米、OPPO 與 vivo 廠商通道，可與 APNs / FCM 統一設定並持續觀測投遞結果。
- RTC 通話狀態可存入 Redis，在多執行個體間共享並安全處理振鈴逾時、ICE 參與者驗證與異常斷線清理；新增工作行程心跳、佇列積壓 / 延遲和資料庫阻塞探針、抓取設定與警示規則，滾動發布和故障定位更可控。
伺服器端 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 軌。)
（用戶端 SDK 1.10.0）訊息大小限額治理：入站請求統一閘門（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 欄時區偏移；MySQL 與 PostgreSQL 兩種資料庫此後均有持續自動化驗證兜底。
（用戶端 SDK 1.9.0）訊息擴充 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 1.8.0）對話體驗三件套（伺服器端 + 四端 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。
- 憑證衛生：發布流程新增金鑰洩漏掃描，防止憑證意外混入儲存庫與發布物。
（用戶端 SDK 同步至 1.7.0）完整伺服器端 OpenAPI 3.1 契約：所有面向客戶的 HTTP 路由均被描述，經 /openapi.{yaml,json} 提供，並與實際實作持續保持一致。
- WebSocket 指令全部 SDK 化：最後 25 個指令進入協定目錄；四端 SDK 新增 operations API。
- 官網相依性安全升級：Astro 升級越過已回報的 npm 警示，靜態建置保持通過。
（用戶端 SDK 同步至 1.6.0）四端弱網路復原：連線建立逾時、無入站流量連線退役、帶抖動的指數重連退避。
- 雙向歷史分頁：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.24.0: customer-service intelligence meets operational reliability — the AI-voice fix chain lands (multi-turn deafness, echo interruptions, final-echo), Auto-QA closes its loop (agent appeals, error retry, QA stats), knowledge-gap mining ships, Copilot gains draft rewrite and live session summary, KPI reporting moves to precomputed database aggregation, proactive invites become behavior-triggered rules, and SOP procedures orchestrate multi-step bot actions. Infrastructure completes the timezone contract (TIMESTAMPTZ everywhere + UTC-pinned sessions). The upgrade includes hot-table schema changes — schedule a maintenance window and run database migrations first.
優化- The timezone contract lands end to end: all 176 timestamp columns convert to TIMESTAMPTZ (MySQL DATETIME eliminated) and every pooled session pins UTC — deployments and dev boxes outside UTC no longer see silently shifted timestamps. Upgrade note: hot tables (messages, sessions) are altered under an exclusive lock, so run the migration in a maintenance window (raise the migrate timeout on large databases); the migration interprets existing rows correctly under the deploying server's timezone.
A dual-track server and customer-service release: CS adds WhatsApp and WeChat-ecosystem channels with a fully redesigned agent workbench; read reporting upgrades to readUpTo cursors and message search gains global scope and AI source filters.
新增- Read reporting upgrades to readUpTo cursors: clients report how far they actually read, the server confirms, and multi-device unread counts converge; offline pushes already covered by the cursor are cancelled — read on one device stops the buzzing on the others.
- AI additions: text-to-speech for bot messages (speech.synthesize webhook), in-flight expansion key-values for streaming messages, and tool-approval outcomes posted back into the conversation.
- Login gains a single-device policy: the newest login kicks the previous one.
優化- Message search gains AI/human source filters, full-text matching on oversized AI replies, and cross-conversation global search.
- The beforeChat webhook gains HMAC signing and a delivery audit trail, plus two metadata lifecycle events (message persistence, group join).
- Xiaomi push adapts to the 2026 message-classification rules.
伺服器端季度升級：訊息熱路徑全面提速，四段關鍵旅程導入延遲指標與警示，管理後台迎來完整深色模式。
新增- 為登入、載入歷史、傳送、AI 首次回應四段關鍵旅程導入延遲指標與警示，問題定位更快
- 管理後台帶來完整深色模式與四端介面整體打磨
優化- 伺服器端季度升級：訊息熱路徑全面提速——大群與直播房間尖峰收發更順暢、記憶體佔用更低，並新增適合低階環境的輕量執行模式
- 發布包安全再升級——每個安裝包附帶簽章完整性清單，服務啟動自我檢查、可發現被竄改替換的程式
- Data-consistency hardening on MySQL for group-message timestamps and customer-service record fields.
基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，交付與升級文件補齊。
新增- 基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，內建簽章完整性清單與執行階段竄改偵測
優化- 發布包 README 與官網快速開始補齊下載驗證、設定、移轉、啟動和升級流程。
Server v1.20.0 is the largest customer-service expansion since the module shipped: agent Copilot reply suggestions with adoption tracking, Auto-QA session inspection with a human review queue, self-serve agent availability plus proactive first-response SLA alerts, case materialization (call-analysis drafts and channel conversations land as cases), report metrics (answer-within-30s rate, FCR, queue wait, agent status durations), omnichannel customer journey with writable tags, and email channel completion (bot auto-reply, channel SLA); the AI platform hardens in step (turn-level trace correlation, DPACT approval time-boxing, per-bot token budgets).
- Transfer-brief authorization strengthened: the customer-profile section renders only for verified agents; the note and history sections are unaffected.
（用戶端 SDK 1.17.0）伺服器端 v1.19.0 帶來數位人客服、媒體內容審核、廠商推播與 VoIP、客服更新監控，以及新的行銷線索和管理能力；建置與多架構發布流程也得到加固。
- 客服版新增火山引擎數位人影片客服：FlowAct 即時語音驅動、豆包 TTS、ByteRTC 身分驗證和對話層級閒置回收；管理員可維護數位人頭像庫、按機器人設定角色與聲音，並即時查看能力和對話狀態。
- 媒體審核接入可替換的外部 provider，圖片、影片和音訊結果統一回寫審核狀態與證據；推播新增廠商直連、iOS VoIP token 和更完整的裝置註冊模型。
- 新增客服與 AI 能力更新監控、行銷線索收集和數位人後台管理；管理員可以查看版本化更新、接收線索並維護數位人設定，相關寫入操作繼續納入稽核與權限控制。
- CJK search handling and multi-architecture image builds are hardened; both MySQL and PostgreSQL deployments are under continuous automated verification.
（用戶端 SDK 1.16.0）伺服器端 v1.18.0 完成訊息體驗與生產營運能力升級：全域搜尋、引用編輯、合併轉寄和訊息置頂進入統一協定；多端推播、OpenAPI 服務憑證、通話狀態、客服語音及工作行程可觀測性同步增強。
- 訊息體驗升級：支援跨私訊與群聊的全域搜尋，並為中英文與 CJK 內容建立可用索引；引用、編輯、單條與合併轉寄、對話層級訊息置頂形成完整鏈路。Chat Studio 同步加入多選轉寄、已讀名單、機器人 Markdown 與亮色 / 暗色 / 跟隨系統佈景主題。
- 群聊新增原使用者群組，可建立、搜尋並維護成員；使用者資料與好友關係變更透過版本化實體和即時事件在多裝置間收斂，SDK 對話快取同時加強重連、亂序事件與歷史回源的一致性處理。
- 離線推播升級為可靠的多裝置投遞：同一訊息按裝置獨立認領與重試，權杖預設歸屬最新帳號；新增華為、榮耀、小米、OPPO 與 vivo 廠商通道，可與 APNs / FCM 統一設定並持續觀測投遞結果。
- OpenAPI 新增資料庫持久化的服務憑證：按 Scope 授權，支援啟停與到期控制，權杖僅在建立時回傳；跨執行個體共享限額，並對認證失敗、拒絕與寫入操作執行統一稽核和敏感欄位去識別化。
- RTC 通話狀態可存入 Redis，在多執行個體間共享並安全處理振鈴逾時、ICE 參與者驗證與異常斷線清理；新增工作行程心跳、佇列積壓 / 延遲和資料庫阻塞探針、抓取設定與警示規則，滾動發布和故障定位更可控。
伺服器端 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 軌。)
（用戶端 SDK 1.10.0）訊息大小限額治理：入站請求統一閘門（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 欄時區偏移；MySQL 與 PostgreSQL 兩種資料庫此後均有持續自動化驗證兜底。
（用戶端 SDK 1.9.0）訊息擴充 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 1.8.0）對話體驗三件套（伺服器端 + 四端 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。
（用戶端 SDK 1.7.0）資料治理控制平面（企業版）：資料清單、存取/匯出/刪除案件、法律保留、保留清理預覽/執行，以及獨立的 governance:read / governance:write 權限。
- 預設失敗關閉：刪除與保留清理預設關閉，須明確設定方可執行；尊重有效法律保留，並持久記錄執行證據。
- 治理 OpenAPI 與作業手冊：11 個強型別介面，附對應到 PIPL/GDPR 的雙語法律審查指南（不作認證承諾）。
- 憑證衛生：發布流程新增金鑰洩漏掃描，防止憑證意外混入儲存庫與發布物。
（用戶端 SDK 同步至 1.7.0）完整伺服器端 OpenAPI 3.1 契約：所有面向客戶的 HTTP 路由均被描述，經 /openapi.{yaml,json} 提供，並與實際實作持續保持一致。
- WebSocket 指令全部 SDK 化：最後 25 個指令進入協定目錄；四端 SDK 新增 operations API。
- 官網相依性安全升級：Astro 升級越過已回報的 npm 警示，靜態建置保持通過。
（用戶端 SDK 同步至 1.6.0）四端弱網路復原：連線建立逾時、無入站流量連線退役、帶抖動的指數重連退避。
- 雙向歷史分頁：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.24.0: customer-service intelligence meets operational reliability — the AI-voice fix chain lands (multi-turn deafness, echo interruptions, final-echo), Auto-QA closes its loop (agent appeals, error retry, QA stats), knowledge-gap mining ships, Copilot gains draft rewrite and live session summary, KPI reporting moves to precomputed database aggregation, proactive invites become behavior-triggered rules, and SOP procedures orchestrate multi-step bot actions. Infrastructure completes the timezone contract (TIMESTAMPTZ everywhere + UTC-pinned sessions). The upgrade includes hot-table schema changes — schedule a maintenance window and run database migrations first.
新增- Auto-QA closes its loop: agents can appeal a confirmed review (self-only, with a reason), supervisors rule through the existing review endpoint (uphold or overturn, verdict noted); transient LLM failures leave error rows that automatically re-enter the pending queue after a retry window instead of being lost forever; QA statistics ship with the suite. The appeal flow is live in the admin console and chat-studio workbench across all 12 locales.
- Knowledge-gap mining closes the knowledge-ops loop: handover conversations are mined by an LLM into KB entry drafts (title/body with the human agent's answer as evidence); accepted drafts publish straight into the existing KB embedding/review pipeline, while skip verdicts are recorded so the same conversation is never re-scanned. Knowledge ops moves from manual write-ups to mine-from-conversations with one-click acceptance.
- Copilot depth reaches the international baseline: draft rewrite sends the agent's composer draft through the shared copilot pipeline (professional tone, typos, same language, no new promises) and live session summaries generate on demand and evolve with the conversation — completing the writing assistant on top of the existing grounded suggestions.
- Proactive invites upgrade to a behavior-triggered rule library: ordered per-widget rules combining URL match, dwell seconds, Nth-pageview and exit-intent, with cooldown minutes (cross-session) and once-per-visitor caps — replacing the single static invite with mainstream targeted-engagement rules.
- SOP orchestration (agentic procedures): a procedure is trigger keywords plus ordered steps (instruction, optional tool binding, optional handover exit); matching messages inject the SOP into the reply pipeline and the model advances step by step with full flow context every turn — no separate state machine, and a preset template library ships built in. The bot moves from answering to getting things done.
- AI real-time voice customer service: visitors talk to the AI agent like a phone call — streaming ASR feeds the existing bot pipeline (KB/tools/memory intact), Doubao TTS speaks replies in real time, with barge-in interruption and mid-call handover into the human voice queue. The engine is pluggable; end-to-end voice-LLM adapters are reserved for a later release.
優化- CS KPI reporting moves to database-side GROUP BY: 30-second first-response rate (the domestic hard KPI), average and per-channel wait, FCR, AI resolution and agent online time render in milliseconds and are always fresh — replacing the 100k-row in-memory aggregation that slowed the reports page on large datasets.
- The timezone contract lands end to end: all 176 timestamp columns convert to TIMESTAMPTZ (MySQL DATETIME eliminated) and every pooled session pins UTC — deployments and dev boxes outside UTC no longer see silently shifted timestamps. Upgrade note: hot tables (messages, sessions) are altered under an exclusive lock, so run the migration in a maintenance window (raise the migrate timeout on large databases); the migration interprets existing rows correctly under the deploying server's timezone.
修復- Fixed AI voice calls going deaf after the first turn and answering twice: Volcano ASR session state accumulated across turns on one connection — late per-utterance finals re-dispatched the previous question, the next question's transcription was polluted with the prior turn's tail, and after a long reply the connection went deaf (later speech got no response). Each turn now recycles to a fresh ASR connection (the swap overlaps the reply wait, imperceptible), repeated questions are no longer swallowed by the echo filter, and an unexpectedly dropped ASR connection redials instead of ending the call.
- Fixed AI voice replies being cut mid-sentence: the bot's own voice was picked back up by the mic, and the echo — once transcribed — was mistaken for the visitor cutting in, cancelling the in-flight reply and even answering its own words as a new question. Uplink ASR now pauses while the bot speaks (real barge-in stays client-driven via local VAD), the client gate requires sustained energy, and the audio budget moved to a burst-tolerant 2-second window so browsers' chunky delivery no longer drops speech.
- Fixed AI voice calls where the bot never spoke: Volcano ASR re-delivers the finalized utterance as an extra partial, which was mistaken for the visitor cutting in and cancelled the just-dispatched reply — transcription and persistence worked, but the spoken reply never played. Echo partials no longer trigger barge-in; genuine interruptions are unaffected.
A dual-track server and customer-service release: CS adds WhatsApp and WeChat-ecosystem channels with a fully redesigned agent workbench; read reporting upgrades to readUpTo cursors and message search gains global scope and AI source filters.
新增- CS channels: WhatsApp Business Cloud API and the WeChat ecosystem (Official Account/Mini Program, WeCom customer service) join the unified agent inbox.
- The agent workbench is redesigned as a mainstream inbox, with proactive outreach, a Copilot console, and a self-service help center.
- Read reporting upgrades to readUpTo cursors: clients report how far they actually read, the server confirms, and multi-device unread counts converge; offline pushes already covered by the cursor are cancelled — read on one device stops the buzzing on the others.
- AI additions: text-to-speech for bot messages (speech.synthesize webhook), in-flight expansion key-values for streaming messages, and tool-approval outcomes posted back into the conversation.
- Login gains a single-device policy: the newest login kicks the previous one.
優化- Multilingual AI customer service: replies follow the customer's language, with multilingual greetings and canned replies.
- Message search gains AI/human source filters, full-text matching on oversized AI replies, and cross-conversation global search.
- The beforeChat webhook gains HMAC signing and a delivery audit trail, plus two metadata lifecycle events (message persistence, group join).
- Xiaomi push adapts to the 2026 message-classification rules.
伺服器端季度升級：訊息熱路徑全面提速，四段關鍵旅程導入延遲指標與警示，管理後台迎來完整深色模式。
新增- 為登入、載入歷史、傳送、AI 首次回應四段關鍵旅程導入延遲指標與警示，問題定位更快
- 管理後台帶來完整深色模式與四端介面整體打磨
優化- 伺服器端季度升級：訊息熱路徑全面提速——大群與直播房間尖峰收發更順暢、記憶體佔用更低，並新增適合低階環境的輕量執行模式
- 發布包安全再升級——每個安裝包附帶簽章完整性清單，服務啟動自我檢查、可發現被竄改替換的程式
- Data-consistency hardening on MySQL for group-message timestamps and customer-service record fields.
基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，交付與升級文件補齊。
新增- 基礎版發布流程升級：基礎版正式以高安全 Basic 包交付，內建簽章完整性清單與執行階段竄改偵測
優化- 發布包 README 與官網快速開始補齊下載驗證、設定、移轉、啟動和升級流程。
- 客服領域開放能力：CS webhook 事件族上線（工單建立/流轉、對話結束、轉人工、SLA 逾時、滿意度評分六類生命週期事件，JSON 投遞、簽章與既有訊息路由同形狀，預設關）；飛書/釘釘/企業微信群機器人通知（設定即用，釘釘支援加簽）；OpenAPI 新增客服資源七端點（對話查詢、工單讀/建/流轉、坐席名冊，cs:read/cs:write 獨立 scope）；零移轉。
Server v1.20.0 is the largest customer-service expansion since the module shipped: agent Copilot reply suggestions with adoption tracking, Auto-QA session inspection with a human review queue, self-serve agent availability plus proactive first-response SLA alerts, case materialization (call-analysis drafts and channel conversations land as cases), report metrics (answer-within-30s rate, FCR, queue wait, agent status durations), omnichannel customer journey with writable tags, and email channel completion (bot auto-reply, channel SLA); the AI platform hardens in step (turn-level trace correlation, DPACT approval time-boxing, per-bot token budgets).
- Email channel completion: inbound message content is persisted, with a console drawer showing session history; inbound emails can trigger bot auto-reply (reusing the bot's credentials and knowledge base, off by default, opt-in); channel conversations join the first-response SLA alert loop.
- 雙軌對話統一（讀時歸一）：客戶 360 新增全通路服務旅程——IM 對話與管道對話按時間倒序合併為一條時間線（來源標記），替代兩張並排表；客戶標籤補上寫入路徑（管理台可編輯，IM 域客戶首次貼標籤即持久化，保序去重、超限拒絕），零移轉。
- CS report metrics upgrade: aggregation performance and accuracy hold at large scale, plus domestic tender metrics — answer-within-N-seconds rate (configurable threshold), first-contact resolution (24h customer-reopen rule, summary/daily only), queue wait avg/P95/max, and agent status durations (self-serve and admin switches both leave a trail); all legacy response fields preserved.
- Auto-QA for agent sessions ships: closed human-handled sessions are periodically inspected (dedicated judge credentials, server-side rescoring); below-threshold reviews land in a human review queue with a new QA console tab for confirm/false-positive verdicts; the ledger is governance-registered; off by default until AI credentials are configured.
- Case materialization closes the loop: a call-analysis ticket draft becomes a case with one click or automatically by a priority gate, and drafts are absorbed into an existing unresolved case as a note; channel conversations (email) convert to cases with full traceability; the call-quality and omnichannel consoles gain the entry points.
- Two-way AI tool I/O hardening: secrets used by outbound tool calls support secure references and config-only rotation; external tool output is isolated from the model side, suspected prompt injections are flagged and audited, and the audit trail keeps the raw content.
- High-risk AI actions join the tamper-evident audit chain: critical tool outcomes (turn-time or resumed after approval) append tamper-evident audit records carrying the turn's trace id, verified by the same integrity tooling as human approvals; the audit storage layer becomes edition-independent, only the console reader stays Ultimate.
- Audits feed evals: the eval miner gains a tool_failure source — denied and degraded tool calls from the unified audit aggregate per conversation into candidate cases, distilled by the LLM miner and gated by human approval, joining handovers, low ratings and stream errors as the fourth signal.
- Agent Copilot ships (P1): one click in the conversation panel drafts reply suggestions from the customer profile, long-term summary, bot KB retrieval and last 10 turns; 2-3 insertable suggestions with adoption tracking making adoption rate a queryable metric; authorization matches the profile card (workbench gate + service relationship).
- Human approvals become short-lived grants (DPACT Time): an approved execution is executable only within a short window (10 minutes by default), expires automatically, and the grant is re-checked before execution.
- Per-bot daily token budgets (0 = unlimited): pre-checked before each paid call and charged by actual usage; over-budget turns return budget_exceeded and land in the message audit. Native and Dify/Coze/webhook backends are both bounded; the admin bot form gains the budget field.
- Transfer-brief authorization strengthened: the customer-profile section renders only for verified agents; the note and history sections are unaffected.
- Agent operations loop closed: agents self-serve their availability status from the workbench (ready/busy/away/rest; auto routing stops assigning new sessions once switched), and first-response SLA alerts go proactive — at_risk at 3/4 of the target and breached at the target, at most once per session per tier, delivered to the assigned agent plus supervisors; the admin realtime operations page gains an alert-history table with derived live status (still waiting / answered / session closed).
- End-to-end AI turn tracing: each turn mints a trace_id stamped across message audits, tool calls and executions (errors and handovers sampled at 100%, ok turns follow a configurable rate); message audits gain model/provider columns and admin-approved executions inherit the original turn's trace.
- Tool permission controls ship: a tool without a permission scope is refused; the admin tool list flags unscoped tools and the tool form gains risk-level, permission-scope and require-confirmation fields.
（用戶端 SDK 1.17.0）伺服器端 v1.19.0 帶來數位人客服、媒體內容審核、廠商推播與 VoIP、客服更新監控，以及新的行銷線索和管理能力；建置與多架構發布流程也得到加固。
- 客服版新增火山引擎數位人影片客服：FlowAct 即時語音驅動、豆包 TTS、ByteRTC 身分驗證和對話層級閒置回收；管理員可維護數位人頭像庫、按機器人設定角色與聲音，並即時查看能力和對話狀態。
- 媒體審核接入可替換的外部 provider，圖片、影片和音訊結果統一回寫審核狀態與證據；推播新增廠商直連、iOS VoIP token 和更完整的裝置註冊模型。
- 新增客服與 AI 能力更新監控、行銷線索收集和數位人後台管理；管理員可以查看版本化更新、接收線索並維護數位人設定，相關寫入操作繼續納入稽核與權限控制。
- CJK search handling and multi-architecture image builds are hardened; both MySQL and PostgreSQL deployments are under continuous automated verification.
（用戶端 SDK 1.16.0）伺服器端 v1.18.0 完成訊息體驗與生產營運能力升級：全域搜尋、引用編輯、合併轉寄和訊息置頂進入統一協定；多端推播、OpenAPI 服務憑證、通話狀態、客服語音及工作行程可觀測性同步增強。
- 訊息體驗升級：支援跨私訊與群聊的全域搜尋，並為中英文與 CJK 內容建立可用索引；引用、編輯、單條與合併轉寄、對話層級訊息置頂形成完整鏈路。Chat Studio 同步加入多選轉寄、已讀名單、機器人 Markdown 與亮色 / 暗色 / 跟隨系統佈景主題。
- 群聊新增原使用者群組，可建立、搜尋並維護成員；使用者資料與好友關係變更透過版本化實體和即時事件在多裝置間收斂，SDK 對話快取同時加強重連、亂序事件與歷史回源的一致性處理。
- 離線推播升級為可靠的多裝置投遞：同一訊息按裝置獨立認領與重試，權杖預設歸屬最新帳號；新增華為、榮耀、小米、OPPO 與 vivo 廠商通道，可與 APNs / FCM 統一設定並持續觀測投遞結果。
- OpenAPI 新增資料庫持久化的服務憑證：按 Scope 授權，支援啟停與到期控制，權杖僅在建立時回傳；跨執行個體共享限額，並對認證失敗、拒絕與寫入操作執行統一稽核和敏感欄位去識別化。
- 客服版新增網頁內語音：訪客可直接呼叫，按坐席線上狀態與語音併發容量排隊路由，坐席可回撥，訪客端與工作台共用通話狀態。CPaaS 基礎層同時提供供應商介接、簽章 webhook 與持久化通話記錄，為電話號碼介接預留統一擴充點。
- RTC 通話狀態可存入 Redis，在多執行個體間共享並安全處理振鈴逾時、ICE 參與者驗證與異常斷線清理；新增工作行程心跳、佇列積壓 / 延遲和資料庫阻塞探針、抓取設定與警示規則，滾動發布和故障定位更可控。
伺服器端 v1.17.0：加入認證對話持久化與管理員撤銷、訊息 envelope 與組合詳情讀取、社群頻道治理、推播策略、執行階段設定稽核和可觀測性；AI 串流支援取消、持久化最終 envelope 與受授權的大回覆物件交付，並完成訊息大小治理和多資料庫移轉驗證。
（用戶端 SDK 1.14.0）客服版完成營運閉環升級：統一客服對話、工單、全通路接入、智慧路由、客戶 360、AI 知識品質與營運報表，網站客服元件也可與宿主業務深度連動。
- 客服管理後台新增對話中心、即時營運、客戶 360、全通路與統計報表；可按業務線設定營業時間、離線接待、路由方式和首次回應 SLA，郵件管道已支援統一收發，團隊話術支援審核發布、版本回溯與效果分析。
- 智慧路由可同時匹配坐席的接待狀態、技能、語言、班次與併發容量，主團隊繁忙時按順序進入溢出團隊；轉接、主管改派和自動分配遵循同一套可用性規則，營運人員可即時查看排隊等待與坐席負載。
- 新增完整工單流程：客服對話可一鍵轉為工單，按優先順序、分類、責任人和狀態推進，分別追蹤首次回應與解決 SLA；工單可關聯多次對話、訂單及其他業務物件，解決或關閉時沉澱標準解決結果。
- AI 知識品質形成持續改進閉環：低信心回答可選擇繼續回答、禮貌婉拒或轉人工，並可向客戶展示來源；真實無命中問題自動進入審查佇列，營運人員可糾正答案、管理機器人版本與評測集，並用評分驗證上線效果。
- 網站客服元件新增宿主整合能力：業務頁面可控制元件開啟、隱藏與銷毀，傳入訪客資料和目前頁面上下文，並監聽連線、訊息、未讀數與轉人工狀態；管理後台同時提供標準安裝和進階整合範例。
- 資料治理涵蓋訊息全生命週期：可按對話或群設定保留策略，過期訊息支援歸檔、還原與安全刪除；完整資料匯出、註銷匿名化、Legal Hold、稽核完整性驗證和備份還原演練進入統一管理閉環。
用戶端 SDK 1.13.0 發布並開放版本化下載，新增 React Native 與微信小程式介接；伺服器端能力與 1.15.0 保持相容。
（用戶端 SDK 1.12.0）客服作業面完整上線：獨立坐席工作台（企業 SSO 登入、僅啟用坐席可進）、即時服務佇列、首次回應 SLA 倒數、對話歷程與當日統計；IM 管理後台新增「客服與 AI 客服管理」，統一維護坐席、團隊、客服群與話術，並沿用管理員權限與稽核。
- AI 客服子系統（AI 機器人、知識庫檢索、人機切換、通話分析）現在 NATS JetStream 下同樣可用，不再僅限 RabbitMQ；內嵌單二進位模式也已打通，最小部署無需外接訊息中介軟體。已有 NATS 部署升級需一次人工步驟，見備份還原作業手冊。
- 服務過程可度量：每次服務自動劃分對話邊界並生成 AI 摘要，記錄時長、訊息數與首次回應時間，人工對話與群客服對話同樣適用；管理後台新增通話後 AI 品質檢核頁，回看通話分析與品質評分。
- 客戶滿意度評價：對話結束後自動傳送評分卡，客戶一鍵評分；管理後台提供滿意度明細複盤、內部標註與提醒評分，營運趨勢同步展示問卷傳送量、回收率與滿意率。預設關閉，需明確開啟。
- AI 長期記憶升級：客戶檔案欄位可按業務自訂，模型自動萃取、營運手動修正優先，並與跨對話摘要、長尾事實召回一同進入對話。AI 轉人工時自動生成交接簡報（只推給坐席），人工的處置結論也會回寫進該客戶的長期記憶。客戶檔案與滾動摘要現已支援 MySQL 部署。
- 坐席協作能力進入全部版本：坐席可把客戶轉交給指定同事，或按團隊自動分配（線上且最閒優先），主管可強制改派；群客服支援認領 / 釋放 / 改派；新增僅對內可見的客戶備註與團隊話術庫。轉接自帶上下文簡報，接手的同事不必從頭翻記錄。
- 富互動訊息：機器人與坐席可傳送快捷回覆按鈕組與資訊卡片，客戶點選即以本人身分進入正常對話流並結構化留痕；Web 與 Flutter UIKit 均已內建渲染，不認識新型別的舊用戶端自動降級為純文字。
- 熱路徑效能最佳化：訊息負載單次解析、編解碼器複用、群與房間扇出減少臨時分配，高併發下 CPU 與記憶體開銷下降，行為無變化。
- 官網 Demo 新增訪客側客服入口：頁面右下角客服氣泡，預設與 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 軌。)
（用戶端 SDK 1.10.0）訊息大小限額治理：入站請求統一閘門（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 欄時區偏移；MySQL 與 PostgreSQL 兩種資料庫此後均有持續自動化驗證兜底。
（用戶端 SDK 1.9.0）訊息擴充 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 1.8.0）對話體驗三件套（伺服器端 + 四端 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。
- 憑證衛生：發布流程新增金鑰洩漏掃描，防止憑證意外混入儲存庫與發布物。
（用戶端 SDK 同步至 1.7.0）完整伺服器端 OpenAPI 3.1 契約：所有面向客戶的 HTTP 路由均被描述，經 /openapi.{yaml,json} 提供，並與實際實作持續保持一致。
- WebSocket 指令全部 SDK 化：最後 25 個指令進入協定目錄；四端 SDK 新增 operations API。
- 官網相依性安全升級：Astro 升級越過已回報的 npm 警示，靜態建置保持通過。
（用戶端 SDK 同步至 1.6.0）四端弱網路復原：連線建立逾時、無入站流量連線退役、帶抖動的指數重連退避。
- 雙向歷史分頁：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 共用一條版本線；以下按版本彙總，並以徽章標註本次涉及的端（含伺服器 Admin SDK）。
- WebDartSwiftKotlinUnity鴻蒙伺服器 Admin新增
- 重大變更SDK 1.24.0 protocol-surface extension (breaking; additive only): the CS Copilot command family (chat_cs_copilot_use/rewrite/summary, chat_cs_qa_get/appeal) and new CSCopilotWire kind/rewritten/summary fields. All additions are optional — existing calls keep working; integrators matching command constants exhaustively need to add the new-key branch. See the 1.24.0 migration report.
- WebDartSwiftKotlinUnity鴻蒙伺服器 Admin新增
- 重大變更Read reporting upgrades to readUpTo cursors: markRead gains a readUpTo parameter — clients report how far they actually read, the server confirms with a clamped cursor, and multi-device unread counts converge on it. The legacy lastMessageID placeholder is deprecated (still accepted during the window — migrate to readUpTo); the web markRead return value is now typed with the confirmed cursor, and Kotlin/Swift binary integrators need a recompile.
- The web SDK ships a cross-conversation search.global wrapper — one call searches every conversation.
優化- 重大變更Package-id normalization (breaking; installation coordinates only, no API change): reverse-DNS identifiers move from com.imcore.* to im.balala.* (Kotlin namespace and Maven coordinates, Java group, Unity UPM package name). Source/tarball integrators only need to update imports and dependency coordinates — the full old→new mapping is in the 1.23.0 migration report.
- Message search gains a source filter (AI replies only, or human messages only); keyword search on oversized AI replies now matches beyond the leading preview.
- WebDartSwiftKotlinUnity鴻蒙伺服器 Admin新增
- （用戶端 SDK 1.22.0）配合伺服器端 v1.20.0 客服域擴展，SDK 端新增 7 個客服指令（狀態切換/SLA 警示/Copilot 三合一）與 6 個 wire 型別，全部六端同步。
- WebDartSwiftKotlinUnity鴻蒙伺服器 Admin新增
- Streaming messages become a first-class type: a generic StreamApi listener, Flutter/UIKit typewriter bubbles with stop-generation, and group-stream rendering in chat-studio.
- Atomic conversation opening: chat_dm_open sends the welcome plus first message in one call, and group creation can carry an initialMessage.
- bot 與串流訊息按 Markdown 安全子集渲染(flutter_markdown_plus,圖片預設停用)
- RTC multi-party screen sharing: switching the shared content needs no renegotiation.
- 直播間 UIKit(投票、禮物連擊、彈幕、進出場)
- 訊息翻譯管道(webhook provider)
優化- Reliability and compliance hardening: a weak-network send acceptance suite, Xiaomi push hardening (token validation and text truncation), and dependency upgrades across the board.
- WebDartSwiftKotlinUnity鴻蒙伺服器 Admin
- Six-platform UIKit logic-matrix alignment (Dart chat-model, typing indicator); API snapshot gate widened to 11 platforms; strict tsc for HarmonyOS/Node; cross-platform push bridge (PushApi + vendor token contract + PushKit/FCM sources); attachment orchestration and message-action callbacks completing the UIKit surface; iOS Simulator and Android Robolectric verification layers; server Admin SDK completed with Java and PHP (five-language locked matrix); new full-stack Unity and HarmonyOS SDKs
- WebDartSwiftKotlinUnity鴻蒙伺服器 Admin
- Fixes and hardening across all platforms: the Swift SDK now registers event streams synchronously, so pushes arriving the instant a subscription is created are no longer dropped (status replay is atomic); the Kotlin toolchain moves to Kotlin 2.4.20 / Gradle 9.7.1; dependency upgrades; HarmonyOS import-path case fix; the version line is unified at 1.19.2.
- WebDartSwiftKotlinUnity鴻蒙伺服器 Admin
- 用戶端矩陣補齊：新增 Unity/.NET、鴻蒙 ArkTS、Go、Node、Python、Java、PHP 七個 SDK（伺服器端 Admin 語言集齊）；Swift UIKit 補齊 wire 映射、對話狀態與歸組時間線並通過 iOS 模擬器測試；Kotlin JVM 時間線核心上線並深化 Compose UIKit；五平台共享 chat-model 歸組/樂觀/typing 語意；Android UIKit 首次本機編譯並跑通 Robolectric 語意測試。
- WebDartSwiftKotlin
- SDK 協定清單新增客服頭像指令（chat_cs_avatar_*）；UIKit 包透過 overrides 固定 esbuild 相依性並同步 lockfile；補充 Compose 與 SwiftUI UIKit 目標的串接文件。
- WebDartSwiftKotlin
- 四端 SDK 與 UI 元件升級：新增 uni-app、React Native、微信小程式與 Electron 介接，並提供 Web、Flutter、Android Compose、SwiftUI 及平台專用 UI Kit；AI 回覆可讀取外部大型文字，通話與 VoIP 推播能力同步補齊。
- WebDartSwiftKotlin
- 四端 SDK 與 UIKit 升級：新增訊息置頂、全域搜尋、群內使用者群組、資料與好友關係即時更新、客服語音信令及強型別合併轉寄；Web 與 Flutter UIKit 補齊引用、編輯、轉寄、已讀名單和機器人 Markdown 等訊息體驗，並加強多端快取一致性。
- WebDartSwiftKotlin
- 四端 SDK 與 UIKit 升級：新增訊息 envelope/組合訊息型別、伺服器端訊息限額動態重新整理、認證撤銷後的重新認證狀態與離線佇列保護，並補齊社群治理、AI 串流取消和大回覆物件參考能力；Web 與 Flutter UIKit 同步更新對話列表和訊息流的一致性處理。
- WebDartSwiftKotlin
- 四端 SDK 新增強型別客服工作台 API，涵蓋工作台啟動、客戶轉接、客戶檔案、內部備註、群客服認領，以及路由變化通知，可直接用於建置自訂坐席端。
- Web
- JavaScript / TypeScript SDK 新增 React Native 與微信小程式平台入口。React Native 介接 AsyncStorage、AppState、NetInfo 與行動裝置 WebSocket；微信小程式介接 SocketTask、非同步儲存、前景/背景與網路重連，以及 wx.uploadFile。兩個入口均包含在同一份版本化 JS SDK 安裝包中。
- WebDartSwiftKotlin
- 新增 PC / Electron 介接層：IM 連線、JWT、快取、離線佇列和媒體上傳留在主行程；preload 僅暴露受限 transport，renderer 繼續使用完整 typed API。雙入口隔離 Node 檔案能力，IPC 驗證來源視窗與協定指令，並提供 userData 原子檔案儲存。
- 四端 SDK 新增客服作業協定：工作台啟動資訊、服務佇列、對話歷程與統計，以及群客服認領 / 釋放 / 改派與路由變更通知，可直接接入自訂坐席介面。新增互動訊息回答介面（Web 與 Dart 提供 typed 封裝），Web 與 Flutter UIKit 內建快捷回覆按鈕渲染與已答狀態同步。
- WebDartSwiftKotlin
- Flutter UIKit 二期——生產可用:歷史分頁(上滑載入更早訊息,進入對話穩定落底)、已讀上報(進入對話/新訊息/回到前景自動清未讀,含對話列表本機清零接線)、樂觀傳送與失敗重試(訊息即時顯示,失敗可重送/刪除)、多媒體訊息渲染(圖片含全螢幕檢視器,影片/語音/檔案卡片經 onOpenMedia 交宿主)、收回/編輯/刪除/表情回應即時同步與長按操作選單(按權限與訊息狀態顯隱)、深色主題(ImcoreTheme.dark(),值集即雙端主題規範)。修正:四端 SDK(TS/Kotlin/Swift/Dart)媒體上傳路徑糾正為 /user/chat/upload(此前對伺服器端恆 404)。已知限制:Flutter Web 上圖片載入受瀏覽器 CORS 限制,行動裝置與桌面端不受影響。
- WebDartSwiftKotlin
- Flutter UIKit 元件庫 imcore_uikit(首期):與 Web 版同一套元件契約與主題 token——ImcoreScope/對話列表/訊息流/輸入框/連線狀態橫幅 + headless 控制器(可自繪 UI),基於 imcore_sdk(兄弟目錄 path 相依),內建 example 應用,所有 edition 均含,發布產物 imcore-uikit-dart-<ver>.tar.gz。Dart ChatMessage.messageId 型別由 int? 改為 String?(伺服器端訊息 ID 為 UUIDv7 字串,舊型別解析必崩潰——Dart 原始碼級不相容變更);Web UIKit 三處修正(歷史載入與在途推播合併不丟訊息、傳送失敗不覆蓋新輸入的草稿、認證完成後自動重拉對話與歷史)。
- WebDartSwiftKotlin
- Web UIKit 元件庫 @imcore/uikit(首發):基於 @imcore/sdk 的 React 聊天 UI——對話列表 / 訊息流 / 輸入框 / 連線狀態橫幅,開箱即用,所有 edition 均含;主題走 CSS 變數(--imcore-* 及與 chat-studio 共用的 --bubble-* token),另有 headless hooks(useConnectionState/useConversations/useMessages)供自建 UI。
- 用戶端 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 尚未上架套件管理器，趁首發前的時間窗落地。
- WebDartSwiftKotlin
- 用戶端 SDK 1.9.0：四端新增群成員禁言/踢人 typed 封裝（group.muteMember / group.kickMember）；新增 chat_{dm,group,room}_expand（訊息擴充）、typed @提及、群推播層級、成員標記指令常數與 API 參考。
- Kotlin SDK：共享 OkHttp 用戶端弱網路加固（明確 connectTimeout / pingInterval；fastFallback 待 OkHttp 5）。
- WebDartSwiftKotlin
- 用戶端 SDK 1.5.0：群治理（muteAll、角色、轉讓、解散、入群申請、歷史策略）與定向可見 group.send。
- WebDartSwiftKotlin
- 用戶端 SDK 1.4.0：即時信令（RTC）—— 四端 typed 封裝（僅信令；媒體/peer connection 由你的 App 持有）。
- WebDartSwiftKotlin
- 用戶端 SDK 1.3.0：訊息生命週期（編輯 / 收回 / 刪除、typing、已讀回條）與四端企業目錄；SDK 版本與伺服器端解耦。
- WebDartSwiftKotlin
- 四端 SDK 版本化下載。
- WebDartSwiftKotlin
- 四個官方強型別 SDK：JavaScript/TypeScript、Dart/Flutter、Swift/iOS、Kotlin/Android（v1）。