# Codex 流式中断：脱敏诊断记录与支持交接模板

模板版本：2026-10-24。对应教程：https://www.cloudmist.cloud/codex-stream-disconnected.html

本表用于手动记录，不采集或上传任何数据，不执行请求。未知项写“未知”，无法看到的日志写“未取得”。本表没有任何预填的实测结论。

## 先确定记录边界

- 不记录 API Key、访问/刷新令牌、密码、验证码、Cookie 或 Authorization 请求头。
- 不复制 `auth.json`、完整配置文件、环境变量列表、业务提示词、响应正文、仓库内容或私人文件路径。
- URL 只保留协议、host 与通用路径类型；删除查询参数、租户/用户/项目标识。内部 host 如需保密，可写 `[内部网关]`。
- 错误信息只保留必要错误类别；若 message 内含输入、文件名或业务数据，用 `[已移除]` 替换。
- 请求 ID、工单号等只交给对应服务的授权支持渠道；制作公开副本时改成 `[请求ID已移除]`。本表不是要求把诊断信息公开。

## 1. 环境与认证

| 项目 | 填写 |
|---|---|
| 本地记录编号（自定义，不用账号 ID） |  |
| 发生日期、时间、时区 |  |
| 客户端：CLI / IDE 扩展 / 桌面 / 云端 |  |
| 客户端版本；IDE 名称及扩展版本（如适用） |  |
| 操作系统与版本 |  |
| 认证类别：ChatGPT 登录 / OpenAI API Key / 第三方 Key / 组织管理 / 未知 |  |
| 使用的 provider 显示名（不含凭证） |  |
| 模型 ID；来源是配置显示、响应显示还是未知 |  |
| 目标 host 与通用路径类型，已脱敏 |  |
| 传输：SSE / WebSocket / 未知；判断依据 |  |
| 网络：家庭 / 企业 / 移动；有无代理或组织网关（不含地址凭证） |  |
| 近期变化：版本、网络、配置；没有则填无 |  |

## 2. 故障发生在哪个阶段

勾选观察到的内容，可以多选：

- [ ] 连接或鉴权前失败，没有看到输出
- [ ] 请求已接受，但没有首段输出
- [ ] 已有输出，随后中断
- [ ] 工具执行之前或之后
- [ ] 出现上下文压缩 / remote compact 提示时
- [ ] 空闲一段时间后；约多久：____
- [ ] 当前无法判断阶段

| 项目 | 填写 |
|---|---|
| 错误族：response.completed / remote compact / WebSocket 10054 / upstream unavailable / 其他 |  |
| 脱敏错误片段（仅错误类别，不含业务原文） |  |
| HTTP 状态；未取得就写“未取得” |  |
| error.code / error.type |  |
| Retry-After 是否存在；值或“未取得” |  |
| 最后可见事件类型或客户端状态（不填响应正文） |  |
| 工具或文件修改是否已发生：是 / 否 / 不确定 |  |
| 是否已查看任务状态和文件差异，防止重复操作 |  |
| 同时段服务状态公告：链接、查看时间、相关组件 |  |
| 对应服务日志是否有记录；筛选和延迟是否核对 |  |
| 请求 ID（仅私下交对应授权支持；公开版移除） |  |

## 3. 一次只改一个条件的对照记录

只记录你有权进行的检查。真实请求可能产生用量；不关闭证书验证、不绕过组织策略，也不为测试把安全限制全部关掉。

| 次序/时间 | 唯一变化项 | 保持不变的条件 | 预期通过判据 | 观察结果（通过/失败/未测） | 错误类别或信息缺口 | 是否已回退 |
|---|---|---|---|---|---|---|
| 原始情况 | 无 |  |  |  |  | 不适用 |
| 对照 1 |  |  |  |  |  |  |
| 对照 2（确有新依据时） |  |  |  |  |  |  |

不要写“改了很多配置后好了”。若多项条件同时变化，记录“无法单独归因”。

## 4. 当前通过了哪一层

| 检查层级 | 通过/失败/未测 | 依据与限制 |
|---|---|---|
| 短请求：目标、认证、协议与模型匹配，得到预期结果 |  |  |
| 完整流：协议成功结束；或仅观察到客户端完成（注明区别） |  |  |
| 小型工具任务：结果、文件差异与工具状态均核对 |  |  |
| 原故障场景：压缩、长任务、空闲后或特定客户端 |  |  |

一次通过只代表该次条件。未能观察结束事件时，只能记录“客户端显示完成”，不能写“已验证协议完整”；新会话短任务成功不能写“原压缩故障已修复”。

## 5. 是否应停止继续重试

- [ ] 已有明确的认证、额度、权限或协议错误，继续重试不会改变条件
- [ ] 一次受控对照仍重复同类失败，需要服务方或管理员进一步检查
- [ ] 相关故障公告尚未恢复
- [ ] 工具是否已执行不确定，可能重复操作
- [ ] 达到自己设定的测试预算或时间上限
- [ ] 下一步需要降低安全设置或绕过组织策略

停止原因：____

当前待证假设：____

下一项需要的证据（不是凭证或业务原文）：____

## 6. 可整理给技术支持的摘要

以下摘要仅供你核对后交给**对应服务的授权支持渠道**；填表不会自动发送。

```text
问题：Codex 在 [客户端/版本] 的 [阶段] 出现 [错误类别]。
时间与时区：[填写]
认证类别：[ChatGPT登录/OpenAI API Key/第三方Key/组织管理/未知]
目标：[脱敏host与通用路径类型]
模型与传输：[模型ID]；[SSE/WebSocket/未知]
状态与代码：[HTTP状态]；[error.code/type或未取得]
工具是否已执行：[是/否/不确定；不贴文件或业务内容]
已经检查：[单变量对照及结果；未测项注明]
当前边界：[短请求/完整流/工具任务/原故障场景分别是什么状态]
已停止重试的原因：[填写]
希望协助核查：[认证路径/响应格式与结束事件/连接中断/压缩支持/上游状态等]
请求ID：[仅在该授权渠道需要时提供；公开版移除]
```

发送前确认：没有凭证、账号标识、私人路径、内部地址、业务输入输出或未经脱敏的截图；不要附整个日志目录或整个项目。