CALLANYTHING
DOCS · PROTOCOL ARCHITECTURE

协议架构
控制面与数据面

这页把首页里偏工程层的 FOR ENGINEERS 内容单独拉出来,集中解释一根 Hotline 是如何被发起、被路由、被交付,以及 Platform / Selfhost 为什么不在业务数据面里 hop。

ProtocolControl planeData planeSelfhost

Protocol = 真相源

所有 Hotline 共享同一份 contracts 定义。调用外形、token 模型、状态机、TransportAdapter 抽象都从这里生长出来。

Client = 本地执行面

Caller Controller 和 Responder Controller 都跑在用户自己的 runtime 里。你可以只跑一边,也可以同机双边联调。

Platform / Selfhost = 控制面

Catalog、token、delivery-meta、metrics 走控制面;公网 Platform 与自托管 Selfhost 只是同一控制面服务的两种部署形态。

FOR ENGINEERS

协议是这样运转的

如果你想知道一根 Hotline 在工程层面如何被发起、被路由、被结算,下面这块可以展开。

FOR ENGINEERS展开协议详情

PROTOCOL

协议层 · 真相源

定义合约形状、token 模型、状态机与 transport 抽象。发布为 @delexec/contracts,所有组件遵守同一份真相源

CLIENT

用户本地进程组

Caller Controller 发起调用、Responder Controller 暴露 Hotline、Ops Supervisor 编排进程。一台机器可只跑一边、也可同机两边

PLATFORM

控制面服务

catalog · token · delivery-meta · metrics。官方托管的公共控制面,不在数据面 hop 业务流量

SELFHOST

Platform 自托管形态

同一份控制面服务的两种部署方式:用公有 Platform、或在企业内自托管 Selfhost,能力对等

网络拓扑

PROTOCOL: @delexec/contractsTHE SINGLE SOURCE OF TRUTHPLATFORM控制面服务catalog · token · delivery-meta · metrics或 SELFHOST同组件 · 两种部署HTTPS · 请求/响应HTTPS · 请求/响应CLIENT (本地进程组)CALLERCONTROLLERCLIENT (本地进程组)RESPONDERCONTROLLERTaskContractTRANSPORT ADAPTERlocal · relay_http · emailResultPackage

Client = 用户本地进程组。图中按"分机部署"展示便于讲清双向通信; 实际上一个 Client 也可以同时承载 Caller + Responder 两个 Controller(同机部署,由 Ops Supervisor 编排)。

控制面 · HTTPS

Client 主动调 Platform / Selfhost
catalog · token · delivery-meta · metrics

数据面 · TransportAdapter

TaskContract Caller CtrlResponder Ctrl
ResultPackage Responder CtrlCaller Ctrl

部署形态

PlatformSelfhost 二选一 · 能力对等
Client 可只跑一边、也可同机两边

工作机制

PROTOCOL 是真相源;CLIENT(用户本地)跑 Caller / Responder Controller,是协议的实施者;PLATFORMSELFHOST是同一份控制面服务的两种部署形态。控制面走 HTTPS(catalog · token · delivery-meta · metrics);业务流量走 TransportAdapter(local · relay_http · email)—— Platform 不在数据面 hop

PAGE FAQ

关于协议架构的 3 个常见问题

这页优先回答工程团队第一次看到 CALL ANYTHING 架构图时最容易卡住的点。

协议架构页主要解释什么?

这页专门解释 Protocol、Client、Platform、Selfhost 四层各自负责什么,以及 control plane 和 data plane 为什么要分开。它解决的是“系统怎么运转”,不是“品牌为什么成立”。

为什么要把这部分从首页拆出来?

因为首页主要负责产品定位、Marketplace 和 Hotline 商业模型。架构图适合工程师深读,但放在首页会把检索意图和答案引擎抽取意图混在一起,拆出去后边界更清晰。

Platform 和 Selfhost 到底是什么关系?

它们是同一份控制面服务的两种部署方式。Platform 是官方托管形态,Selfhost 是你在自己基础设施里部署同样的控制面能力;协议和调用外形不变,运营边界不同。

NEXT

继续往哪看

如果你已经知道控制面和数据面怎么分,再顺着这些稳定入口继续就够了。