dsh-qqbot-guard
在终端中运行以下命令:
dsh plugin install 13377184330/dsh-qqbot-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install 13377184330/dsh-qqbot-guard,或按 README 从 https://github.com/13377184330/dsh-qqbot-guard 安装并配置 profile 中的 cordis.patch.yml。
插件介绍
NapCat、LLOneBot 等 OneBot v11 网关里有一种很烦人的「假死」:QQ 进程还在、WebUI 端口也在听,机器人却一条消息都不回。常见根因是 QQ 会不定期重开承载机器人的 utility 子进程,而反向 WebSocket 往往不会自行重连,于是出现「端口活、连接死」——用 netstat 或端口探测根本看不出来,只能人肉重启。
dsh-qqbot-guard 把这件事做成 DSH 里的常驻守卫:按间隔请求你配置的网关状态 HTTP 接口,解析 connected、gateway.connected 等字段做深度健康判断;连续多次失败才触发救援,避免服务刚起来还没连上就被误杀。触发后会按配置清理残留进程并执行重启命令,并在一次救援后进入冷却期(默认 15 分钟),给扫码登录留窗口,失败计数与上次救援时间会落盘,DSH 重启也不丢。
适合自建 NapCat / LLOneBot / Go-cqhttp 等网关、又不想再为偶发断连半夜爬起来重启 QQ 的用户。需要人工扫码登录时建议保留足够冷却;若你已是快速登录且启动很快,可在 profile 里按需调小间隔与冷却。
使用场景
- 网关端口正常但反向 WebSocket 断连、消息不回
- 需要定期探测网关状态并自动重启 QQ/网关
- 希望断连后自动救援,又避免扫码窗口被反复杀掉
适合人员
- 自建 NapCat / LLOneBot / Go-cqhttp 的 OneBot 用户
- 偶发假死、不想再手动重启 QQ 的自托管者
- 在 DSH 工作流里做机器人运维自动化的开发者