dsh-turn-watchdog

by equinox7379

开发与运行时github收录于 08-23

DeepSeek Harness 插件:定期扫描 live 会话,报告长时间未产生 turn/end 的疑似卡住会话。

DeepSeek Harness plugin that periodically scans live sessions and reports turns stuck without a turn/end.

安装

dsh plugin --profile web add github:equinox7379/dsh-turn-watchdog

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

README

目录

DeepSeek Harness 插件:定期扫描 live 会话,报告长时间未产生 turn/end 的疑似卡住会话。

用途

回合生成中途挂起(模型卡住、外部调用超时等)时,用户常处于空等状态。本插件每 60 秒扫描一次,将疑似卡住的会话注入提示词警示(供 AI 与用户参考),并提供查询工具。

用法

  • 工具:turn_watchdog_status(参数 refresh 默认 true,立即重扫)
  • 判定规则:最后事件不是 turn/end / session/end-seed,且空闲超过 thresholdMinutes(默认 10,可在 profile patch 的 config 里配置)
  • 排除 subagent 会话

示例(问「哪些会话卡住了」):

{ "thresholdMinutes": 10,
  "stuck": [ { "sessionId": "…", "cwd": "E:\\surdet", "lastEventType": "step/start", "idleMinutes": 12 } ] }

可靠性

  • 只读:不改写会话事件、不打断回合、不重启服务;
  • 警示文本为同步纯文本拼接(不含模板变量),空结果时不注入;
  • 已知边界:合法长回合可能被列入,需结合 lastEventType 判断;
  • 零依赖、无自定义会话事件、无 HTTP 路由。

安装

dsh plugin --profile web add link:/path/to/dsh-turn-watchdog
# 重启 dsh web

License

MIT

原始 README: https://github.com/Equinox7379/dsh-turn-watchdog/blob/master/README.md ↗