cscs181/qq-github-bot repository overview

⁠简介

在 QQ 内 订阅, 查看, 处理 GitHub Issue and Pull Request 。

⁠功能简介

主要功能有 (持续更新中)：

⁠事件订阅

支持的事件根据 GitHub APP 配置的 Webhook 事件列表而定，可以自行选择和更改，推荐选择的事件有：

⁠部署

⁠Docker

1. 部署要求

   • Docker & Docker Compose

     curl -sSL https://get.docker.com/ | sh
     

     Copy

   • 1+ CPU Core

   • 1+ GB RAM

   • 能够访问 GitHub API 的网络环境

   对于内存大小的限制，可以通过修改 docker-compose.yml 中的 deploy.resources.limits.memory 来调整，由于采用了 playwright(chromium) 渲染图片，不限制内存可能会导致渲染大图时直接卡死服务器。

2. 注册 GitHub App 配置 GitHub App：

   1. callback URL 为 http://<your-domain>/github/auth
   2. webhook URL 为 http://<your-domain>/github/webhooks/<app_id>，可在 app 创建完成后添加
   3. 权限为 Contents (Read Only), Deployments (Read Only), Issues (Read and Write), Pull requests (Read and Write), Metadata (Read Only) 和 Starring (Read and Write)
   4. Webhook 事件参考 事件订阅⁠ 自行选择需要的事件
   5. 取消勾选 Expire user authorization tokens 或在 app optional feature 中 opt-out
   6. 勾选 Request user authorization (OAuth) during installation
   7. 记录 app_id, client_id，生成并下载 private_key, client_secret 备用

3. 下载 docker-compose.yml⁠ 至任意空目录

4. 在 docker-compose.yml 同目录下创建 .env 并写入如下配置项：

   # 可选，参考 nonebot superuser 格式
   SUPERUSERS=["机器人管理号"]
   
   # 必填，可以访问到机器人的公网地址，用于上传图片
   FILEHOST_URL_BASE=https://<your-domain>
   
   # onebot
   # 可选
   ONEBOT_ACCESS_TOKEN=your_access_token
   # 可选
   ONEBOT_SECRET=your_secret
   
   # 可选，QQ 机器人配置项
   QQ_BOTS='
   [
     {
       "id": "xxx",
       "token": "xxx",
       "secret": "xxx",
       "intent": {
         "at_messages": false,
         "guild_messages": true,
         "direct_message": true
       }
     }
   ]
   '
   
   # 必填，postgres 数据库配置项
   # 如果使用 docker compose / helm 部署则无需修改
   POSTGRES_USER=bot
   POSTGRES_PASSWORD=postgres_password
   POSTGRES_DB=bot
   
   # 必填，redis 数据库配置项
   # 如果使用 docker compose / helm 部署则无需修改
   REDIS_PASSWORD=redis_password
   
   # 可选，Sentry DSN 网址
   SENTRY_DSN=https://xxxxxxxx.sentry.io/123123
   
   # Github App 配置
   # 可选，图片主题，light/dark
   GITHUB_THEME=light
   # 必填，github app 配置
   # 可选，oauth app 配置，用于没有权限时的 fallback
   # private_key 是从 github app 配置中下载的私钥
   # 私钥开头结尾应与示例一致，注意每行需要引号与逗号，结尾不应有逗号
   # webhook_secret 与 github app 配置中的 webhook secret 保持一致，如果没有设置则删除
   GITHUB_APPS='
   [
     {
       "app_id": "",
       "private_key": [
         "-----BEGIN RSA PRIVATE KEY-----",
         "~~ YOUR PRIVATE KEY HERE ~~",
         "-----END RSA PRIVATE KEY-----"
       ],
       "client_id": "",
       "client_secret": "",
       "webhook_secret": ""
     },
     {
       "client_id": "",
       "client_secret": ""
     }
   ]
   '
   

   Copy

   docker-compose.yml 中的配置视情况修改，如无必要请勿修改！

5. 启动

   在目录下执行 docker compose up -d (旧版方式 docker-compose up -d) 即可。

⁠Kubernetes

待完善，可自行尝试使用 k8s/bot/ 目录下的 helm chart

下载或克隆 k8s/bot/ 目录，新建文件 values.yaml，参考目录下的 values.yaml 填写覆盖配置项，然后执行 helm install -n <botnamespace> --create-namespace -f values.yaml <botname> ./k8s/bot 即可。其中 <botnamespace> 为命名空间，<botname> 为部署应用名称，请自行修改。

⁠开发

使用 Codespaces (Dev Container) 一键配置开发环境 (Python、Redis、Postgres)：

修改 .env.dev 文件中的部分配置项，然后执行 python bot.py 即可。

如需连接到 Redis 或 Postgres 数据库调试，请确保 VSCode 已正确映射端口 (必要时可以重新映射 6379、5432 端口)，使用本地工具远程连接即可。