dsh-napcat-keeper
在终端中运行以下命令:
dsh plugin install waning-sun/dsh-napcat-keeper
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中可通过插件市场添加,或在终端执行 dsh plugin install waning-sun/dsh-napcat-keeper;也可使用仓库地址 https://github.com/waning-sun/dsh-napcat-keeper 安装。
插件介绍
在 DSH 里用 NapCat 当 QQ 协议端时,常见痛点是:DSH 已开但 NapCat 没跟上、OneBot 端口突然不通、两条 QQ 进程链互踢、或卡在扫码与快登失效后的无声掉线。手工翻二维码目录、反复杀进程,很难长期扛住。
dsh-napcat-keeper 为 NapCat 提供看门狗,目标是「DSH 在,QQ 就在」。它会周期性探测端口与进程:端口不通且无进程则拉起;刚拉起给宽限期避免重复拉;扫码超时按配置重试;发现重复链则保留最早、杀掉晚出现的;判卡死则干净重启。需要扫码时可在本机打开自动刷新的扫码页,不必再去 NapCat 的 cache 里找图。
配置集中在 DSH → 设置 → napcat桥,保存即生效。可与 dsh-qq-link 搭配——桥接负责「说话」,本插件负责「别掉线」;也可单独使用。与 dsh-onebot-qq 反向 WebSocket 共存时,能区分 HTTP 与反向 WS 探测,并可提示 dsh-qq-link 端口是否配错。Agent 侧提供状态查询、重启与去重三类工具。
适合已在 Windows 安装 NapCat.Shell、希望 DSH 启动后自动维持 QQ 在线、并愿意在设置页完成路径与端口配置的用户。若开启「记住密码」以应对令牌失效,请先理解明文落盘的风险说明。
使用场景
- 希望 DSH 打开后 NapCat 自动跟上,不必每次手动启动 QQ 协议端
- 搭配 dsh-qq-link 长期跑会话,需要有人盯着端口、去重和掉线恢复
- NapCat 卡在扫码或快登令牌失效后离线,想自动重试并在本机打开刷新二维码
适合人员
- 在 Windows 上已安装 NapCat.Shell 的 DSH 用户
- 使用或计划使用 dsh-qq-link 把 QQ 接到 DSH 的开发者
- 需要稳定 OneBot 连接、减少手工运维的 agent 工作流用户