Development & Runtime

dsh-turn-watchdog

equinox7379/dsh-turn-watchdog · ★ 0

equinox7379

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

README body is shown in Chinese.

License
MIT
Added
2026-08-23
Maintenance
active
Install kind
github

No manifest check is available; listing does not imply compatibility or security review.

安装

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

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

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents
  1. 用途
  2. 用法
  3. 可靠性
  4. 安装
  5. License

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