前言¶
DeepSeek Harness（DSH）桌面端會長期積累 JSONL 會話日誌。會話一多，列表變長，查找和清理都靠手工翻目錄，既慢也容易誤刪還在用的記錄。社區插件 dsh-session-archive 把「歸檔、恢復、搜索、按項目分組、永久刪除」收進 Settings → Archive Management（歸檔管理），並可選按保留期自動歸檔不活躍會話。下面介紹它是什麼、能做什麼，以及如何安裝與使用。
這是什麼¶
dsh-session-archive 是面向 DeepSeek Harness 的社區插件（非 DeepSeek 官方發佈或背書），維護者爲 ailawu0409，在 SkillHub 目錄中歸類爲「記憶」。它在 Harness 的 Settings 擴展裏增加會話歸檔管理能力：支持手動與自動歸檔、恢復、搜索與篩選排序、按項目分組，以及對永久刪除做會話 ID 與日誌身份校驗。
插件無遙測與第三方分析；設置與刪除審計記錄在本地 DSH profile 中維護。永久刪除會移除會話日誌目錄且插件不提供回收站或撤銷，重要會話應先導出或備份。
核心功能¶
依據倉庫 README，當前版本（package.json 爲 0.1.0）能力包括：
- 手動歸檔與恢復：在歸檔管理界面分別查看已歸檔與未歸檔會話；可將符合條件的未歸檔會話歸檔，或將已歸檔會話恢復爲可用。運行中、已固定或正在使用的會話可能被 DSH 拒絕操作。
- 自動歸檔（默認關閉）：在設置中開啓並選擇保留期後，對「不活躍且超過保留期」的會話掃描歸檔。默認保留期 30 天、默認掃描間隔 60 分鐘；界面提供 3、7、14、30 天選項。單次掃描最多處理 50 個候選會話。
- 掃描排除規則：自動掃描會跳過運行中、已固定、空白、當前加載、子智能體、不可用、已歸檔以及需要遷移的會話。
- 列表能力：搜索、篩選、排序，並按項目分組展示。
- 永久刪除：在已歸檔流程中提供，需確認；Host 校驗 session ID 與存儲日誌身份，拒絕存活或已固定的會話，隨後刪除會話日誌目錄並更新歸檔/工作區關係。
- 本地持久化：在 profile 內保存
plugin-state/session-archive.json（插件設置）與plugin-state/session-archive-audit.log（刪除審計，約 1 MiB 輪轉並保留一代舊文件）。設置界面支持中英文。
兼容性說明：需要支持 profile 插件與 Settings 擴展的 DSH 桌面端；本地開發與測試要求 Node.js 22+（初始發佈在 Node.js 24.17.0 上測試）。同一環境只應安裝一份該插件；若曾安裝開發包 @local/session-archive，需先移除再安裝本倉庫包，勿新舊並存。
安裝與啓用¶
在已配置 DSH CLI 的環境中執行官方安裝命令：
dsh plugin --profile desktop add github:ailawu0409/dsh-session-archive
安裝指定 Release 時可帶 tag，例如：
dsh plugin --profile desktop add github:ailawu0409/dsh-session-archive#v0.1.0
若仍保留舊開發包，先移除再安裝：
dsh plugin --profile desktop remove @local/session-archive
dsh plugin --profile desktop add github:ailawu0409/dsh-session-archive
重啓 DeepSeek Harness 後，打開 Settings → Archive Management（歸檔管理） 使用界面。
升級前建議備份重要會話數據，再次執行安裝命令拉取目標版本並重啓；變更見 Releases。卸載前請先關閉自動歸檔，再執行：
dsh plugin --profile desktop remove dsh-session-archive
卸載不會代爲永久刪除會話；profile 內設置與審計文件可能仍存在，需自行備份後手動清理。
典型用法¶
自動歸檔：進入歸檔管理設置，開啓自動歸檔並選擇保留期（如 7 天或 30 天）。只有滿足「不活躍 + 超過保留期」且不在排除列表中的會話纔會被納入掃描。
手動歸檔與恢復：在「未歸檔」「已歸檔」兩個標籤頁瀏覽列表，對 eligible 會話執行歸檔，或對已歸檔項執行恢復。
永久刪除：僅在已歸檔工作流中發起，按界面確認。操作前務必確認無需再用的日誌已備份；審計日誌可能包含 session ID 與本地路徑，提交公開 issue 前應脫敏。
適用場景與注意¶
適合長期在 DSH 桌面端做多項目、多會話開發的開發者：需要把歷史會話從主列表裏「收起來」而不是立刻刪盤，或需要按項目整理後再決定是否永久清除。
使用前請注意：
- 插件以當前 DSH 進程權限讀寫 profile 與會話存儲；安裝前應查看 GitHub 源碼 與 MIT License，自行評估是否滿足環境要求。
- Harness 擴展 API 可能在版本間變化；README 標明此爲非官方社區插件。
- 永久刪除不可通過插件撤銷；自動歸檔默認關閉，避免誤配後立即移動大量會話。
結尾¶
dsh-session-archive 把會話生命週期管理放進 Settings，在本地完成歸檔、恢復與受控刪除，並保留容量受限的刪除審計。目錄與說明見 SkillHub 插件頁，源碼與文檔見 GitHub：ailawu0409/dsh-session-archive。
