前言¶
DeepSeek Harness（DSH）採用插件化架構。在開發或使用過程中，管理會話（創建、重命名、歸檔）通常需要切換上下文或操作側邊欄。dsh-session-pilot 插件允許模型和用戶在當前對話內部直接管理 DSH 會話，無需離開當前聊天窗口。
核心能力¶
該插件主要提供兩類能力：模型可調用的工具和 UI 上的操作入口。
模型工具¶
插件向模型暴露了五個工具，用於會話的全生命週期管理：
new_conversation：從當前對話中剝離一個 drifted topic 或 well-scoped task，在側邊欄創建一個全新的會話。新會話零歷史，僅包含模型構造的一條完整的自包含用戶消息。rename_session：重命名當前會話。list_sessions：按最近活動列出會話（顯示標題、運行狀態、目錄）。支持通過 content-search 消息傳遞 query 進行搜索。read_session：讀取指定會話的緊湊型文本記錄（僅包含最新的用戶/助手文本消息，有界）。archive_session：將會話從工作區會話列表中歸檔（日誌持久化保留）。
UI 操作¶
插件複用了 DSH 官方 UI 的插槽，未進行 DOM 注入：
- Session-header “＋ New chat”：點擊該按鈕可在當前工作區打開一個空白會話。
- Per-assistant-message “⧉”：點擊助手消息上的該按鈕，會將該消息的文本（有界）作爲新會話的第一條用戶消息內容。
安裝與啓用¶
安裝插件需要使用 DSH 的插件管理命令。安裝後需重啓 dsh 進程。
dsh plugin add dsh-session-pilot
安裝完成後，模型將獲得上述五個工具，會話標題欄將出現“＋ New chat”按鈕，每條助手消息旁將出現“⧉”操作。
使用方法¶
1. 通過模型工具操作¶
直接在對話中輸入自然語言指令，由模型調用對應的工具。
- 創建新會話：說 “spin this task off into a new conversation”。
- 重命名：說 “rename this conversation to X”。
- 列表：說 “list my recent conversations”。
- 讀取：說 “what did we discuss in session X”。
- 歸檔：說 “archive session X”。
2. 通過 UI 操作¶
- 創建空白會話：點擊會話標題欄的 “＋ New chat”。
- 基於上下文創建：點擊助手消息旁的 “⧉”，將消息文本作爲上下文引用到新會話的開頭。
侷限性與注意事項¶
- 文本摘錄限制：
read_session僅返回文本消息。助手消息中的圖片和工具調用塊不會被攜帶。在新會話中引用文件時，建議使用@符號。 - 預設繼承差異：通過 UI 創建的會話會使用部署的默認 agent preset（跳過了源會話預設的繼承），而通過工具路徑創建的會話會繼承源會話的預設。
- 歸檔與撤銷：歸檔操作僅是從工作區列表中移除會話，日誌依然保留，且插件內不支持取消歸檔（需在 UI 中恢復）。創建會話後沒有撤銷操作，需通過歸檔來清理。
- 工具調用過濾：
read_session會跳過工具事件，僅展示用戶/助手文本。
結尾¶
dsh-session-pilot 填補了社區中“讓模型直接創建、重命名和歸檔用戶可見的一級會話”的空白。它與純 UI 的會話管理插件（如 dsh-session-kit）互不衝突，前者提供模型可調用的操作接口，後者提供可視化的管理面板。
