dsh-one-click-archive：DeepSeek Harness 一鍵歸檔舊對話

在 DeepSeek Harness (DSH) 的日常使用中，對話記錄會隨時間不斷累積。手動篩選並歸檔過期的對話不僅耗時，還容易造成歷史記錄管理混亂。該插件提供了一種基於時間閾值的自動化歸檔方案，通過 Web 界面即可完成操作。

這是什麼¶

dsh-one-click-archive 是一個 DeepSeek Harness Web GUI 插件，由用戶 sujiu222 維護。它解決的核心問題是“如何快速、安全地歸檔符合時間條件的舊對話”。該插件通過設置年齡閾值，允許用戶在歸檔前預覽候選會話，並一鍵執行歸檔操作。

該插件具備以下核心能力：

靈活的年齡閾值：支持從 1 小時到 90 天的多種時間跨度，包括 1/6/12 小時，以及 1/3/7/14/30/90 天。
預覽與確認：在執行歸檔前，插件會計算候選會話的具體數量，並展示樣本列表，確認無誤後再進行操作。
空白會話選項：用戶可選擇是否包含內容爲空的會話。
智能過濾：自動跳過正在運行、最近活躍以及已經被歸檔的會話，避免重複操作。
實時計算：在執行歸檔動作前，會立即重新計算候選會話，防止因緩存導致的預覽與實際結果不一致。
非破壞性歸檔：使用 DSH 官方的 workspaceRegistry.archiveSession() API。歸檔操作僅將會話 ID 添加到全局歸檔集合中，不會刪除原始對話日誌或影響工作區統計。
安全機制：使用僅限 Loopback 主機的路由，並在執行變更前彈出確認對話框。

安裝該插件需要使用 DSH 的命令行工具。首先執行安裝命令：

dsh plugin --profile <your-web-profile> add github:sujiu222/dsh-one-click-archive

安裝完成後，需要重啓對應的 DSH Web 配置文件，刷新瀏覽器，然後在設置菜單中找到 One-click archive 選項。

如果是本地開發環境，安裝步驟如下：

npm install
npm run check
dsh plugin --profile <your-web-profile> add /absolute/path/to/dsh-one-click-archive

注意：客戶端插件的更新僅在 DSH 檢出代碼運行 pnpm run dev:web 監聽器時支持熱重載。否則，需要重新構建/安裝插件、重啓宿主插件並刷新頁面。

安裝並啓用插件後，進入設置頁面的 One-click archive 標籤頁。在界面上設置歸檔的年齡閾值，並決定是否包含空白會話。點擊歸檔按鈕前，系統會展示預覽信息。

通過插件暴露的 API，也可以進行自動化操作。請求體格式如下：

{ "ageMs": 86400000, "includeBlank": false }

其中 ageMs 爲時間毫秒數，includeBlank 控制是否包含空白會話。

該插件適用於需要定期清理歷史對話記錄、保持工作區整潔的用戶。在使用前，請確保理解其非破壞性特性：歸檔僅添加會話 ID，日誌和會計信息依然保留。如需恢復，請使用 DSH 的歸檔 UI 或其他歸檔管理插件。

此外，插件使用 Loopback-only 主機路由，所有 API 調用均需在相同源下進行。在進行任何變更操作前，務必查看預覽並確認對話框內容。

dsh-one-click-archive 提供了一個基於時間維度的對話歸檔解決方案，通過預覽、智能過濾和非破壞性 API 設計，降低了手動管理歷史記錄的門檻。