前言¶
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
