源码系统概览
文章正文
签到台是一套跑在本地机器的多账号自动签到控制台,每天定时把 WorkBuddy 国内版、国际版与 Trae 的签到、成长任务与领奖流程跑完,并把积分、连登天数、凭证到期时间集中展示。
项目用 Python 编写,FastAPI 提供网页服务,数据存本地 SQLite,账号凭证以对称加密保存,不经过任何第三方服务器。
源码简介
工程规模约一万八千行 Python。webapp/app.py 是路由与业务编排入口,两千四百余行;scheduler.py 负责定时、补签、看门狗与到期巡检,七百七十余行。
platforms 目录是平台适配层,按站点拆成 workbuddy.py、workbuddy_intl.py 与 trae.py,各自封装登录方式、签到接口与积分字段解析,公共逻辑抽到 base.py。
credits.py 处理积分快照与每日汇总,按固定东八区计算当天差额;db.py 初始化 SQLite 并启用 WAL 模式;admin.py 实现管理员鉴权、会话与审计。
另有几个值得说的实现:browser_login.py 用 CDP 加 WebSocket 做内置浏览器投屏登录;cdp.py 是纯 Python 实现的 CDP 客户端;trae_storage.py 解析客户端 storage.json 并一次性取出凭证与设备号。
前端是原生 HTML、CSS 与 JavaScript,无构建步骤也无框架依赖;项目自带 Dockerfile、systemd 服务示例与守护脚本,三种部署方式都覆盖了。
适用场景
同时在用 WorkBuddy 与 Trae、手上有多个账号需要每天签到的开发者,想把手动操作交给定时任务。
需要集中查看多个账号的积分余额、连登天数与凭证到期时间,避免积分过期浪费的用户。
学习 FastAPI 应用组织、APScheduler 定时任务、凭证加密存储与多平台适配层设计的 Python 开发者。
功能亮点
定时与补签机制完整:每天固定时间执行,服务重启或机器唤醒后发现当天漏签会立即补跑,另有每分钟自检的看门狗兜底。
任务体系覆盖全:除签到外还能跑成长任务、领取奖励,并支持查询抽奖次数、盲盒、旅行进度与补签卡等玩法状态。
多平台统一管理:国内版与国际版登录态不通用、接口路径也不同,适配层分别处理,前端用同一套账号列表呈现。
积分统计细致:按包展示剩余额度与到期时间,快过期时前台标橙,后台给出十四天柱状图与每日汇总。
失败保护:连续失败达阈值自动停用账号,断网等环境问题不计入;处理好后可手动恢复并清零计数。
安全设计到位:凭证用 Fernet 加密入库,密钥文件权限六百且不随仓库分发;管理员密码 PBKDF2 二十万次迭代,会话可吊销,所有写操作落审计表。
通知渠道齐全:支持 Bark、PushPlus、企业微信与钉钉,可推送每日汇总与凭证到期提醒。
技术架构与部署指南
技术栈与运行环境
后端为 Python 3.10 以上,框架 FastAPI 配 uvicorn,定时任务用 APScheduler,加密依赖 cryptography,浏览器登录用 playwright 与 websocket-client。
数据存储为 SQLite(WAL 模式),单文件即全部状态;前端为原生页面,由 FastAPI 直接托管静态资源。
部署方式支持本机直跑、Docker 容器与服务器 systemd 常驻三种。
安装与部署提示
第一步准备 Python 3.10 以上环境,创建虚拟环境并安装 requirements.txt 中的依赖。
第二步运行启动脚本拉起服务,浏览器访问本机八千端口的控制台路径即为前台。
第三步首次进入后台会引导创建管理员账号,随后在后台设定执行时间、补签与看门狗开关。
第四步添加账号:国内版用手机验证码登录或粘贴令牌,国际版走网页授权,Trae 可直接选择客户端的 storage.json 自动解析。
第五步如需外部访问,务必设置访问令牌环境变量并套一层反向代理加 HTTPS。
第六步用 Docker 部署时数据目录必须挂载出来,否则容器重建会连同加密密钥一起丢失,旧备份也无法还原。
截图与演示说明

账号列表一列一项信息,凭证过期的账号整行标红,右上角可批量签到。

账号行展开后可见逐项执行记录,每次跑了哪些任务、领到多少积分都在这。

后台概览展示今日签到率、积分汇总、十四天执行趋势与凭证到期看板。

移动端界面适配效果,手机上也能查看账号状态与执行积分。
项目自带完整界面截图,位于 docs/screenshots 目录,可直接作为文章配图使用。
accounts-table.png 展示账号列表,一列一个信息,凭证过期整行标红,适合作为产品主图。
accounts-detail.png 展示行展开后的任务执行入口,accounts-tasks.png 展示逐项执行明细与当日积分。
admin-overview.png 与 admin-accounts.png 展示后台概览与账号管理,admin-daily.png 是十四天趋势图。
mobile.png 展示移动端适配效果,trae-import.png 到 trae-refresh.png 四张图完整说明 Trae 导入与凭证刷新流程。
常见问题
问:支持哪些平台?答:WorkBuddy 国内版、国际版与 Trae,三个平台的签到与积分查询都覆盖。
问:签到显示无活动是失败吗?答:不是,这是平台明确返回活动未开放,凭证正常,系统单独计数不视为失败。
问:换机器怎么迁移?答:拷贝整个数据目录,尤其是加密密钥文件,缺了它数据库里的凭证全部解不开。
问:能提高签到频率吗?答:不建议,签到每天一次即可,频繁轮询容易触发平台风控。
安全风险提示
特别提示:源码未经过安全审计,建议先在测试环境部署核查后再使用。
本项目通过调用平台接口实现自动化签到,各平台服务条款对自动化访问的态度不同,使用前请自行确认并承担账号被限制的风险。
系统需要保存账号登录凭证,数据目录与加密密钥属于高敏感内容,切勿提交到公开仓库、也不要分享给他人。
对外网开放时必须设置访问令牌,否则任何人打开链接都能操作你的账号;建议再叠加反向代理与 HTTPS 并限制访问来源。
Trae 的 storage.json 含设备凭证,导入后请确认原文件未被复制留存;本项目声明只读一次内存、不保存原文件,但仍建议自行核查。
相关源码推荐
同为本地自动化工具且涉及多账号凭证管理的,《闲鱼自动发货Python源码虚拟商品工具系统》在凭证隔离与幂等设计上可以对照参考。
如果关注定时轮询与本地服务形态,《UptimeKuma自托管监控管理源码》的调度与告警思路值得借鉴。
需要 Flask 加后台线程的实现对照时,《学习通签到监控Python源码Flask工具系统》同样以定时检测为核心。
下载说明
源码仅供学习研究与技术参考,请在下载后二十四小时内自行决定保留或删除,请勿用于任何违法用途。
本资源为 Python 多账号签到控制台源码,含网页服务、平台适配层、定时调度与完整界面截图,解压后按说明安装依赖即可运行。
使用过程中请自行承担账号、数据与合规责任,遵守各平台服务条款。
更新日期:2026-10-30。