通知推送拆成两个渠道:QQ 机器人和 MeoW,各自带开关和测试连通

用户要求两件事:① QQ bot 推送要能测连通、并加一个开关;② 照 MeoW 的接口
文档(https://www.chuckfang.com/MeoW/api_doc.html)加一个推送渠道,同样要有
测试和开关。确认过的三个决定:QQ bot 就是现有 webhook;事件勾选两个渠道
共用、开关按渠道分开;MeoW 只填一个昵称。

1) 通知推送改成「共享事件勾选 + 每渠道一个开关」
   - notify.go: notifySetting 扩成两个渠道,新增 qqReady()/meowReady();
     sendNotify 按渠道各自起后台 goroutine 分发,事件没勾选、或两个渠道都
     没启用时什么都不做
   - config.go: 新增 notifyEnabled(QQ 机器人渠道开关)、meowEnabled、
     meowNickname、meowMsgType、meowHtmlHeight、meowImgUrl
   - 关掉开关只是暂停推送,地址、昵称这些配置都留着,随时能再打开

2) 老配置的兼容(重要)
   - notifyEnabled 是普通 bool,老 config.json 里没有这个字段会解成 false,
     升级后会把已经配好的推送静默关掉
   - 解法:loadConfig() 里先置 true 再 json.Unmarshal(Unmarshal 只覆盖文件里
     出现的字段),默认值里也写 true;文件里显式写 false 的仍然会关掉
   - 已加回归测试 TestNotifyEnabledBackwardCompat 覆盖三种写法

3) MeoW 渠道(新增 meow.go)
   - 按文档走 POST {昵称},title/msg/url/imgUrl 放 json body,
     msgType/htmlHeight 是 query 参数(文档明确说这两个不属于 JSON 参数)
   - 文档自己前后矛盾:响应格式那节写 msg,示例写 message,两个字段都解析
   - 空字段一律不放进 body:body 里的 title 优先级高于路径参数,
     传空串会把 MeoW 的默认标题顶掉
   - 业务状态码翻成中文(400 参数错、403 内容被拦、404 昵称未注册、
     429 频控、500 服务器错误),失败信息直接显示在页面上
   - msgType 为 html 时渲染成 HTML(首行加粗、链接可点、内容转义),
     高度默认 200、范围 40-2000;事件正文复用 webhook 的那份 text

4) MeoW 的错误昵称会封 IP,所以加了保护(踩出来的)
   - 实测用不存在的昵称打真实接口,返回的提示是「一天之内累计3次输错对方
     昵称您的IP将被封禁」。而开播+开始录制+下播+合并完成一天轻松触发 4 次,
     昵称配错就会把用户 IP 封了
   - meow.go: 新增 meowBadNick 记录,pushMeow 收到 404 就记下这个昵称;
     sendNotify 和测试接口命中记录时直接跳过/拒绝并说明原因,
     改掉昵称或重启程序即恢复
   - 只有 404 触发拦截:429 是频控、400 是参数问题,都应该继续尝试
   - 已加测试 TestMeowBadNickGuard(404 要拦、429/400 不能拦、不影响别的昵称)

5) 测试连通
   - /api/notify/test 合并成一个接口,用 channel 区分 qq / meow,
     每个渠道的配置下面各有一个「测试连通」按钮
   - 用页面上当前填的值直接测、不用先保存,留空的项自动用已保存的值补齐;
     测试不受渠道开关和事件勾选影响(本来就是为了打开之前先确认配置)
   - 成功返回 {ok, detail},detail 就是页面上的结论:QQ 渠道显示 webhook 的
     HTTP 状态码和耗时,MeoW 渠道显示它返回的 status 和耗时;
     webhook 返回 200 只代表地址口令没问题,能不能收到要看机器人那边,
     这点也写在结果里
   - /api/status 新增 meowBlocked,页面上红字显示「当前推不出去:…」
     (昵称没填、格式不对、或已被判过未注册)

6) 页面
   - 通知区分成「事件勾选 / 渠道一 QQ 机器人 / 渠道二 MeoW」三块,
     每块用一条带标题的细线隔开,两个渠道各带开关和测试按钮
   - 消息类型选 text 时自动收起 HTML 高度那一行

另外:README 的通知推送一节重写(两个渠道的对比表、MeoW 的频控与封禁提醒、
测试连通的说明),配置文件详解补上新字段;doc/webapi.md 补 /api/notify/test
和 meowBlocked。doc/momoko-acfunlive-notify.py 本来就处理 event="test",不用改。

已验证:新增 notify_test.go,15 个用例全部通过(URL 拼接与转义、昵称校验、
消息类型与高度归一、HTML 渲染与转义、接口成功/失败/空字段处理、6 种业务状态码
的文案、404 拦截保护、老配置兼容、测试接口各分支),其中 TestSendNotifyFanOut
是端到端分发测试:两个渠道都开→各收到 1 条、关掉任一个→只剩另一个、
两个都关→0 条、事件没勾→0 条。真机冒烟两轮:页面控件齐全、老配置默认开启、
QQ 渠道实测本地 webhook 收到完整推送(含 Authorization 和 X-Auth-Token 头与群号)、
空值回退到已保存配置、6 种非法输入全 400、开关能落盘且关开关不清地址、
MeoW 真实接口返回的 404 被正确翻成中文。全量 34 个测试通过,
Windows/Linux 双平台构建、go vet、gofmt 全干净。
This commit is contained in:
tamakyi
2026-09-25 13:42:49 +08:00
parent 36fe7a978c
commit 8528499a69
7 changed files with 1279 additions and 61 deletions
+41 -2
View File
@@ -86,6 +86,7 @@ GOOS=windows GOARCH=amd64 go build -o acfunlive.exe
"webExternal": false, // 是否允许外网访问 web UI,false 时只监听本机 127.0.0.1
"authToken": "…", // web UI 管理接口的访问口令,首次启动自动生成
"notifyEnabled": true, // QQ 机器人(webhook)推送的渠道开关,关掉后即使填了地址也不推送
"notifyUrl": "", // 开播/下播等事件推送到该地址(HTTP POST JSON),留空不推送
"notifyToken": "", // 推送时附带的 Bearer 口令,留空不带
"notifyGroup": "", // 推送时带上的群号,机器人可以直接用它决定发到哪个群
@@ -94,6 +95,12 @@ GOOS=windows GOARCH=amd64 go build -o acfunlive.exe
"notifyRecordStart": false, // 开始录制直播视频时推送
"notifyMergeDone": false, // 自动合并完成时推送
"meowEnabled": false, // MeoW 推送的渠道开关
"meowNickname": "", // MeoW 昵称,推送地址里的路径参数
"meowMsgType": "text", // MeoW 消息类型:text(纯文本)或 html
"meowHtmlHeight": 200, // MeoW 在 msgType 为 html 时的显示高度(像素)
"meowImgUrl": "", // MeoW 通知图标 URL,建议 216×216 的 PNG,留空用默认图标
"ffmpegPath": "", // ffmpeg 可执行文件(或它所在文件夹)的路径,留空则自动查找
"recordFormat": "mp4", // 录播文件的封装格式:mp4、flv、ts、mkv
"recordSubdir": "record", // 录播原片和弹幕文件存放在保存目录下的子文件夹名
@@ -201,7 +208,18 @@ web UI 的`手动合并`区用来自己挑视频和弹幕出片,适合手动
### 通知推送
填好`notifyUrl`并勾选需要的事件后,程序会把事件以 JSON POST 到该地址,可以用来接自己的机器人(NoneBot、Koishi 等)或任何 HTTP 服务。
开播、下播、开始录制、合并完成这四个事件可以推到两个渠道,两个渠道各推各的、互不影响:
| 渠道 | 接收方 | 需要的配置 |
| --- | --- | --- |
| QQ 机器人 | 自己的机器人(NoneBot、Koishi 等)或任何 HTTP 服务 | `notifyUrl`(+ 可选的`notifyToken`、`notifyGroup`) |
| MeoW | 手机上 MeoW App 的通知 | `meowNickname` |
「推哪些事件」只有一套勾选(`notifyLiveOn`等四个),两个渠道共用;每个渠道另有自己的开关(`notifyEnabled`、`meowEnabled`)。关掉开关只是暂停推送,地址、昵称这些配置都会留着,随时可以再打开。**没勾选的事件、或两个渠道都没启用时,程序什么都不做。**
#### 渠道一:QQ 机器人
填好`notifyUrl`并勾选需要的事件后,程序会把事件以 JSON POST 到该地址。
推送的请求体:
@@ -219,12 +237,33 @@ web UI 的`手动合并`区用来自己挑视频和弹幕出片,适合手动
}
```
`notifyToken`非空时会以`Authorization: Bearer <口令>`和`X-Auth-Token`两个头一起发出去。推送在后台进行且有 10 秒超时,失败只在日志里记警告,不会影响录制。同一场直播的开播通知只会推送一次。web UI 设置区的`发送测试通知`按钮可以用当前填写的地址直接测试(不需要先保存)。
`notifyToken`非空时会以`Authorization: Bearer <口令>`和`X-Auth-Token`两个头一起发出去。推送在后台进行且有 10 秒超时,失败只在日志里记警告,不会影响录制。同一场直播的开播通知只会推送一次。
`notifyGroup`是随推送下发的群号,留空则不带这个字段。它只是原样透传给机器人,程序自己不做任何判断——好处是群号、口令这些都能在 web UI 里改,不用去动机器人那边的配置。
接 NoneBot 的例子见`doc/momoko-acfunlive-notify.py`:把这个文件复制到 NoneBot 项目的插件目录即可,收到后直接把`text`发到群里。插件会优先使用推送里的`group`,只有推送没带时才回退到环境变量`ACFUNLIVE_NOTIFY_GROUP`,所以群号在 acfunlive 页面上改完立即生效,不用重启机器人。
#### 渠道二:MeoW
[MeoW](https://www.chuckfang.com/MeoW/api_doc.html) 是个消息推送 App,手机上装好、注册自己的昵称后,把昵称填进`meowNickname`打开开关,就能直接收到通知,不用自己架机器人。
- 消息内容用事件正文(就是上面 webhook 里的`text`),标题按事件取「开播提醒 / 下播提醒 / 开始录制 / 合并完成」
- 开播、开始录制这类事件会带上直播间地址,MeoW 里点通知就能跳回直播间;合并完成带的是本地成片路径,手机上打不开,所以不带跳转链接
- `meowMsgType`为`html`时会渲染成 HTML(第一行加粗、链接可点),`meowHtmlHeight`控制显示高度(默认 200,范围 40–2000);为`text`时就是纯文本,也是默认值
- `meowImgUrl`可以换掉通知图标,官方建议用 216×216 的 PNG
**注意 MeoW 的频控和封禁规则**:非会员是 3 秒 1 条、每分钟 15 条、每小时 60 条,超了返回 429;更麻烦的是**一天内累计 3 次推给不存在的昵称,它会把你的 IP 封掉**。所以程序做了保护:一旦某个昵称被 MeoW 判定为「昵称未注册」,就不再向它推送,页面上会红字提示原因,改掉昵称(或重启程序)才恢复。请先把昵称填对再打开开关。
#### 测试连通
两个渠道各有一个`测试连通`按钮,就在各自的配置下面:
- 用**页面上当前填的值**直接测,不用先保存;留空的项自动用已保存的值补齐
- 测试不受渠道开关和事件勾选影响,关着开关也能测(本来就是为了在打开之前先确认配置对不对)
- 成功后会显示实际结果:QQ 渠道显示 webhook 返回的 HTTP 状态码和耗时,MeoW 渠道显示它返回的`status`和耗时;失败则显示具体原因,比如`MeoW 返回 status 404(昵称未注册)`
webhook 返回 200 只代表**地址和口令没问题**,能不能真的收到还要看机器人那边有没有正常处理——这一点测试结果里也会写明。
### 文件管理
web UI 的`文件管理`区可以列出录播文件夹和成片文件夹里的文件(名称、大小、修改时间),并显示保存目录所在磁盘的剩余和总容量。