前言¶

DeepSeek Harness (DSH) 的生態強調“一切皆插件”，但在會話持久化與側邊欄管理上，通常缺乏直觀的 Web 界面工具。用戶需要頻繁整理歸檔會話、篩選特定工作區或清理回收站，手動操作容易造成數據殘留或遺漏。該插件旨在爲 DSH Web 端提供一套完整的會話管理方案，解決歸檔瀏覽、工作區篩選、回收站維護以及失效記錄清理的問題。

是什麼¶

哦鯨鯨會話管理插件是一個 DeepSeek Harness 專用的 Web 插件，開源項目，許可證爲 MIT。它提供了查看歸檔會話、管理回收站、按工作區篩選以及清理失效記錄的功能，通過清理三層記賬（歸檔集、工作區記賬、投影檢查點）來確保側邊欄數據的乾淨與一致。

安裝與啓用¶

在已配置好 DSH Web 插件環境的目錄下，執行以下命令安裝：

dsh plugin --profile web add ./dsh-session-manager

核心功能¶

插件主要包含以下功能模塊：

會話瀏覽與管理：查看歸檔會話列表，支持查看最後一問一答的預覽。支持將歸檔會話恢復到側邊欄。
視圖篩選：自動識別 DSH 已註冊的工作區，支持按工作區篩選；支持按時間篩選（最近一天 / 最近七天 / 更早）。
數據刷新：提供下拉或按鈕手動刷新，首次加載後不會自動覆蓋舊數據。
回收站操作：支持單個或批量將會話移動到回收站；支持單個或批量恢復回收站會話；支持單個或批量徹底刪除；支持一鍵清空回收站。
維護工具：清理失效記錄，掃描並移除孤兒會話以及失效的歸檔 ID、工作區記賬和投影緩存。

使用流程與語義¶

刪除流程：刪除操作默認將數據移入回收站。清空回收站後，數據將徹底刪除且不可恢復。
清理失效記錄：這是一個兜底維護功能。它掃描祖先已不存在的孤兒子會話（移入回收站，可恢復），以及無法再解析到會話的失效記賬數據。即使會話是被插件之外的路徑刪除的，也可以通過此功能掃乾淨殘留。

技術細節與路由¶

插件通過 HTTP 路由提供管理接口：

GET /session-manager/archives          # 查看歸檔會話
GET /session-manager/workspaces        # 查看工作區列表
GET /session-manager/trash             # 查看回收站列表
POST /session-manager/trash            # 移動到回收站 (Body: { ids: string[] })
POST /session-manager/unarchive        # 取消歸檔 (Body: { ids: string[] })
POST /session-manager/restore          # 恢復回收站會話 (Body: { ids: string[] })
POST /session-manager/purge            # 徹底刪除 (Body: { ids?: string[] })
POST /session-manager/cleanup          # 清理失效記錄

在刪除邏輯上，插件會連帶子代理會話（parentSession 血緣）一起移入回收站，防止子會話日誌留在磁盤上。刪除操作同時清理三層記賬：歸檔集、每個工作區的會話記賬以及持久化投影檢查點。任何一層殘留都會導致已刪除的會話重新出現在側邊欄。

注意事項¶

正在打開的會話不能刪除。
插件不修改會話日誌內容。
刪除會連帶子代理會話一起移入回收站。
清理失效記錄會移除孤兒會話，但允許恢復。

資源¶

GitHub: https://github.com/133563825as-ai/oha-whale-session-manager
生態目錄: https://www.skillhub.cn/plugins/133563825as-ai/oha-whale-session-manager

哦鯨鯨會話管理插件

前言¶