YYB-Go 应用宝协议服务

应用宝（YYB）协议实现，提供微信扫码登录与 wx.login code 获取，供 QQ 经典农场等微信小程序自动化使用（Farm5 兼容，配合 qq-farm-automation-bot 的微信端登录）。

上游：https://github.com/Aoluis1005/yyb-go （本仓库为 fork，仅新增 Docker 部署支持）

功能

• 微信扫码添加账号，扫码成功后保存 openid / login_buffer（SQLite 持久化）
• wx.login code 获取（getCode）、手机号（getPhoneNumber）、微信数据操作（operateWxData）
• 凭据自动保活：默认每 30 分钟检查，access token 剩余 <45 分钟时自动续期
• Web 控制台 + OpenAPI 文档

快速开始（Docker）

# 构建
docker build -t yyb-go:latest .

# 运行（可选环境变量）
docker run -d --name yyb-go \
  -p 8000:8000 \
  -v yyb-go-data:/app/resource \
  -e YYB_API_TOKEN=your-token \
  -e YYB_ADMIN_USER=admin \
  -e YYB_ADMIN_PASS=admin \
  yyb-go:latest

环境变量

变量	默认	说明
YYB_API_TOKEN	空	调用 /qr、/wxapp/* 接口需 Authorization: Bearer <token>
YYB_ADMIN_USER / YYB_ADMIN_PASS	空	Web 控制台登录
YYB_KEEPALIVE_INTERVAL	30m	账号保活检查间隔（0 关闭）
YYB_KEEPALIVE_AHEAD	45m	token 剩余不足该时长时提前续期

API 示例

# 获取登录二维码
curl -X POST 'http://localhost:8000/qr?as_base64=true' \
  -H "Authorization: Bearer $TOKEN"

# 轮询扫码状态
curl 'http://localhost:8000/qr/<session_id>/poll' \
  -H "Authorization: Bearer $TOKEN"

# 确认登录（扫码成功后）
curl -X POST 'http://localhost:8000/qr/<session_id>/confirm' \
  -H "Authorization: Bearer $TOKEN"

# 获取 wx.login code（Farm5 兼容：openid + forceRefresh）
curl -X POST 'http://localhost:8000/wxapp/getCode' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"openid":"<openid>","forceRefresh":true}'

与 qq-farm-automation-bot 集成

见 qq-farm-automation-bot README 的「微信扫码登录」章节。Docker Compose 编排（docker-compose.yml 双服务）中：

• yyb-go 不暴露宿主机端口，仅通过 compose 内部网络供 qq-farm-bot 访问（http://yyb-go:8000）
• YYB_API_TOKEN 需在两个服务中保持一致

免责声明

仅供学习与研究用途，请遵守相关服务条款。