前言¶

DeepSeek Harness（dsh）是 DeepSeek AI 開源的智能體運行時，官方倉庫的定位是「Everything is a Plugin」：界面、工具、工作流都以插件形式掛載。日常使用裏，側欄的歸檔可以把對話藏起來，但磁盤上的會話日誌往往還在；Web 端也缺少一條「把這條會話徹底刪掉」的入口。調試 harness、會話歷史不同步、損壞會話佔着側欄時，這個問題會更明顯。

社區維護者 lsz-asd 做了 dsh-plugin-session-delete。它在會話頭部放垃圾桶按鈕，在側欄會話行的「…」菜單里加「刪除會話」，確認後會刪除會話日誌、投影緩存和工作區記賬。本文根據插件目錄頁、GitHub 倉庫 README 與源碼交叉覈對後，整理它的安裝與使用方法。

需要先說明一點：DeepSeek Harness 插件社區目錄（deepseek-harness-plugin.com）是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。

這是什麼¶

dsh-plugin-session-delete 是一款「會話與消息」類插件，由 lsz-asd 維護。npm 包名爲 @huanlin/dsh-plugin-session-delete，當前版本 0.3.1（2026-08-14）。主要語言是 JavaScript，package.json 要求 Node.js >=20。GitHub 倉庫截至本文覈實時爲 20 星；社區目錄頁當時顯示 13 星，星標以倉庫頁面爲準。

它解決的是「歸檔不夠徹底、Web 端沒有刪除入口」。確認刪除後，會同時處理磁盤上的會話目錄、投影緩存，以及工作區裏的會話記賬，避免下次 flush 又把會話寫回去。package.json 把客戶端平臺標成 web；README 寫明可在 Web 中使用，並聲稱理論上兼容一切 Web 套殼客戶端，倉庫簡介也提到桌面客戶端。

核心功能¶

根據 README 與倉庫裏的 src/index.js、src/client.js，當前版本主要提供下面這些能力。

1、會話頭部的垃圾桶按鈕。插件往 conversation.session.header.actions 插槽註冊一個危險操作按鈕，當前會話可以直接點刪除。

2、側欄會話行「…」菜單裏的「刪除會話」。官方 rc.6 的會話行菜單（重命名 / fork / 歸檔）沒有擴展插槽，插件在 DOM 層注入菜單項。點擊後按標題匹配目標會話，不會先跳轉到那條對話。

3、風險確認彈窗。點擊上述任一入口後，會彈出確認框，展示會話名稱和會話 id；必須勾選「我已瞭解後果，確認刪除」後，「刪除」按鈕纔可用。若會話正在運行，彈窗會額外提示：刪除會立即停止任務並永久刪除，進行中的操作無法恢復。

4、刪除鏈路。確認後，宿主端會按順序處理：若有運行中的 agent，先 cancel 並等待其靜止（最多約 15 秒）；flush 活動會話，避免 dispose 階段回寫日誌；刪除 ~/.dsh/sessions/ 下對應目錄（同時清理原始 uuid 與 session- 前綴兩種 id）；清理投影緩存；磁盤日誌確認消失後，再解除工作區記賬（sessionIds 與歸檔集合）。v0.3.1 專門修過「半刪除後會話掉進未分組」的問題。

5、刪除後就地刷新列表，不整頁重載。若刪的是當前會話，客戶端會打開剩餘列表中的下一條，方便繼續工作。

6、Agent 工具 workbench_session_delete。智能體可以按 sessionId（uuid 或 session- 形式）直接刪除一條會話，刪除內容與界面入口相同。工具在有無 Web 界面的 profile 裏都會註冊；HTTP 接口（GET /__chameleon/session/list、POST /__chameleon/session/delete）只在存在 webServer 時掛上，純終端 profile 不會因此卡住。

7、中英文文案。v0.3.0 起，刪除對話框、頭部按鈕和側欄菜單項接入客戶端 zh/en 字典，跟隨界面語言（設置中的語言或瀏覽器語言）切換；沒有 locale 服務時，按瀏覽器語言回退到內置字典。

安裝與啓用¶

插件目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端中運行即可：

dsh plugin add github:lsz-asd/dsh-plugin-session-delete

dsh CLI 會從 GitHub 解析插件並安裝到當前配置。如需可復現安裝，請固定 commit 哈希。本文覈對倉庫 main 時，最新提交是 352510e552983dcfcb993cf9124181c55e2070f5（2026-08-14，對應 v0.3.1）：

dsh plugin add github:lsz-asd/dsh-plugin-session-delete#352510e552983dcfcb993cf9124181c55e2070f5

README 還提供了本地路徑安裝的寫法，適合先 clone 再裝進指定 profile：

dsh plugin --profile <profile> add file:C:/path/to/dsh-plugin-session-delete

安裝後需要重啓該 profile 纔會生效。目錄頁也寫明：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼；安裝前請檢查源代碼倉庫和許可證。

典型用法¶

界面刪除可以按下面步驟操作。

1、打開 DeepSeek Harness 的 Web 界面（或兼容的 Web 套殼客戶端），進入任意會話。

2、在會話頂部點擊垃圾桶按鈕；或者不打開目標會話，直接在側欄對應行的「…」菜單裏選「刪除會話」。

3、在彈窗中核對會話名稱和序列號。若提示「會話正在運行」，確認自己確實要中斷該任務。

4、勾選「我已瞭解後果，確認刪除」，再點「刪除」。成功後側欄列表會刷新；當前會話被刪時，界面會切到剩餘的下一條。

如果希望由智能體來刪，需要提供會話 id。工具名爲 workbench_session_delete，參數是 sessionId。README 沒有給出對話示例，調用時以工具描述爲準：它會永久刪除該會話的日誌、投影緩存和工作區記賬；刪除後調用方應用會話列表或 workbench_status 自行確認結果。

適用場景與注意事項¶

這個插件適合已經在用 DeepSeek Harness Web 界面、需要真正清掉本地會話而不是隻做歸檔的人，例如：試錯產生的廢會話、損壞且無法同步的歷史、以及想從側欄徹底去掉某條記錄的情況。它不是會話管理套件，沒有回收站、批量導出或取消歸檔；同類目錄裏還有功能更全的會話管理插件，需求不同應分開選。

使用前需要注意下面幾點。

• 刪除不可恢復。彈窗文案寫明會永久刪除會話及其全部對話記錄（會話日誌、統計與工作區記賬）。
• 運行中的會話仍可刪，但會先停 agent。不要在長任務做到一半時誤點。
• workbench_session_delete 會把同樣的刪除能力交給智能體。若你的 profile 會跑不可信任務，安裝前應評估是否接受這一工具。
• package.json 聲明許可證爲 MIT，但倉庫根目錄沒有獨立的 LICENSE 文件，GitHub 也未識別許可證。安裝前應自行覈對源碼與許可聲明。
• 插件以當前 dsh 進程權限運行，會讀寫 ~/.dsh/sessions/ 等工作區數據。只從自己信任的倉庫安裝，並儘量固定 commit。
• 客戶端聲明平臺爲 web。純終端、沒有 Web 界面的 profile 只能用工具刪除，沒有頭部按鈕和側欄菜單。

小結¶

dsh-plugin-session-delete 把「徹底刪除會話」補進了 DeepSeek Harness 的 Web 界面：頭部按鈕、側欄菜單、勾選確認，以及磁盤日誌、投影緩存、工作區記賬的一致清理。當前版本是 0.3.1，維護者是 lsz-asd。它是社區開源插件，不是官方內置功能；裝之前先看源碼和許可證，確認自己接受「真刪、不可恢復」再使用。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-plugin-session-delete/

GitHub：https://github.com/lsz-asd/dsh-plugin-session-delete