前言¶
DSH Web 長期使用後，會話記錄會越攢越多。官方入口通常可以做歸檔，但歸檔更多是把會話從側邊欄隱藏；已經歸檔的會話如果缺少恢復入口，後續查找會比較麻煩；導出會話時，如果只能逐個操作，歷史記錄一多就很耗時。
dsh-session-management 是 DeepSeek Harness（DSH）Web 的會話管理插件，由 cokiscarazo-rgb 維護，許可證爲 MIT。它主要用於補足 DSH Web 官方會話管理的缺失能力，讓歸檔、取消歸檔、真正刪除本地聊天記錄和批量導出會話數據可以在「設置」面板裏集中完成。
這是什麼¶
dsh-session-management 通過 DSH 插件機制掛載到 web profile 下。安裝並重啓 dsh web 後，會在「設置」裏提供「會話管理」入口。
它主要解決三類問題：
- 會話歸檔後還能恢復；
- 本地會話記錄可以真正刪除；
- 會話數據可以批量導出。
核心功能¶
歸檔與取消歸檔¶
插件支持歸檔會話，並支持一鍵全量歸檔。歸檔後，會話記錄仍然保留，只是從側邊欄列表中隱藏。
與單純歸檔不同，插件也提供取消歸檔能力，支持：
- 單個會話取消歸檔；
- 按工作區批量取消歸檔；
- 按月份批量取消歸檔。
真正刪除本地聊天記錄¶
插件提供刪除本地聊天記錄的能力，會刪除磁盤上的會話日誌文件：
session.jsonl
session.jsonl.zstd
以及對偶文件。
執行“刪除所有聊天”時，運行中的會話會自動跳過，避免會話仍在活躍狀態下日誌被重新寫回。
批量導出會話數據¶
插件支持一鍵批量導出會話數據，會逐個生成與官方格式一致的 ZIP 歸檔：
dsh-session-<id>.zip
這適合在刪除前做備份，也適合把歷史會話整理後遷移到其他位置。
查看已歸檔聊天¶
打開管理窗口後，可以按工作區或月份分組查看已歸檔聊天。
支持以下操作：
- 按創建日期排序，可升序或降序；
- 按更新日期排序，可升序或降序；
- 分組摺疊與一鍵展開；
- 按組批量取消歸檔；
- 按組批量刪除該組已歸檔的聊天。
界面語言¶
插件界面爲中英雙語，並隨 DSH 的語言設置即時切換。
安裝與啓用¶
前置要求¶
- Node.js，含 npm；
dsh plugin依賴 pnpm。
DSH 插件通過 profile 掛載，dsh web 對應 web profile。安裝完成後，需要重啓 dsh web 才能看到新入口。
全局安裝 dsh 時¶
如果本機已經可以直接使用 dsh 命令，執行：
dsh plugin --profile web add dsh-session-management
通過 npx 運行 dsh 時¶
如果平時通過 npx @deepseek-ai/dsh 啓動 DSH，執行：
npx -y @deepseek-ai/dsh plugin --profile web add dsh-session-management
安裝完成後，重啓：
dsh web
打開「設置」，看到「會話管理」入口，說明插件已生效。
版本問題¶
如果安裝後仍提示舊版本相關問題，例如出現 declares no dsh.bundle，可以先查詢 npm 上該包的最新版本號，再顯式指定版本重裝。全局安裝 DSH 時可以用類似命令：
dsh plugin --profile web add dsh-session-management@<版本號>
通過 npx 運行 DSH 時，在前面加上 npx 前綴：
npx -y @deepseek-ai/dsh plugin --profile web add dsh-session-management@<版本號>
卸載¶
執行：
dsh plugin --profile web remove dsh-session-management
然後重啓 dsh web。
典型用法¶
下面是一組常見的操作順序。
1、安裝插件並重啓 dsh web。
2、打開「設置」，進入「會話管理」。
3、點擊「管理」，打開已歸檔聊天管理窗口。
4、選擇查看方式：
- 按工作區查看，適合多個工作區並存的情況；
- 按月份查看，適合按時間整理歷史會話。
5、如果只是想先隱藏會話，可以使用一鍵歸檔全部會話。記錄會保留，只是從側邊欄列表中隱藏。
6、如果需要清理本地記錄，可以先執行「導出數據」，生成與官方格式一致的 ZIP 歸檔。
7、確認備份完成後，再執行「刪除所有聊天」。運行中的會話會被跳過。
8、如果之前誤歸檔，或只想處理某一組會話，可以在管理窗口裏按組批量取消歸檔，或刪除該組已歸檔的聊天。
適用場景與注意¶
適合以下使用場景：
- 長期使用 DSH Web，會話數量較多；
- 歸檔後仍需要恢復會話；
- 需要真正刪除本地聊天記錄；
- 需要批量導出會話數據；
- 希望按工作區或月份管理歷史會話。
使用前注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證； - 刪除操作會移除本地會話日誌文件，執行前建議先導出數據；
- 運行中的會話會被跳過，不能直接刪除；
- 刪除父會話不會級聯刪除子代理會話，子代理會話是獨立記錄，可以單獨刪除；
- 聊天中的圖片附件採用 content-addressed 存儲，可能被多個會話共享，刪除會話不會連帶刪除附件。
鏈接¶
社區目錄：
https://www.skillhub.cn/plugins/cokiscarazo-rgb/dsh-session-management
GitHub：
