前言¶
在 DeepSeek Harness（dsh）里長期跑智能體會話時，側欄會積累大量已歸檔條目。歸檔只是把會話標記爲「已歸檔」，並不會停止仍在運行的 agent，也不會刪掉日誌目錄和投影緩存。若需要徹底清掉某條歸檔會話及其磁盤數據，Harness 本體未必提供與側欄操作一致的一鍵永久刪除路徑。dsh-delete-archived-session 針對這一類管理需求：僅在會話已歸檔時出現刪除控件，並通過兩步確認，在確認後停止該會話相關工作、刪除日誌與緩存記錄，並從工作區側欄移除對應行。
這是什麼¶
dsh-delete-archived-session 是社區維護的 DSH 插件，倉庫爲 Cnily03/dsh-delete-archived-session，維護者 Cnily03。在插件目錄站點上的分類爲 admin-security。插件在 Web 或桌面 Harness 的側欄中，爲已歸檔的會話行提供永久刪除入口；刪除流程帶 3 秒「武裝」確認，避免誤觸。
核心功能¶
下面介紹插件在界面與後端上的行爲，均來自倉庫 README 與 package.json 的說明。
界面入口（僅歸檔會話）¶
控件只在對應行的會話處於已歸檔狀態時渲染，有兩處：
- 行懸停條（Hover strip）：歸檔、置頂單元格之後顯示垃圾桶圖標。
- 「⋯」更多菜單：提供「Delete archived session」菜單項，點擊後菜單會關閉。
控件複用宿主自帶的 IconTrashOutlineRegular、Tooltip 和 MenuItemButton，視覺上與原生控件一致。
兩步確認刪除¶
刪除需要兩次有意爲之的點擊：
- 第一次點擊：進入「武裝」（armed）狀態——控件變紅，文案變爲 Permanently delete，武裝狀態持續 3 秒。
- 武裝期內再次點擊：執行刪除。若 3 秒超時，下一次點擊僅重新武裝，不會直接刪除。
刪除後的副作用¶
確認刪除後，插件會：
- 停止該會話上仍在運行的工作；
- 從磁盤移除該會話的日誌目錄與 projection-cache 記錄；
- 清理工作區會計信息，使側欄對應行消失。
歸檔與刪除的區別¶
必須先歸檔，才能刪除。僅歸檔不會停止 agent，也不會刪除任何文件；刪除纔是停止工作並清除文件的操作。
安裝與啓用¶
按運行環境選擇 --profile web（dsh web 服務）或 --profile desktop（桌面應用），安裝後需要重啓 Harness。
# npm
dsh plugin --profile web add dsh-delete-archived-session
# GitHub（最新）
dsh plugin --profile web add github:Cnily03/dsh-delete-archived-session
桌面版也可在內置插件市場中安裝。將上述命令裏的 web 換成 desktop 即對應桌面 profile。
典型用法¶
- 在側欄找到目標會話，先將其歸檔（若尚未歸檔，不會出現本插件的刪除控件）。
- 在該歸檔行上懸停，點擊懸停條中的垃圾桶圖標；或打開「⋯」菜單，選擇刪除歸檔會話項。
- 第一次點擊後等待控件變紅並顯示 Permanently delete。
- 在 3 秒內再次點擊，完成永久刪除。
開發或自研構建時，倉庫根目錄提供 pnpm install、pnpm build（tsup 輸出至 dist/）等腳本；Host 邏輯在 src/index.ts（刪除路由、停止/idle/flush/remove、清理與啓動掃描），客戶端兩步控件在 src/client.ts。
適用場景與注意¶
適合誰：需要在本地或自託管 dsh 環境中清理已歸檔會話、並連同日誌與投影緩存一併移除的管理員或日常使用者；與 admin-security 類插件一樣，涉及會話生命週期與磁盤數據。
務必注意：
- 插件以當前 dsh 進程的權限 訪問文件系統並執行停止、刪除操作。安裝前建議閱讀倉庫源碼與 MIT License，確認行爲符合你的安全與合規要求。
- 永久刪除不可通過本插件撤銷；歸檔與刪除的語義差異見上文，誤刪前請確認會話已不再需要。
- 社區插件目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係，安裝來源以你實際使用的
dsh plugin add命令或桌面市場爲準。
package.json 中當前版本爲 1.0.1，許可證 MIT，作者 Cnily03。
結尾¶
dsh-delete-archived-session 在側欄爲已歸檔會話補上帶時限確認的兩步永久刪除，並負責停止任務與清理日誌、投影緩存。若你要在 Harness 裏做會話衛生而不是隻堆歸檔標記，可按官方 README 安裝並重啓後再操作。
