DSH 官方提供了 /export 導出功能，但缺乏配套的導入工具。dsh-session-import 插件填補了這一空白，允許將官方導出的 ZIP 或 JSONL 文件還原爲可繼續對話的會話。
插件簡介¶
插件名稱爲 dsh-session-import，歸屬於「記憶」類別，由維護者 kinyokun 提供，遵循 MIT 許可證。
核心功能¶
- 文件解析：支持解析
/export導出的 ZIP 或裸 JSONL 文件。 - 校驗機制：進行結構真實性驗證，並通過 SHA-256 指紋校驗文件完整性。
- 狀態同步：同步模型、預設、權限等狀態。
- 樹狀支持：支持整棵子會話樹、圖片與文件附件的導入。
- 實時交互：導入/刪除操作通過實時推送免刷新。
安裝與啓用¶
通過以下命令安裝插件：
dsh plugin --profile web add github:kinyokun/dsh-session-import
安裝後需重啓 dsh web 並刷新瀏覽器。
典型用法¶
- 在新會話頁面點擊「導入對話」。
- 選擇 ZIP 或 JSONL 文件。
- 查看校驗結果、子會話和附件數量。
- 選擇目標工作區。
- 點擊「開始導入」。
每次導入會生成新的會話 ID，重建包內父子關係，不覆蓋原會話。導入成功後，歷史消息、系統提示詞、模型和其他狀態事件均完整保留。
限制與注意¶
該插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 上傳大小最多 256 MiB。
- ZIP 解壓總量最多 512 MiB。
- 最多支持 256 個會話。
- 最多 4096 個 ZIP 條目。
- 最多 100 萬個邏輯事件。
- 不支持分卷、加密 ZIP、ZIP64 或符號鏈接。
恢復與校驗¶
結構校驗判斷官方運行時能否恢復日誌；SHA-256 用於比對文件指紋。恢復區位於存儲根目錄的同級，例如 ~/.dsh/sessions 對應 ~/.dsh/sessions-import-recovery/。
