术语速查:把实现说成人话
先把术语对齐,再读实现会轻松很多。
常用词对照
| 术语 | 一句话解释 | 相关入口 |
|---|---|---|
| Gateway | 网关主进程:连接、鉴权、分发、广播与审计 | Gateway 协议 / 健康检查 |
| WS(WebSocket) | 一条不断开的控制面通道:先 connect,再 subscribe/call | Gateway 协议 |
| method | 客户端请求网关执行的动作名(如 chat.send) | TypeBox |
| event | 网关主动推送的通知(流式回复、审批、日志等) | Control UI |
| sessionKey | “这条消息属于哪个会话”的稳定钥匙 | 会话管理 / Session tool |
| runId | 一次具体执行任务的编号(用来追踪日志/事件) | 日志 |
| lane / queue | 排队与并发底座:同 key 串行,不同 key 可并行 | 队列与 Lane |
| scope | 权限范围:决定能调用哪些方法/事件 | 认证与权限 |
| tool policy | 工具允许/拒绝/分组等策略流水线(收敛工具面) | 工具系统 |
| approval | 高风险执行的人工闸门(允许/拒绝/超时) | approvals / 执行审批 |
| fallback | 失败回退:当前模型/提供商失败时切换候选 | 模型故障转移 |
| hot reload / restart | 配置生效策略:不停进程应用 vs 需要重启生效 | Gateway 配置 |
先记住 4 句话
sessionKey决定“这条消息属于哪个会话”。lane + queue决定“任务怎么排队执行”。scope + approval决定“有没有权限执行敏感动作”。runId决定“你在日志与事件里怎么把一次执行追到底”。