前言¶
DeepSeek Harness（DSH）的智能體開發中，會話管理容易變得零散：每個會話各自有信箱、需要區分活會話與歸檔、會話刪除缺少統一入口。dsh-session-suite 把這些能力打包成一個插件，提供一個總信箱、一個心跳、一個會話中樞面板，以及按名投遞、免辨活踢醒、會話導出導入等能力。
這是一個什麼樣的插件¶
dsh-session-suite 是一個爲 DeepSeek Harness（DSH）設計的 Cordis 插件，由維護者 chc-1986 提供。它提供跨會話對話、目錄即隊列的信箱、會話工作區登記、會話中樞面板、會話導出/導入和信箱守衛（gatekeeper）等能力。當前狀態爲 beta（0.2.x），目標 DSH 版本爲 >=0.2.1-0 <0.3.0。
核心功能¶
- 統一信箱 + 心跳：所有來信投到同一個目錄；信箱守衛攔截垃圾、按名字分派；插件用 500 ms 輪詢（心跳）把信送到目標會話，再把回執寫回 outbox/；不需要爲每個會話單設信箱，也不需要常駐服務或端口。
- 按名投遞：talk_to_session 直接寫會話名字（targetName）就能投；會話 ID 對用戶隱藏，只有重名時才追問編號，且 30 分鐘內記住選擇。
- 免辨活踢醒：wakeable = 記錄存在 && 未歸檔；未歸檔的會話可以直接喚醒派活，只有歸檔過的才踢不醒。
- 會話盤點與刪除：session_probe 做全量盤點（含誤建、被隱藏的會話）；配合會話中樞面板的歸檔/軟刪除/回收站清空與宿主側真刪除，補上 DSH 官方“會話刪不掉”的缺口。
- 會話導出/導入：將整個會話打包成 .zip（歸檔與回收站裏的會話也能導出），導入時校驗 manifest、日誌完整性和 sessionId 格式，ID 衝突一律拒絕，不覆蓋、不合並。
- 會話中樞面板：側邊欄入口 + 分組會話清單（重命名/歸檔/軟刪除），信箱守衛標籤頁（白名單、密碼、守衛模型），信件標籤頁（回執、重發、統計）。
- 工作區註冊：通過插件創建或後續附加的會話，根據 cwd 註冊到對應 Workspace，在側邊欄正確分組。
- 工具函數：session_contacts、talk_to_session、steer_session、stop_session、session_handover、create_session、update_session、session_probe、session_host_probe、workspace_lookup、read_session_log 等。
安裝與啓用¶
使用官方安裝命令即可完成安裝：
dsh plugin add dsh-session-suite
插件聲明瞭自己的 cordis.patch.yml 和瀏覽器端（./client），普通 dsh plugin add 即可，無需手動 wiring。
可選配置（寫在 cordis.patch.yml 中）：
- id: dsh-session-suite
name: "dsh-session-suite"
config:
writeEnabled: true # 跨會話寫路徑（默認 false）
dir: "" # 信箱根目錄；空 = <DSH_HOME 或 ~/.dsh>/mailbox
pollMs: 500 # 心跳：掃描 inbox 的間隔
heartbeatMs: 1000 # 心跳：狀態刷新間隔
allowTargets: [] # 建議顯式填白名單（或使用 <dir>/allow.json）
secret: "" # 共享目錄建議設置一個投遞密鑰
典型用法¶
-
發送消息到另一個會話：在控制台或腳本中使用 talk_to_session，指定會話名字。
-
會話導出：在會話中樞面板中選中會話，點擊“導出”，會話目錄被打包爲 .zip，默認落在 ~/.dsh/exports/。
-
會話導入：在會話中樞面板頂部點擊“導入會話包”，選擇 .zip 文件，插件校驗 manifest、日誌完整性和 sessionId 格式後解壓到臨時目錄，再原子重命名進 sessions/<編碼工作區>/
/。 -
信箱協議：將 JSON 文件放入
/inbox/，插件將其移動到 processed/ 並在 outbox/ 寫入回覆。示例請求：
{ "target": "<session name or id>", "message": "hello", "from": "my-app", "id": "req-0001" }
適用場景與注意¶
適合需要統一管理多個會話、需要按名投遞消息、需要盤點與刪除會話、需要會話導出/遷移的開發者。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
結尾¶
dsh-session-suite 通過統一信箱、按名投遞、免辨活踢醒、會話盤點與刪除、會話導出/導入和會話中樞面板，爲 DSH 提供了一套會話管理的完整路徑。插件當前爲 beta（0.2.x），目標 DSH 版本 >=0.2.1-0 <0.3.0。目錄頁：https://www.skillhub.cn/plugins/chc-1986/dsh-session-suite，GitHub：https://github.com/chc-1986/dsh-session-suite。
