DSH Plugins
返回列表
⚙️

dsh-napcat-keeper

工作流 更新于 2026.11.04

在终端中运行以下命令:

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 工作流用户