fzuhelper-bot

功能

• 推送福uu内测版更新日志
• AI生成更新日志
• 上传福uu测试版apk
• BOT掉线通知

部署

前置需求

• 已安装 Docker和Docker Compose
• 一个已注册的QQ账号（用作机器人）
• 一个想好的GitHub Webhook密钥

1. 下载并解压release

wget https://github.com/west2-online/fzuhelper-bot/releases/download/edge/docker-fzuhelper-bot.tar.gz
tar -xzf docker-fzuhelper-bot.tar.gz
cd docker-fzuhelper-bot

2. 配置环境变量

cp .env.example .env

编辑 .env 文件，配置必要的环境变量：

#NoneBot驱动 (无需改动)
DRIVER = ~fastapi+~httpx+~websockets
HOST = 0.0.0.0
PORT = 8080
MILKY_CLIENTS = '
[
  {
    "host": "lagrange",
    "port": "3000",
    "access_token": "最好配一个密钥，虽然在内部，但是配一个总是好的",
    "secure": false
  }
]
'
API_TIMEOUT = 120.0
#Webhook的密钥
WEBHOOK_SECRET = SECRET
#测试群号
TEST_GROUP_ID = 785037622
#APP仓库的全名
APP_REPO = ACaiCat/WebHookTest
#离线飞书通知的Webhook地址
OFFLINE_NOTICE_WEBHOOK = https://www.feishu.cn/...
#离线邮件通知配置
SMTP_SERVER = smtp.qq.com
SMTP_PORT = 465
SMTP_USERNAME = [email protected]
SMTP_PASSWORD = your_generated_auth_code
EMAIL_FROM = [email protected]
EMAIL_TO = [email protected]
#AI配置 (生成CHANGELOG)
AI_API_KEY = your_ai_api_key
AI_API_URL = https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
AI_MODEL = qwen-max-latest

3. 配置Lagrange

mkdir data
cp lagrange_config.example.jsonc data/lagrange_config.jsonc
code lagrange_config.jsonc # 编辑lagrange_config.jsonc，配置密钥

4. 配置 Docker Compose

复制 docker-compose 模板并重命名：

cp docker-compose.yml docker-compose.override.yml

编辑 docker-compose.override.yml 文件，配置端口映射等：

services:
  nonebot:
    ports:
      - "8080:8080"

5. 使用Docker Compose部署

docker compose up -d

6. 登录 QQ 机器人

查看Lagrange日志并扫描二维码登录：

docker logs -f lagrange

Note

如果控制台中的二维码无法扫描，可以打开 data/qr-0.png 文件扫描图片中的二维码。

7. 测试BOT

在群中发送/bot-ping (首先得拉BOT进群)
如果BOT正常就会响应pong

8. 添加Webhook

1. 在仓库-Settings-Webhooks选择Add webhook新建一个Webhook

2. 配置Webhook

   • Payload URL: http(s)://address:port/github/webhook
   • Content type: application/json
   • Secret: webhook_secret
   • Which events would you like to trigger this webhook?
     • Let me select individual events.
       勾选Releases
     • Send me everything.

   [!IMPORTANT]
   Bot的GitHub Webhook并不支持https交付。如果需要使用https交付，请配置Nginx等反代

3. 测试Webhook 点开新建Webhook的Recent Deliveries可以看到最近的交付，如果ping事件正确响应，则Webhook配置正确

BOT掉线重连

先重启lagrange容器

docker restart lagrange

然后再重新扫码登录

Note

如果被限制登录需要先在手机QQ上解除

Important

如果重启容器后不显示二维码，可以尝试删除data/keystore.json和data/device.json再重启容器

rm data/keystore.json data/device.json
docker restart lagrange

登录失败

1. 在自己电脑下载Lagrange
2. 运行Lagrange，并且按下任意键进入登录
3. 登录
4. 把生成的device.json和keystore.json上传到data文件夹中
5. 使用docker restart lagrange重启容器即可完成登录