Files
Agent-Workbench/docs/QA-M2-REQUEST-CONTRACT.md
T
2026-11-07 16:18:59 +08:00

50 lines
7.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# M2 请求版本、认证、路径与头:验收及回顾
2026-11-07,承接 [切片计划](M2-REQUEST-CONTRACT-PLAN.md) 与 [官方优先路线](DEVELOPMENT-ROADMAP-OFFICIAL-FIRST.md)。来源 `337d1bc9`、核心 `f95507ab`、界面 `26472d28`,分支 `feat/task-agreement-1.25`。本批完成 I14 现有三协议请求契约,以及 I12 非提示参数与版本指纹;I09/I11、CI 与 M3 发行仍独立待验。
新任务能使用与所选供应商相符的版本、认证、Beta、额外请求头和路径;错误中能核对当次准备交给 fetch 的设置、原上游响应与版本。原运行保留冻结契约,修改连接不会重新解释旧规格或原生参数。未知 Beta/版本值和普通头继续透传,上游不接受时保留一次原错误。
## 实际交付
- 官方来源固定为 request defaults `2026-11-07.1`。新官方 Anthropic 使用 `2026-10-21`/Bearer,已有连接仍保留 `2023-06-01`/原鉴权。官方版本历史说明新版不接受 `temperature`、`top_p`、`top_k`;工作台保留用户原参数,收到上游 400 后不删参数或换版本重发。DeepSeek Messages 的可选版本头和实际目录/模型路径分别处理。详见 [来源与契约](MODEL-REQUEST-CONTRACT.md)。
- 额外请求头可覆盖同名默认头,`null` 可移除;自定义路径绑定当前服务域名。`{{credential}}` 引用独立保存的 Key,普通设置不保存鉴权字面凭据。未增加头数量、大小或 token 额度。
- 版本、Beta、普通非认证头修改保持原加密绑定;认证、凭据来源、端点或路径改变使旧绑定失效,改回设置不会让旧绑定复活。目录能力声明另绑定实际目录 URL、有效头模板和凭据修订;组织/项目等变化不能继续采用旧目录事实,原件仍保留。
- 混合模型池成员冻结并发送各自契约。原 request body SHA 与 ordered-prefix v1/v2 不变;新增非提示设置指纹独立核对型号、地址、头、身份与非提示参数。指纹一致不证明上游缓存命中。
- `prepared-fetch-arguments` 表示当次准备给 fetch 的参数,公开记录使用脱敏表示;`frozen-run-contract` 表示原 Run 快照推导的设置。界面分别显示实际请求与冻结请求,凭据用引用/模板表示,传输层补充的 HTTP 头不冒称已经完整观察。
- 模型中心支持保存/恢复版本、Beta、头、路径,目录使用同一契约。请求账本、错误原文与上下文详情可核对对应来源。原没有这些元数据的 unknown 记录不会被补造。长通知已移入内容滚动流,展开完整错误和请求头后下一连接按钮可正常操作;保留 Orven 原布局和三配色。
## 验证
| 范围 | 原证据及结果 | 可证明范围 |
| --- | --- | --- |
| 最后源码相关检查 | `source-contract-final.log`,38/38;`typecheck-final.log` 通过 | 请求契约、规格绑定、原前缀和声明类型 |
| 独立首候选相关检查 | `candidate-backend-1.log`,143/143 | 冻结后的12个相关测试文件;最终176后端/209测试输入逐 SHA 未变 |
| 最终独立构建 | `build-3` → `candidate-app-3`,871输入/29编译/74runtime | 工作源码与冻结输入一致、编译及运行复制一致;不是正式发行 |
| 网页最终验收 | `web-ui-4`,8组/8图,1280/390 | 真实自有 HTTP、保存、目录分页、错误、账本、重启后凭据及原存储恢复 |
| 实际桌面最终验收 | `electron-ui-1`,8组/8图,1280/390 | 候选 Electron 原生 capturePage,隐藏窗口保持;正常关窗/停止自有宿主后独立重开存储 |
最终两端各3次自有模型 POST、2次自有目录 GET;两端合计6 POST/4 GET仅是最终 UI 轮次,未把它当成本阶段全部合成请求数。页面错误与外部浏览器请求均0;原 metadata、DPAPI cipher 和原存储 JSON 快照逐字节 exact。合成 Key 与子连接共享来源恢复通过;全部16图 SHA 核对,8张最终宽窄图实际打开复看,三配色被测文字对比度均大于4.5。
`identity-final-report.json`、`source-git-final-proof.json`、`visual-review.json`、`owned-processes-final.json` 保存输入、Git、渲染及清理依据。上一 I13 4328份/I15 5688份原件和 manifest SHA 只读复核一致,构建依赖 junction 不递归读取。自有候选进程与最终原件中出现的已知端口监听均0;未查询正式4318。
## 首失败与复验保留
1. 首专项5/9及自有残留进程处置、第二轮8/9与第三轮9/9分开。相关113/114中的真实冻结规格回归已修:不把 native/override 加进旧快照规格绑定。原空规格默认调用 TypeError 也保留,缺项守卫另验。
2. 第二轮相关142/143的 SSE 断言误读 `result.content`,真实 API 为 `result.message.content`。原驱动封存,独立1/1补验;中间21/21和22/22不代签最后38/38。首次未找到 Node 的构建没有实际运行,后一次早于最后补强。
3. 暂存扫描器把旧标识符里的4处 `sk-` 片段当成凭据,原扫描器/分类保留;词边界修正后原字节 Git 核对通过,未打印值或读取真实 Key。
4. 网页1因品牌标签精确匹配失败且0请求;网页2发现真实通知覆盖缺陷,原 pointer interception、DOM、图和驱动保留,修产品后重新构建。网页3七组/八图及原存储一致,最终验收器将存储 JSON 与含 undefined 的内存对象相比而失败;修为比较解析后的原存储,产品未再改动,网页4全过。
5. 最后身份复核首轮错误期待 TAP `#` 计数,原 Node 输出为 `ℹ` 计数;首驱动/日志保留,第二轮身份核对通过,没有重跑产品测试。
6. Mnemo只读子脚本已成功,父包装器的同名回执路径触发 EEXIST。保留子原件,用新文件核对既有回执,未重读源报告或重发网络请求。
这些原轮次、驱动输入、日志、截图和 SHA 全部进入新证据清单;原失败不会被后来的通过覆盖。完整机器记录:[m2-request-contract-2026-11-07.json](m2-request-contract-2026-11-07.json)。
## 封存与后续
新根 `.qa/m2-request-contract-2026-11-07/` 已封存 3207 份、1498866416 字节。MANIFEST SHA256 `3963ad9e02d3f62c1ae4d5fefcb59fdc0bcdc63682be1c72109542a60a2b408c`,三个构建依赖 junction 仅记录、不递归;封存后本根只读,推送/收尾回执另放新根。来源337d1bc9、核心f95507ab、界面26472d28与验收04c0556c已沿既有 GitAtlas 分支普通增量推送,远端逐 SHA 一致;[推送回执](gitatlas-m2-request-contract-push.json) 与完成接续最后另提交核对,不使用 force。
仅源码与确定性自有验收交付;本批0真实模型请求、0真实 Key 读取、0正式写入,不委派、不续旧实验/用户工程、不发行/安装/重启。正式仅沿 F 历史1.25.12/PID71628记录,不作新的健康声明。默认 unrestricted/passthrough/preserve 与持久 ask/auto/full 保持。
W/AD/AE/AG 网络与用量 unknown、重复读取普遍改善未证明、R/W v2真实排除边界未到,以及 Purge 收益 unknown 保留。请求头适配和合成400/SSE/302不证明全球真实供应商兼容或自主工程交付。下一 I09 原生缓存块/工具元数据、I11 跨 Run 亲和/原生状态、I27/I28 CI,再 M3 真正 schema2 迁移增量与新处理器产生结果后的回退;不能删新记录或直接移除逐表全等守卫。
[Mnemo只读同步](integration/MNEMO-PUBLIC-SOAK-ADMISSION-V2-READONLY-2026-11-07.md) 保留源方60/60/双180/p95报告、原短3/3与持续59/60和167/180失败。新普通公网窗口不替代手机或工程验收,两个原键 unknown 禁重发、TLS与任务 unknown 独立;新增等待接口公开版本/参数消费仍待核对,不启用新发送器。