docs: record New API compatibility review and independent regression evidence

This commit is contained in:
Agent Workbench Dev
2026-11-06 20:27:04 +08:00
parent 341f5f69f6
commit 0dd9c50d90
10 changed files with 215 additions and 7 deletions
+24 -4
View File
@@ -28,10 +28,30 @@
| 任务保存 | 旧页24小时,新rc.47默认72小时 | 不改写旧版行为 |
| API定义完整性 | Messages正文体optional却有必填字段、仅旧thinking枚举;Responses用量示例沿用Chat;部分管理定义直接标Unresolved $ref | 不把该生成schema当穷尽的原厂规范或完整SDK |
## 已确认的工作台后续差距
## 与工作台实现逐项对照
1. 已有连接目录apply直接跳过,未刷新upstreamModel;应只更新目录来源,保留用户原生参数、名字、覆盖、凭据归属和启停。
2. 截断提示通称未附加输出额度,对Messages必填值/用户原生值不准确;应依据实际wire说明。
3. 正式1.25.12 Claude旧声明2048仍被用于Messages必填max_tokens,未取得此型号权威最大值;不能声称同步了最大值,不能用0表示无限。
下表是源码能力与本机契约的对照,不把网关文档条目当作工作台已经实现的功能,也不认证代理线路的实际模型能力。
| 文档主题 | 工作台实现与此次处理 | 仍需保留的边界 |
|---|---|---|
| Chat / Responses / Messages | 已有三种请求/响应与流式适配;Messages携带anthropic-version和协议必填max_tokens | 代理的协议转换、物理型号与实际服务稳定性须另验 |
| 模型获取与多选 | 现有目录预览、多选、共享凭据、手动或自动模型池;此次修复已有连接仅跳过、未刷新upstreamModel的问题 | 只有ID的目录不能补造最大容量或能力;刷新仍由用户显式应用 |
| 目录容量与名字 | 此次增加displayName、inputTokenLimit、outputTokenLimit声明解析;已有连接只更新目录元数据 | 这不是Gemini原生请求或分页适配;目录声明与已验证能力分开 |
| 在途请求与凭据 | 刷新替换元数据对象,旧准备快照保持;不改凭据绑定的连接revision,不重加密保存块 | 用户参数、覆盖、启停、名字不由目录刷新覆盖 |
| 输出截断 | 此次诊断改读实际已序列化请求,分别显示max_tokens / max_completion_tokens / max_output_tokens或确实未携带字段 | 不根据错误自动扩大参数、重试或改写历史请求;截断工具批次不执行 |
| Responses incomplete | 此次补齐HTTP200 / incomplete / max_output_tokens的截断分类;其它原因保留原意 | 内容过滤、未知原因不能统一归因为输出额度 |
| 推理参数与内容状态 | 已有品牌参数配置、原生参数、thinking签名/不透明状态与DeepSeek reasoning_content绑定 | 不是所有模型都公布完整能力,不把New API旧枚举当原厂完整范围 |
| 工具与图像输入 | 已有工具定义/参数/返回关联、图片内容和流末帧完整性核对 | 服务端搜索/执行工具、PDF、全部多模态内容块尚未完整接入 |
| 缓存与用量 | 保留实际上游缓存/推理用量、原始usage、请求前缀依据;unknown与本地估算分列 | 网关Redis/Session不是prompt cache,缓存命中及Purge收益不能据文档保证 |
| 错误、网络与重定向 | 保存上游原文/状态/请求ID/物理尝试、实际地址;默认透传不自动重发,重定向不转发凭据 | 网络中断可能已产生上游消费,unknown不补造成功或计费 |
| Gemini原生与媒体 | 目录可识别部分声明;原生generateContent、音频、视频、Realtime等未完整实现 | 经兼容Chat接口使用某型号,不等于已实现该品牌所有原生能力 |
| 网关插件 | 已读Wasm ABI、宿主HTTP/认证/持久化/用量、SSE与异步任务约定,版本差异单列 | 未安装或执行网页插件,也未实现New API Wasm插件宿主 |
| 管理/运营与Skills | 已读权限、渠道、令牌、额度、计费、日志、支付与Skills说明 | 不作为模型Key接口,不复制运营额度为工作台本地默认限制;不执行文中安装命令 |
## 未完成的真实验证
正式1.25.12 Claude旧声明2048仍被用于Messages必填max_tokens,未取得此型号权威最大值。本次源码刷新修复只在上游确实提供容量、且用户选择应用时使用该声明;缺项仍不能声称同步了最大值,也不能用0表示无限。
此次两处修复的本机HTTP、序列化请求、用量与回归结果见[兼容复核验收](QA-NEWAPI-COMPATIBILITY-REVIEW.md)。Gemini原生/媒体、服务端工具和插件宿主是独立功能差距;真实供应商兼容、角色收益、普遍重复读取改善与Purge收益仍需新实验。
研究尚未操作正式服务、真实Key或模型请求;原400缺max_tokens、网络异常、重复读取、unknown用量与Purge收益unknown保持。仅学习不自动打包或重启。