前言¶
DSH(DeepSeek Harness)支持將會話歸檔,但歸檔之後,會話會從活躍列表退出;如果之後需要再次閱讀完整對話、恢復回側邊欄,或清理這條歸檔記錄,就需要一個補充入口。
dsh-archived-sessions 是一個 DSH 插件,用於查看、恢復和刪除 DSH 中已歸檔的會話。它會在設置面板新增「已歸檔會話」頁面,讓歸檔列表可查、可讀、可恢復。
這是什麼¶
- 維護者:Jiangdl0220
- GitHub 倉庫:
https://github.com/Jiangdl0220/dsh-archived-sessions - npm 包名:
@jiangdaoli/dsh-archived-sessions - 許可證:MIT License
- 運行環境:桌面端與 Web 端通用
這個插件解決的是 DSH 中“已歸檔會話缺少找回入口”的問題:先查看歸檔記錄,再按需恢復或刪除歸檔記錄。
核心功能¶
歸檔列表¶
歸檔列表會顯示以下信息:
- 會話標題
- 所屬工作區
- 消息數
- 最後活躍時間
列表支持刷新。v0.3.0 起每頁 10 條分頁,並支持按標題或工作區即時搜索過濾。
只讀對話查看¶
點擊會話後,可以彈出只讀對話流,查看完整對話內容:
- 按輪次分組。
- 摺疊推理、工具調用、命令執行等工作過程。
- Markdown 渲染支持標題、無序/有序列表、引用、鏈接、代碼塊和可橫向滾動表格。
- 工具執行以終端卡片展示工具名、狀態點、
$命令行和可展開輸出。
如果日誌存在 seq 缺口導致損壞,會話會顯示「日誌損壞」標記,打開時展示可解析的部分內容。
恢復歸檔會話¶
v0.2.0+ 支持恢復歸檔會話。恢復後會取消歸檔,讓會話回到側邊欄活躍列表的原位置。
恢復需要兩步確認。該操作寫 workspace 存儲域的 archivedSessionIds,會話數據本身不被觸碰。
刪除歸檔記錄¶
刪除也需要兩步確認。刪除僅從歸檔列表移除該條歸檔記錄;會話數據保留在磁盤。
DSH 產品本身沒有會話刪除 API,因此這裏的刪除不會刪除會話數據。
安裝與啓用¶
dsh plugin 必須指定 --profile,對應插件要安裝到的運行環境。
安裝到 DSH Desktop:
dsh plugin --profile desktop add @jiangdaoli/dsh-archived-sessions
安裝到 Web 環境:
dsh plugin --profile web add @jiangdaoli/dsh-archived-sessions
安裝後重啓 DSH,然後在「設置 → 已歸檔會話」中查看。
注意:請從 npm 安裝上述包。GitHub 倉庫只包含源碼,構建產物由 CI 生成,從倉庫直接安裝會缺文件。如果你需要從源碼安裝,先執行:
pnpm install && pnpm build
典型用法¶
先做安裝,再做查看、恢復或刪除:
1、安裝插件並重啓 DSH。
2、打開「設置 → 已歸檔會話」。
3、在歸檔列表中按標題或工作區搜索,找到目標會話。
4、點擊會話,查看按輪次組織的只讀對話流,必要時展開工具執行輸出。
5、如果要繼續使用這個會話,執行恢復;會話會回到側邊欄活躍列表。
6、如果只想移除這條歸檔記錄,執行刪除;磁盤上的會話數據仍然保留。
適用場景與注意¶
適合以下情況:
- 歸檔過 DSH 會話,之後需要回看完整對話。
- 想把某個已歸檔會話恢復回側邊欄活躍列表。
- 想從歸檔列表中清理不再需要的歸檔記錄,但不清空磁盤數據。
安裝前需要注意:插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。該倉庫許可證爲 MIT License。由於插件會讀取、恢復或刪除歸檔相關記錄,建議只在你信任的 DSH 環境中安裝,並確認目標運行環境是正確的 --profile。
鏈接¶
- 插件目錄:
https://www.skillhub.cn/plugins/Jiangdl0220/dsh-archived-sessions - GitHub:
https://github.com/Jiangdl0220/dsh-archived-sessions