主题
项目介绍
free-llm-router 把多个大模型供应商的账号池，聚合成一个 OpenAI 兼容的 API， 外加任务自动化（签到 / 成长任务 / 自动领奖）。跑在 Cloudflare Workers 上， Free 计划即可。
- API 基址：
https://<你的域名>/v1 - 管理面板：
https://<你的域名>/panel/
它能做什么
- OpenAI 兼容网关 ——
GET /v1/models、POST /v1/chat/completions，流式与非流式， 含工具调用。请求经过账号池（选号 / 记账 / 失败换号 / 会话粘性）。 - Responses API ——
POST /v1/responses，给 Codex CLI 这类只发input的客户端用。 内部复用 Chat 路径，Chat 侧修好的缺陷它自动受益。 - 14 家供应商 —— 统一
Provider接口，模型名用provider/model前缀路由。 - 聚合路由 ——
aggregate/…把各家的同一个真实模型归到一个规范名下， 按「积分最快作废」自动选渠道，失败自动换下一家。 - 任务自动化 —— 一键签到 + 成长任务 + 自动领奖，全部任务幂等。
- 凭据自动续期 —— 8 家支持。每小时 cron 在过期前 1 小时主动换新，401 时另有兜底续期重放。
- 凭据加密 —— AES-GCM 落 Durable Object SQLite，不落明文；未配置密钥时拒绝写入。
- 子密钥 —— 可签发给外部客户端的受限密钥（见子密钥）。
它不是什么（使用边界）
本项目仅限本人授权账号自用，明确反对：
- 批量注册小号 / 收购账号；
- 账号池出租、对外提供付费 API、二次加壳售卖。
⚠️ 不接纯 API Key 型供应商：本项目是账号集中管理网关，价值在账号（登录态）上 —— 设备码 / OAuth 登录、自动续期、签到、按账号的额度轮转。只发放一个静态 API Key 的 服务没有账号可管，不在接收范围（这类需求请使用 one-api 等项目）。
技术方案不阻止违规用法，但项目的开发意图不包含它们。批量注册与转售接口配额 违反目标平台的服务条款。
架构速览
客户端(Cline/Cherry Studio/curl…)
│ OpenAI 协议(/v1/chat/completions 等)
▼
Worker 网关(鉴权 / 模型路由 / 选号 / 记账)
│ │
▼ ▼
各供应商上游 AccountPool DO(账号池 + 凭据加密存储)
(buddy/qoder/…) TaskRunner DO(任务自动化)- Worker：无状态入口，全部数据在 Durable Object 里；
- AccountPool DO：账号池状态机（可用 / 冷却 / 熔断 / 停用）+ 凭据加密存储；
- TaskRunner DO：每账号一个，跑签到与成长任务。
更多设计细节见仓库的 AGENTS.md （唯一权威设计文档，含全部协议事实与踩坑记录）。