前言¶
DeepSeek Harness (DSH) 採用插件化架構,插件之間通過 RPC 通信。在實際使用中,往往需要讀取已有會話的上下文、複製會話 ID,或者向其他會話發送指令以協調工作。dsh-session-telecom 旨在解決這些跨會話通信的需求,提供了一套標準化的交互能力。
插件定位¶
dsh-session-telecom 是一個 DeepSeek Harness 會話通信插件,由 ltmroberthk915 維護。它從原本地會話通信插件獨立改名而來,與 npm 上的 dsh-session-toolkit 是不同項目。該插件不依賴或升級 dsh-session-toolkit,也不引入額外的運行時依賴。
核心功能¶
該插件主要提供以下能力:
* 會話管理:複製會話 ID,列出會話並查看狀態。
* 內容讀取:只讀已有會話內容,支持摘要、尾部或原始數據模式。
* 消息發送:向在線或已保存的會話發送消息,支持排隊或插入。
* 數據監控:查看 token 用量、計費 token 和緩存命中率。
安裝與啓用¶
插件通過 npm 包安裝。對於 CLI 或 Web 用戶,執行以下命令:
dsh plugin --profile web add dsh-session-telecom@1.1.0
安裝完成後需要重啓宿主。桌面端與 Web 端的 profile 獨立,需要分別安裝。
典型用法¶
插件通過模型工具 session_telecom 提供功能,支持 JSON 格式的 action 參數。
- 列出會話
獲取會話列表,支持限制條數。
{"action":"list","limit":20}
- 讀取會話內容
讀取指定會話的最近記錄。last參數控制讀取條數,mode控制輸出格式(summary 爲摘要,raw 爲原始 JSONL)。
{"action":"read","sessionId":"源會話完整 ID","last":5,"mode":"summary"}
- 發送消息
向目標會話發送文本。mode: queue將消息排在目標下一回合,mode: steer插入到下一步。
{"action":"send","targetSessionId":"目標會話 ID","text":"請繼續這項工作","mode":"queue"}
- 期望回覆
當需要對方明確答覆時,設置expectReply: true。宿主會驗證發送方身份並附上回信指引。
{"action":"send","targetSessionId":"目標會話 ID","text":"還有哪些驗收工作未完成?","expectReply":true}
適用場景與注意¶
- 權限限制:插件只訪問當前 DSH 宿主可見的 DSH 會話,不提供 zcode 等外部平臺會話的查找、讀取或接管。
- 停止查找規則:當帶
query的查詢沒有匹配,或讀取/投遞返回session/not-found時,工具描述要求模型停止查找並向用戶報告。不得重複查詢、改詞擴大搜索或掃描磁盤。 - 費用與喚醒:發送消息會喚醒目標會話,這可能產生模型費用。應只在用戶授權的通信範圍內使用。
- 依賴關係:無運行時 dependencies、optionalDependencies 或捆綁依賴,不會安裝第二份 DSH 內核。
結語¶
該插件爲 DSH 用戶提供了便捷的會話間通信手段,適合需要跨會話協作或上下文複用的場景。更多細節可參考:GitHub。