gylive/ccodex-sleep-state
# 技术雷达学习卡：ccodex-sleep-state
一、一句话定位
一个本地运行的 Go 语言工具，通过采集和注入 `X-Codex-Turn-State` 来改善 Codex 降智、限流与连接问题，并提供可视化面板与诊断能力。
二、核心技术/架构亮点
1. Turn-State 机制：自动探测候选出口的响应封装、时间与密文块数（个人 292 字符/10 块，Team 332 字符/12 块），保存合格值并注入后续请求。
2. 多模型与多认证兼容：支持 Astra、Sol、Terra 模型，兼容官方 ChatGPT、API Key、CCS 中转等多种认证方式，按凭据和模型隔离 state。
3. 代理路由引擎：内嵌 HTTP/SOCKS5 及 Clash/VMess/Trojan 等订阅解析，不切换系统代理，支持订阅导入与固定出口。
4. 故障自愈与诊断：面板提供一键接入、配置修复、脱敏诊断（doctor 命令），自动备份并恢复被改坏的 Codex 配置。
5. 兜底策略灵活：未采到合格 state 时可选择“严格模式”（返回错误）或“普通转发”（不注入但继续使用选定出口），避免服务中断。
三、适用场景与目标用户
- 遭受 Codex 降智或 401/403/429 限流的普通用户，希望透明地切换出口并监控请求状态。
- 使用 CCS、CC Switch 等配置管理工具的用户，需要在不破坏原配置的前提下接入 turn-state 优化。
- 愿意自行调试、反馈的早期体验者（工具仍为公开测试版）。
四、可动手动作
- 快速启动：从 Releases 下载对应平台包，完整解压后运行 `start.cmd`（Windows）或 `start.command`（macOS），浏览器自动打开面板。
- 配置代理与订阅：在面板“订阅与代理”处填写本地代理地址或导入订阅链接（YAML/URI/Base64）。
- 监控与切换：查看“开始使用”页面确认接管状态，在“连接设置”切换模型、账号规则或兜底策略。
- 排错与反馈：运行 `ccodex-sleep-state doctor` 生成脱敏诊断，附带系统版本、Codex 版本等信息提交 Issue 或群聊。
五、学习优先级：P1（排期学习）
理由：对 Codex 用户有实用价值，能直观解决降智和连接不稳定问题，但效果依赖上游账号和代理质量，且需花时间理解边界（如不支持 WebSocket、无遥测）。建议本周内跑通基础流程，后续视需求深入调试策略细节。⌂