Releases: gylive/ccodex-sleep-state
Release list
v0.4.0 · 一键检测、固定主用与代理池
v0.4.0：一键检查、固定可用 state 与可控代理池
普通用户怎么开始
- 下载对应系统的完整包并解压。Windows 双击
start.cmd；macOS 双击start.command。 - 首页先点 一键检测环境配置。有问题时点“带我去处理”，不用先研究高级参数。
- 确认显示 Codex 已接管，重启 Codex、新建会话后再使用。
| 设备 | 下载文件 |
|---|---|
| Windows x64 | ccodex-sleep-state-windows-amd64.zip |
| Windows ARM64 | ccodex-sleep-state-windows-arm64.zip |
| Apple 芯片 Mac（M 系列） | ccodex-sleep-state-darwin-arm64.tar.gz |
| Intel Mac | ccodex-sleep-state-darwin-amd64.tar.gz |
同时提供含依赖的源码包及 SHA256SUMS。请保留包内的启动脚本和教程，不要只拷贝程序。
本次更新
- 一键检测环境配置：只读检查本地配置和现有连接状态，问题优先显示并给出下一步。不读登录凭据、不下载订阅、不探测代理、不自动调用模型。
- 拿到后固定使用：新用户默认固定主用，失效或发现不匹配后再获取。也可选择提前准备备用；切换策略保留已有主用/备用和冷却。旧配置缺少策略字段时保留旧模式，不强制切换。
- 手动输入与 TXT 多订阅导入：每行一个订阅，合并去重，支持追加或替换。导入页默认勾选随机出口＋用后移出，追加时保留已有固定出口；不想改变策略可取消勾选。
- 可用、已用、失败、停用清单：全选、手动回收、可恢复清理和单节点短探测。不在后台自动把失败节点放回。
- 出口单独设置：正式请求可以用固定节点或独立随机节点；不要求与采集节点相同。不同节点配置不保证有不同公网 IP，跨出口 state 仍属实验功能。
- 本地 413 修复：请求体、zstd 窗口、压缩回复上限默认 64 MiB，可在高级设置调整到 16–128 MiB。保留并发和解压边界，不提高上游限制。
- 中转助手：规范地址、查询 Astra / Sol / Terra 模型列表、带备份补全缺失
base_url。不覆盖已有地址，不保存临时检测 key，不对中转强制采集 292。 - 补充朋友卡网展示、贡献元数据说明、合规边界和回退教程。
升级与回退
先正常停止旧服务，等正在运行的请求结束及配置恢复；保留旧程序和整个服务数据目录的私有备份，再解压新包。不要让两个版本同时接管同一份 Codex 配置。
新配置字段不能直接交给旧版本读取。需要回退时，先正常停止新版本并完成恢复，再恢复升级前的服务配置备份；不覆盖用户在测试期间另行修改的 Codex 配置。配置备份可能含订阅凭据，不要公开分享。更详细的步骤见升级指南。
验收和重要限制
- 本次发布验收使用隔离服务数据目录、独立 Codex Home 和本地模拟上游，不接管日常配置。48 项跨进程检查全部通过，涵盖固定/主备 292、312 不重放、配置恢复与代理池持久化；具体通过项及未验项见测试记录。
- 本地
go vet ./...、全包竞态回归及 JavaScript 语法检查通过；标签发布流水线已在 Windows、macOS、Ubuntu 通过检查，并成功构建四平台包。 - 真实中转生成尚未通过：此前模型列表为 HTTP 200，唯一 Sol 短生成为 HTTP 403 后停止。本次没有重新冲击该上游，不能把本地模拟成功当作真实权限已恢复。
- 不保证取得 292，不保证 292 代表回答质量；Team 规则和替补提升有合成测试，不代表所有真实账号均已验证。
- 不匹配响应正文会拦截；已有备用只供后续请求使用。当前请求可能已经计费，不自动重放；没有备用时可能短暂等待，不承诺零中断。
- 401/403/429、冷却及有界探测规则保留，不通过换节点、换模型或回收清单解除。探测可能消耗模型额度。
- 外部代理模式是运行时约束；发行包仍含内嵌核心，不是法律免责版。见合规与使用边界。
正式版本号表示本次软件交付，不表示所有真实上游、网络或硬件场景都已通过，也不承诺规避风控或提升回答质量。
正式包复验
本地 v0.4.0 原生 macOS ARM64 正式包再次完成相同的 48 项跨进程隔离检查，全部通过。全部使用本地合成服务，不消耗真实模型额度，不把模拟成功冒充真实中转已恢复。
标签发布流水线与主分支 CI均成功。6 个附件已从 GitHub 下载并核对 SHA256；源码与标签对应，下载的 macOS ARM64 二进制与通过 48 项隔离验收的二进制逐字节相同。
v0.3.1 · 修复启动崩溃，采集时间可在网页调整
v0.3.1：启动修复与可视化采集设置
本次更新
- 感谢 debin-ge 的 PR #2：修复 Codex 配置包含
[[skills.config]]等 TOML 数组表时，接入启动发生 panic 的问题，保留原贡献提交。 - 在 连接设置 → 采集时间与次数 开放单次探测超时、两轮采集间隔、本地 state 有效期、提前刷新时间、每轮最多探测次数。
- 提供填入默认值、低频采集预设、撤销未保存修改、实时说明及保存确认。定时状态刷新不再覆盖未保存的时间输入。
- 固定出口从订阅消失时，保存设置会拒绝并保留原配置与原采集器，不再误报成功。
- README 微信入口改为作者个人二维码；QQ 群入口保留。
- 增加可复现打包脚本，附带依赖的源码包与 SHA256 校验文件。
下载与升级
| 设备 | 下载文件 |
|---|---|
| 普通 Windows x64 | ccodex-sleep-state-windows-amd64.zip |
| Windows ARM64 | ccodex-sleep-state-windows-arm64.zip |
| Apple 芯片 Mac（M 系列） | ccodex-sleep-state-darwin-arm64.tar.gz |
| Intel Mac | ccodex-sleep-state-darwin-amd64.tar.gz |
先在旧服务终端按 Ctrl+C，等待配置恢复，再把新包完整解压到新目录。Windows 双击 start.cmd，macOS 双击 start.command，之后重启 Codex、新建会话。不要删除现有服务数据目录、配置或恢复备份。
不确定时间怎么填，使用默认值。低频预设为两轮至少 600 秒、每轮最多 2 次，其他参数默认；它可能让取得可用 state 更慢，不承诺节省比例。预设只填表，需要保存确认才生效。
验证与边界
- 本地全包
go vet、竞态测试和独立目录浏览器验收通过；功能分支 Windows、macOS、Ubuntu CI 均通过。本标签的 Windows、macOS、Ubuntu 发布测试及四平台打包上传也已通过。 - 测试包括数组表崩溃回归、时间范围校验、备份、外部改动保护、鉴权、固定出口消失和限流状态保持。
- 本轮没有调用真实模型验证，不代表在四类硬件上完成桌面联调，也不保证改善回答质量或取得指定长度的 state。
- 采集可能消耗账号额度；本地有效期不会延长上游真实有效期。401、403、429 的停止规则保留，不通过修改时间绕过。
- 本项目仍是实验性工具；版本号不代表对质量改善或账号权限作保证。
v0.3.0 · 双击启动，配置问题在网页里解决
v0.3.0：少改文件，多点按钮
这次重点不是再加几个配置项，而是把群里反复出现的「未接管」「配置被改过」「采不到 state 就卡住」做成能在网页里处理的事。
一般情况：完整解压 → 双击启动 → 自动打开面板并接入 → 重启 Codex。 不用装 Go，不用先跑 init，不用复制一串 PowerShell 命令，也不用先看懂 TOML。
这仍是实验性工具。目标是尝试改善 Codex 的降智、限流和连接体验，不保证百分百有效，不增加账号额度，不绕过官方限流。版本号是 v0.3.0，GitHub 保留 Pre-release 标记，未完成的真实验收在下面说明。
下载哪个？
| 电脑 | 下载文件 |
|---|---|
| 大多数 Windows 电脑，Intel / AMD | ccodex-sleep-state-windows-amd64.zip |
| Windows ARM 电脑 | ccodex-sleep-state-windows-arm64.zip |
| Apple 芯片 Mac，M 系列 | ccodex-sleep-state-darwin-arm64.tar.gz |
| Intel Mac | ccodex-sleep-state-darwin-amd64.tar.gz |
以本页 Assets 的实际文件名为准。普通用户下载对应系统的程序包，不要选 GitHub 自动生成的 Source code。请完整解压，别只拖走 exe；启动脚本和中文教程也在包里。校验文件是 SHA256SUMS。
第一次用：照这几步来
- 先确认 Codex 原来就能用。 官方账号先登录；中转先配好自己的 key。用 CCS / CC Switch 的，先选好这次用的连接，退出 Codex，暂时别来回切。
- Windows 双击
start.cmd；Mac 双击start.command。 不是直接双击裸 exe。程序会打开网页、备份并尝试接入。保持启动窗口开着。 - 看到「已接管」后，重启 Codex，新建会话发一句话。 面板请求计数增加，才说明消息经过了本工具。仅仅能打开网页不算接通。
- 如果没找到本地代理，到 「订阅与代理」 填你的 HTTP / SOCKS5 地址、订阅链接或本地订阅文件。先测试能否读取，再保存；实际连通性在「路由」里测。
已经接上就不用继续折腾设置。启动会沿用已有代理、订阅、模型和注入开关；没有自定义来源时，只检查几个常见的本机 SOCKS5 端口。它不会读取你的代理软件账号库，也不会替你切系统代理。
不知道代理怎么填？
本地代理填的是地址，例如 socks5://127.0.0.1:7897 或 http://127.0.0.1:7890，不是 PowerShell 命令。端口看你自己的代理软件，例子里的数字不一定适合你。只有订阅链接就填订阅；有 YAML / 节点列表文件就选本地文件。
浏览器没自动打开时，用启动窗口显示的管理地址和口令进入。口令不是 Codex 密码，不要截图发群。默认面板地址是 http://127.0.0.1:17841/admin/。
命令行兜底：Windows 运行 .\ccodex-sleep-state.exe setup；Mac 运行 ./ccodex-sleep-state setup。再次运行 setup 会重新打开已有服务的面板，不会启动第二份服务。
从旧版升级，别删配置
- 在旧服务窗口按 Ctrl+C，等它退出。退出 Codex。
- 把新版完整解压到一个新文件夹，双击新版启动脚本。不要同时开着两版。
- 如果自动接入没有完成，先点首页 「一键接入 Codex」。能安全保留的旧记录会先备份，再恢复接管。
- 仍提示配置冲突，到「连接设置」点 「检查与修复配置」，通常选择 「保留当前配置并重新接管」。
- 只有确定要撤销后来的改动，才选择「恢复接管前备份」。修复完成后重启 Codex。
不要删 config-transaction.json，不要清空 .codex，不要随便覆盖 auth.json。 如果原 TOML 已经损坏，面板还有「配置已经很乱，重新配置连接」；这是最后手段，会备份旧文件，但不会把所有插件、MCP 和个人偏好自动搬过去，需要你确认。
程序解压位置随你放；服务数据默认在 Windows 的 %LOCALAPPDATA%\codex-sleep-state、macOS 的 ~/Library/Application Support/codex-sleep-state。Codex 默认目录是 ~/.codex；用了 CODEX_HOME 或独立 profile，必须接入实际使用的那一份。
这版更新了什么
- 双击启动与自动进面板。 新增 setup、Windows / Mac 启动脚本，正常情况下不用复制管理口令。
- 配置冲突不用再全靠手改。 不再因注释、信任目录等无关变化判整份配置失效；增加保留 CCS 当前配置、恢复旧备份、坏配置修复入口。
- 没采到 state 时，可以先正常聊天。 首次 setup 没有明确策略时使用普通转发兜底；原来主动选过严格模式的保留。兜底会明确显示未注入，不拿 312 冒充 292。
- 重新采集按钮。 会话里能看目标、最近形状、失败原因和冷却时间，再采集需要确认，会消耗额度；不能跳过冷却或限流。
- 三模型与账号规则。 支持
gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra；个人 / Team 规则分开，state 不跨账号、凭据和模型混用。是否有模型权限仍取决于上游。 - 远程压缩兼容。 官方通道保留客户端需要的 OpenAI provider 名称；识别 V2 压缩，增加官方旧 V1 到 V2 的发送前桥接。API / 中转不强行套用官方桥接。
- 补齐真实客户端请求编码。 支持受大小限制的 gzip / zstd，修复此前 OAuth 客户端可能遇到的本地 415。
- 报错更好找原因。 区分配置未就绪、出口、采集、模型容量和上游拒绝；503 会带本机管理地址。请求计数独立保留，不再靠空会话列表猜是否收到请求。
- 反馈不用发整份配置。 面板可下载脱敏诊断，命令行也有 doctor。别把登录文件、完整订阅、代理密码和管理口令发群里。
有多省事，也要把边界讲清楚
正常环境不用手改文件；可安全恢复的旧记录可以自动处理。真正换了 provider、认证方式，或者坏文件无法判断原意时，仍需要你确认。 省步骤不等于替你猜账号，更不能把官方登录凭据发给未知中转。
服务运行时尽量不要同时用 CCS 改同一份配置。切换的稳妥顺序是：停止服务 → CCS 切换 → 启动服务 → 重启 Codex。
关闭网页不等于停止服务，关闭注入也不等于停止转发。退出用 Ctrl+C，给程序恢复配置的机会。
测过哪些，哪些还不能打包票
- GitHub Windows、macOS、Linux 的
go vet与竞态测试通过；四个平台程序包由 Release 工作流构建。不是每一种用户桌面环境都已人工实测。 - 真实 Sol：普通回复、V2 远程压缩、压缩后继续回复通过。
- 真实 Terra：普通回复通过。
- 真实 Astra：追加的两次短回复通过；此前容量失败仍保留在记录里。
- 本轮没有验证成功的项目：合格 292 采集/注入、真实 Team、旧 V1→V2 桥接的真实完整链路。 V1 直连曾返回 404；桥接已通过真实 CLI + 模拟上游测试，后续真实验收在压缩前遇到传输失败。
292 / 332 是本项目采用的经验筛选形状，不是官方公布的模型质量分数。不能仅凭长度判断降智，也不能承诺换代理一定采到。401 / 403 / 429 仍会停止，不靠换出口继续撞。
Windows 详细教程 · macOS 教程 · 面板教程 · 34 项问题与验收 · 真实测试记录
v0.2.0-alpha.1 · 管理面板与 CCS 配置兼容
这版主要解决一件事：不用再让群友打开配置文件、猜代理端口、对着 503 干着急。
这次新增
- 本地 Web 管理面板：启动后打开终端显示的
/admin/地址，用管理口令进入。可以开关注入、测试订阅、配置代理和查看路由，不需要另起一个服务。 - 订阅与本地代理：支持远程 HTTPS 订阅、本机 HTTP 订阅、本地订阅文件，以及 HTTP / HTTPS / SOCKS5 等代理。网页保存后直接应用，修改前会留备份。
- 路由页：查看节点、测试连接，或固定一个出口。订阅重排序不会悄悄把固定出口换成别的节点。
- CCS / Codex 配置兼容：识别当前 provider 和 profile，区分官方 ChatGPT 登录、API Key 和中转。兼容常见的
env_key，以及requires_openai_auth=true搭配 API Key 的配置。 - 更清楚的错误与恢复：区分本地没有合格 state 和上游 503。上次异常退出留下的配置，先核验再恢复；如果 CCS 或你自己改过，不覆盖新内容。
怎么开始
- 下载对应系统的包并解压。一般 Windows 电脑选
windows-amd64；Apple 芯片 Mac 选darwin-arm64。 - Windows 运行
.\ccodex-sleep-state.exe init，已有配置会保留。先退出 Codex，再运行.\ccodex-sleep-state.exe serve。 - 打开终端显示的管理面板地址，复制终端里的管理口令登录，在「订阅与代理」配置自己的出口。
- 重新打开 Codex，选 Astra，先发一个短问题验证。服务终端要保持打开，用完按 Ctrl+C 退出。
Mac 命令前缀换成 ./ccodex-sleep-state。完整说明见 Windows 教程、macOS 教程、面板教程。
这次测到了什么
- 全部 Go 包通过 race 测试和 vet；GitHub CI 的 Windows、macOS、Linux 均通过。
- 实际浏览器验证面板登录、注入开关、配置解析和路由列表，检查了窄屏显示。
- 本轮实际用了 4 次 Astra 请求：采集到默认规则下的 292，两次带 state 的 CLI 请求正常回复；通过管理接口关闭注入后，再请求也正常回复，且未注入 state。
- CCS API Key 和 env_key 两种接法，使用实际 Codex CLI + 本地模拟中转完成接管、认证传递、SSE 回复和配置恢复。不是所有真实中转站或 Windows 桌面客户端都测过。
仍然要说明
这是公开测试版，只做 Astra。它是一种尝试改善降智和限流体验的办法，不保证百分百有效；292 也不是官方的智力评分。普通中转默认不采集、不注入官方 turn-state；中转本身还得支持你请求的模型。
注入关闭后仍通过本服务转发，不等于恢复了 Codex 配置。运行期间不要同时在 CCS 里切换同一份配置：先停服务，再切换，再启动。401、403、429 不会靠换出口绕过去。
包内附中文教程。SHA256SUMS 用于核对下载文件；源码包包含对应依赖及许可证。程序没有遥测，不上传日志，不刷新登录或重置额度。不要把管理口令、auth.json、订阅或整个数据目录发到群里。
v0.1.0-alpha.1 · 首个公开测试版
这是 ccodex-sleep-state 的第一个公开测试版。
想试着改善 Codex 的降智和频繁限流，可以把自己的订阅或代理接进来，在本地跑这个服务。目前只做 Astra，不保证百分百有效，也不会增加账号额度。
这次实际测通了什么
保持默认 10 块规则，从真实 AnyTLS 出口采到了 292 字符 state。随后两次真实 Codex CLI 请求，都注入了这份 state、使用同一出口，并收到 Astra 的 OK 回复。第二次直接复用，没有重复采集。
不是把 312 改成“合格”来通过测试。没有合格 state 时仍会明确暂停。
下载哪个
| 电脑 | 文件 |
|---|---|
| 大多数 Windows 电脑 | ccodex-sleep-state-windows-amd64.zip |
| Windows ARM 电脑 | ccodex-sleep-state-windows-arm64.zip |
| Apple 芯片 Mac | ccodex-sleep-state-darwin-arm64.tar.gz |
| Intel Mac | ccodex-sleep-state-darwin-amd64.tar.gz |
压缩包里有程序和中文教程，运行不需要安装 Go。二进制尚未做商业签名或 Apple 公证，请先核对来源与 SHA256SUMS；不用关闭整个系统的安全防护。
Windows 怎么开始
先在 Codex 里完成登录。解压后打开 PowerShell：
.\ccodex-sleep-state.exe init
.\ccodex-sleep-state.exe paths按订阅与代理教程填好自己的出口，再退出 Codex，运行：
.\ccodex-sleep-state.exe check
.\ccodex-sleep-state.exe serve看到 Listening 后重新打开 Codex。服务窗口保持打开，用完按 Ctrl+C，正常退出会恢复配置。意外关闭后用 restore，再重启 Codex。
这一版补了什么
- AnyTLS 导入与出站支持。
- 每条订阅可指定下载客户端标识，解决部分链接返回空节点配置的问题。
- 可以按协议选择、按关键词排除节点；过滤后才建立连接，不关闭 TLS 校验。
- 首条请求拿到可用 state 就继续，不再等备用采集。
- 探测和正式请求共用认证/限流暂停逻辑，遵守 Retry-After，不靠切出口继续请求。
- 状态区分已就绪、等待采集、认证暂停和限流等待，方便排错。
Windows、macOS、Linux 的发布前自动测试通过后才打包。真实模型联调在 macOS CLI 完成；Windows 桌面客户端完整联调、长会话和质量对照还需要反馈。完整测试记录
源码包包含锁定版本的依赖和许可证。仓库及发布包不包含作者的订阅、节点、账号或个人配置。来 Issues 或 群里反馈时，请别贴登录凭据和完整订阅链接。