前言¶
在 DSH Web 側邊欄裏，會話歸檔後通常會以灰色行保留在列表中，便於日後查閱，但本地仍會佔用日誌目錄、歸檔登記與投影緩存等空間。宿主默認側重「歸檔」而非「從本機徹底移除」，若你只想清理已歸檔且確認不再需要的對話，往往缺少一條帶預檢、可二次確認的官方式入口。下面介紹的客戶端插件 dsh-archived-session-delete（維護者 HuiHuanYe）在歸檔會話的右鍵或 ⋯ 菜單中增加「刪除歸檔會話」，經確認後在本機永久刪除權威日誌及相關登記，並通知已連接頁面更新列表。
這是什麼¶
dsh-archived-session-delete 是分類爲「客戶端」的 DSH Web 插件：在側邊欄歸檔會話的上下文菜單中增加永久刪除操作；刪除採用 fail-closed 策略，會拒絕仍在使用中的會話，並清理子 agent 日誌、歸檔項與派生緩存。倉庫：github.com/HuiHuanYe/dsh-archived-session-delete；社區目錄頁：skillhub.cn/plugins/HuiHuanYe/dsh-archived-session-delete。許可 MIT，與 DSH 0.2.2-rc.1 對齊驗證，運行環境要求 Node ≥ 24；README 記載 35 個測試通過。插件以當前 DSH 進程權限操作本機會話存儲，安裝前宜自行審閱源碼與許可證。
核心功能¶
- 入口與交互：僅在歸檔會話的右鍵菜單或行尾
⋯中顯示；菜單由 DSH 原生菜單服務承載（鍵盤導航、焦點、危險樣式由宿主處理）。確認框說明永久刪除且不可撤銷，支持 Esc、遮罩關閉與焦點循環。 - 刪除範圍：刪除權威會話日誌目錄（含歷史代際）、
origin: 'subagent'子會話日誌、workspace 歸檔登記、session_projcache投影緩存，並廣播api-session/removed，使已連接頁面即時移除該行。 - 刪除前預檢：校驗歸檔狀態；全程持有寫聲明；檢查後臺
jobs與定時schedule；目錄內存在未知文件則放棄刪除。子會話先刪、祖先最後；子會話失敗會阻塞祖先以便重試。 - 明確不刪除：附件爲內容尋址且可能跨會話共享，無刪除 API；SQLite 搜索索引爲派生庫，下次搜索時會自動對賬。
- 安全邊界：不提供 agent 工具，不可撤銷操作僅保留用戶手勢入口；中英雙語界面。
Host 端通過認證通道註冊 POST /api/archived-sessions.delete，僅接受已認證的 owner Peer。常見結構化錯誤碼包括 session-not-archived、session-pending、session-in-use、session-scheduled、work-check-unavailable、storage-unsupported 等，客戶端按碼做本地化提示。
安裝與啓用¶
插件無構建步驟。任選其一：
從 GitHub 安裝（CLI profile）
dsh plugin --profile <name> add github:HuiHuanYe/dsh-archived-session-delete
從本地目錄安裝（已持有倉庫副本時）
在 DSH → 設置 → 插件 → 從目錄安裝 中選擇插件目錄；或使用：
dsh plugin --profile <name> add 'link:<絕對路徑>'
說明：桌面 profile 由 Electron 獨佔管理，宜用插件設置頁操作。安裝後若未熱加載，重啓一次 DSH；在插件頁移除 Bundle 即可卸載，已刪除的會話不會恢復。
典型用法¶
- 側邊欄打開 視圖選項 → 會話篩選，選「全部對話（顯示已歸檔）」或「僅顯示已歸檔」。
- 在灰色歸檔會話上右鍵，或點行尾
⋯，選擇 刪除歸檔會話。 - 在確認框中點擊 永久刪除；成功後會有釋放空間類提示，該行從列表消失。
若瀏覽器請求超時，刪除可能在 Host 端仍會繼續；稍後刷新側邊欄確認狀態。
適用場景與注意¶
適合：長期在本機使用 DSH、歸檔會話積累較多、且需要在二次確認後徹底釋放日誌與歸檔登記空間的用戶。
限制（以 README 爲準）：
- 新建後未發消息的未落盤會話會拒絕刪除（
session-pending）。 - 舊格式需遷移的會話會拒絕刪除（
migration-required）。 - 請求體按 64 KiB 上限處理；
/api橋接層另有總量限制，且僅 owner 可訪問。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄由社區維護，與 DeepSeek / 幻方無官方從屬關係。本插件在分類上屬於客戶端擴展，星標數爲目錄所示當前值，能力以倉庫 README 與 release 爲準。
結尾¶
dsh-archived-session-delete 補足了歸檔會話在本機的「可確認、可預檢、不可通過 agent 誤觸」的永久刪除路徑，與 DSH 0.2.2-rc.1 會話持久化、workspace 登記模型一致。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
