这是一个 Surge Mac 模块和 JavaScript 脚本，用于质量验证并管理 Codex Responses 请求中的 turn-state：
- 使用同模型隐藏探针提问“最新的 iPhone 型号是什么”，按项目规则仅将
iPhone 17判为通过；iPhone 16、iPhone 15或无法判定均拒绝。 - 只有探针同时满足 HTTP 200、完整 SSE、回答
iPhone 17、state 结构与签发时间有效，才会缓存并注入；state 长度只作观测，不再决定质量。 - 探针默认最多轮换 3 个住宅 IP，每次等待 25 秒；住宅策略只影响隐藏探针，正式 Codex 请求仍按当前 Surge 规则选路。
- 按账号与实际请求模型隔离缓存，在后续同模型请求中复用；不同模型不会混用 state。
- TTL 默认按 5 分钟保守管理，剩余约 1 分钟时在发送前续期。
- 遇到正式请求 429 时补齐
Retry-After，并对客户端后续自动重试执行 2、4、8、16、32、60 秒的账号级退避。 - Surge 原生面板区分“已验证并注入”与“未验证放行”，并显示 TTL、探针回答档位、state 长度、出口类型和最近记录。
- 捕获成功时发送本地 Surge 通知。
项目只处理本机 Surge 流量，不上传账号信息、请求正文、提示词、回答或完整 state。缓存由 Surge 的脚本持久化存储管理。
点击下面的链接，或将链接复制到浏览器地址栏：
一键导入 Surge 模块
直接导入地址：
https://raw.githubusercontent.com/tzf1003/csss/main/codex-state.sgmodule
导入后在 Surge 的「模块 → 未分类」中启用 Codex Sleep State Sugar。模块使用 GitHub Raw 地址加载脚本，并每天检查一次脚本更新。
模块默认使用 model=* 处理所有匹配 Responses 接口的模型。脚本从请求头或 JSON 请求体读取实际模型，并为每个“账号 + 模型”建立独立缓存；不同模型之间不会混用 state。若只想处理单个模型，可把三处 model=* 改成对应模型 ID。
下面的截图展示了新会话质量检测。按本项目验收规则：iPhone 17 为通过，iPhone 16 为降智，iPhone 15 为更严重降智。插件实际判定的是后台隐藏探针，而不是界面中最后显示的正式回答。
面板会显示当前请求是否会注入已验证 state、缓存 TTL、距离续期时间、探针回答档位、出口类型、累计注入次数和最近记录。
启用 force_http=1 后，脚本会在 WebSocket 请求阶段中止握手，等待 Codex 回退到 HTTP Responses/SSE 路径。这个切换过程中，Codex 可能显示下面的提示：
stream disconnected before completion / WebSocket protocol error: Handshake not finished 是切换到 HTTP fallback 时可能出现的连接提示。请以 Surge 面板中的探针回答、HTTP 状态、state 长度和注入记录为准。
使用 Surge Mac，并确保当前配置本来就能访问 ChatGPT/Codex。先确认：
- Surge 已打开并正在接管流量。
- 「增强模式」已开启。
- 「脚本」已开启。
- 「MITM」已开启，并已为
chatgpt.com、api.openai.com安装并信任 Surge 证书。 - 现有规则能把 Codex 请求送到可用出口。
模块默认不写入任何私人节点名，也不覆盖正式 Codex 请求的代理规则。没有配置探针专用住宅出口时，隐藏探针也沿用当前规则。
打开一键链接后，进入 Surge「设置 → 模块 → 未分类」，选中 Codex Sleep State Sugar，勾选「启用」并应用。
如果网络无法访问 GitHub Raw，可以下载 codex-state.js 到本地，并把三处 script-path 改成本地绝对路径。
policy 是可选变量：如果你有住宅 IP 策略，可以把策略名称 URL 编码后填入 codex-state-request 的 argument=。它只控制隐藏的采集与续期探针；正式 Codex 请求继续沿用 Surge 当前规则。如果没有住宅 IP，或把变量留空/删除，探针也走当前规则。
policy=YOUR_RESIDENTIAL_IP_POLICY
例如策略名含空格时，使用 %20。不要把代理账号、密码、订阅 URL 或节点 URI 提交到 GitHub。
获取 1024Proxy：
在 1024Proxy 控制台选择 SOCKS5、地区和会话类型后生成代理。控制台通常会给出类似下面的 cURL 命令：
curl --socks5 HOST:PORT -U "USERNAME-region-US:PASSWORD" https://ipinfo.io其中 HOST、PORT、USERNAME-region-US、PASSWORD 分别对应 Surge 描述符中的四个字段。先运行该命令；能够返回出口 IP 后，再转换为：
socks5, HOST, PORT, USERNAME-region-US, PASSWORD, underlying-proxy=DIRECT
如果控制台提供的是 socks5://USERNAME:PASSWORD@HOST:PORT 链接，同样按用户名、密码、主机和端口四部分填入。-region-US 用于选择美国出口；其他地区替换为相应的两位国家代码。
如果只希望采集和续期 state 的探针走独立 SOCKS5，可在 Surge 脚本编辑器中执行下面的本机配置；普通 Codex 请求仍按原规则选路：
$persistentStore.write(
"socks5, proxy.example, 1080, username, password, underlying-proxy=DIRECT",
"csss-probe-policy-descriptor-v1"
);
$done({});underlying-proxy=DIRECT 仅指定如何连接 SOCKS5 服务器，探针访问 OpenAI 时仍从该 SOCKS5 出口发出。脚本也会为未指定上游的 SOCKS5 描述符自动补上该参数。凭据只应保存在本机，不要写入模块、仓库、Issue 或日志。置空该存储键即可恢复到 policy 参数或 Surge 当前规则。
如果 SOCKS5 服务要求先经过现有 Surge 策略才能连接，请在本机主配置的 [Proxy] 中创建命名链式策略，再把策略名写入同一个持久化键：
[Proxy]
CSSS-Probe-SOCKS = socks5, proxy.example, 1080, username, password, underlying-proxy=YOUR_ENTRY_POLICY$persistentStore.write("CSSS-Probe-SOCKS", "csss-probe-policy-descriptor-v1");
$done({});Surge 模块不能修改 [Proxy]，因此命名策略必须保存在本机主配置中。探针会优先使用持久化键指定的命名策略。
原始 SOCKS5 描述符是 1024Proxy 的推荐方式。脚本会为每次探针创建新的临时 Surge 策略；当主机是 *.1024proxy.io 时，还会自动替换或补充唯一的 sid（1 分钟会话），减少 HTTP/2 连接池复用同一出口。默认一批最多尝试 3 个新会话，每次最多等待 25 秒。请把控制台生成的用户名原样填入，脚本只在运行时生成临时副本，不会改写持久化凭据。
其他代理服务如果也需要轮询多个命名策略，可使用 | 分隔策略名：
$persistentStore.write(
"CSSS-Probe-Session-01|CSSS-Probe-Session-02|CSSS-Probe-Session-03",
"csss-probe-policy-descriptor-v1"
);
$done();脚本每次探针会选择列表中的下一个策略。每个策略名最长 128 字符，完整列表最长 2048 字符；这些命名策略仍需预先存在于本机主配置中。
在 macOS 菜单栏点击 Surge 图标，打开「面板 → Codex State 状态」。面板含义如下：
| 面板标题 | 含义 |
|---|---|
等待采集 |
当前没有合格 state；下一条匹配请求会先运行质量探针 |
正在复用 |
当前请求会注入通过 iPhone 17 验证的 state |
正在采集 |
住宅探针正在运行，正式请求在脚本回调中等待 |
未验证放行 |
本批探针未通过或处于冷却；正式请求按当前 Surge 规则继续发送，没有注入缓存 |
最近记录会标注探针结果、请求是否注入、响应 state 长度和会话尾部标识。记录不保存提示词、回答或完整 token。
建议先打开面板，再在 Codex 中新建会话发送一条普通短消息。随后刷新面板：
- 首次没有缓存时，状态应变为「正在采集」，并最多尝试 3 个探针出口。
- 探针回答
iPhone 17且返回有效 state 后，状态应显示「正在复用」。 - 再开一个新会话，面板历史应出现「已注入 state」。
- 探针回答
iPhone 16/15、超时或没有 state 时，面板应显示「未验证放行」，不会把该 state 写入缓存。 - TTL 剩余约 1 分钟时，下一条请求会先尝试续期；失败时仍保留尚未过期的旧缓存。
界面中的正式回答和隐藏探针是两次独立请求。例如面板记录住宅探针回答 iPhone 15 并显示「未验证放行」后，界面里的正式请求仍可能通过当前规则回答 iPhone 17；这表示正式会话本身通过了你的质量判断，但不表示住宅探针成功或发生了 state 注入。
请求脚本只匹配 Responses HTTP/SSE 接口。脚本识别实际模型；该模型没有可用 state 或已进入续期窗口时，使用当前请求的认证头和同一模型发起隐藏探针。探针询问固定的最新 iPhone 问题，并解析完整 SSE 文本。只有回答命中 iPhone 17，且响应携带结构和签发时间有效的 state，才会写入该账号与模型对应的 Surge 持久化缓存。
一批探针最多尝试 3 次；住宅 SOCKS5 每次使用新的会话 ID。单次等待上限是 25 秒，三次都未通过后正式请求按当前规则放行，并在面板记录「未验证放行」。探针返回的 292、312、780 等长度只用于诊断；任何长度都必须先通过 iPhone 17 质量门。401、403、429 和网络失败按各自状态退避。
后续匹配请求会在发送前把缓存值写入 x-codex-turn-state。正式响应回调只观察响应头，不读取回答正文，也不会把未经质量探针验证的普通响应 state 顺手写入缓存。
正式生成请求返回 429 时，脚本会记录账号级退避状态，并把指数退避时间写入 Retry-After。Codex 客户端发起下一次自动重试后，请求脚本会先等待剩余退避时间再放行，并跳过额外探针，避免插件放大限流。默认从 2 秒开始，最高 60 秒，可用 retry_base 和 retry_max 调整。
Surge 的响应脚本拿不到原请求正文；强行由脚本重放必须暂存提示词并缓冲完整 SSE 响应，会破坏正常流式输出。因此本模块不会自行复制正式生成请求，而是调度 Codex 客户端原有的自动重试。若服务端持续限流直到客户端重试次数耗尽，最终 429 仍会显示；需要完全透明的无限重放时，应使用能够流式代理请求体和响应体的本地反向代理，而不是 Surge JavaScript 模块。
兼容范围是经 Surge 捕获、使用 Responses 接口且请求中能识别模型 ID 的模型。缓存严格按“账号＋模型”隔离，票据不会跨模型借用。iPhone 17/16/15 是本项目采用的黑盒质量验收规则；state 是不透明数据，长度和块数只用于展示。插件能证明自己是否运行了探针、是否通过本地规则以及是否注入，不能控制住宅代理的可用率、账号额度或上游限流。
检查脚本、MITM、证书和 Responses 请求是否经过 Surge；确认请求体可被脚本读取且包含模型 ID。面板里的最近探针会显示 HTTP 状态、state 长度、iPhone 档位、尝试次数和出口类型。住宅代理连通但 OpenAI 响应超过 25 秒时仍会记为超时。
面板会显示账号级退避时间和连续次数。脚本会尊重服务端 Retry-After，没有该响应头时按 2、4、8、16、32、60 秒退避，并挂起 Codex 客户端的下一次自动重试；成功响应后自动清零。持续性的额度或服务端限流仍可能在客户端重试耗尽后显示 429。
在 Surge 模块设置中停用模块即可；也可以只关闭脚本，保留普通代理规则。
在 Surge 的脚本持久化存储中删除 codex-turn-state-v6，或在脚本编辑器中清空对应存储后重新加载模块。删除前请确认你没有其他脚本共用该键名。
完整可复制提示词见 AGENT_PROMPT.md。它要求 Agent 自动导入模块、检查增强模式/脚本/MITM、打开面板并汇报结果，同时禁止输出账号、订阅、Cookie、Authorization 和完整 state。
完整研究总结与 Burp 风格报文流程 记录了参数、state 外层结构、质量闸门、缓存边界，以及一次 turn 从 WebSocket 尝试到 SSE 完成的脱敏报文。
公开仓库不包含节点名称、代理地址、账号 ID、Authorization、Cookie、订阅 URL、脚本持久化数据或本机路径。使用者应把策略名和代理凭据留在本地 Surge 配置中。请不要在 Issue、截图或日志中粘贴完整请求头、订阅链接或 turn-state。
- Surge Information Panel 文档
- Surge Generic Script 文档
- Surge Scripting API
- 292 State 研究文章
- gylive/ccodex-sleep-state：感谢其对 state 生命周期、探针、TTL 和诊断体验的公开讨论；本仓库是独立的 Surge 脚本实现。
本项目与 OpenAI、Surge、上述作者或仓库没有隶属关系。
MIT，见 LICENSE。
需要 Node.js 18 或更高版本：
node test-codex-state.js