前言¶
在 DeepSeek Harness 裏跑智能體時,會話歸檔後容易從側欄消失。想回看某段工具輸出、檢索一條歷史消息、恢復舊版本,或者安全清理佔用的本地空間,通常需要額外手段。
dsh-archived-chats 把“歸檔後會話管理”做成一個本地優先的 DSH 插件,提供瀏覽、搜索、預覽、歷史版本、備份恢復、回收站和保留策略。
這是什麼¶
dsh-archived-chats 是面向 DeepSeek Harness 的 local-first archived-chat center,由 Ultronen 維護,MIT 許可。
它解決的不是即時對話問題,而是會話離開主界面之後的問題:按工作區查找歸檔會話,檢查消息、工具結果和已存儲內容,管理本地歷史版本,導出或導入備份,並在刪除時保留可恢復路徑。
核心功能¶
- 按工作區瀏覽歸檔會話,並支持對消息和工具結果做全文搜索。
- 原生只讀預覽 Markdown、reasoning、tool activity、JSON、代碼和已存儲圖片。
- 提供 Local History,可查看歸檔後生成的已驗證版本,並支持 Restore as copy。
- 支持 JSON + Markdown ZIP 導出,以及 conflict-safe import。
- 提供 Recycle Bin,支持撤銷、兩級恢復和經確認的 permanent purge。
- 提供存儲統計與保留策略;保留策略與執行分離,清理前先做短預覽並顯式選擇。
- 提供 Origins & Branches,用於查看 fork 和 subagent 樹的只讀關係。
安裝與啓用¶
1、新增安裝:
dsh plugin --profile web add dsh-archived-chats@latest
2、啓用插件:
重啓 DSH 一次,然後打開 Settings → Session Archive。
3、更新已有安裝:
dsh plugin --profile web update dsh-archived-chats
插件數據保存在本地目錄:
$DSH_HOME/plugin-data/archived-chats/
插件元數據、回收站記錄、策略和已驗證快照都放在該目錄下,沒有上傳或雲同步。
典型用法¶
- 查看歸檔會話:在 Session Archive 中按工作區瀏覽,再用全文搜索定位消息或工具結果。
- 恢復舊版本:在 History 中預覽已驗證快照,選擇 Restore as copy。導入和恢復會創建或選擇非衝突 ID,不替換已有會話。
- 備份與遷移:導出 JSON + Markdown ZIP。導出包含完整會話 JSON 和可讀 Markdown,不包含附件字節或 descendant sessions。
- 刪除會話:普通刪除先進入 Recycle Bin,並帶有快照保護;需要徹底刪除時,單獨執行 permanent purge。
- 降級前備份:如果降級到不顯示 History 或不理解 recycle snapshots 的版本,先備份:
$DSH_HOME/plugin-data/archived-chats/
適用場景與注意¶
適合經常歸檔 DSH 會話、需要在本地查找歷史消息、工具結果、代碼、JSON 或圖片,並希望刪除可恢復、導出範圍可覈對的人。
注意:
- 插件以當前 dsh 進程權限運行,文件訪問邊界取決於本機 DSH 環境和 Host 能力。
- 如果 Host 缺少寫入能力,相關操作會返回
restore-unsupported,不會寫入或覆蓋數據。 - 安裝前建議檢查源碼、許可證和數據路徑;本插件聲明爲 MIT 許可。
- 導出 ZIP 的範圍不包括附件字節和 descendant sessions,重要附件需另行保留。
- 社區目錄是獨立插件目錄,不等同於官方應用商店。
鏈接¶
- 社區目錄:https://awesome-dsh-plugin.com/p/Ultronen/dsh-archived-chats/
- GitHub:https://github.com/Ultronen/dsh-archived-chats