前言¶
在 DSH Web 中，會話歸檔後如果缺少集中管理入口，查看舊會話、篩選項目、預覽內容、取消歸檔或清理磁盤空間會比較分散。z953218350/dsh-archive-manager 是一個面向 DSH Web 界面的插件，用來集中管理歸檔會話。
下面介紹它的能力、安裝方式、典型用法，以及需要注意的數據刪除風險。
這是什麼¶
dsh-archive-manager 是 DSH 的一個 Web 插件，倉庫 owner 爲 z953218350，包名爲 @mlgbnb/dsh-archive-manager，許可證爲 MIT。
它爲 DSH Web 界面提供 Codex 風格的會話歸檔管理能力，主要用於在設置頁中查看、搜索/篩選、預覽、取消歸檔和徹底刪除歸檔會話。
核心功能¶
插件的能力集中在 DSH Web 的歸檔會話管理上：
- 在 DSH Web 界面設置頁中查看歸檔會話。
- 對歸檔會話進行搜索/篩選。
- 按工作區/項目分組展示會話。
- 支持刪除項目中的全部內容。
- 解析
session.jsonl.zstd與session.jsonl。 - 展示會話標題、創建時間、對話輪數、磁盤佔用。
- 預覽會話最近 50 條用戶/助手消息。
- 恢復會話並即時同步側邊欄。
- 物理刪除會話元數據及磁盤數據文件。
- 即時監聽側邊欄歸檔變動並同步列表。
- 內置基於 Node
zlib的 zstd 多幀解壓引擎，無需安裝zstd命令行工具。
安裝與啓用¶
先確認環境滿足要求：
- DSH
>=0.1.2-alpha.2 - 使用 Web Profile
- 使用 Node.js 內置
zlib package.json中聲明的peerDependencies包含react ^18.2.0
插件運行時讀取 DSH 的 storages/workspace.json、storages/session_projcache.json 和 sessions/ 目錄。數據目錄可以通過 DSH_HOME 指定，默認是 ~/.dsh。
下面用 DSH CLI 安裝。
1、使用當前包名安裝：
dsh plugin --profile web add -w @mlgbnb/dsh-archive-manager
2、如果希望固定版本，可以顯式指定 1.0.10：
dsh plugin --profile web add -w "@mlgbnb/dsh-archive-manager@1.0.10"
3、如果本地有插件目錄，也可以使用 link: 方式安裝：
dsh plugin --profile web add -w "link:/path/to/dsh/plugin/dsh-archive-manager"
安裝完成後，檢查 Web Profile 的 package.json，確認 dsh.profile.bundles 數組中包含 @mlgbnb/dsh-archive-manager。
如果執行 add 後啓動報錯，提示子包重複聲明，需要檢查 dsh.profile.bundles 數組，確保其中只包含根包，避免包含子組件包。
最後啓動 DSH Web：
dsh --profile web
或者：
dsh web
啓動後訪問：
http://127.0.0.1:3080/
進入：
設置 -> 插件
即可使用歸檔管理功能。
典型用法¶
經過上面的步驟後，常見操作如下：
1、進入設置頁，找到歸檔管理入口，查看歸檔會話列表。
2、按工作區/項目瀏覽會話分組，確認某個項目下有哪些歸檔會話。
3、搜索或篩選需要處理的會話。
4、查看會話元數據，包括標題、創建時間、對話輪數、磁盤佔用。
5、點擊預覽，查看會話最近 50 條用戶/助手消息。
6、如果只需要把會話恢復到原工作區，執行取消歸檔。恢復後會同步側邊欄。
7、如果確認不再保留該會話，執行物理刪除。該操作會刪除會話元數據及磁盤數據文件，並釋放存儲空間。
8、如果需要清理某個項目下的全部歸檔內容，使用項目級的刪除全部能力。
適用場景與注意¶
適合正在使用 DSH Web Profile，並且需要集中查看、預覽、恢復或刪除歸檔會話的開發者。
使用前需要注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 插件會讀取
storages/workspace.json、storages/session_projcache.json和sessions/目錄。 - 物理刪除會刪除會話元數據及磁盤數據文件，屬於不可逆操作。
- 刪除項目中的全部內容會影響該項目下相關歸檔會話。
- 如果
dsh.profile.bundles中混入了子組件包，啓動時可能出現重複聲明問題。
項目倉庫：
https://github.com/z953218350/dsh-archive-manager
