前言¶
在 DeepSeek Harness (DSH) 的開發流程中，隨着項目註冊和持久化會話的積累，清理不再活躍的資源是維護環境整潔的關鍵步驟。手動刪除文件或配置可能遺漏註冊信息，導致環境狀態不一致。本插件提供了標準化的命令和 Web 界面，用於安全地移除項目註冊和持久化會話。
插件介紹¶
dsh-command-delete 是一個 DSH 插件，由用戶 wang122818 維護。它的核心功能是提供斜槓命令和 Web UI 管理面板，專門用於刪除項目註冊和持久化會話，解決了手動管理 DSH 資源帶來的繁瑣與潛在錯誤。
核心功能¶
斜槓命令¶
插件提供了三個核心命令：
* /delete-project <workspaceId>：刪除項目註冊。
* /delete-workspace <workspaceId>：刪除工作區註冊。
* /delete-session <sessionId>：刪除持久化會話。
其中，/delete-workspace 是 /delete-project 的別名，兩者行爲一致。
Web UI 管理¶
安裝 Web UI 捆綁包後，側邊欄底部會出現一個垃圾圖標。點擊該圖標可打開管理面板，列出項目與會話。所有破壞性操作（如刪除）都會彈出確認對話框，防止誤操作。
刪除邏輯¶
- 項目/工作區刪除：此操作僅移除 DSH 工作區註冊，項目目錄及會話日誌文件在磁盤上保持不變。
- 會話刪除：此操作會永久刪除持久化的 JSONL 會話目錄。如果會話當前被活躍的 Agent 擁有，刪除操作將被拒絕。
安裝與啓用¶
從包含該插件包的目錄運行以下命令。請根據實際使用的配置文件名稱替換 default：
dsh plugin --profile default add .
安裝後需重啓 DSH 進程以使插件生效。
典型用法¶
在 DSH 界面中直接輸入以下命令：
/delete-project <workspaceId>
/delete-workspace <workspaceId>
/delete-session <sessionId>
如果不提供 <workspaceId> 或 <sessionId>，命令會打印當前可用的 ID 列表。
注意事項與適用場景¶
適用場景¶
- 清理測試產生的多餘工作區註冊。
- 歸檔並刪除歷史會話日誌。
- 通過 Web 界面進行可視化的資源管理。
權限與限制¶
- 權限運行：插件以當前 DSH 進程的權限運行，執行文件系統操作。
- 活躍會話保護：當前 DSH 版本未暴露公共的會話刪除生命週期接口。因此，插件設計爲拒絕刪除當前被活躍 Agent 擁有的會話，以防止數據丟失或進程異常。
- 項目目錄保留：刪除項目註冊不會清理磁盤上的項目目錄和日誌文件，僅清理 DSH 的內部註冊表。
安全建議¶
安裝前請檢查插件的源碼與許可證（MIT），確保符合您的安全合規要求。
總結¶
dsh-command-delete 爲 DSH 用戶提供了項目註冊和會話管理的標準化工具，既支持命令行快速操作，也提供 Web 界面的安全確認機制。對於需要頻繁管理開發環境資源的開發者而言，這是一個實用的輔助工具。
