前言¶
DeepSeek Harness（DSH）的會話數據存儲在本地磁盤目錄 ~/.dsh/sessions/ 下。官方 Web 界面僅展示當前工作區的會話，且缺乏批量管理能力，當會話數量增多時，管理效率較低。dsh-session-admin 插件在 Web 設置面板提供全局視圖，允許用戶查看所有現存與已歸檔的會話，並提供歸檔、刪除及批量操作功能。
插件定位¶
dsh-session-admin 是一個 DeepSeek Harness 插件，由用戶 robin758 維護。它通過在 Web 設置面板掛載管理入口，實現對 DSH 會話的統一治理，解決會話堆積與清理困難的問題。
核心功能¶
- 查看全部會話：列出磁盤上所有現存與已歸檔的會話，包含標題、工作區及時間戳。
- 歸檔與恢復：支持將不常用的會話一鍵歸檔，或隨時從歸檔中恢復。
- 永久刪除：刪除會話目錄，該操作不可恢復，但包含二次確認防止誤刪。
- 搜索過濾：通過關鍵詞快速篩選會話列表。
- 批量操作：支持多選會話，批量執行歸檔、取消歸檔或刪除。
安裝與啓用¶
通過官方命令安裝插件：
dsh plugin --profile web add github:robin758/dsh-session-admin
安裝完成後，必須重啓 Web 服務以加載插件：
launchctl kickstart -k gui/$(id -u)/com.deepseek.dsh
典型用法¶
- 啓動 DSH Web 服務。
- 進入 設置 → 會話管理 面板。
- 在頂部輸入框輸入關鍵詞搜索會話，或直接勾選會話進行操作。
- 點擊操作按鈕對選中的會話執行歸檔、取消歸檔或永久刪除。
HTTP API¶
插件提供 RESTful 接口，可用於腳本自動化或第三方工具集成。
| Method | Path | 說明 |
|---|---|---|
| GET | /plugins/dsh-session-admin/list |
列出磁盤上的全部會話（現存 + 歸檔） |
| POST | /plugins/dsh-session-admin/archive |
歸檔一個會話 |
| POST | /plugins/dsh-session-admin/unarchive |
取消歸檔一個會話 |
| POST | /plugins/dsh-session-admin/delete |
永久刪除一個會話 |
| POST | /plugins/dsh-session-admin/batch |
批量歸檔 / 取消歸檔 / 刪除 |
注意：變更類接口（POST 請求）僅接受同源請求（Origin 與 Host 一致），否則返回 403 錯誤。
配置與開發¶
插件支持通過 bundle patch 中的 config 字段進行覆蓋（profile 層可再覆蓋）。插件爲純 ESM 模塊，無構建步驟，可直接運行。
注意事項¶
- 永久刪除：刪除操作爲永久刪除，不可恢復，操作前請確認。
- 服務重啓：安裝或更新插件後，必須執行
launchctl kickstart重啓 Web 服務。 - 同源限制：變更類 API 限制了跨域請求，確保調用環境與 DSH Web 服務同源。
