前言¶
DeepSeek Harness（dsh）會在本機 ~/.dsh/sessions 下以 Zstandard 壓縮的 JSONL 保存對話（session.v4.jsonl.zstd）。換機器、拷貝備份目錄或重裝後，你希望這些記錄重新出現在側邊欄並能續聊，而不是隻留在磁盤裏。
社區裏常見的 dsh-plugin-session-import 面向 claude-code、codex、reasonix、zcode 等外部工具導出，並不識別 dsh 自己的 v4 日誌。dsh-session-import-native（維護者 Felix-fyz，分類：記憶）專門處理 dsh 原生格式，從任意文件夾把日誌導入當前 profile。
這是什麼¶
dsh-session-import-native 是 dsh 插件：讀取 dsh 自己保存的會話日誌（session.v4.jsonl.zstd），導入後按原工作區掛到側邊欄，可立即點開繼續對話。Web UI 爲中文；Host API 與 /dsh-import 命令與界面語言無關。
- 倉庫：Felix-fyz/dsh-session-import-native
- 目錄頁：SkillHub 插件頁
- 許可證：MIT（見倉庫 README）
- 當前 package 版本：0.1.0（見
package.json）
核心功能¶
下面行爲均來自官方 README 說明。
導入範圍與格式
- 僅支持 v4 日誌（當前 dsh 寫出的
session.v4.jsonl.zstd）。 - 來源可以是默認目錄
~/.dsh/sessions，也可以是桌面上的sessions、sessions11、sessions - 副本等備份路徑，或單條日誌的完整文件路徑。
導入後會保留什麼
- 用戶/助手消息、思考、工具調用與結果、標題、輪次結構。
- 會話編號：每條記錄生成新的
session-<uuid>，不覆蓋已有會話；同一份日誌可重複導入。
工作區與側邊欄
- 若日誌裏記錄的
cwd在磁盤上仍存在，則導入到該工作區；否則落到默認工作區目錄並自動掛到側邊欄。
會丟棄或降級的內容
- 其他插件/版本的運行時事件（job、投遞迴執、重試標記、審批卡片、檢索請求等），避免舊版本詞彙導致回放失敗。
- 圖片與文件依賴另一份配置裏的附件 ID，導入時變爲
[圖片]/[附件：名稱]佔位文本。
去重提示
- 導入臺賬寫在
~/.dsh/session-import-native/imported.json；列表裏對已導入項顯示「已導入」徽標，仍可再次導入。
安裝與啓用¶
插件以 bundle 形式裝進當前 profile，安裝後由 HMR 生效；若改動過 Host 側代碼，需在插件管理裏關閉再打開該插件。
從本地已有源碼目錄安裝時，在 dsh 可用的環境中執行（路徑換成你的絕對路徑）：
plugin_manager install_bundle <絕對路徑>\dsh-session-import-native
若目錄來自 GitHub 倉庫的本地副本，同樣對上述克隆目錄使用 install_bundle：
plugin_manager install_bundle <克隆目錄的絕對路徑>
安裝前應自行查看倉庫源碼與 MIT 許可證。插件在 當前 dsh 進程的權限 下運行，導入時會讀取你指定的 sessions 目錄並寫入 profile 與會話數據，請只導入你信任的路徑。
典型用法¶
側邊欄
- 側邊欄底部點「⇩ 導入 DeepSeek 對話」。
- 選擇 sessions 目錄（默認可選
~/.dsh/sessions；常見備份名會自動列爲快捷位置）。 - 勾選要恢復的會話後導入。
- 也可在對話框裏直接輸入某一條
session.v4.jsonl.zstd的完整路徑。
命令
在支持 /dsh-import 的對話裏，可指定目錄或單文件（示例路徑來自 README，按你的環境替換）：
/dsh-import C:\Users\me\Desktop\sessions
/dsh-import C:\Users\me\Desktop\sessions\--C-...--\session-xxxx\session.v4.jsonl.zstd
經過上面的步驟，導入的會話會出現在側邊欄對應工作區下，結構與當前 dsh 會話一致，可直接續聊。
適用場景與注意¶
適合誰
- 需要在同一 profile 內恢復本機或備份裏的 dsh v4 會話，而不是導入 Claude Code 等外部工具記錄的用戶。
- 多工作區使用者：依賴日誌中的
cwd還原側邊欄分組；目錄已刪除時會落到默認工作區。
與同類插件的區別
dsh-plugin-session-import：外部 IDE/助手導出，不識別 dsh 原生session.v4.jsonl.zstd。- 本插件：只處理 dsh 自己在
~/.dsh/sessions體系下寫出的多幀 Zstandard JSONL 文件。
使用注意
- 附件無法按原 ID 還原，續聊時看到的是佔位文本。
- 舊版本運行時事件會被過濾，回放行爲以當前 dsh 爲準。
- 開發改 Host 需在插件管理裏重開插件；改 Client 需刷新頁面（本地
pnpm run dev:web時 HMR 可自動重載）。
結尾¶
若你的目標是「把 dsh 自己備份的 session.v4.jsonl.zstd 拉回當前環境並續聊」，而不是遷移其他產品的對話記錄，dsh-session-import-native 對得上這個需求。安裝與行爲以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/Felix-fyz/dsh-session-import-native
- GitHub：https://github.com/Felix-fyz/dsh-session-import-native
DSH 社區插件目錄由 SkillHub 等站點彙總，與 DeepSeek / 幻方無官方從屬關係；選用插件時請自行審閱源碼與權限影響。
