统一的 AI 编码账号网关 — 把 WorkBuddy / CodeBuddy 与 Trae CN 的账号池，汇聚成一个 OpenAI 兼容 API。
A unified gateway for AI coding accounts — merge your WorkBuddy / CodeBuddy and Trae CN account pools into a single OpenAI-compatible API.
中文 · English
本项目是一个非官方、逆向实现的本地网关，用于把你个人账号的既有额度集中暴露为 OpenAI 兼容接口，方便自用工具（编辑器、脚本、本地 Agent）统一调用。
- 仅限你本人拥有并合法使用的账号，且仅用于本机 / 私有环境自用；
- 明确反对：批量注册小号对外提供付费 API、共享账号池、二次加壳售卖、任何商业转售；
- 逆向接口随时可能被上游变更而失效，且可能违反上游平台服务条款，存在账号封禁风险；
- 凭证以明文落盘（见
auths/等目录），请勿外传、勿提交到公开仓库、勿对外暴露监听端口。
继续使用即代表你已知悉并自行承担上述风险。 The authors assume no liability for any account suspension or terms-of-service violation.
CodeNexus 的目标是把两套已在用、各自成熟的工具收敛为一个：
| 来源 | 角色 | 现状 |
|---|---|---|
linguo2625469/workbuddy2api-panel |
WorkBuddy / CodeBuddy 账号 → OpenAI API | 已实测可用 |
autumnsentiment/Trae2api-cn |
Trae CN 账号 → OpenAI API | 已实测可用 |
两者对外都已是 OpenAI 兼容接口，但各自独立运行、各自一套账号池与控制台。CodeNexus 以 workbuddy2api-panel 的单二进制 + 内嵌网页控制台架构为主要参考，引入统一网关层，让「一个进程、一个面板、一个 base_url」同时托管两类账号。
状态：🚧 早期骨架。以下为目标特性，实现进度见
docs/ROADMAP.md。
- 统一 OpenAI 兼容 API：
/v1/chat/completions、/v1/models，流式（SSE）与非流式。 - 多源账号池：同一池内混合 WorkBuddy/CodeBuddy 与 Trae CN 账号，按来源、积分、可用性调度。
- 上游适配器：可插拔的
Upstream接口，每个来源实现自己的鉴权、请求、流式解析与错误映射。 - 调度与容错：顺序 / 积分优先轮询、每账号并发槽位、429 冷却与指数退避、熔断。
- 内嵌网页控制台：账号管理、用量与积分看板、任务中心、在线改配置、运行日志（前端随二进制 embed）。
- 自动签到 / 保活：按本地时区定时的签到、活跃、保活任务（可逐项开关）。
- 单文件部署：Go 编译为单二进制，前端已内嵌，拷到任意机器即可运行。
flowchart LR
C[OpenAI 兼容客户端<br/>编辑器 / 脚本 / 本地 Agent]
subgraph CN[CodeNexus 单进程]
API[HTTP API 层<br/>/v1/chat/completions · /v1/models]
ROUTER[统一路由与调度<br/>账号选择 · 冷却 · 并发槽]
POOL[(统一账号池)]
SCHED[定时任务<br/>签到 · 保活]
PANEL[内嵌网页控制台]
subgraph UP[上游适配器 Upstream]
WB[WorkBuddy 适配器]
TR[Trae CN 适配器]
end
end
WBUP[WorkBuddy / CodeBuddy 上游]
TRUP[Trae CN 上游]
C -->|OpenAI 协议| API --> ROUTER
ROUTER --> POOL
SCHED --> POOL
PANEL --- POOL
ROUTER --> WB --> WBUP
ROUTER --> TR --> TRUP
设计要点：
- 入口统一、出口适配：对外只暴露一套 OpenAI 协议；对内通过
Upstream接口屏蔽两套上游的差异。 - 池与调度解耦：账号池只关心「有哪些凭证、状态如何」，调度器只关心「这次请求该选谁」。
- 控制台与 API 同源：单一二进制同时服务 API 与控制台，部署面最小。
| 来源 | 形态 | 出口协议 | 备注 |
|---|---|---|---|
| WorkBuddy / CodeBuddy | 账号池 + 网页控制台 | OpenAI Chat | 以 workbuddy2api-panel 为参考 |
| Trae CN | 账号池 + 网页控制台 | OpenAI Chat | 以 Trae2api-cn 为参考，含 9074 设备级风控退避 |
🚧 设计 / 骨架阶段：本仓库当前仅包含项目说明与文档，尚无可运行代码。约定的技术栈（Go 单二进制 + 内嵌网页控制台 + 统一网关）与实现计划见 docs/ROADMAP.md。
规划中的使用方式：
git clone https://github.com/ZicongCheung/CodeNexus.git
cd CodeNexus
# 构建与启动命令将在 P0 阶段落地首次启动将在工作目录生成 config.json（含随机 api_key，仅在日志中打印一次），随后浏览器打开 http://127.0.0.1:7863/panel/。
config.json 预期字段（实现中会逐步补齐）：
⚠️ api_key留空等于完全不鉴权，即使本机自用也务必设置。
任何支持「自定义 base_url + API Key」的 OpenAI 兼容客户端均可接入：
base_url：http://127.0.0.1:7863/v1api_key：config.json中的api_keymodel：从GET /v1/models动态获取（上游模型目录随时变化，硬编码会 404）
from openai import OpenAI
client = OpenAI(base_url="http://127.0.0.1:7863/v1", api_key="<your-key>")
print([m.id for m in client.models.list().data]) # 先取真实模型 id
resp = client.chat.completions.create(
model="<上一步的某个 id>",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in resp:
print(chunk.choices[0].delta.content or "", end="")当前为文档骨架；代码目录将在实现阶段按下方规划创建。
CodeNexus/
├── docs/ # 设计与路线图文档
├── README.md
├── CONTRIBUTING.md
├── LICENSE
└── .gitignore
# 规划中（尚未创建）：
# ├── cmd/codenexus/ # 程序入口
# └── internal/ # 核心实现 api / router / pool / upstream / panel / store
见 docs/ROADMAP.md。概览：
- P0 骨架 — 目录、配置、HTTP 服务与
/healthz。 - P1 上游适配器 — 抽象
Upstream接口，落地 WorkBuddy 与 Trae CN 两个实现。 - P2 账号池与调度 — 统一池、轮询、冷却、并发槽。
- P3 统一 API —
/v1/models、/v1/chat/completions（流式/非流式）。 - P4 控制台与任务 — 内嵌网页控制台、签到/保活调度。
- P5 打包 — 单二进制 + 前端 embed，跨平台构建。
见 CONTRIBUTING.md。请勿在 issue / PR 中粘贴任何真实凭证。
本项目建立在以下开源工作之上，特此致谢：
linguo2625469/workbuddy2api-panel— 架构主要参考（Go 单文件 + 内嵌控制台 + 多账号池 + 自动签到）。autumnsentiment/Trae2api-cn— Trae CN 上游适配与风控处理参考。
MIT © 2026 ZicongCheung
CodeNexus — A unified gateway that merges your WorkBuddy / CodeBuddy and Trae CN account pools into a single OpenAI-compatible API.
This is an unofficial, reverse-engineered local gateway that exposes your own accounts' quotas as an OpenAI-compatible endpoint for personal use.
- For accounts you own and are legally allowed to use, locally / in private only.
- Explicitly opposed: bulk-registering throwaway accounts to resell paid APIs, shared pools, repackaging/reselling.
- Reverse-engineered endpoints may break at any time and may violate the upstream platform's Terms of Service, risking account suspension.
- Credentials are stored in plaintext on disk. Never commit them, share them, or expose the listening port publicly.
Use at your own risk.
- Unified OpenAI-compatible API —
/v1/chat/completions,/v1/models(streaming + non-streaming). - Multi-source account pool — WorkBuddy/CodeBuddy and Trae CN in one pool, scheduled by source, credits and availability.
- Pluggable upstreams — an
Upstreaminterface; each source implements its own auth, request, streaming and error mapping. - Scheduling & resilience — round-robin / credit-priority, per-account concurrency slots, 429 cooldown with exponential backoff, circuit breaking.
- Embedded web console — account management, usage/credit dashboard, task center, live config, runtime logs.
- Auto check-in / keep-alive — scheduled tasks (individually toggleable).
- Single-binary deployment — Go single binary with the frontend embedded.
🚧 Design / scaffolding stage — this repository currently contains documentation only; no runnable code yet. See docs/ROADMAP.md for the planned Go-based stack and implementation phases.
git clone https://github.com/ZicongCheung/CodeNexus.git
cd CodeNexus
# build & run commands will land in the P0 phasebase_url:http://127.0.0.1:7863/v1api_key: theapi_keyfromconfig.jsonmodel: fetch dynamically fromGET /v1/models
Built upon linguo2625469/workbuddy2api-panel (primary architectural reference) and autumnsentiment/Trae2api-cn.
MIT © 2026 ZicongCheung
{ "listen": "127.0.0.1:7863", // 监听地址，仅本机时用 127.0.0.1 "api_key": "", // 客户端鉴权用；留空=不鉴权（危险） "pool": { "credit_floor": 100, "cooldown_seconds": 600 }, "upstreams": ["workbuddy", "trae-cn"], "schedule": { "checkin_enabled": true, "keepalive_enabled": true } }