前言¶
DSH 插件用于扩展当前环境能力。在 DSH 场景中，会话可能同时存在多个；当某个会话停在 running 状态，或需要查看另一个会话的记录并继续发消息时，就需要一组围绕会话的诊断与操作工具。
下面介绍 dsh-session-doctor，它用于诊断、解卡、读取 DeepSeek Harness 会话。
这是什么¶
dsh-session-doctor 是维护者 mayf3 发布的 DSH 插件，定位为“会话医生”。
它把五个能力收在同一组工具里：列出会话、读取会话记录、诊断会话状态、恢复卡住的会话、向目标会话发送消息。
当前版本为 1.0.0，许可证为 MIT。
核心功能¶
下面是插件提供的五个工具：
list_sessions
列出所有会话，包含 id、标题、工作目录、持久化状态、agent 运行状态、排队消息数。
read_session
读取指定会话的用户/助手文本消息，按顺序返回，支持 limit。
session_status
诊断目标会话是否在线、running/idle、inbox 排队数、最后事件。
session_recover
对卡死的 running agent 发送取消信号（keepInbox: true），中止卡住活动并保留排队消息。
send_session_message
向目标会话发送消息，在线直接投递，离线自动恢复后投递。
安装与启用¶
下面命令用于添加 dsh-session-doctor：
dsh plugin --profile web add dsh-session-doctor
安装后，可按工具名调用上述功能。
典型用法¶
以下示例按插件说明列出：
1、列出所有会话。对应 list_sessions，返回每个会话的 id、标题、工作目录、持久化状态、agent 运行状态和排队消息数。
2、检查会话 <id> 的状态。对应 session_status，查看是否在线、running/idle、inbox 排队数和最后事件。
3、解卡会话 <id>。对应 session_recover，对处于 running 的 live agent 发送取消信号，保留排队消息。
4、看看会话 <id> 最近在做什么。对应 read_session，按顺序读取用户/助手文本消息。
5、给会话 <id> 发消息：……。对应 send_session_message，在线直接投递，离线自动恢复后投递。
适用场景与注意¶
适合需要查看 DSH 会话记录、诊断卡住的 running 会话，并向目标会话继续发消息的使用者。
使用前注意：
- 插件会运行在 DSH 插件环境中，按当前 dsh 进程权限调用当前 dsh 进程可见的会话能力；安装前应检查源码、许可证和依赖版本。
session_recover只作用于 live agent（running状态）。send_session_message的离线恢复以默认模型启动目标会话。- 跨进程/跨机器通信不在本插件范围内。
版本与依赖信息：
version: 1.0.0
license: MIT
peerDependencies: @deepseek-ai/cordis ^4.0.1; @deepseek-ai/dsh-tools >=0.1.0-rc.5 <0.2.0
engines: node >=22.19; dsh >=0.1.0-rc.5 <0.2.0
相关链接¶
dsh-session-doctor 的价值在于把会话诊断、恢复和消息投递放在同一组工具里。
目录页（来自插件线索，不代表官方应用商店）：https://www.skillhub.cn/plugins/mayf3/dsh-session-doctor
