前言¶
DeepSeek Harness 採用插件化架構，旨在通過組件化擴展提升開發與使用效率。隨着會話數量的累積，管理長對話歷史、整理標籤體系以及處理歸檔數據往往變得繁瑣且容易出錯。DSH Session Manager 旨在爲 DeepSeek Harness Web 提供一套標準化的會話治理方案，解決會話組織混亂、歷史記錄缺失和誤刪風險等問題。
插件概覽¶
這是一個面向 DeepSeek Harness Web 的會話治理插件：以標籤組織 Session，管理歸檔生命週期，並讓長對話摺疊與輪次跳轉保持完整。
- 維護者：6jeffr3y
- 許可證：MIT
核心功能¶
會話生命週期管理¶
提供統一的歸檔、歸檔視圖、恢復、收藏和標題跳轉功能。通過集中管理這些狀態，可以顯著減少在長會話列表中重複查找歷史記錄的時間。
多標籤組織¶
支持爲一個 Session 添加多個標籤，並允許複用已有的標籤體系。用戶可以按標題、路徑或標籤進行檢索，從而更靈活地組織知識庫。
嚴格標籤關係圖¶
構建“標籤—會話”的嚴格關係圖。僅以完全相同的標籤建立連接，歸檔和無標籤的會話不會進入圖譜，避免了無依據的關係推斷。圖譜支持縮放、拖動畫布、重置視圖以及點擊會話節點直接跳轉。
安全刪除¶
實現了嚴格的刪除邏輯。永久刪除要求會話必須已經歸檔、停止運行，並經過二次確認。刪除範圍明確，僅清理 Session JSONL、對應的投影緩存、Workspace 成員關係、歸檔記錄以及本插件保存的標籤和收藏。插件不會刪除 MemOS 數據庫、Agent 記憶與 Skill、其他 Session、插件與模型配置或跨 Session 共享的附件對象。
完整長對話導航¶
通過調用 DSH 公開的 Session.loadOlder() 方法，串行加載當前會話的更早歷史頁。補全的歷史窗口讓原生“工具調用 · 消息”過程區塊能夠穩定摺疊，並使右側的用戶輸入輪次標記能夠準確定位到對應的輸入。
多模型自然標題¶
針對 GLM 等非 DeepSeek 輔助模型，當標題 Token 預算受限時容易只輸出推理過程而缺少正文的問題，插件提供了配置選項來改善標題生成效果。
安裝與啓用¶
使用本插件前，請確保已安裝 DeepSeek Harness，且運行環境爲 Node.js ^22.19.0 || >=24。
- 安裝插件：
dsh plugin --profile web add github:6jeffr3y/dsh-session-manager#v0.1.0
- 重啓 Web profile：安裝後需重啓 Web profile 才能生效。
dsh web
- 卸載插件：
dsh plugin --profile web remove dsh-plugin-session-manager
- 安裝本地 checkout：如果需要調試或使用本地修改，可直接安裝當前目錄。
dsh plugin --profile web add link:$PWD
配置¶
插件的默認配置位於 cordis.patch.yml 文件中：
| 配置項 | 默認值 | 說明 |
|---|---|---|
stateDir |
'' |
插件狀態目錄。留空時將使用 $DSH_HOME/session-manager 作爲默認路徑。 |
improveNonDeepSeekTitles |
true |
爲支持該能力的標題模型關閉推理輸出，以獲得更自然的標題正文。 |
autoLoadFullHistory |
true |
自動加載當前會話的更早歷史頁，以補全導航能力。 |
數據與刪除範圍¶
關於永久刪除會話的範圍，請務必注意以下細節：
- 前置條件：永久刪除僅支持已經歸檔、當前未運行且使用獨立 JSONL 製品的 Session。仍由 Host 掛載但已經停止的會話會進入待刪除隊列，並在下次 DSH 啓動、恢復該會話之前完成刪除。正在生成回覆的會話會被明確拒絕刪除。
- 將被刪除的內容：Session JSONL、對應的投影緩存、Workspace 成員關係、歸檔記錄以及本插件保存的標籤和收藏。
- 不會被刪除的內容：
- MemOS 數據庫或
~/.dsh/memos-plugin/ - Agent 記憶與 Skill
- 其他 Session
- 插件與模型配置
- 跨 Session 共享的附件對象
- MemOS 數據庫或
注意事項¶
- 版本兼容性：當前版本針對 DeepSeek Harness
0.1.2-alpha.1開發和測試。由於 DSH 處於預發佈階段，Workspace 或 Session 內部接口可能會發生變化。如果發生未知格式的數據修改，插件會明確失敗，不會靜默處理。 - 供應鏈安全：通過 GitHub 安裝時，插件直接使用 Release 中提交的
lib/目錄，不執行安裝期的構建腳本。如果需要固定供應鏈內容，可以將版本標籤替換爲具體的 commit SHA。
結語¶
DSH Session Manager 提供了一套從標籤組織到安全刪除的完整會話治理流程，適合需要維護大量歷史對話記錄的用戶。更多技術細節與源碼可參考 GitHub 倉庫。
