dsh-session-doctor
会话医生:诊断、解卡、读取 DeepSeek Harness 会话。诊断卡死的 agent、中止卡住的活动、保留排队消息并恢复处理。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:mayf3/dsh-session-doctor说明文档
阅读完整 README ↗dsh-session-doctor · 会话医生
English | 中文
诊断、解卡、读取 DeepSeek Harness 会话的插件。给每个会话装上五个工具,让你能查看、诊断、恢复、指挥其他 Agent 会话。
这是什么
在 DeepSeek Harness 里,一个进程会同时挂着多个 Agent 会话。一个会话可能卡死——比如 cordis_inspect_query 之类的 Client 平台查询永远等不到页面响应,agent 停在 running 状态,后续消息全部积压在 inbox 不被处理。本插件提供:
- 列出所有会话:标题、id、在线状态、agent 运行状态(
running/idle)、排队消息数、工作目录; - 读取任意会话的对话记录:用户与助手消息按时间顺序返回,附带标题与 live 状态;
- 诊断会话是否卡死:查看 agent 是否在线、
running/idle、inbox 排队数、最后事件; - 解卡卡死的会话:对
running的 agent 发送取消信号(keepInbox: true),中止卡住的活动但保留 inbox 排队消息,agent 回到 idle 后自动处理排队消息; - 向其他会话发送消息:目标在线直接投递;仅持久化时自动恢复后投递。
典型场景:发现另一个会话卡住不动 → 诊断确认 → 解卡恢复 → 查看它后续的进展 → 必要时发消息指挥它继续。
功能
| 能力 | 说明 |
|---|---|
list_sessions | 列出所有会话:id、标题、工作目录、持久化状态、agent 运行状态、排队消息数 |
read_session | 读取指定会话的对话记录(用户/助手文本消息),按序返回,支持 limit |
session_status | 诊断目标会话:是否在线、running/idle、inbox 排队数、最后事件 |
session_recover | 解卡:对卡死的 running agent 发取消信号(keepInbox: true),中止卡住的活动、保留排队消息 |
send_session_message | 向目标会话发消息:在线直接投递;仅持久化自动恢复后投递 |
安装
方式一:一行命令
dsh plugin --profile web add dsh-session-doctor
方式二:从 GitHub 安装
dsh plugin --profile web add github:mayf3/dsh-session-doctor
方式三:直接发给你的 Agent
打开任意一个 DSH 会话,把下面这句话发给它:
帮我安装会话医生插件,执行:
dsh plugin --profile web add dsh-session-doctor
装完自动挂载,所有会话立即获得上述五个工具。
使用
- 对会话 A 说「列出所有会话」——它调
list_sessions,你可以看到每个会话的标题和运行状态; - 怀疑某个会话卡住 → 说「检查会话 `` 的状态」——它调 ,返回 且长时间无进展即确认卡死;