linguo2625469/workbuddy2api-panel

选用指南

AI 根据 README 整理 · 2026/10/16 22:36:46

适用场景

适用于个人管理多个CodeBuddy账号，提供OpenAI兼容接口供本地工具接入，并自动完成签到、成长任务等日常维护。

查看 README 依据

WorkBuddy2API 是一个自托管的 **OpenAI 兼容反向代理网关**，将腾讯 CodeBuddy（`copilot.tencent.com`）账号包装为统一的 `/v1/chat/completions` 服务。 - 官方不提供 OpenAI 形态的开放 API，本项目通过 **OAuth 设备授权**（面板「添加账号」或 `login.sh`）获取账号凭证，在网关侧做 token 自动刷新、账号池调度与流量治理； - 面向 **个人多账号** 场景：多账号共享、单号故障自动换号、冷却 / 熔断防止雪崩、会话粘性保证多轮上下文不跳号； - 对客户端只暴露 OpenAI 兼容接口，现有 SDK / 前端 / 工具 **零改造接入**。 > ⚠️ 合规须知：本项目是**非官方**网关，使用 CodeBuddy 账号作为上游，**仅限本人授权账号、本机 / 私有环境测试**。详细边界见[安全与合规](#安全与合规)。 ## 核心能力 | 能力 | 说明 | |---|---| | 🔑 **OAuth 一键登录** | `login.sh` 设备授权流程，自动落盘凭证并重启容器加载新账号 | | 🔄 **多账号池** | 快过期积分加权 + 成本分层 + 加权随机选号，Top-5 候选 + 防惊群 |

| 🗑️ **指纹脱敏** | 出站请求体黑名单指纹字段清洗（可关闭），与提示词体系两层叠加 | | 📊 **可观测** | 每请求一行表格日志（TTFB / token 速率 / uid）；`/healthz` 带 `service` 身份标识可接负载均衡 / 宿主探活 | | 💾 **状态持久化** | 池状态本地原子落盘 + Upstash Redis 异步镜像（可选），重启择新恢复 | | 🖥️ **Web 管理面板** | 内嵌单页面板（明暗主题，七个视图）：账号运维 / 用量与积分分析 / 模型档位条件查询 / 在线改配置（热生效）/ 运行日志（含**调用来源 IP·UA** 与时间区间）/ 积分任务，见 [Web 管理面板](#-web-管理面板) | ## 🎯 成长任务一键完成（17/18） 官方「成长计划」的 18 个成长任务中，**17 个可在面板上一键纯 API 完成**——无需安装官方客户端、无需人工交互，点一下「一键完成」即自动推进进度、等待异步计分落定并**自动领奖**。剩余任务展示操作指引。 ### 任务覆盖与奖励 | 任务 | 奖励 | 一键完成方式 | |---|---|---| | `first_buddy` | +300c +8e | 解锁上报 → 同意协议 → 领养第一只 Buddy |

目标用户

面向个人用户，用于管理自己的CodeBuddy账号，不适用于批量分发或商业售卖。

查看 README 依据

> ⚠️ **本项目仅限自用账号（签到 / 保活 / 个人工具接入），不支持同时也是禁止批量小号分发额度、二次打包或收费售卖。** 详见 [使用声明（必读）](#使用声明必读)。 ## 使用声明（必读） 本项目（含上游 [Sliverkiss/workbuddy2api](https://github.com/Sliverkiss/workbuddy2api)，下同）的开发初衷只有一个：**方便个人管理自己的 CodeBuddy 账号**——自动签到、保活、给自己的本地工具提供一个 OpenAI 兼容入口。它是免费、开源、按「原样」提供的个人自用工具。 近期我们发现有人将本项目用于以下行为： - **批量注册小号 / 收购账号，对外提供付费 API、共享池、代充等业务**； - **二次加壳、捆绑卡密（授权码）售卖**，或以「公益服」「低价中转」等名义变相收费分发。 我们对上述行为**表达最强烈的反对**，并声明如下： 1. **一切商用 / 售卖行为与本项目及作者无关。** 本项目不授权、不支持、不参与任何面向公众的 API 售卖、账号池出租、卡密收费分发；行为人由此产生的一切后果（包括但不限于账号封禁、条款违约与法律风险）由其自行承担，与作者和贡献者无任何关系。

使用方式

通过Web面板或命令行脚本添加账号，提供OpenAI兼容API接口，支持流式与非流式请求。

查看 README 依据

构建全部二进制： ```bash CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o wb2api ./cmd/server CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o signin_bin ./cmd/signin CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o login ./cmd/login CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o credit ./cmd/credit ``` ### 添加账号（登录） **方式 A：Web 面板（推荐，各平台通用，免命令行）** 打开 `http://127.0.0.1:7863/panel/`，点右上角「**添加账号**」：面板展示授权链接 → 浏览器完成登录 → 自动检测并落盘凭证 → **热加载进池（无需重启）**，顺带完成首次签到。 **方式 B：命令行脚本（仅 Linux / macOS，依赖 bash + python3）** ```bash ./login.sh

-H "Content-Type: application/json" \ -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hi"}],"stream":true}' # 非流式聊天（本地聚合） curl -s http://localhost:7863/v1/chat/completions \ -H "Authorization: Bearer your-api-key" \ -H "Content-Type: application/json" \ -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hi"}],"stream":false}' ``` ## 配置说明 **`config.example.json` 是配置项最完整的参考**：每个字段、默认值与结构都能在其中找到，示例值一律是 `test_key` 之类占位符，**不含任何真实密钥**。下表为字段含义速查。 ### 字段速查 | 字段 | 默认 | 说明 | |---|---|---| | `listen` | `:7863` | HTTP 监听地址 |

部署要求

需要Docker或直接运行单文件二进制，需要已注册的CodeBuddy账号，从源码构建需要Go 1.22或更高版本。

查看 README 依据

上游请求在出站前经历统一的改写管线（`internal/upstream/payload.go`）：强制 `stream:true`、`developer` 角色归一、tool_choice 归一、`image_url` 字符串兼容为 OpenAI 对象形态、DeepSeek 思维链注入、`reasoning_effort` 档位降级、`reasoning_content` 回填、指纹脱敏。 ## 快速开始 ### 环境要求 - **Docker + Docker Compose**（服务端部署方式，镜像内已含低权限用户与全部工具脚本）——或 - **Windows / macOS / Linux 直接跑单文件二进制**（无需 Docker，见下方「Windows 单文件运行」） - 一个或多个已注册的 CodeBuddy 账号，用于 OAuth 登录 - 宿主机 Go ≥ 1.22（仅从源码构建时需要） ### 方式〇：GHCR 镜像（免克隆免构建） CI 会自动构建多架构镜像（`amd64` / `arm64`）并发布到 GHCR，`git clone` 之外的部署路径： ```bash # 1. 准备配置与数据目录 mkdir -p auths data && cp config.example.json config.json

已知限制

仅限自用账号，不支持批量小号分发额度、二次打包或收费售卖；成长任务中有一项需真实捐款无法自动完成。

查看 README 依据

> ⚠️ **本项目仅限自用账号（签到 / 保活 / 个人工具接入），不支持同时也是禁止批量小号分发额度、二次打包或收费售卖。** 详见 [使用声明（必读）](#使用声明必读)。 ## 使用声明（必读） 本项目（含上游 [Sliverkiss/workbuddy2api](https://github.com/Sliverkiss/workbuddy2api)，下同）的开发初衷只有一个：**方便个人管理自己的 CodeBuddy 账号**——自动签到、保活、给自己的本地工具提供一个 OpenAI 兼容入口。它是免费、开源、按「原样」提供的个人自用工具。 近期我们发现有人将本项目用于以下行为： - **批量注册小号 / 收购账号，对外提供付费 API、共享池、代充等业务**； - **二次加壳、捆绑卡密（授权码）售卖**，或以「公益服」「低价中转」等名义变相收费分发。 我们对上述行为**表达最强烈的反对**，并声明如下： 1. **一切商用 / 售卖行为与本项目及作者无关。** 本项目不授权、不支持、不参与任何面向公众的 API 售卖、账号池出租、卡密收费分发；行为人由此产生的一切后果（包括但不限于账号封禁、条款违约与法律风险）由其自行承担，与作者和贡献者无任何关系。

| `Expert_team_use_3` | +100c +5e | 专家团召唤+使用链 ×3 | | `Hp_Appearance` | +100c +5e | 主题设置 + 皮肤生效事件 | | `Expert_lighthouse` | +100c +5e | 轻量云专家召唤+使用链（真实对话 requestId，**可免费领一个月轻量服务器**） | | `skill_1` | +100c +5e | 真实对话 + 技能加载事件（skill_info） | **全新账号一键全做完 ≈ +1950 credits +78 能量**，其中仅数个任务涉及真实对话（`Model_chat_GLM5.2` 一条、`expert_5`/`Expert_team_use_3`/`skill_1` 各数条 fast-model 短对话），其余全部为行为事件上报，零对话消耗。 ### 不可自动的 1 个 | 任务 | 原因 | |---|---| | `Expert_Philanthropy` | 需真实捐款（服务端领奖时校验捐赠回执，已实测无法绕过） | ### 实现原理（简述）