前言¶
在 DeepSeek Harness (DSH) 的開發過程中，會話會被歸檔以保留上下文。隨着使用時間的增長，歸檔集中的會話數量可能變得龐大，且難以在主界面中快速恢復或徹底清理。dsh-archive-sessions 插件旨在爲 DSH 增加一個專門的會話管理入口，讓開發者能夠直接在設置頁面中查看、恢復或永久刪除已歸檔的會話。
插件簡介¶
名稱：dsh-archive-sessions
所有者：jujiujiang222-cell
許可證：MIT
核心價值：提供歸檔會話的持久化視圖，支持恢復至側邊欄及永久刪除（含二次確認）。
核心功能¶
該插件主要解決歸檔會話的管理問題，具體包括：
1. 會話列表：列出所有具有持久化日誌的已歸檔會話。插件以磁盤文件爲準，避免因內存狀態不一致導致的髒數據。
2. 信息展示：顯示會話標題、創建時間、工作目錄以及當前是否在內存中處於打開狀態。
3. 恢復會話：將已歸檔的會話移出歸檔集，使其重新出現在側邊欄。
4. 永久刪除：移除會話的日誌文件並解除工作區關聯，操作前需在頁面內進行二次確認。
安裝與啓用¶
安裝插件需要當前環境具備 DeepSeek Harness 的 Web Profile，並擁有插件市場運行時環境。
官方安裝¶
使用以下命令從 GitHub 安裝：
dsh plugin --profile web add github:jujiujiang222-cell/dsh-archive-sessions
本地構建安裝¶
若需從源碼構建，請將包放入依賴集，並確保配置文件中存在以下行：
# cordis.patch.yml
- insert:
- id: dsh-archive-sessions
name: dsh-archive-sessions
安裝或更新後，重啓應用，打開 設置 → 歸檔會話 即可使用。
使用說明¶
在設置頁面的“歸檔會話”欄中，你會看到所有磁盤上存在的歸檔會話列表。
* 恢復：點擊恢復後，會話會立即回到側邊欄。
* 刪除：點擊刪除並確認後，插件會嘗試移除對應的日誌文件。由於安全限制，刪除操作需要完全訪問權限策略。
注意事項¶
- 刪除機制：會話日誌採用追加寫入模式。永久刪除會在歸檔集中留下“墓碑”標記，直到應用重啓後纔會完全清除引用。
- 內存會話：如果會話當前在內存中處於活躍狀態，刪除前必須先停止代理（通常需要約 4 秒）。
- 權限要求：刪除應用數據目錄中的文件需要完全訪問權限策略，沙箱默認 Shell 無法執行此操作。
- 不可逆性：已永久刪除的會話無法恢復。
- 依賴項：該插件依賴以下 DSH 客戶端庫：
@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-settings
生態與鏈接¶
DeepSeek Harness 遵循“一切皆插件”的理念。該插件由社區開發者維護，與 DeepSeek 官方無從屬關係。
* GitHub 倉庫：jujiujiang222-cell/dsh-archive-sessions
* 插件目錄：jujiujiang222-cell/dsh-archive-sessions
