前言¶

DeepSeek Harness (DSH) 採用插件化架構。在日常使用中，清理無效會話或對錯誤的 AI 回覆進行補救是常見需求。dsh-session-delete 插件通過擴展側欄菜單和消息交互，提供了徹底的會話刪除能力（清理日誌、工作區、內存實例及界面行）以及消息重試功能。

核心功能¶

該插件提供以下主要能力：

1. 側欄會話刪除：在側欄會話行「…」菜單中新增「刪除此會話」選項，支持永久移除會話日誌目錄、工作區歸屬、宿主內存實例以及客戶端列表行。
2. 消息重試：在用戶消息與 AI 回覆的複製按鈕右側添加「重試」按鈕，點擊可將輸入重新提交給模型。
3. 批量清理：支持批量刪除會話（單次最多 200 個），並支持清理失效行（sweep）。
4. 運行保護：對運行中的會話進行雙重拒絕（服務端與客戶端），防止誤刪。
5. 回收站配置：支持通過配置項控制刪除模式（trashMode），可選擇直接永久刪除或進入回收站。

安裝與啓用¶

本插件依賴 DSH 0.2.x 或更高版本。將插件目錄放入工作區，執行以下命令：

install_bundle target: <本目錄絕對路徑>

執行後，插件會將自身打包進當前 profile，並自動加載。若插件未自動生效，需重啓 DSH。

使用方法¶

刪除會話¶

在側欄會話行點擊「…」，選擇「刪除此會話」，在彈窗中確認即可。運行中的會話無法刪除。

批量刪除¶

1. 點擊側欄「工作區」標題右邊的「批量刪除」進入批量模式。
2. 勾選需要刪除的會話行（支持官方搜索與分組篩選）。
3. 點擊「確認刪除」執行永久刪除。

重試消息¶

在用戶消息或 AI 回覆的複製按鈕右側，點擊刷新圖標進行重試。此操作僅重發文本內容，不重發附件。

配置說明¶

插件支持可選配置項 trashMode，用於控制刪除行爲：

- insert:
    - id: session-delete
      name: dsh-session-delete
      config:
        trashMode: purge

• purge（默認）：直接永久刪除會話產物，不可恢復。
• recycle：優先進入系統回收站，失敗時降級至插件回收區。

注意事項¶

1. 不可恢復：默認 purge 模式下刪除不可恢復，需還原時請設置 trashMode: recycle 並使用 @mzzsfy/dsh-session-manager 等工具找回。
2. 運行保護：運行中的會話無法刪除，這是服務端與客戶端的雙重限制。
3. 無 peer 依賴：不聲明任何 @deepseek-ai/dsh-* peerDependencies，兼容性判定僅依賴 DSH 版本。
4. 僅支持非運行中會話：sweep 功能僅針對產物已不存在的會話進行列表清理。