系统概览

Croupier 是面向游戏运营与控制场景的 Server / Agent / SDK 平台。 当前架构已经明确收敛到“统一 session 传输”：

• Agent <-> Server：TCP session + TLS
• SDK <-> Agent：TCP session，默认不启用 TLS

核心特点

特性	说明
统一 session 传输	双向请求、重连、heartbeat、drain、背压
函数注册驱动	SDK / Agent 上报 function/provider/process 能力
Schema 驱动 UI	JSON Schema + Formily
JSON payload	用户业务数据默认 JSON
protobuf 信封	平台控制字段与消息路由统一 protobuf

关键组件

Server

• 保存 registry
• 做 RBAC / 审批 / 审计
• 负责路由 invoke/task/ops 请求
• 持有 Agent session

Agent

• 主动连接 Server
• 本地接入 GameServer / SDK / 第三方应用
• 在本地和上游两侧维护 session

SDK

• 作为嵌入式客户端主动连接 Agent
• 默认不监听本地端口
• 通过 provider session 暴露函数能力

关键术语

shared session runtime

指共享的 session 运行时基座：

• tcp/tls
• framing
• request/response 复用
• reconnect
• heartbeat
• drain
• backpressure

subprotocol

指运行在 shared session runtime 之上的具体子协议：

• sdk-agent subprotocol
• agent-server subprotocol

它不是“配置模板”，而是“不同边界上的应用层协议变体”。

不再推荐的理解

以下旧概念不应再当作新设计依据：

• 历史 REQ/REP 作为主链路模型
• Server -> Agent 直接回拨
• rpc_addr 作为长期运行时入口
• SDK 开本地监听端口给 Agent