源码系统概览
文章正文
这是一套把腾讯 CodeBuddy 账号池装进可视化面板的管理系统方案，WorkBuddy Manager 扫码批量纳管账号、自动签到、多密钥分发、IP 管控、调用日志与用量统计全在一个 Web 面板完成。
项目由作者 ithtelab 开源，仓库获 479 star、122 fork 关注，采用 MIT 协议，前端 Next.js 15 + React 19 + TypeScript 5 + Tailwind 4，后端 Python 3.11 + FastAPI，对应版本 v1.0.70 最后更新 2026 年 9 月 24 日，更新日志完整，配套上游 workbuddy2api 反代网关随发布包分发。
源码简介
管理腾讯 CodeBuddy 账号池，原来只有命令行，加账号要跑脚本、看状态要 curl、发密钥没有界面，这套把全部运维动作搬进浏览器面板。
扫码授权即可批量纳管账号，自动每日签到并续期，过期前自动向腾讯换新令牌，仪表盘实时展示健康度、冷却与积分余额。
密钥系统支持多密钥分发，各自独立配额、IP 白名单与模型白名单，调用日志全量留痕，方便排查与计费。
vs Linux DO cdk 等命令行面板，区别在把账号纳管、签到、密钥与 IP 管控全部可视化，免写脚本。
| 对比维度 | WorkBuddy Manager | Linux.DO cdk 命令面板 |
|---|---|---|
| 交互形态 | Web 可视化面板 | 命令行接口 |
| 账号纳管 | 扫码批量+自动签到 | 脚本手动操作 |
| 密钥管理 | 多密钥独立配额与白名单 | 单一全局 Key |
| 授权协议 | MIT | 各有差异 |
想把 CodeBuddy 账号池管理可视化，拉源码配好上游按部署指南跑起来即可。
适用场景
- 运营方批量管理腾讯 CodeBuddy 账号池，扫码入库自动签到
- 给多个下游客户端分发独立 API Key，配额与白名单隔离
- 监控账号健康度、冷却与积分余额，预警即将过期账号
- 审计每次调用的模型、Token、延迟与来源 IP
技术栈与运行环境
压缩包大小: 约8MB
前端: Next.js 15 + React 19 + TypeScript + Tailwind
后端: Python 3.11 + FastAPI + uvicorn
数据库: SQLite（api_tokens）
协议: MIT
上游: workbuddy2api（Go）随发布包分发
server 端 FastAPI 承载账号、密钥、日志、设置等 API 路由，依赖 fastapi/uvicorn/httpx/pydantic，配置全走环境变量覆盖。
web 端 Next.js 提供仪表盘、账号、密钥、日志、模型、统计等页面，开发时 next dev 反代 /api 与 /v1 到后端。
功能亮点
- 扫码批量纳管微信 / QQ 账号，自动每日签到与令牌续期
- Token 有效期进度条，即将过期自动预警并换新令牌
- 多密钥分发，各自独立配额、IP 与模型白名单
- 入站白名单 / 黑名单 + 每密钥 IP 上限
- 每次调用模型、Token、延迟、来源 IP 全量留痕
- 中文可视化设置，开关 + 数字框调整签到与并发
技术架构与部署指南
安装与部署提示
推荐用发布包一键脚本部署，会自动带入随包分发的上游源码。
sudo bash deploy/install.sh也可用 docker compose 拉起容器。
docker compose up -d前端开发时启动 next 并反代后端。
cd web && npm run dev截图与演示说明
第一张为仪表盘截图，实时展示账号健康度、冷却、有效期进度与积分余额，配合登录概览一眼掌握整个账号池的在线与闲置状态。
第二张为密钥管理页，呈现多密钥独立配额、IP 白名单与模型白名单配置，按客户端隔离管控分发与用量。
常见问题
问. 这是什么
腾讯 CodeBuddy 账号池的 Web 管理控制台，把扫码、签到、密钥、IP 与日志全部可视化。
问. 是开源的吗
采用 MIT 协议，上游 workbuddy2api 源码随发布包一起分发，同样 MIT。
问. 需要什么依赖
上游 workbuddy2api 提供账号池调度，本项目是其可视化配套，需两者配合运行。
问. 数据存哪
密钥等存于 SQLite，账号授权凭据存上游目录，请勿公开提交数据目录。
安全风险提示
历史上 users.json 曾存在 api_keys 数组提权后门，新设计已改为密钥仅存哈希且有 scope 与审计，部署前请拉取最新版。
涉及真实账号授权与腾讯令牌管理，请勿将数据目录公开分享，部署应启用 HTTPS 与强密码。
上游 workbuddy2api 源码随包分发，依赖它提供账号调度与限流熔断，升级时保持两者版本一致。
这和纯命令行的管理方式不同，面板把所有运维动作集中在一处，省去记忆脚本与接口。
下载说明
本页提供 WorkBuddy Manager 账号池管理系统源码，含 Next.js 前端、FastAPI 后端与一键部署脚本。
压缩包较小，三个网盘均可下载，解压后按部署指南安装。
GitHub项目开源地址 https://github.com/ithtelab/workbuddy-manager
