docs: define native model and error preservation requirements

This commit is contained in:
Agent Workbench Dev
2026-11-01 21:29:41 +08:00
parent 017923aace
commit 02cefd0498
5 changed files with 53 additions and 0 deletions
+39
View File
@@ -0,0 +1,39 @@
# 模型能力与错误信息保留方案
用户提出工作台应保留大模型能力,错误也应传到用户面前,并询问Codex是否为原样透传。本记录固定接入原则与已确认缺口;属于后续维护方案,尚未实现,不改变正式1.20.2服务或原会话。
## 接入原则
保留模型实际支持的输入、输出、原生参数和继续状态,协议转换需有明确映射与验证。用户配置、实际发送参数及系统附加约束应可核对;不能把已连接或兼容文本接口写成全部能力已支持。尚未接入的内容类型明确展示,不悄悄丢弃或伪装成功。
错误界面同时提供中文说明和上游原错误,保留HTTP状态、原error.code/type/message、上游request ID、Retry-After及实际线路。工作台自己的等待截止、任务预算、用户停止、协议核验或权限拒绝应注明本地来源。本机产生的attempt/request ID与上游request ID分开保存,不互相代替。
模型工具调用保留原身份与参数,通过当前执行内核核验并记录实际执行结果。模型、API与Codex/Claude Code等产品的上下文和工具能力需要分别验证;接入同名模型不能自动获得另一产品的全部执行能力。
原文需脱敏凭据并有明确容量边界;超限记录原字节数、截断范围及可用工件,摘要不能冒充完整原响应。服务端提供的可用推理继续状态按原线路续接,不推测未公开的内部推理。
## 1.20.2 源码确认的缺口
| 位置 | 当前行为 | 后续要求 |
| --- | --- | --- |
| src/server/provider.mjs HTTP错误分支 | 只提取error.message,脱敏后截600字符;缺原code/type和上游request ID | 有界保存原响应及允许的诊断响应头;中文摘要引用原错误 |
| src/server/diagnostics.mjs httpFailure | 429统一为rate_limit并可重试,未依据原code区别额度限制 | 保留原code,额度限制不反复重试,未知明确保留 |
| src/server/provider.mjs Retry-After | 计算等待时间但最大截为90秒 | 保留原值;自动等待不足以满足时不提前重试,总预算仍有效 |
| src/core/models/model-stream.mjs | 原片段有工件,但error/response.failed等变成通用提示 | 保留原错误字段、所属请求/响应身份和已有用量,不执行不完整工具或重放片段 |
| src/shared/contracts/model-request.mjs | 已接Chat/Responses、流式、图像与Responses继续项,参数由固定适配器生成 | 逐供应商/协议验证原生推理、输出、上下文及缓存选项;未接入项明确提示 |
| src/core/models/protocols.mjs | 未接入输出类型拒绝执行,Responses继续项保留 | 保留原输出并说明具体不支持项,逐项接入后才标支持 |
## 后续切片与验收
1. HTTP/SSE错误信息保留:有界工件、允许响应头、上游身份、脱敏、归属和旧记录兼容;原失败不回写。
2. 区分429频率与额度限制,保留Retry-After和每次真实尝试;预算不足时保留明确终态,不提前重试或重放工具。
3. 界面提供中文解释、原文、上游请求ID、实际线路、重试过程与本地来源;先用独立HTTP/SSE和桌面/390px验证,不使用用户真实模型或工程测试。
4. 原生参数与新模态逐协议接入并形成能力表;核对实际请求/响应后标支持,不能自动降级并宣称等效。
后续源码修改通过相关验证后本地提交,部署仍用新不可变候选和保留状态升级。本方案不自动启动1.21、真实上游调用或重新执行历史任务。
## Codex概念参考
[OpenAI官方架构文档](https://developers.openai.com/api/docs/guides/agents-api/architecture#the-pieces)将Harness定义为运行模型与工具循环、维护会话的执行系统,并区分实际执行环境。该页描述托管Agents API,不能据此证明当前桌面应用的每个内部网络字段均被原样展示。当前所见429和request ID也不能独自证明全部错误元数据完整透传。
[OpenAI官方错误文档](https://developers.openai.com/api/docs/guides/error-codes#api-errors)区分429请求速率、额度、组织/项目消费及用量限制;需要具体error.code才能对应处理。用户本次429明确出现在Codex对话,属于与工作台本机超时不同的请求链。
+2
View File
@@ -1,5 +1,7 @@
# 后续执行计划
新增接入要求:按[模型能力与错误信息保留方案](MODEL-FIDELITY-PLAN.md)先补有界HTTP/SSE原错误、上游request ID、原code/type与Retry-After,再逐项验证供应商原生能力和参数。1.20.2目前不是全能力/全错误字段透传;本次只完成源码审查与方案登记,正式服务未改动。原失败不回写,本机ID与上游ID分开,不把中文解释当原文。
本轮正式暂存及独立核对实际耗时860秒,最终安装指针激活及原状态核对647秒,发行19560文件。原暂存后因新增模型尝试被拒绝的结果保持失败,耗时不能当成已通过的性能指标。后续维护优先研究运行载荷与历史验收材料分离、同一发行的必要核对复用,以及当前校验阶段/耗时/失败收据的可见反馈;保留路径、字节变化和回滚门槛,另行实现验收。
1.20.2已完成模型响应等待修复与保留状态部署:单次响应默认300秒、流式无数据120秒,模型中心可调整。111项专项/关联回归、真实本机JSON/SSE各65秒、五组等待UI/五组协议UI及五组随包等待UI通过;实际旧版到新版升级及正式Edge/Electron两视口回看通过。正式PID36552/Provider、17项目/31全部会话/3207记录/6138事件和1761个工件文件原字节保持,仅公开模型中心增加计算出的等待默认值;磁盘配置不回写。本轮验收发起真实模型请求0。
+2
View File
@@ -1,5 +1,7 @@
# 汇总发现
- 用户提出能力/错误透传。源码确认HTTP错误仅提取message截600字符,缺原code/type和上游request ID;429只按状态判可重试,Retry-After截90秒;SSE错误原片段有工件但诊断通用化。Chat/Responses已有适配不等于全部供应商原生能力。细节与后续门槛见docs/MODEL-FIDELITY-PLAN.md,正式1.20.2未改变。
- 最新结论:1.20.2已完成模型响应等待修复与保留状态部署:单次响应默认300秒、流式无数据120秒,模型中心可调整。111项专项/关联回归、真实本机JSON/SSE各65秒、五组等待UI/五组协议UI及五组随包等待UI通过;实际旧版到新版升级及正式Edge/Electron两视口回看通过。正式PID36552/Provider、17项目/31全部会话/3207记录/6138事件和1761个工件文件原字节保持,仅公开模型中心增加计算出的等待默认值;磁盘配置不回写。本轮验收发起真实模型请求0。 发行源码3b650275ffe6984a1147a39ba1c22dd3a6859a61,原始用户导出/SSE和SQLite备份仅保留本机忽略目录,不进Git。用户确认另一次429来自当前Codex对话,和工作台超时分属不同请求链。
- 用户已确认本次关注“模型服务响应超时”。新会话753cb109第二请求先在非流式连接等待60008毫秒失败,再在流式连接60012毫秒结束。原SSE 4898字节/SHA febb1633c9bca49248241c8bb1755a51a6d466d62daad72b221d7fc1e51be4cc,19帧、propose_file参数112字符、没有finish/[DONE]/usage;本轮没有文件应用。Provider在有signal时把整次响应一律限制为60000毫秒,未区分首响应/无数据/持续生成;超时策略确实需改进,但原流没有时间戳,不能据此断言上游全程持续输出。原完整导出仅保留.qa,不复制进Git。
+4
View File
@@ -1,5 +1,9 @@
# 统一执行进度
## 模型能力与错误信息保留讨论
只读核对官方Harness/错误文档与当前源码,明确模型推理、协议能力和产品执行环境的关系;确认HTTP/SSE错误字段及原生参数覆盖缺口。已写MODEL-FIDELITY-PLAN并更新后续计划,尚未实现;正式服务、原用户任务/配置均未操作,没有模型调用。首轮批量文档补丁因findings标题误猜整体拒绝,无文件写入;读取实际标题后修正。一次rg使用PowerShell不展开的路径通配符导致局部查询报错,已改为已存在目录加-g过滤;其余结果实际读取。
## 1.20.2 本地交付完成
最终Git字节核对补齐新证据目录的-text属性:保留验收日志原CRLF字节,避免后续检出时SHA与封存清单不符。按范围重新暂存原字节并增加逐个Git blob核对,产品源码和已安装发行均不变。首份ACCEPTANCE仅校验工作区证据;最终FINAL收据额外绑定提交内原证据字节,前份保留。
+6
View File
@@ -1,5 +1,11 @@
# Agent Workbench:核心代理能力研究与产品计划
## 新增要求:模型能力和错误信息保留
1. [complete] 核对官方Harness概念及源码:HTTP错误截600字符且缺原code/type/request ID,流错误通用化;模型适配未覆盖全部原生参数。
2. [complete] docs/MODEL-FIDELITY-PLAN.md固定原则、缺口、后续切片与验收;本次为解释/规划,不修改1.20.2正式代码或历史记录。
3. [pending] 先补有界原错误及上游身份/重试语义,再逐协议扩展能力,独立验证后另行本地发行。
## 已完成:1.20.2 当前页面模型等待修复
用户报告右侧当前页面仍报错。先保留现场并只读核对,不根据URL中的旧release参数推断实际运行版本,不重放原任务或调用真实模型。正式健康接口已确认1.20.1/PID36552;出现升级后新增失败会话,须以原Run/attempt/工件定位。