前言¶
DeepSeek Harness（DSH）可以把會話歸檔，歸檔後會從主列表消失，但會話日誌目錄和投影緩存仍留在磁盤上，界面也沒有公開的「刪除會話」入口。若只在文件系統裏手動刪目錄，容易漏掉工作區歸屬、投影緩存或內存裏的會話引用，側邊欄仍可能出現點開會報錯的「幽靈」行。
下面介紹社區插件 luckamuu/dsh-sessions-plugin（包名 @local/archived-sessions）：在側邊欄增加「已歸檔會話」頁面，列出當前歸檔集合中的會話，並提供經兩步確認後的徹底刪除。維護者爲 luckamuu，分類爲客戶端插件；當前 Release 爲 v1.0.0，MIT 許可證，零運行時依賴。README 標明在 @deepseek-ai/dsh-desktop 0.2.0-rc.1 上驗證，兼容基線徽章爲 DSH 0.2.0-rc.2。
這是什麼¶
這是一個 DeepSeek Harness 插件，由宿主半邊（index.js）與瀏覽器半邊（client.js）組成：宿主註冊 archivedSessions 服務並負責在確認後從硬盤刪除；客戶端在側邊欄註冊入口並渲染管理頁。兩半通過 DSH 的 Typert Remote 通信，前端只調用 archivedSessions/list 與 archivedSessions/deleteSession，不直接做文件操作。
核心功能¶
| 能力 | 說明 |
|---|---|
| 歸檔會話列表 | 按最近活動時間倒序，展示標題、時間、工作目錄、佔用空間與文件數 |
| 徹底刪除 | 每行僅一個操作；先點「徹底刪除」，再點「確認刪除」，不可撤銷 |
| 空間統計 | 遞歸統計會話目錄大小，刪除前可見將釋放的空間 |
| 缺失文件標記 | 仍在歸檔集合中但目錄已不在磁盤上的會話會標註「文件已不在」 |
| 宿主版本自檢 | 面板發現宿主端點與界面不一致時說明原因並禁用刪除，而非靜默 404 |
| 中英雙語 | 隨 DSH 語言切換，文本走 ctx.locale |
刪除只在會話確實處於歸檔集合（workspaceRegistry.archivedSessionIds）時執行；正在跑回合的會話（agent.status === 'running'）會被拒絕，需先停止。子代理會話不在歸檔集合中，不會出現在列表裏。
安裝與啓用¶
前置條件¶
- 已安裝 DSH 桌面版。
- 安裝目標可以是本地目錄的絕對路徑（包管理器記爲
link:），或 Git 倉庫簡寫github:<owner>/<repo>（無需事先克隆倉庫）。 - 安裝或卸載後必須完全退出並重新打開 DSH（確認托盤或任務管理器中沒有
DeepSeek Harness進程）。宿主import()插件與界面插件清單均在啓動時生成，不會熱生效。
步驟¶
- 打開 DSH，左側邊欄進入 插件 頁面。
- 點 安裝，在輸入框填入其一，例如：
C:\Users\you\Desktop\dsh-sessions-plugin (Windows，本地目錄絕對路徑)
/home/you/tools/dsh-sessions-plugin (macOS / Linux)
github:luckamuu/dsh-sessions-plugin (Git 倉庫地址)
- 確認安裝。插件無依賴、無安裝腳本，不會觸發構建確認。
- 完全退出並重新打開 DSH。
- 重啓後側邊欄在「插件／計劃」附近會出現 已歸檔會話 入口。
若需固定某一 Release 版本，可在安裝前自行取得對應 tag 的源碼目錄，再向插件頁填寫該目錄的絕對路徑；Release 無額外構建產物，源碼包即爲全部內容。手改 ~/.dsh/profiles/<profile>/package.json 也可行，但 README 建議優先使用插件頁，且改完同樣必須重啓 DSH。
典型用法¶
面板頂部會顯示實際讀取的 DSH 主目錄（DSH_HOME，否則 ~/.dsh），便於排查「曾歸檔卻列表爲空」等問題。
- 打開 已歸檔會話，必要時點 刷新。
- 在某行點 徹底刪除。
- 在確認條上點 確認刪除（或 取消 放棄）。
- 成功後頂部提示「已刪除 \<會話 id>」，列表自動刷新。
刪除會按既定順序解除歸檔標記、工作區歸屬、內存會話、投影緩存，並遞歸刪除 sessions 下對應目錄及 session_projcache 相關文件，最後通過 api-session/removed 通知界面。附件等共享內容不會被刪。
適用場景與注意¶
適合誰： 長期用 DSH 歸檔舊會話、磁盤被日誌佔滿，又希望按正確順序清理註冊表與緩存、避免幽靈會話行的開發者。
權限與安全： 插件以當前 DSH 進程權限運行，刪除使用 node:fs 與解析後的絕對路徑，不走 shell。安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的環境策略。刪除不可恢復，務必依賴界面兩步確認。
生態說明： DSH 強調「一切皆插件」；SkillHub 目錄頁 爲社區收錄站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
luckamuu/dsh-sessions-plugin 補上了 DSH 歸檔後缺少的「從硬盤徹底移除」入口：列表、統計、版本自檢與嚴格歸檔邊界，把原先需要手動對齊的多步清理收成側邊欄裏的可確認操作。
- 目錄頁：https://www.skillhub.cn/plugins/luckamuu/dsh-sessions-plugin
- GitHub：https://github.com/luckamuu/dsh-sessions-plugin
