协议与架构

支撑一切的 那套协议。

一套线上协议在三种传输上承载消息、Channel 事件与强类型 RPC。每个产品面 — 聊天、游戏、智能体 — 都是同一个底座的消费者。

全景图

五层结构,一份契约。

客户端只面对 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 与智能体通道 — 可以只用底座,也可以整栈采用。

PrivChat Server

Rust 实时核心:网关、鉴权、Channel、消息同步、文件钩子与运维工具 — 为自托管而生。

PrivChat SDK

Rust 参考引擎 + UniFFI 原生 Kotlin 绑定,外加面向 Web 的地道 TypeScript 实现 — 处处同一套协议。

PrivChat 平台

商业应用层 — 账户、钱包、支付、游戏、管理后台与助手 — 构建在开源底座之上。

智能体通道

机器人与助手是一等公民:与用户在同样的 Channel 上订阅、发布、应答强类型 RPC。

更进一步

读代码,别只看图。

服务端、传输与 SDK 都是开源的 — 架构页是地图,仓库才是疆域。

探索开源