模桥术语表
| 术语 | 项目里的意思 | 延伸阅读 |
|---|---|---|
| 模桥(ModelBridge) | 网页与仓库的项目品牌;不同于部署时设置的 Worker 服务名 | 品牌与部署名称 |
| 管理员 Secret | 部署环境中的 ADMIN_PASSWORD,用于登录换取后台会话 | 访问权限与配置 |
| 管理员会话 | 服务端可撤销、限定来源和有效期的登录状态;不是密码哈希或调用密钥 | 访问权限与配置 |
| 调用密钥(API Key) | 网关签发给客户端使用的模型接口凭据;不直接发送给供应商 | 访问权限与配置 |
| 上游凭据 | 供应商 API Key、Cloudflare Token 或 OAuth 刷新令牌,由被选中账号使用 | 访问权限与配置 |
| 配置权威 | 实例唯一的当前配置来源,选择自建 SQLite 或原生 DO;故障不自动切换到旧快照 | 配置持久化 |
| 状态引擎(GatewayStateStore) | 共用配置、会话和用量规则,由 SQLite 或 DO 持久化适配器执行 | 平台状态边界 |
| 配置对象(AppConfigStore) | 原生 Durable Object 兼容类,保留旧 KV 首次迁移 | 平台状态边界 |
| 自建状态服务 | Node.js HTTP 宿主和本地 SQLite 持久化,经 HTTPS 供多个边缘入口访问 | 自建持久化 |
| 状态数据库路径(DB_PATH) | 自建服务使用的本地 SQLite 文件;恢复时选择全新路径,再调整该变量 | 备份恢复 |
| 本地平台运行时 | Wrangler 使用 workerd,ESA Linux CLI 使用 EW2;本地打包、入口和 API 检查不等于云端环境变量、权限及容量验收 | 验收范围 |
| 命名配置实例(app-config-v1) | 同一 DO 命名空间内选定权威实例的名称;跨平台不能误用另一个宿主命名空间 | 配置持久化 |
| 状态服务令牌(MODELBRIDGE_STATE_TOKEN) | 远程网关访问配置服务的高权限服务端 Secret,不是客户端调用密钥 | 服务凭据 |
| 状态入口范围(MODELBRIDGE_STATE_ORIGINS) | 状态服务允许的精确 HTTPS origin 列表;额外限制服务令牌的使用范围 | 服务凭据 |
| 客户端地址头(CF-Connecting-IP) | Cloudflare 提供的地址信息;远程入口还要求运行时 request.cf 元数据,Makers/ESA 不信任客户端填写的同名头 | 登录限流身份 |
| 账号版本比较(CAS) | 异步验证之后,只有账号仍与验证前一致才保存;冲突返回 409 | 配置持久化 |
| 模型别名与目标 | 别名是客户端名称,目标决定供应商、实际模型或指定账号;映射不是封闭名称白名单。指南中的 my-chat、chat-small 是示例别名,example-chat、provider-model 是示例上游模型标识 | 模型路由 |
| 账号模型列表 | models 非空时限制该账号可承接的实际模型;空列表表示不限制 | 模型路由 |
| 原生协议与跨协议转换 | 前者保留供应商原有消息/事件形状,后者要求内容和约束能在另一协议中表达 | 协议边界 |
| 上游调用器 | callOpenAICompatibleAPI 负责按已解析目标选择普通上游并处理转换;函数名不表示只接入 OpenAI | 代码地图 |
| 回放元数据 | 保存原生历史、工具和签名的扩展内容,必须与可见文本、参数及结果一致 | 历史一致性 |
| 服务端发送事件(SSE) | 逐段传送结果或错误的事件流;HTTP 200 不代表后续全部成功 | 结束与错误语义 |
| 明确拒绝与不确定结果 | 前者允许在预算内换账号,后者可能已生成或计费,因此不再补发生成 | 重试边界 |
| 刷新合并(singleflight) | 共用正在进行的刷新;原生 OAuth 在单 Worker 实例内,带请求级网络取消的适配器限制在同一网络上下文内,用量刷新在配置对象内 | 刷新与缓存 |
| 环境账号集合 | ANTIGRAVITY_ACCOUNTS Secret 中的 Antigravity JSON 账号数组;与后台账号共同参与选择,但不导入后台编辑列表 | 环境账号格式 |
| 免费额度与硬预算 | 前者是映射及面板的参考口径,后者需强制阻止超支;当前网关没有将两者等同 | 配额边界 |
| 模拟上游验证 | 本地测试控制模型响应;部分状态测试使用真实 SQLite/HTTP,仍不证明云平台、真实账号或实际计费停止 | 验证记录 |
证据状态:除特别标注外,本页基于当前源码已确认。