4.7 KiB
模型能力与错误信息保留方案
用户提出工作台应保留大模型能力,错误也应传到用户面前,并询问Codex是否为原样透传。本记录固定接入原则与已确认缺口。用户随后授权实现上线,1.20.3已完成HTTP/SSE错误、重试语义、错误界面与现有Chat/Responses原生参数接入及本地部署;实际范围、原失败与验证见QA-1.20.3。更多原生参数与新模态继续逐项开发,原会话不回写。
接入原则
保留模型实际支持的输入、输出、原生参数和继续状态,协议转换需有明确映射与验证。用户配置、实际发送参数及系统附加约束应可核对;不能把已连接或兼容文本接口写成全部能力已支持。尚未接入的内容类型明确展示,不悄悄丢弃或伪装成功。
错误界面同时提供中文说明和上游原错误,保留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继续项保留 | 保留原输出并说明具体不支持项,逐项接入后才标支持 |
后续切片与验收
- HTTP/SSE错误信息保留:有界工件、允许响应头、上游身份、脱敏、归属和旧记录兼容;原失败不回写。
- 区分429频率与额度限制,保留Retry-After和每次真实尝试;预算不足时保留明确终态,不提前重试或重放工具。
- 界面提供中文解释、原文、上游请求ID、实际线路、重试过程与本地来源;先用独立HTTP/SSE和桌面/390px验证,不使用用户真实模型或工程测试。
- 原生参数与新模态逐协议接入并形成能力表;核对实际请求/响应后标支持,不能自动降级并宣称等效。
后续源码修改通过相关验证后本地提交,部署仍用新不可变候选和保留状态升级。本方案不自动启动1.21、真实上游调用或重新执行历史任务。
Codex概念参考
OpenAI官方架构文档将Harness定义为运行模型与工具循环、维护会话的执行系统,并区分实际执行环境。该页描述托管Agents API,不能据此证明当前桌面应用的每个内部网络字段均被原样展示。当前所见429和request ID也不能独自证明全部错误元数据完整透传。
OpenAI官方错误文档区分429请求速率、额度、组织/项目消费及用量限制;需要具体error.code才能对应处理。用户本次429明确出现在Codex对话,属于与工作台本机超时不同的请求链。
1.20.3已完成本地部署及保留状态验收,实际范围/原失败/后续边界以验收、回顾与发行身份为准;更多模态与供应商字段不因此视为已接入。