dsh-archived-sessions:DSH 歸檔會話管理插件

在 DeepSeek Harness (DSH) 中,歸檔會話通常只是文件系統中的日誌文件。在 UI 中查看它們、恢復它們或徹底刪除它們,通常需要直接操作文件系統或依賴 DSH 的內置行爲,這並不總是直觀或安全的。dsh-archived-sessions 插件通過在 DSH 設置頁提供一個統一的入口來解決這個問題,實現了對歸檔會話的列表、預覽、恢復和徹底刪除。

是什麼

這是一個 Memory 類別的 DSH 插件,由開發者 Zalpha263 維護,採用 MIT 許可證。它旨在解決 DSH 用戶在管理大量已歸檔會話時遇到的操作不便問題,提供了一套完整的界面化操作流程。

核心功能

該插件提供了以下四種核心操作:

  1. 列表查看:列表加載迅速,直接顯示會話標題、原工作區和最後活躍時間(絕對時間戳)。消息數在後臺統計並緩存,反覆打開列表不會重複解析日誌,避免卡頓。
  2. 內容預覽:點擊“預覽”按鈕,可以查看會話開頭的 6 條對話(用戶/助手消息)以及調用了哪些工具。
  3. 恢復會話:點擊“恢復到工作區”,歸檔記錄會被移除,會話回到原來的工作區位置,側邊欄會立即刷新。
  4. 徹底刪除:一次性清理日誌文件、工作區歸屬和歸檔記錄。刪除前必須輸入會話標題確認(防誤刪);系統會攔截有子會話的歸檔;刪除後還會驗證日誌確實已經消失,避免會話“復活”。

安裝與啓用

安裝前請確保已安裝 pnpm,並且 DSH 版本爲 0.1.5-rc.2 或兼容的 0.1.x 系列。

使用發佈態(釘死提交,最穩定)進行安裝:

dsh plugin --profile web add github:Zalpha263/dsh-archived-sessions#<40位commit>

安裝完成後重啓 DSH。之後只有界面(Client)改動,刷新頁面(Ctrl+F5)即可;Host 改動需要重啓 DSH。

典型用法

  1. 入口:打開 DSH 設置,找到“歸檔會話”菜單。
  2. 查看:在列表中查看會話的基本信息,消息數已緩存,刷新速度極快。
  3. 預覽:點擊卡片上的“預覽”,快速查看前 6 條對話和工具調用記錄。
  4. 恢復:點擊“恢復到工作區”,會話即刻回到原位置,側邊欄自動更新。
  5. 刪除:
    • 點擊刪除按鈕,輸入確認值(標題、工作區目錄名、會話 ID 或界面顯示的標題均可)。
    • 如果該會話有子會話,系統會先詢問選擇:“僅刪父會話”或“連同 N 個子會話一起刪除”。
    • 系統會自動攔截正在運行的會話(刪除後日志會被重新寫入),並將其標記爲“無法刪除 · 仍在運行”,重啓 DSH 後方可再次刪除。

適用場景與注意

  • 依賴環境:插件依賴 DSH 0.1.5-rc.2 及以上版本。
  • 權限與安全:插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
  • 刪除限制:如果在本次運行中被打開過的歸檔會話,直接刪除會導致日誌被重新寫入,表現爲“刪了又回來”。界面會將其標爲“無法刪除 · 仍在運行”,重啓 DSH 後即可正常刪除。
  • 子會話處理:刪除有子會話的父會話不會損壞子會話的日誌。刪除時會給出二次確認,允許選擇僅刪除父會話,或者連同子會話樹一起刪除(仍在運行的子會話會被跳過)。

該插件通過封裝底層文件操作,爲 DSH 用戶提供了安全、高效的歸檔會話管理能力。更多細節可參考其 GitHub 倉庫。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜