前言¶
在使用 DeepSeek Harness (DSH) 的 Web GUI 進行開發時，直接刪除會話或工作區往往意味着數據即刻丟失。雖然 DSH 原生的“刪除工作區”行爲會保留項目目錄和會話日誌，但這在交互上缺乏靈活的“軟刪除”選項。對於需要誤刪恢復或批量清理的場景，缺乏一個統一的回收站機制會帶來不便。
是什麼¶
dsh-session-trash 是一個爲 DSH Web GUI 插入會話級回收站功能的插件。它由 Huo-yang 維護，解決了原生操作缺乏撤銷機制的問題，提供會話的暫存、恢復及自動清理能力。
核心功能¶
插件在 DSH Web GUI 中主要提供以下能力：
- 會話行菜單：在會話列表的「…」菜單中新增「移入回收站」和「徹底刪除」兩個選項。
- 回收站面板：提供一個集中的面板查看已刪除會話，支持逐條恢復、永久刪除或清空。
- 側邊欄狀態：當回收站中有內容時，側邊欄入口會顯示綠色狀態點。
- 原生配置：將回收站設置（暫存、保留天數、確認提示、自動清理）融入 DSH 原生插件頁面。
- 列表同步：通過精確會話 ID 隱藏已刪除條目，保持主列表整潔。
安裝與啓用¶
插件通過 GitHub Releases 發佈，不提供 npm 包。安裝前需確認已安裝 DSH。
- 從 GitHub Releases 下載對應版本的
dsh-session-trash-<版本>.tgz。 - 執行安裝命令：
dsh plugin --profile trash add "C:\Downloads\dsh-session-trash-0.2.1.tgz"
安裝後，在 DSH 的「插件」頁面即可看到回收站相關的配置項。
典型用法¶
- 恢復會話：在會話菜單中選擇「移入回收站」，隨後在回收站面板中點擊恢復。
- 卸載插件：如果不再需要，可以移除插件，但回收站數據會保留在本地磁盤：
dsh plugin --profile trash remove dsh-session-trash
- 開發調試：在源碼目錄下直接安裝：
dsh plugin --profile trash add "$pluginPath"
注意事項與適用場景¶
- 數據保留：卸載插件不會自動刪除回收站中的數據，建議在清理前確認是否還有需要恢復的會話。
- 刪除工作區：該插件不改變 DSH 原生“刪除工作區”的行爲（僅移除登記，保留日誌），它主要處理會話級的軟刪除。
- 語言支持：雖然 README 提供了英文版本，但插件界面目前主要針對簡體中文優化。
- 生態歸屬：這是一個社區維護的第三方插件，與 DeepSeek 官方無官方隸屬關係。
總結¶
dsh-session-trash 通過引入軟刪除機制，爲 DSH 用戶提供了更可控的會話管理體驗。適合需要頻繁調試、誤刪恢復或定期清理測試數據的開發者使用。
