{"id":13432068,"url":"https://github.com/eric2788/vup_monitors","last_synced_at":"2025-05-03T23:30:43.896Z","repository":{"id":42035422,"uuid":"429285905","full_name":"eric2788/vup_monitors","owner":"eric2788","description":"高亮个别用户弹幕+捕捉进入直播间 QQ 机器人版","archived":false,"fork":false,"pushed_at":"2023-03-12T04:13:20.000Z","size":2139,"stargazers_count":66,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-07T23:04:55.783Z","etag":null,"topics":["bilibili","bilibili-live","dd","monitor","vtuber","vup"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eric2788.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-18T03:40:24.000Z","updated_at":"2025-03-24T14:34:38.000Z","dependencies_parsed_at":"2024-02-26T20:01:18.293Z","dependency_job_id":null,"html_url":"https://github.com/eric2788/vup_monitors","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eric2788%2Fvup_monitors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eric2788%2Fvup_monitors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eric2788%2Fvup_monitors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eric2788%2Fvup_monitors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eric2788","download_url":"https://codeload.github.com/eric2788/vup_monitors/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252269026,"owners_count":21721239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bilibili","bilibili-live","dd","monitor","vtuber","vup"],"created_at":"2024-07-31T02:01:08.324Z","updated_at":"2025-05-03T23:30:43.286Z","avatar_url":"https://github.com/eric2788.png","language":"JavaScript","funding_links":[],"categories":["监听与推送"],"sub_categories":["直播脚本"],"readme":"# Vup Monitors\n\n基于 go-cqhttp 和 nodejs 的 Vups 直播间监控机器人，支持多群使用和私人广播\n\n![showcase](/assets/dd_showcase.png)\n\n#### 目前支持监控的DD行为\n\n- 进入直播间\n- 发送SC\n- 发送弹幕\n- 开播通知(需要在设定中启用)\n- 上舰\n- 送礼\n\n## 前置\n\n- [go-cqhttp](https://github.com/Mrs4s/go-cqhttp/) (QQ机器人)\n- [biligo-live-ws](https://github.com/eric2788/biligo-live-ws) (B站直播间 WS 监控)(可选)\n\n## 启动\n\n### go-cqhttp\n\n- 在 https://github.com/Mrs4s/go-cqhttp/releases 下载对应平台的可执行文件\n\n- 运行 `go-cqhttp`, 根据提示填写 QQ 号和密码等信息, 参考文档 https://docs.go-cqhttp.org/guide/quick_start.html\n\n- 启用正向 Websocket (这点很重要，不然之后无法连接到 go-cqhttp)\n\n### biligo-live-ws\n\n#### 使用自架\n\n- 在 https://github.com/eric2788/biligo-live-ws/releases 下载对应平台的可执行文件\n\n- 运行程序\n\n#### 不使用自架\n\n- 到 https://github.com/eric2788/biligo-live-ws 查看公共API地址\n\n\n### 本项目 (Vup_monitors)\n\n- 到 `releases` 下载对应平台的可执行文件\n\n- 运行程序后关闭\n\n- 到 `data/settings.json` 填入设定，包括\n    - 设定数据源 `source` 为 `websocket`\n    - websocket 中 填入你自架的 biligo-live-ws 或使用 公共API地址 (如果使用公共API，则需要 `use-tls: true`)\n    - 在管理员 `owners` 的设定中添加你的 QQ 号\n    - 填入你在 go-cqhttp 中启用正向 Websocket 的端口 (如非6700)\n\n- 再运行程序\n\n- 开始通过指令设定监控和高亮\n\n\n#### 除了 biligo-live-ws 以外的运行方式\n\n- [blive-redis-server](https://github.com/eric2788/blive-redis-server) + [redis](https://www.redis.com.cn/redis-installation.html) 服务器 (比较麻烦)\n\n    运行 blive-redis-server 和 redis，然后在 `data/settings.json` 设定数据源为 `redis` 即可 \n\n## 指令\n\n`\u003c\u003e` 为必填参数， `[]` 为选填参数\n\n**真正填入参数时不需要加引号**\n\n\n### v0.1.13 追加频道广播\n\n指令输入与先前相同，但将会检测群id格式:\n(有-则为频道，无-则为群聊)\n\n频道号格式如下\n``频道号-子频道号``\n\n注意： 你无法在频道使用指令，请在私聊连带群id(根据频道号格式)输入指令\n\n### !B站直播\n\nB站直播WS讯息监控指令\n\n- `!B站直播 监控 \u003c房间号\u003e` - 监听房间\n- `!B站直播 中止 \u003c房间号\u003e` - 中止监听房间\n- `!B站直播 监听中` - 获取正在监听中的房间号列表\n\n### !高亮名单\n\n控制高亮名单用户，以进行广播\n\n```log\n- 如果在群使用指令，则会添加/删除到该群所属的高亮用户名单\n- 如果在私聊使用且附上`[群id]`，则会添加/删除该群id所属的高亮用户名单\n- 如果在私聊使用而不附上`[群id]`，则会添加/删除属于你自己的高亮用户名单\n```\n\n- `!高亮 新增 \u003c用户id\u003e [群id]` - 新增用户到高亮名单\n- `!高亮 移除 \u003c用户id\u003e [群id]` - 删除用户到高亮名单\n- `!高亮 列表 [群id]` - 显示高亮用户名单列表\n\n**高亮名单会分开群/频道号和QQ号，只有在私聊才会接受 `[群id]` 作为参数以私下设置群高亮名单，如不填则为属于该QQ号的高亮名单**\n\n### !注视名单\n\n通过设置群注视名单，可以在广播时限制仅限在注视用户的直播间内/注视用户本人的所有DD行为。\n\n```log\n- 由于注视用户不支持私聊，因此在私聊使用此指令时必须添加群id\n- 如果在群添加注视用户，则无需填入群id，并以该群作为添加/删除对象\n```\n\n- `!注视 新增 \u003c用户id\u003e \u003c群id(如私聊)\u003e` - 新增该群注视用户\n- `!注视 移除 \u003c用户id\u003e \u003c群id(如私聊)\u003e` - 移除该群注视用户\n- `!注视 列表 \u003c用户id\u003e \u003c群id(如私聊)\u003e` - 查看该群所属注视用户名单\n\n添加注视用户后，广播规则将如下\n\n| 高亮用户 | 直播间 | 广播 |\n| ------- | ----- | ----- |\n| 在注视名单内 | 不在注视名单内 | ✔ |\n| 不在注视名单内 | 不在注视名单内 | ✖ |\n| 不在注视名单内 | 在注视名单内 | ✔ |\n| 在注视名单内 | 在注视名单内 | ✔ |\n\n如果没有注视用户，则默认广播所有高亮用户在监控中的直播间的DD行为。\n\n### !检查更新\n\n检查是否有新版本 (每次启动也会检查一次)\n\n## 设定\n\n设定可到 `data/settings.json` 中查看，参考如下:\n\n```json\n{\n    // go-cqhttp 相关\n    \"bot\": {\n        \"http\": \"http://127.0.0.1:5700\",\n        \"ws\": \"ws://127.0.0.1:6700\"\n    },\n    // redis 作为数据源，如果你是用 websocket, 可无视\n    \"redis\": {\n        \"host\": \"127.0.0.1\",\n        \"port\": 6379,\n        \"database\": 0\n    },\n    // websocket 数据源\n    // 使用 blive.ericlamm.xyz 可贡献统计数据\n    \"websocket\": {\n        \"id\": \"vup_monitors\", // 辨识ID，详见下面“多实例使用”部分\n        \"host\": \"blive.ericlamm.xyz\",\n        \"use-tls\": true\n    },\n    \"source\": \"websocket\", // 数据源选择 websocket, redis\n    \"owners\": [], // 管理员QQ号，列表内的QQ号可绕过房管限制\n    \"identifier\": \"\", // 多实例识别符，详见下面“多实例使用”部分\n    \"accept_gadmin_command\": true, // 是否接受群管使用指令\n    \"enable_live_broadcast\": false, // 启用开播通知\n    \"show_cover\": true, // 开播通知时是否显示封面\n    \"show_gift_danmu\": false, // 是否显示礼物弹幕\n    \"show_image_danmu\": true, // 是否显示表情包弹幕\n    \"auto_check_update\": true, // 是否自动每天检查更新\n    \"show_detail_list\": true, // 显示高亮/直播/注视列表时是否顺带显示用户名称(需要更多时间刷取)\n    \"debug_mode\": false, // 是否启用 debug 模式\n    \"disabled_commands\": [ // 禁用的广播\n        // \"DANMU_MSG\", // 弹幕消息\n        // \"SEND_GIFT\", // 赠送礼物\n        // \"USER_TOAST_MSG\", // 上舰\n        // \"SUPER_CHAT_MESSAGE\", // 发送SC\n        // \"ENTRY_EFFECT\", // 大航海用户进入直播间\n        // \"INTERACT_WORD\", // 进入直播间\n        // \"LIVE\", // 开播\n    ], \n}\n```\n\n### 多实例使用\n\n分为两种场景：多实例共用同一个biligo-live-ws实例，以及多实例共用同一个go-cqhttp\n\n#### 共用同一个biligo-live-ws\n根据 [biligo-live-ws的说明](https://github.com/eric2788/biligo-live-ws#使用方式) ，同一IP下的实例需要配置不同的辨识ID以避免混淆\n\n因此如果要在同一IP下部署多个实例同时使用同一个biligo-live-ws作为数据源，则应在设置中为每个实例指定不同的辨识ID（不指定时默认为vup_monitors）\n\n#### 共用同一个go-cqhttp\n多个实例共用同一个go-cqhttp时，因为前端的QQ号码是同一个，因此会同时响应命令，造成使用上的困难\n\n此时应在设置中为每个实例指定不同的多实例识别符，配置后bot将只响应以``#[多实例识别符]``结尾的命令，以此达到准确控制特定实例的效果\n\n此时命令形式将变为形如`!B站直播 监听中 #abc`的格式，具体逻辑如下\n\n| 多实例识别符 | 命令 | 响应 |\n| ------- | ----- | ----- |\n| 未配置 | 不带# | ✔ |\n| 未配置 | 带有# | ✖ |\n| 配置为abc | 不带# | ✖ |\n| 配置为abc | 以#abc结束 | ✔ |\n| 配置为abc | 以#xyz结束 | ✖ |\n\n\n## 统计数据\n\n使用了 ``https://blive.ericlamm.xyz`` 作为 公共API地址 的机器人都可以贡献统计数据。\n\n统计数据网站: [ddstats.ericlamm.xyz](https://ddstats.ericlamm.xyz)\n\n## 其他部署方式\n\n### Docker\n\n详见 Dockerfile 或 查看 [`docker.io/eric1008818/vup_monitors`](https://hub.docker.com/r/eric1008818/vup-monitors)\n\n## 鸣谢\n\n[go-cqhttp/node](https://github.com/go-cqhttp/node)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feric2788%2Fvup_monitors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feric2788%2Fvup_monitors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feric2788%2Fvup_monitors/lists"}