模桥 · ModelBridge 文档质量复核
本页基于 2026-10-31 整理,并随 2026-11-02 内部审查更新。它记录读者能从指南复述什么,以及哪些结论仍需另行验证;不重复完整 walkthrough。
Reader Simulation
| 读者问题 | 从指南能得到的答案 | 反查入口 |
|---|---|---|
| 项目解决什么,最短阅读路径是什么? | 同一共享网关核心在多个边缘入口统一供应商调用;先跟随一条聊天请求,再按概念深入或定位源码。 | 项目指南 |
| 输入和输出是什么,难点在哪里? | 输入是模型别名、消息与实例密钥;结果是客户端协议 JSON 或 SSE。调用权、目标账号和协议能力必须分别判定。 | 编号主流程 |
| 为什么有这些阶段? | 先鉴权防止匿名消耗,解析和筛选避免凭据串用,能力校验避免静默降级,有界切换避免重复生成。 | 模型与协议 |
| 三种凭据可以混用吗,配置会不会退回旧状态? | 管理、调用与上游凭据各自使用;SQLite 事务或 DO 串行更新保护当前权威,账号验证以版本检查防止覆盖。 | 访问与配置 |
| 正常、失败及边界行为能否举例? | walkthrough 给出合法别名请求及 401、413、白名单不匹配、限流和不确定结果;模块补充协议、并发与平台预算例子。 | walkthrough 与概念页 |
| 免费模型和本地取消是否保证不花钱? | 免费额度不是硬预算;不确定失败不重做,取消只说明本地传播,连接测试也可能有开销。 | 上游与配额 |
| 想改源码、文档或提交规则应看哪里? | 代码地图按 Worker、测试、工具、CI、站点定位;提交与安全边界在根规范中。 | 代码地图、贡献指南(仓库文件:CONTRIBUTING.md) |
| 怎样验证理解和交付状态? | 模拟回归、文档校验/构建、签名验证和线上验收分开记;历史消息规范化不改变代码树。 | 同步记录 |
| Makers 和 ESA 可以独立摆脱 Cloudflare 吗? | 可与 Cloudflare 远程入口共用自建 Node/SQLite 服务,无需 DO/KV;输入、时长及网络预算仍不同,真实云端另验。 | 多平台部署 |
| 迁出 DO 或恢复备份会不会恢复旧权限? | 切换前冻结旧写入,仅空库导入;恢复必须核对期间撤销,不自动切换权威或恢复旧快照。 | 迁移与备份 |
| Docker、TLS 和厂商打包是否都已验证? | 各有独立显式工具与结果:容器持久化/恢复、私有 CA TLS、Wrangler dry-run/workerd、ESA 本地 EW2;Makers 及真实云端仍有边界。 | 部署验收范围 |
| 旧行为接入新宿主时,取消和预算会不会互相干扰? | 单个订阅者取消不会终止共享统计;父请求取消不能被单次状态操作覆盖;ESA 诊断预算不足会在探针前拒绝,OAuth 控制响应另有总时长与大小限制。 | 上游与配额、状态生命周期 |
可理解性复核
主流程先说明一个可观察请求,再引入鉴权、目标与账号;源码名称放在阶段解释后。代码地图用于找责任,概念页分别说明配置、协议、资源和多平台机制。根中英 README 负责部署和接入,指南保持中文,术语表用于消除概念歧义。
反证检查(Falsifying check):若读者仍把模型列表当成权限保证、把三账号预算当成最多三次 HTTP 请求、或把模拟测试当成真实账单验收,应重新检查对应页面,而不是增加一张笼统“兼容”表。
下一位读者可能问(Next reader question):某个具体模型的图像、思考、工具和多轮回放能否用于自己的客户端?本指南给出检查入口和已知拒绝边界,不能替代该组合的真实账号验收。
剩余风险与范围
文档不证明供应商未来字段、计费或权限保持不变;默认免费模型目录也不是实时价格承诺。生产磁盘与恢复、HTTPS、云端流取消、OAuth 项目权限、模型输出质量和计费仍需在单独授权的验收中确认。SQLite 版本不承诺多机高可用。
文档站保留 VitePress 默认主题;已知开发搜索索引需重启刷新。构建成功证明页面可生成,不证明 Worker 业务或云端工作流已经通过。源码依据和排除范围见两遍调查记录,实际命令结果见指南同步记录。
证据状态:除特别标注外,本页基于当前源码已确认。