指南变更记录
最新阅读入口为项目指南。下文保留历次同步的原始提交锚点;2026-10-31 的本地历史信息整理只改消息和签名,旧对象仍由本机备份引用保留。
| Timestamp | Request | Actions | Verification | Result |
|---|---|---|---|---|
| 2026-10-29 19:08 Asia/Shanghai | widened docs sync:补齐中英文入口、中文源码指南和 Agent 路由 | 以一条主流程建立 Lite + 代码地图,保留既有丰富说明;文档站接入,根规则归一 | 两遍源码调查完成;文档校验及站点构建结果见下文 | Synced through 27e5f558fb689e67c7dd1b5fe545f1a306783aff;此锚点只标识当前 Git HEAD,工作树未提交行为不声明已发布 |
验证范围
文档结构校验通过(退出 0);独立站点构建通过(退出 0),输出在仓库外,未替换业务预览产物。
测试使用模拟上游;当前可读用例覆盖错误包、账号隔离、重试预算和协议转换,但本轮未运行这些业务测试。真实账号权限、云端持久化和生产流取消仍需独立验证。
统一维护复核(2026-10-29)
补齐中英 README 入口、贡献与安全说明;AGENTS 为规范正文,CLAUDE 为引用入口。补充钩子检查暂存内容、提交标题及推送新增历史,保留项目原有检查;安装步骤与边界见根 SECURITY 和 CONTRIBUTING。独立站点采用 VitePress 默认主题,源码链接在网页中保留为精确路径。
本地分支规范化了 20 条提交信息;重建对象均已验证 SSH 签名,文件树、署名、日期和父图保持对应。原引用有本机备份,远端与标签未改。
文档结构校验和站点构建均退出 0;共用护栏的 9 项隔离测试通过。业务测试、生产部署和远端发布未因此视为通过。大文件扫描边界见 SECURITY。
Synced through 27e5f558fb689e67c7dd1b5fe545f1a306783aff;源码树与原锚点对应,未提交实现仍按工作树单列。
文档站恢复默认主题(2026-10-29)
按用户要求统一使用 VitePress 默认主题,移除额外配色、字体、圆角和入场动效。指南正文、源码定位及导航保留;文档依赖与业务依赖分开。新建站点从 MkDocs 迁移为 VitePress,既有两个 VitePress 站点使用原生主题入口。
界面与配套实现整理(2026-10-29)
完善多上游协议转换、配置鉴权和响应安全边界,接入对应回归与持续集成;管理界面统一视觉层级。
验证:完整 Node 回归 225 项通过,Worker 语法检查通过;未执行线上部署。
Synced through f4fdf26ccd593489ddf0c9f9126417d18184399a;本节对应随后提交的工作树。
品牌入口与素材说明(2026-10-30)
因用户询问网页名称是否跟随 Worker 名称,前台同步代码地图中的品牌说明,并从阅读路径增加入口。明确网页静态显示名、内联图标与仓库 SVG 的维护位置;区分根 README 的素材链接和当前 Worker 提供的路由,说明演示截图用于项目展示。
本节逐项核对了页面模板、请求路由、Wrangler 配置、两个 SVG 和根 README;未为文档检查启动或修改运行服务。按既有 Lite 包运行文档结构与链接校验,退出 0,零错误、零警告;git diff --check 通过。本次文档检查未运行业务测试,不据此声明生产验收。
Synced through 12a0f67ef4d2e715e421104f31bac5a10a8c159c;锚点对应本轮检查的源码基线,本节与截图更新属于其后的工作树。
蓝色 Logo 接入业务界面(2026-10-30)
首页、管理侧栏和移动顶栏统一使用共享品牌组件,独立图标与浏览器页签改为仓库 SVG 对应的蓝色渐变版本;代码地图同步组件职责和数据地址的使用方式。品牌与部署服务名称保持独立,聊天输入输出和存储责任没有变化。
实际验证:完整 225 项模拟回归通过;本地页面完成登录、浅色和深色主题、320px/390px/768px 布局检查,未发现横向溢出或脚本错误。按既有 Lite 包执行文档校验,零错误、零警告。文档验证单独执行,不据此证明模型供应商权限或计费行为。
Synced through 12a0f67ef4d2e715e421104f31bac5a10a8c159c;本节对应其后的界面工作树。
再次审查后的边界修复(2026-10-31 12:21 Asia/Shanghai)
修复审查确认的九项问题,并处理同账号刷新重复请求和文档站主题回退。主流程补充请求读取限额、格式错误与超限响应、Gemini 异常结束及 Anthropic 拒绝语义;代码地图增加输入读取、向量结果校验、刷新合并和维护护栏入口。中英 README 与 Agent 命令同步 Python、Git 测试前提。源码证据页保留初次调查范围,后续实跑统一在此记录。
登录、管理写入和模型调用 JSON 分别限制为 16 KiB、1 MiB、16 MiB;按实际字节计数并取消超限读取,解析错误和异常日志不包含原始凭证片段。Gemini 内部转换直接交接已解析的数据,避免回放元数据膨胀导致对预算内请求误报 413。
Cloudflare 连接测试复用有界上游请求,传播取消,错误脱敏;向量输出检查数量、索引、有限数值、维度与编码,不把无效成功响应交给下游或重复生成。OAuth 在单一 Worker 实例内按凭据指纹合并正在执行的刷新,失败后释放。维护护栏会重查撤销例外但内容未变的文件,覆盖索引、提交历史及合并父项。文档站恢复原生主题入口,原有自定义文件已备份并保留,不再加载额外样式和动效。
实际验证:node --test tests/*.test.mjs 完整 259/259 通过,包含新增 34 项回归;旧版 Completions 测试改用真实 JSON 读取依赖后仍覆盖原有断言。Worker 语法检查通过,Lite 文档结构与链接校验零错误、零警告;文档站在仓库外构建成功,产物没有额外动画模块。CI 使用测试文件通配符覆盖新增用例,并检查 Python 版本。没有调用真实模型、部署、提交或推送,不据此声明真实账号权限、云端持久化或计费停止已验收。
Synced through 12a0f67ef4d2e715e421104f31bac5a10a8c159c;该锚点标记检查基线,本节对应其后的修复工作树,保留此前未提交变更。
后续修补与自动复审(2026-10-31 12:56 Asia/Shanghai)
修补再次审查确认的五项问题:切换供应商须显式更换凭据并清理原目标及 OAuth 身份;归一化 Gemini 嵌套别名与冲突;OpenAI 与 Anthropic 双向保留严格工具标记;保留上下文窗口截断;统一新旧嵌入配置并拒绝无法执行的跨供应商约束。JSON Schema 字面量不参与协议字段改写,不再静默丢失采样、思考和输出限制。
按用户要求接着启动独立审查,发现供应商内置工具被改成普通函数的遗漏,已改为调用前拒绝。复审同时收紧 Gemini 缓存上下文、续传及其他无法表达的顶层约束;原生供应商路由保留其语义。原生 Anthropic JSON/SSE 的服务端工具结果、引用和 citations_delta 有对应模拟验证。两部分独立复核完成后,未再发现新的可复现 P1/P2。
文档开发依赖保留 VitePress 1.6.4 默认主题,覆盖 Vite 到 6.4.5,锁定 esbuild 0.25.12;配置仅增加两个已知搜索虚拟模块的解析兼容。新增真实 Node HTTP/WebSocket 冒烟,并在文档 CI 中执行安装、依赖审计、冒烟和构建。剩余 P3:该 VitePress 版本的开发搜索索引需重启服务刷新,包版本及完整性与修补前相同;正文热更新正常,生产构建重新生成索引。本轮没有加入私有索引修改钩子。
实际验证:新增 27 项回归,node --test tests/*.test.mjs 完整 286/286 通过、退出 0;独立协议复核 17/17 通过,账号及资源边界复核 71/71 通过。干净 pnpm install --frozen-lockfile、pnpm audit 均退出 0,审计零告警;文档冒烟 1/1 通过,验证初始搜索、正文 HMR、源码链接、Host/CORS 和文件访问边界,自有服务及合成文件已清理。Worker 语法、文档结构链接和差异检查通过,文档站在仓库外构建成功。模型上游仍为模拟,未部署、提交或推送,不把本地验证当成真实账号权限或计费验收。
Synced through 12a0f67ef4d2e715e421104f31bac5a10a8c159c;本节对应其后的修补工作树,保留此前未提交变更。
提交信息与双语文档整理(2026-10-31 13:18 Asia/Shanghai)
按用户要求执行 widened docs sync,将 Lite 指南整理为 Standard:中英 README 使用对应的部署、首次调用、供应商、模型映射、Antigravity、协议、配额和验证入口;主走读重放一个明确示例,代码地图负责定位,三个概念页分别解释访问配置、路由协议和上游资源。补齐术语表,重新记录两遍源码调查与读者模拟;深入机制不再堆在代码地图中。根 Agent 规则保持操作约束,贡献指南和提交模板拥有消息规范,安全说明拥有报告与扫描边界。
核对源码、测试和 Cloudflare 官方说明后,明确映射不是封闭的模型白名单、空账号模型列表不限制路由、免费额度不是硬预算,公共 fetch 路由开关不是完整私网防火墙。修正 KV 缓存的旧表述:当前配置、会话与用量缓存均在 DO,KV 只参与旧配置首次迁移。模型输出的回放一致性、工具签名和不能跨协议表达的约束均有独立说明。
文档站为新增模块和术语表增加 include 页面与导航,保持指南正文单一来源。主题入口恢复 VitePress 默认主题;原有未提交装饰资源保留且不启用,原入口另有本机备份。未改动 Worker 业务实现或依赖。
经用户明确授权,规范本地 main 可达历史的 49 条标题,重建并使用当前配置的 SSH 密钥签署 52 个提交;不是由原作者重新签署。逐条核对文件树、作者、提交者、日期、父图顺序和消息正文,全部保持对应;52 个签名验证通过。新 HEAD 为 a7f2b31b72c71031cdc4a72ff4b7e50a9883a397,与原 HEAD 的代码树相同。原 HEAD 保留在本机 refs/backup/message-normalization-20261031/main,另保存并验证完整 bundle、旧新编号映射及核验报告。切换引用前后索引和工作树文件哈希一致,其他原有引用、标签和远端未改动;历史未发布。
本轮实际验证:Standard 文档校验 0 错误、0 警告;14 份文档的本地链接目标检查通过;文档站在仓库外构建成功,冒烟 1/1 通过(临时服务及合成文件已清理),差异检查通过。已知开发搜索索引仍需重启刷新。文档与历史整理没有重跑业务生成测试;整理前最后审查的 286/286 记录保留,不把它改写成本轮执行或生产验收。此前业务修补及本轮文档仍为未提交工作树,没有新建业务/文档提交、推送或部署。
Synced through a7f2b31b72c71031cdc4a72ff4b7e50a9883a397;该锚点与原 12a0f67ef4d2e715e421104f31bac5a10a8c159c 文件树相同,本节说明其后的未提交文档工作树。
开源发布与 Worker 部署(2026-11-01 11:08 Asia/Shanghai)
按用户授权,将已审阅的业务修补和维护护栏分别签名提交为 555b30f、2db31d3,配套双语文档和默认主题站点独立提交。原有未启用的装饰、动效及字体资源继续保留在本地,不递归加入发布。发布仓库确认是公开的 https://github.com/CyberNova2333/modelbridge;GitHub 原作者仓库保留为 upstream,GitHub 设为 origin。
按用户指定采用 AGPLv3(AGPL-3.0-only),根 LICENSE 使用标准许可全文,原上游 MIT 版权和许可逐字节保留到 LICENSES/WorkersAI2API-MIT.txt;NOTICE 说明来源与分发,双语 README、贡献规范和阅读入口同步。第三方依赖保留各自许可。推送前已确认无分支,首次推送不需要覆盖远端历史。最终提交编号与远端一致性以发布核验报告为准。
本轮重新执行 node --test tests/*.test.mjs,286/286 通过;Worker 语法、文档 Standard 结构链接及差异检查通过,依赖审计零漏洞,文档冒烟 1/1、仓库外构建与 Wrangler dry-run 成功。实际索引扫描和新提交 SSH 签名核验通过。业务回归使用模拟上游与存储,不以此声称真实账号权限或计费验证。
已使用现有登录态部署到 Cybernova2333@qq.com 的 aigateway,保留原 KV、CONFIG_STORE 与迁移配置,以 --keep-vars 保留线上变量。Cloudflare 版本 4e74f491-0c15-419d-80ae-5b1fc878b34c,于 2026-11-01 11:05 Asia/Shanghai 接收 100% 流量,绑定 aigateway.cbnv.top。部署内容对应 555b30f 的 Worker,后续只有维护工具及文档调整。部署前后公开首页、后台匿名跳转、三类模型/消息鉴权、管理 API 鉴权、robots 和未知路径共 8 项均通过;没有登录后台、读取私有配置或发起真实模型生成,不把公开路由烟测当作完整生产验收。
Synced through 2db31d3;该锚点包含已发布 Worker 与维护护栏,本节和配套许可、文档为随后的发布提交。
首页与 README 标题精简(2026-11-01)
按用户确认同时简化两处标题:首页将页首品牌作为唯一一级标题,移除独立宣传标题及其上方标签,简介和三个协议入口收为紧凑布局;浏览器页签直接使用品牌名。双语 README 将带字 Logo 作为唯一一级标题,保留图片替代文字,并更新使用本地合成数据的首页截图。后台各功能页标题保持原有职责,代码地图同步品牌与标题的关系。
本轮实际验证:Worker 语法检查和模拟回归 286/286 通过;浏览器检查 1280、390、320 像素宽度下的深浅两种主题,首页均只有一个可访问名称为“模桥 ModelBridge”的一级标题,品牌与按钮未重叠、页面无横向溢出。文档校验 0 错误、0 警告,文档站在仓库外构建成功。未调用真实模型;发布结果另以最终远端与部署核验为准。
Synced through 01c00e1f103a0ecbb512ed9cbbb570cd18c06a75;该锚点为本轮修改前基线,本节与标题调整在随后同一提交交付。
双语 README 居中题头与徽章(2026-11-01)
按用户给出的题头参考,将双语 README 的唯一 Logo 标题、语言切换和文档导航居中,增加 AGPL-3.0-only、Cloudflare Workers、JavaScript 与三类协议入口的蓝色静态徽章。徽章分别链接到已有许可证、部署章节、源码和协议指南;代码地图同步题头职责。
实际验证:两份 README 的一级标题、四枚徽章、图片替代文字及题头链接目标检查通过;本地桌面与手机预览通过,四枚远程徽章均可加载,窄屏可换行。文档校验 0 错误、0 警告,仓库外文档站构建成功。业务源码和部署配置未修改,未重新执行业务回归或部署 Worker;实际显示另于推送后核对。
Synced through 3e4fe2120641451903dc5b090c88cddb34cb32ad;该锚点为本轮题头调整前基线,本节在随后的文档提交交付。
三平台入口与独立状态通道(2026-11-02 19:22 Asia/Shanghai)
新增 EdgeOne Makers 和阿里云 ESA 入口,共享现有协议核心;Cloudflare 原生入口保留现有绑定、迁移与 DO 权威配置。createGateway 按请求注入状态、网络、可信客户端身份和输入预算。独立 Cloudflare 状态服务通过固定 HTTPS 端点、独立高熵服务令牌和精确 origin 范围转交现有 app-config-v1 DO,不以最终一致的 KV 替代当前配置。服务令牌属于绑定等价的高权限凭据,不提供被盗 Bearer 的防重放保证。
Makers 限制 1 MiB 输入;ESA 将状态、OAuth 和上游请求计入每次 4 个出站请求预算,并采用 9 秒首个响应数据、115 秒总时长限制。取消覆盖入站读取、状态响应体和上游流;运行时缺少原生取消 API 时拒绝服务。按请求网络依赖隔离 OAuth 正在执行的刷新,避免一个请求取消影响另一个请求;仍保留已完成令牌缓存和原生 Cloudflare 刷新合并。四条 SSE 响应分支统一去除逐跳连接头。
构建脚本生成 Cloudflare、Makers、ESA 和独立状态服务四套项目;静态目录与函数源码隔离,模板不复制本地 Secret 或生产绑定。新增平台模块说明、部署模板及读者入口,同步走读、代码地图、术语、安全边界和 CI。文档冒烟测试先等待 Vite 后台转换结束再关闭服务,修复断言完成后退出挂起的问题,原有断言保留。原有未跟踪主题资源保持不变。
实际验证:完整模拟回归 332/332 通过、退出 0(原有 286 项与新增 46 项);语法检查、四套产物构建及差异检查通过。文档冒烟连续两次 1/1 通过、退出 0,文档站构建成功,依赖审计零漏洞。Standard 指南校验 0 错误、1 条文风提示;该提示来自代码地图多个“重要代码”表头的重复词计数,未修改校验器或删除必要表头。冒烟合成文件与自有临时服务已清理。
本轮仅完成本地实现与模拟验证,未提交、推送、部署或调用真实模型。Makers 和 ESA 仍依赖 Cloudflare DO 状态服务;真实平台的持久化、SSE、断连传播、日志脱敏、出网及账号权限需另行验收,不能据本地测试声明生产兼容。
Synced through 7dfba0f1a7890b983cbe39f399383f3aa18a3b8f;该锚点为本轮改造前基线,本节对应其后的未提交工作树。
自建 SQLite 状态服务与 DO 可选化(2026-11-02 19:43 Asia/Shanghai)
按用户要求将推荐部署调整为自建 Node.js 24 + SQLite 权威状态服务,Cloudflare 远程入口、Makers 与 ESA 通过同一 HTTPS 协议访问,三者不再必须使用 Cloudflare DO/KV。共享 GatewayStateStore 保留配置、会话和用量规则;原 AppConfigStore 作为兼容类继续支持既有 DO 与旧 KV 首次迁移,不自动切换或双写权威。
SQLite 使用真实文件、WAL、FULL 同步和完整读改写事务;同连接操作排队,跨连接/进程锁争用采用有界异步等待。账号版本比较、撤销、限流和会话重启语义保留,统计网络请求在事务外执行。独立复核发现并修复仅含 VIEW 的其他数据库被误当空库接管的问题,初始化现在拒绝所有非系统 schema 对象。用量刷新合并仍限定单个服务实例;本方案面向单机本地磁盘,不声称多机高可用。
新增 Node HTTP 宿主,限制固定 RPC 路径、来源、输入、Header 和请求时长,传播断连并排空关闭;启动前验证配置并等待数据库就绪。新增受认证配置导出、空库导入和 SQLite 一致性备份工具,输出不打印私有配置、已有目标不覆盖。迁移仅导入配置,旧会话和用量缓存不复制。切换前冻结旧写入和恢复时核对撤销仍是维护者必须执行的步骤,工具不会自动操作运行实例。
新增 cloudflare-remote、self-hosted-state 产物,保留原四套项目。自建模板提供非 root Node 容器、SQLite 持久卷、文件 Secret 和 Caddy HTTPS,状态 HTTP 端口不映射到宿主机;边缘产物排除 Node 专用模块。主 README、平台模块、权限页、走读、代码地图、术语、安全与 Agent 约束同步为可选后端,新增迁移及备份说明,保留原有未跟踪主题资源。
实际验证:最终完整回归 372/372 通过、退出 0,本轮在上一版 332 项上新增 40 项。自建测试使用真实临时 SQLite、独立 Node 进程及本地 HTTP,覆盖并发更新、取消锁等待、事务回滚、重启、空库导入竞态、一致性备份,以及三个真实入口共用服务的 JSON/SSE、会话隔离和撤销;模型上游仍为模拟。语法检查、六套产物构建与差异检查通过;Docker Compose 配置解析通过,但未构建或启动容器。文档冒烟 1/1 通过,依赖审计零漏洞,文档站构建成功;Standard 校验 0 错误、1 条代码地图重复表头的文风提示。测试自有服务和临时数据已清理。
未提交、推送、部署或调用真实模型,未读取或迁移生产配置。生产磁盘、备份恢复、TLS、云平台 SSE/断连及真实账号权限仍需单独验收。原生 DO 实例和运行服务保持原状。
Synced through 7dfba0f1a7890b983cbe39f399383f3aa18a3b8f;该锚点仍为两轮平台改造前基线,本节对应其后的未提交工作树。
实际容器、TLS 与官方 CLI 验收(2026-11-02 20:11 Asia/Shanghai)
新增三个显式运行的部署验收工具:verify:container 实际构建自建服务镜像并验证持久化及恢复;verify:tls 使用生产 Caddy 模板和测试内部 CA 检查真实 HTTPS;verify:edge-builds 在隔离配置中运行固定版本官方 CLI,--esa-docker 增加 Linux EW2 验收。默认回归不下载这些工具或启动 Docker。主指南、代码地图、贡献命令与 Agent 入口同步,并补充停止服务、恢复到全新数据库路径、避免遗留 WAL/SHM 混用的操作说明。
Docker 29.9.2、容器 Node v24.22.2 下,默认 Dockerfile 构建及六组容器检查全部通过、退出 0:非 root UID 1000、数据库 0600/WAL、只读根文件系统与 Secret;真实私网配置/会话 RPC;重启与密钥/会话撤销持久化;在线备份;新独立卷恢复到准确备份点,同时源库后续变更保持不动。成功镜像 ID 为 sha256:053285ea538985338e15a00a9dc9468633cc6051d00480a92c04092c4e5a4f0c,用于审计本次构建,不是已发布镜像。独立 Linux 验证另运行 SQLite、状态维护和 HTTP 宿主 32 项,全部通过;补充检查跨 origin 会话、凭据隔离和恢复后撤销,未发现新的可复现业务问题。
TLS 最终八项全部通过、退出 0:未知 CA、错误主机名均被拒绝;受信任链上完成读写、错误服务令牌拒绝、origin 范围、路由限制与密钥撤销。Caddy 镜像 ID 为 sha256:36c24ad91a7ff7bc4c87fe22bfa8df3c4b18da0773d73fc12ee2c52b98c0bb7e。没有向主机信任库安装 CA、发布主机端口或申请公网证书。工具在创建前登记资源,清理前核对 UUID 标签及精确名称,无法确认清理时报告失败。
固定 Wrangler 4.156.1 的三个真实 dry-run 与本地 workerd 共 11 项路由/认证断言通过,包括原生 DO 登录和会话验证。原生、远程网关、DO 桥接产物分别为 416686、420909、412039 字节,未残留 Node 专用导入。Makers CLI 1.6.47 的命令和官方说明未提供独立 build/dry-run;未登录或匿名发布,因此保持未验收。ESA CLI 1.0.13 + EW2 1.0.0 在隔离 Linux 容器中真实构建 432295 字节产物并加载入口;缺配置拒绝与运行时探针通过,但本地 env 为 undefined,不能据此认定云端环境变量、远程状态链、断连传播及长 SSE 已通过。完整 CLI 检查及清理加固后的 ESA 定向复跑均退出 0;日志保留于本次输出的系统临时报告目录。
本轮没有修改网关协议或状态业务实现,未重复上一轮完整 372 项回归;上述实际容器、Linux、TLS 与厂商运行时结果单独记账。语法、六套产物构建和差异检查通过,Standard 指南校验 0 错误、1 条已有代码地图表头文风提示。测试自有服务、容器、卷、网络、临时私有夹具及专属测试镜像均清理,标准 Node/Caddy 下载缓存保留,CLI 报告及隔离工具目录留作复核。未提交、推送、登录云平台、部署公网服务或迁移生产配置;原有工作树与未跟踪主题资源保留。
Synced through 7dfba0f1a7890b983cbe39f399383f3aa18a3b8f;本节记录该基线之后的未提交本地部署验收工具与指南。
新旧实现交界内部审查(2026-11-02 22:00 Asia/Shanghai)
按用户要求交叉审查共享核心、原生 DO 兼容路径、远程状态通道、SQLite/HTTP 宿主、平台预算、OAuth、迁移备份、构建与部署模板,以及中英文入口和指南。重点通过反例检查旧逻辑接入新宿主后的取消、并发、凭据和资源边界;没有读取生产配置或调用真实模型。
| 分类 | 确认的问题 | 修复与验证依据 |
|---|---|---|
| P2 · 并发正确性 | 用量刷新合并继承第一个 SQLite 请求的取消上下文,A 取消导致仍有效的 B 失败 | 共享任务脱离订阅者上下文,每个调用者检查自身取消;增加存储关闭信号,统计请求受 15 秒完整读取和 16 MiB 限制,关闭时取消并排空;tests/sqlite-state.test.mjs 覆盖 A/B、全取消、响应头/体挂起与停止后续查询 |
| P2 · 取消正确性 | 单次远程状态操作的 init.signal 覆盖父请求信号,可能越过平台取消范围 | 同时监听父子信号,任意一方取消即终止;已取消父请求不发送网络请求;tests/remote-state.test.mjs 覆盖两种信号及提前取消 |
| P2 · 资源与生命周期 | OAuth/项目查询直接读取 JSON,没有大小上限;响应头到达后取消可能留下悬挂读取与刷新记录 | 共用有界读取,每次控制请求限制 1 MiB、20 秒完整阶段,保留原生 Cloudflare 刷新合并;tests/oauth-runtime-scope.test.mjs 覆盖取消、超限不缓存和持续滴流的总时限 |
| P2 · 平台逻辑与配额 | ESA 已有 Cloudflare 账号诊断只剩两次 fetch,却启动三项探针,可能先执行付费推理再报权限失败 | 发探针前检查完整三次预算,不足返回 503 platform_subrequest_limit 且零上游探针;tests/platform-runtime.test.mjs 覆盖已有及新账号差异 |
| P2 · 构建文件安全 | 预期输出文件是硬链接时,重建会连带覆盖目录外同一文件 | 在任何写入前拒绝多链接输出;tests/platform-build.test.mjs 验证所有产物及目录外文件均未改变 |
| P3 · 授权输入正确性 | 摘要正则隐式接受数组,出现登录成功但会话无法验证等异常 | 所有摘要字段要求字符串;非法输入在访问存储前 400,配置与已有会话不变。属于类型加固,没有证明越权路径 |
| 测试缺陷 | 旧诊断及 OAuth 测试用固定次数事件循环轮询等待,完整并发测试时可能过早断言 | 改为请求、计时器转换及实际刷新加入事件的就绪 Promise,保留原断言与有界测试超时;tests/review-upstream-regressions.test.mjs |
旧配置导入校验继续复用原 DO 的 validAppConfig;独立复核使用三类历史形状确认导入后原样读回,并检查非法配置操作不修改当前配置。原生 DO 的统计网络默认行为保留;新增统计关闭与有界传输属于 SQLite 宿主。共享任务的 15 秒限制是每次 HTTP 请求,不是整批刷新总时限。未增加跨请求配置缓存,也未放宽密钥撤销和不确定结果不重试的约束。
文档前台同步:纠正用量刷新仍由 DO 独占及 OAuth 只列 Makers/ESA 的旧说明;中英 README 明确共享核心与平台限额的区别、原生 Pages 的 DO 范围;ESA 模板明确本地 dev 的云端 env 缺失边界;平台页、上游页、主走读、代码地图与证据/质量复核同步新行为。
实际验证:首次全量 381 项中 380 项通过,唯一失败为上述旧测试等待竞态;该次未包含随后完成的摘要类型新增用例。修复测试后,最终完整 node --test tests/*.test.mjs 382/382 通过,退出 0(约 21.35 秒)。最终 Linux 六文件专项 58/58 通过,退出 0,容器禁网、UID 1000、只读仓库及根文件系统,临时数据位于 tmpfs,已核对无残留测试容器。构建/迁移工具另在 Windows 和 Linux 各 11 项通过;这些专项与完整测试存在重叠,不累计为独立覆盖数。
pnpm run check、六套产物构建及 git diff --check 通过。文档依赖审计零漏洞,默认主题开发冒烟 1/1 通过,文档站构建成功;Standard 指南校验 0 错误、1 条已有代码地图重复表头文风提示。此前 Docker/TLS/厂商 CLI 验收属于上一节记录的源码版本,本轮没有重新运行整套官方 CLI 或公网验收,不能将旧验收结果视为本轮云端发布证明。
本轮未发现新的可复现越权、供应商凭据串用或撤销密钥复活路径,不据此声称没有其他漏洞。性能审查覆盖有界读取、取消清理、锁内无网络与共享刷新;没有进行生产规模的吞吐/延迟压测,每请求远程读取完整配置与单机 SQLite 的容量仍需按实际配置规模评估。Makers、ESA 云端环境变量、真实断连/SSE、权限及生产磁盘恢复仍待单独验收。未提交、推送、部署或迁移生产状态;保留原有未提交工作和未启用的主题资源。
Synced through 7dfba0f1a7890b983cbe39f399383f3aa18a3b8f;该锚点仍为改造前基线,本节记录其后工作树的审查与修复。
第二轮内部审查(2026-11-02 22:18 Asia/Shanghai)
复核上一轮修复,并沿数据库路径/WAL、平台成功与错误响应、旧诊断网络调用及大模型目录检查交界。修复五项行为问题,并单列一项防御性错误脱敏加固:
| 分类 | 复现与影响 | 最终处理 |
|---|---|---|
| P2 · 状态完整性 | 主文件 checkpoint 后创建硬链接别名,再由原连接撤销密钥写入 WAL;从别名备份成功,但快照仍含已撤销密钥 | SQLite 打开和备份来源均在连接前拒绝 nlink !== 1,原路径和别名都拒绝;回归检查 DB/WAL/SHM 未改变,移除别名后正常备份保留撤销。内部发布快照的临时链接仍可用,最终输出 nlink=1 |
| P2 · 性能 | 模型目录逐条 Array.some 去重,合法大配置产生平方级扫描 | 使用 Set 去重,保留展示顺序、同名首条元数据、供应商前缀及禁用过滤;不增加跨请求配置缓存 |
| P2 · 请求清理 | POST /、OPTIONS 等成功路由不消费上传体,适配器只对错误响应取消上传 | 所有路由返回后释放未使用上传;以可观察取消的流回归验证 |
| P2 · 诊断生命周期 | 通用模型目录诊断没有转发当前请求取消,并等待可能永不完成的 body.cancel() | 复用有界 GET 传输,转发取消,15 秒响应头/闲置预算,取消无用正文时不等待底层回调;HTTP 错误仍只请求一次模型目录、不触发生成 |
| P3 · HTTP 一致性 | HEAD 的缺配置、状态构造失败及缺原生 signal 分支仍返回 JSON 正文 | 所有平台错误响应遵守 HEAD 无正文,保留状态和安全响应头 |
| 防御性加固 | 测试传输抛出包含合成凭据的异常时,OAuth/项目准备可经管理或推理错误回显诊断 | 控制传输错误改用固定说明;HTTP 明确拒绝保留状态码,错误体仍不读取。此复现不证明供应商能够控制底层 fetch 异常或已经发生线上泄露 |
本地完整网关目录夹具中,1000/5000/10000 条模型声明的首次观测为 37/210/629 ms;集合去重后为 40/10/17 ms。最大配置约 129 KB,结果 20000 条,回归另检查 5000 条与多账号重名的顺序和元数据。这是本机合成输入的算法对比,包含启动/解析开销,不是云平台 CPU 或生产吞吐承诺。
对上一轮 SQLite 统计传输新增 12 情形对照:HTTP 401/403 与 200 明确鉴权错误可换同账号凭据;混合错误、查询错误、429/503、重定向、网络异常、坏 JSON、停滞正文均不扩散重试,未发现包装改变旧规则。ESA 另补新 Cloudflare 账号的正例,认证一次加三项探针恰好四次 fetch,避免预算预检误禁可完成的诊断。
实际验证:最终完整 node --test tests/*.test.mjs 394/394 通过,退出 0(约 28.63 秒,较上一轮新增 12 项)。Windows 定向状态测试 64/64、平台/OAuth/诊断 75/75、模型目录 5/5 均通过;Linux 禁网、非 root、只读容器的 SQLite/HTTP 专项 32/32,以及构建/备份专项 12/12 均退出 0,任务容器已删除并按标签核对无残留。专项包含重叠用例,不累加计算覆盖数。
语法检查、六套部署产物构建、差异检查通过;文档依赖审计零漏洞,文档结构校验 0 错误、1 条已有代码地图表头文风提示,文档站构建成功。同步平台与备份说明、模型路由页、上游页、主走读及证据记录。本轮没有变更站点配置,未重复上一轮已通过的开发服务冒烟,也未重新运行官方云 CLI、容器 TLS 或生产压测。
剩余边界仍为生产容量、Makers/ESA 云端 Secret、真实 SSE/断连、上游权限以及生产磁盘/恢复验收;数据库路径检查不能代替私有目录权限,也不支持运行时由其他进程更换文件。未提交、推送、部署、迁移生产状态或调用真实模型;保留原有工作树和未启用主题资源。
Synced through 7dfba0f1a7890b983cbe39f399383f3aa18a3b8f;本节对应该基线后的第二轮审查工作树。
第三轮内部审查(2026-11-02 22:35 Asia/Shanghai)
沿前两轮的容量、认证、清理与旧协议交界继续检查,确认三项缺陷,另完成一项资源边界加固。修改均有修复前反例与修复后回归;没有部署、调用真实模型或读取生产配置。
| 分类 | 复现与影响 | 最终处理 |
|---|---|---|
| P2 · 迁移完整性 | 恰为 16 MiB 的合法配置可存储和远程读取,但导出加入格式与时间后超过同一文件限额,导致导出失败 | 文件单独保留 1 KiB 元数据空间;内部配置仍限 16 MiB。真实 SQLite→认证服务→导出→新库导入通过,超限配置在创建目标库前拒绝;tests/state-admin.test.mjs |
| P2 · 上游生命周期 | 通用及 Antigravity 的非 SSE 拒绝、思考响应拒绝三个真实路由等待 body.cancel();底层回调未决使错误响应一直挂起 | 共享 fetchUpstream 本地闭合、清理计时器并发中止信号后,不等待底层取消确认;同步抛错和异步拒绝也被隔离。待决客户端读取正常结束、三个拒绝仍只生成一次;tests/gateway-runtime.test.mjs |
| P2 · HTTP 连接资源 | CONNECT、Upgrade 和原始解析错误只发送 FIN;客户端保留写半边,宿主可长期持有连接 | 这些拒绝路径统一增加 250 ms 强制关闭,正常关闭提前清计时器。真实半开 TCP 回归先失败后通过;tests/self-hosted-server.test.mjs |
| 资源边界加固 | 宿主先缓冲正文才进入服务认证,无效 Bearer 的停滞上传等待到截止后才返回 504 | 复用服务层同一请求头认证函数,在读取正文前返回 401;不进入存储,不回显令牌。未发现鉴权绕过 |
没有为反证通过的路径增加修复:Expect 上传在 120 秒请求截止配置下,417 后仍及时关闭半开连接;SQLite 配置更新超过记录上限时完整回滚,之后撤销密钥仍成功。后者加入永久回归。恶意 JSON 键诊断未发现原型污染或非法映射覆盖;独立复核还检查合法 keepalive、拒绝仅关闭对应连接,以及认证计算期间断连不进入存储。
核实原生 DO 使用 new_sqlite_classes,其 key/value 合计的 2 MB 官方限制与旧 KV 后端的 128 KiB 不同;没有将旧后端限制误报为当前会话存储漏洞。平台指南补充 DO/自建容量差异、配置与迁移文件大小区别、HTTP 前置认证及连接清理;上游页和主走读同步取消不等待底层确认的含义,部署说明和证据页同步。
实际验证:最终完整 node --test tests/*.test.mjs 405/405 通过,退出 0(约 28.99 秒,较上一轮新增 11 项)。Windows 取消与旧协议专项 111/111、状态/HTTP 专项 52/52、维护与远程专项 29/29 均通过;最终 HTTP 专项含 Expect 反证 15/15 通过。Linux Node 24 的状态/HTTP 专项 52/52、导入导出专项 7/7 均退出 0,禁网、非 root、只读仓库及根文件系统,临时数据位于 tmpfs,专属容器已清理。各专项有重复覆盖,不累加为独立用例总数。
语法检查、六套部署产物构建和差异检查通过。文档依赖审计零漏洞,文档站构建成功;指南结构校验 0 错误、1 条已有代码地图文风提示。本轮未改站点配置,未重跑开发服务冒烟、官方云 CLI 或整套容器 TLS 验收;此前验收记录仍只对应当时源码。
本轮没有复现新的越权、凭据串用或撤销复活路径;不能据此声称没有其他漏洞。16 MiB 边界回归验证存储、回滚与迁移正确性,不是生产容量压测。真实云端 Secret、SSE/断连、上游权限、生产磁盘恢复和吞吐仍待按部署环境验收。未提交、推送、部署或迁移生产状态,保留既有工作树与未启用的主题资源。
Synced through 7dfba0f1a7890b983cbe39f399383f3aa18a3b8f;本节对应该基线后的第三轮审查工作树。
2026-11-15 文档体系重置与双语文档站校准(Synced through 60592ed)
继 a70bfee(前端多语言自动重定向)、ebc508b(meta.json)与 60592ed(接入 guideLinks 与 Vite 6 本地搜索兼容插件)之后,本轮依据根目录 _worker.js、src/、tools/、deploy/、wrangler.toml、cloudflare-model-map.json 与 tests/*.test.mjs 对全仓文档体系实施“单一事实来源、分角色渐进导航”重置,未改动任何网关或状态服务业务源码:
- 双语入口中枢重置:重写根目录
README.md与README.en.md(严格 6 节架构,各 80 行),覆盖定位边界、6 节点 Mermaid 请求与配置流转图、4 行本地验证 Quick Start + 5 种运行/部署模式跳转表、4 项前置选型 FAQ、Reading Paths 路由表及AGPL-3.0-only/ WorkersAI2API MIT 来源声明。 docs-site/Tier B 三阶段重构与虚构模板清理:清理此前引入的不实通用模板页(/docs/configuration、/docs/faq及其en/副本中虚构的@modelbridge/adapter-*、import { ModelBridge }与Ollama独立 provider 等描述),按三阶段重组.vitepress/config.mts中英文导航与侧栏:起步与配置部署(docs/index.md、docs/deployment-faq.md及en/对应页):涵盖 Workers 原生 DO /AppConfigStore、Cloudflare Remote、EdgeOne Makers、阿里云 ESA、自建 Node.js 24 + SQLite(WAL)、DB_PATH/HOST/PORT/MODELBRIDGE_STATE_*变量矩阵、65 条预设别名与排错 FAQ;接口与扩展契约(docs/contracts.md、docs/adapters.md及en/对应页):涵盖四态凭据隔离、限额、自定义baseUrlSSRF 校验、resolveModelName优先级、validateReplayMetadata、401/403/404/429有界切换与扩展指南;原理与源码导览(含决策迁移)(docs/architecture.md、docs/migrations.md及en/对应页):保留/diagrams/modelbridge-architecture.html交互式全景图,汇总五项核心 ADR 与tools/state-admin.mjs迁移/热备份 Runbook。
- 恢复
repo-docs/站点映射与双语防 404 对称:依据config.mts中既有的pages表补齐docs-site/下 10 份薄@include包装页(其中高密度审计台账change-log.md与references/*设search: false以维持 dev 模式本地搜索响应低于冒烟2 MiB预算),并配套补齐 10 份docs-site/en/英文伴随导览页以配合theme/i18n.ts语言重定向避免 404;完整保留.vitepress/theme/、.vitepress/guide-links.mts与public/diagrams/modelbridge-architecture.html。 - 文档规范与护栏校准:清理
DESIGN.md中的本机 Windows 绝对路径(D:/...);更新repo-docs/README.md、repo-docs/code-map.md与repo-docs/modules/platform-adapters.md(修正临时审计锁文件路径引用,消除不存在仓库路径告警)。
Synced through 60592ed6f79b1739448c4fc544436a6a0dc9d01e。