前言¶
在做 DSH / 智能體開發時，常見情況是：歷史會話已經存在於 claude-code、codex、reasonix、zcode 等工具裏，但想在 DSH 中繼續同一項目時，需要重新整理上下文。
dsh-plugin-session-import 解決的是這個遷移問題：把上述工具的歷史聊天記錄導入爲 dsh 會話，並帶上工作區綁定與工具能力，導入後可以直接續聊。
這是什麼¶
dsh-plugin-session-import 是 huguangyu666 維護的 DeepSeek Harness 插件，採用 MIT 許可證。
它面向已有本地會話記錄的開發者，將 claude-code / codex / reasonix / zcode 的聊天記錄轉換爲 dsh 可繼續使用的會話。
核心功能¶
會話導入¶
- 支持 claude-code、codex、reasonix、zcode 四種工具解析。
- 將歷史聊天記錄導入爲 dsh 會話，包含工作區綁定與工具能力。
- 導入後可以直接續聊。
會話發現與搜索¶
- 會話列表展示標題、項目名、消息數、時間。
- 掃描使用 30s 緩存。
- 按標題 / 項目名過濾搜索，輸入爲防抖。
批量導入¶
- 支持多選會話一次導入。
- 每個會話獨立 seed + 工作區綁定。
工具能力¶
- 導入會話自動加入默認 preset scope。
- 可用 25+ 工具，例如
read/edit/glob/grep/pwsh等，與正常會話一致。
超長會話保護¶
- 按順序執行：內容裁剪 → 消息截斷 → 單條兜底。
DSH_IMPORT_CONTEXT_BUDGET可覆蓋預算。
Web UI 與命令¶
- Web UI 側邊欄提供「⇩ 導入會話」按鈕，明暗主題自適應。
- 命令行支持：
/import <tool> <path>
文件或目錄均可傳入，目錄表示批量。
安裝與啓用¶
先檢查運行環境：
node >=22.5
插件聲明的依賴版本：
@deepseek-ai/dsh >=0.1.0-rc.6
@deepseek-ai/dsh-client-locale >=0.1.0-rc.6
react >=18.0.0
使用官方命令安裝：
dsh plugin --profile web add dsh-plugin-session-import
dsh web
第一條命令把插件加入 web profile，第二條命令重啓後生效。
也可以使用商店方式：
- 安裝
dsh-store。 - 打開「插件商店」搜索安裝。
典型用法¶
Web UI 導入¶
- 點擊側邊欄底部的「⇩ 導入會話」。
- 選擇工具。
- 搜索 / 滾動分批加載。
- 勾選會話。
- 導入。
命令行導入¶
示例：
/import codex C:\Users\xxx\.codex\sessions
傳入目錄時按批量處理。
適用場景與注意¶
適合已經有 claude-code、codex、reasonix、zcode 本地會話，並且希望在 DSH 中繼續後續任務的開發者。
使用前需要注意：
- 圖片附件會降級爲佔位文本，部分工具不支持 image block。
- 超長會話被截斷的歷史消息不保留，保留摘要與錨點。
- reasonix 桌面版部分會話標題依賴
.titles.json，缺失時回退文件名提取。 - 插件以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證。
- 許可證爲 MIT。
結尾¶
經過上面的步驟，可以把本地工具的歷史會話導入 DSH，並在導入後的會話中繼續任務。
GitHub 倉庫：
https://github.com/huguangyu666/dsh-plugin-session-import
插件線索中的目錄頁：
https://www.skillhub.cn/plugins/huguangyu666/dsh-plugin-session-import
