前言¶
DSH（DeepSeek Harness）是智能體開發與調試的重要工具。在 Web 界面中，原本的會話管理僅支持重命名、分叉和歸檔。歸檔操作只是將會話從列表中隱藏（修改 archivedSessionIds），並不會清理磁盤上的日誌、工作區掛賬等數據，無法徹底移除。
本插件補上了這一缺失的“刪除”能力。安裝後，它會在會話頭部提供刪除入口，通過二次確認機制，徹底移除工作區掛賬、歸檔集合、內存記錄及磁盤日誌。
核心功能¶
本插件在 DSH Web 界面提供以下能力：
- 刪除入口：在會話標題右側的操作區新增“刪除會話”按鈕。
- 徹底清理：刪除會話的同時，清理工作區掛賬、歸檔集合條目、內存會話記錄以及磁盤上的事件日誌。
- 安全機制：
- 二次確認：刪除前彈出模態框，防止誤操作。
- 運行保護：拒絕刪除正在運行的會話，防止寫入衝突。
- 信任籬笆：API 使用 Loopback-only 信任模型，僅允許本地同源訪問。
- 交互反饋：刪除成功後自動切換視圖，並通過 Toast 提示結果。
安裝與啓用¶
安裝過程需要執行構建和插件註冊兩步：
- 克隆倉庫並構建瀏覽器端 Bundle：
git clone https://github.com/huimingli666/dsh-session-delete.git
cd dsh-session-delete
node scripts/build-client.mjs
- 將插件註冊到 Web Profile 的 Bundle 列表中：
dsh plugin --profile web add "$PWD"
重啓 DSH 並刷新瀏覽器即可生效。
典型用法¶
激活後，打開任意會話，在標題右側的操作區找到垃圾桶圖標，點擊並在彈出的確認模態框中確認即可永久刪除該會話。
限制與注意事項¶
- 入口限制：刪除按鈕僅位於已打開會話的頭部操作區，無法從列表行的菜單中調用。
- 歸檔清理依賴：歸檔集合的清理依賴原型補丁。若補丁不可用，插件僅發出警告而不阻斷刪除流程。
- 版本要求：需要 Node.js 版本
^22.0.0或>=24.0.0。插件在dsh 0.1.x上開發與測試。 - 刪除管線：插件在宿主端依次執行校驗、運行保護、工作區掛賬移除、歸檔集合清理、磁盤日誌刪除及內存摘除。
總結¶
該插件解決了 DSH 原生會話管理中“刪不掉”的問題，提供了徹底清理會話數據的方案。
