dsh-chain-check
在终端中运行以下命令:
dsh plugin install wuying1630/dsh-chain-check
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install wuying1630/dsh-chain-check,即可从 https://github.com/wuying1630/dsh-chain-check 安装 dsh-chain-check 插件。
插件介绍
消息链路一断,表面现象往往一样:它不回话。桥接进程没了、DSH 重启后 preset 没注册、DSH 换了端口而 surfcore 还指着旧地址、机器上两份 OneBot 令牌读错了——修法完全不同,人却只能猜。这个工具把「猜」换成「看」:一次跑完六项检查,分别看 DSH 进程与端口、桥接是否通、QQ 是否在线、preset 是否注册、最近有没有唤醒硬故障、最后一条消息何时出现;每项给出通不通、一句人话说明和怎么修。
你可以把它装成 DSH 插件,会话里多一个只读的 chain_check 工具;也可以在链路已经可疑时直接 node 跑同一套脚本——两条路是同一个实现,不会出现两套说法。它 deliberately 不是监控:跑一次看一次快照,不常驻、不写守护进程。默认只读日志、配置和端口,不启停进程、不改配置;只有 CLI 的 --fix 会在机器能自证安全的两件事上动手——把 surfcore 里 dsh.baseUrl 对齐到当前探到的端口、把没在跑的桥接拉起来。preset 和坏语法配置它不会替你改,避免把 DSH 搞起不来。
它假定的是 DSH 加 surfcore 桥接加 OneBot 实现这一套栈;SnowLuma 是 README 里写明的典型组合,NapCat、AstrBot 也可通过 chain.config.json 指向 HTTP OneBot 并跳过没有的部分,工具会标明「已按配置跳过」而不是假绿。没有 DSH 就不适合用它——第一项查的就是 DSH。适合在「明明收到消息却像没看见」、改完配置或重启后突然哑巴、想确认断在链的哪一段时用;模型答非所问、群禁言、网络抖动它判不了,那是内容或平台侧的事。
作者在 Windows 上实测为主,Linux/macOS 分支写了但未验证;端口探测在沙箱里可能「看不见」监听口,脚本会按设计说明而不误报成链路失败。它是出问题时用的扳手,不是每半小时跑一次的监护仪。
使用场景
- 收到消息但机器人像没看见,需要确认断在 DSH、桥接还是 QQ 侧
- 电脑或 DSH 重启后突然不回话,想快速区分桥接未起或端口未对齐
- 改完 profile、preset 或 surfcore 配置后链路异常,需要六项检查定位原因
适合人员
- 使用 DSH + surfcore 桥接 + SnowLuma(或同类 OneBot)跑 QQ 机器人的维护者
- 在 NapCat、AstrBot 等栈上仍依赖 DSH 做 AI 侧、需要可配置跳过项的用户
- 愿意用 CLI 或插件工具做一次性只读诊断、而非长期监控的 Windows 主环境用户