基于 Python 标准库与 curses 的终端工具,用于定时或探测调用 AnyRouter 并查看响应状态与用量(本工具不保证服务商账号保活效果)。
在项目目录下执行 nix develop 进入开发环境,随后任选一种模式启动:
./codex-time.sh # 模式 1:定时轮询 (Keeper)
./codex-probe.sh # 模式 2:持续探测,200 后停止 (Probe)
./codex-auto.sh # 模式 3:探测成功后自动转定时 (Combined)(也可在具备 Python 3.10+ 及 curses 支持的 Linux 环境下直接运行上述脚本)
- 凭据与操作:首屏通过顶部掩码输入框填写 API Key,仅保存在当前内存中,不读取环境变量、本地配置文件或命令行参数。主界面按键:
S设置、P暂停/继续、R立即请求、↑/↓浏览历史、Q退出;设置面板按Tab或↑/↓切换字段,Enter保存,Esc取消。 - 定时模式 (Keeper):每轮从本地 50 位诗人中随机抽选一位构建提示词;仅遇 HTTP 500 时立即重试(沿用同位诗人,最多额外 10 次,单轮上限 11 次);整轮请求全部完成后等待设定间隔(默认 120 秒)。
- 探测模式 (Probe):启动时生成完整请求载荷(含固定元数据与 ID)并在后续尝试中复用完全相同的请求内容;遇非 200 响应(含各类网络错误)持续单路重试,每次完成后等待 1 秒(默认);一旦收到 HTTP 200 状态码即永久终止后续请求(即使解析出错也停发),TUI 保持开启(按键无法重新触发,需重启程序);左侧展示固定提示词与当前响应,右侧展示状态与费用。
- 联动模式 (Auto):同一进程与内存 Key 下运行,首先执行探测逻辑;收到 HTTP 200 后立即触发首次定时请求(不等待 120 秒),之后按默认 120 秒间隔常驻运行(若处于手动暂停或设置打开状态则优先保持暂停)。
- 持久化日志:所有尝试结果均追加写入
logs/requests.jsonl(首个结果产生时自动创建),跨进程重启保留,可通过tail -f logs/requests.jsonl持续查看。日志记录脱敏摘要,不包含 API Key、请求头及原始载荷;运行时日志已被 Git 忽略,不会上传到远端仓库。 - 接口与费用:直连
https://anyrouter.top/v1/responses(模型gpt-6-astra)。官方参考费率按每 1M tokens 输入 $10、缓存 $1、输出 $50 估算,仅供参考,非实际账单;所有网络请求(含 500 重试)均可能产生计费,退出时在途请求仍可能消耗配额。
在离线 Mock 传输与虚拟时钟环境(模拟 500 -> 503 -> 200 序列,观测 4 虚拟秒)下对比调度行为(仅验证本地控制流,非真实上游性能或成功率):
| 测试方案 | 请求次数 | 不同请求体 | 发起时刻(虚拟秒) | 行为特征 |
|---|---|---|---|---|
| 基线逻辑 (Baseline) | 3 | 1 种 | 0, 1, 2 | 单路复用相同请求体,收到 200 永久停止后续调度 |
| 消融:固定载荷 | 3 | 3 种 | 0, 1, 2 | 每次尝试重新构建载荷并生成新 ID |
| 消融:200 停发机制 | 5 | 1 种 | 0, 1, 2, 3, 4 | 收到 200 后未终止,持续重复探测 |
| 消融:完成间隔保护 | 3 | 1 种 | 0, 0.125, 0.25 | 完成后不再等 1 秒,随下一循环发起(0.125 秒仅为模拟步长) |
本项目采用 GNU GPL v3.0 或后续版本(GPL-3.0-or-later)。