協議與架構

支撐一切的 那套協議。

一套線上協議在三種傳輸上承載訊息、Channel 事件與強型別 RPC。每個產品面 — 聊天、遊戲、AI 代理 — 都是同一個底座的消費者。

全景圖

五層結構,一份契約。

客戶端只面對 SDK 執行時;執行時只說一套協議;服務端核心向業務模組扇出。任何一層都可替換,無需重新談判線上協議。

多傳輸通道

QUIC 提供現代低延遲鏈路,TCP 保證相容性,WebSocket 覆蓋瀏覽器 — 原生客戶端可在傳輸間切換,協定始終不變。

Channel 優先

訊息、在線狀態、遊戲事件、機器人回覆與業務推送共用同一套 Channel 模型,學一次到處用。

Transfer RPC

在長連線上運行的強型別請求-回應路由,業務模組隨時擴充能力,不動傳輸層。

伺服器端權威

訊息 ID、序列點、已讀游標與恢復邏輯全部以伺服器端為準 — 客戶端快取既快又可信。

連線生命週期

從冷啟動到恢復,語義明確。

連線的每個階段都有顯式語義 — 這正是重連與多端同步變得可預期的原因。

01

連線

SDK 選擇傳輸 — 原生端 QUIC 或 TCP,Web 端 WebSocket — 建立一條長連線。

02

鑑權

基於令牌的鑑權把連線繫結到使用者與裝置。重新整理流程在不斷線的情況下更新憑證。

03

訂閱

客戶端用短時效票據訂閱 Channel。訊息、線上狀態與業務事件立即開始流動。

04

釋出與 RPC

Channel 釋出向訂閱者扇出;強型別 transfer 路由在同一條連線上承載請求-響應呼叫。

05

恢復

任何中斷後客戶端重新鑑權、重新訂閱,並從服務端序列恢復 — 訊息不丟。

傳輸

三種傳輸,應用層零改動。

協定與傳輸無關:原生客戶端 QUIC/TCP 執行時切換,Web 端 WebSocket — 業務程式碼永遠不用動。

傳輸優勢適用場景
QUIC最低延遲、多路複用流、連線遷移現代移動與原生客戶端
TCP最大相容性、久經考驗的運維工具鏈伺服器、桌面、受限網路
WebSocket瀏覽器在哪它就在哪,代理友好Web 應用、PWA、內嵌 WebView

技術棧

四個元件,天生可組合。

下層是開源的服務端與 SDK;上層是商業的 Platform 與AI 代理通道 — 可以只用底座,也可以整棧採用。

PrivChat Server

Rust 即時核心:閘道器、鑑權、Channel、訊息同步、檔案鉤子與運維工具 — 為自託管而生。

PrivChat SDK

Rust 參考引擎 + UniFFI 原生 Kotlin 繫結,外加面向 Web 的道地 TypeScript 實作 — 處處同一套協定。

PrivChat 平臺

商業應用層 — 賬戶、錢包、支付、遊戲、管理後臺與助手 — 構建在開源底座之上。

AI 代理通道

機器人與助手是一等公民:與使用者在同樣的 Channel 上訂閱、釋出、應答強型別 RPC。

更進一步

讀程式碼,別隻看圖。

服務端、傳輸與 SDK 都是開源的 — 架構頁是地圖,倉庫才是疆域。

探索開源