前言¶
如果你同時用 Claude Code 和 DSH（DeepSeek Harness），大概遇到過同一個問題：會話歷史在一邊，技能、全局指令和項目記憶在另一邊。Claude Code 的會話是 JSONL 轉錄，技能和記憶散落在 ~/.claude 下的各個文件裏，換到 DSH 之後這些資產既不能直接續用，手動搬運也容易丟結構。
DSH 的理念是「一切皆插件」，claude2dsh 就是按這個思路做的一個遷移插件：讀 Claude Code 的會話與資產，寫入 DSH 的原生持久化；需要反向操作時，還能把 DSH 會話導回 Claude Code。下面介紹它的功能、安裝和典型用法。
這是什麼¶
claude2dsh 是 kirkchinese 維護的 DSH 插件，MIT 許可證，當前發佈版本爲 0.2.0-rc.5（release candidate，候選版本）。按 awesome-dsh-plugin 列表的收錄說明，它屬於 Sessions & Messages 分組。
一句話定位：將 Claude Code 的會話、技能、記憶與插件資產遷移爲 DSH 原生可續會話，並可在需要時把 DSH 會話導回 Claude Code JSONL。
兩個設計點值得先說清楚：
- 默認零配置：默認路徑不需要理解 profile 或 bundle 就能產生可見結果，危險的寫回默認顯式門控。
- 源目錄只讀：原始 Claude 目錄默認保持只讀；導出/同步默認寫入
$DSH_HOME下的安全副本；併發編輯時暫停而不是覆蓋任一側。
核心功能¶
會話導入¶
claude2dsh_import 把 Claude 會話遷移爲 DSH 原生會話事件，遷移後的會話可以被 DSH 檢查、回放和續用。執行後返回分類計數：previewed / imported / already / appended / skipped / failed，哪些條目已存在、哪些是新導入、哪些被跳過或失敗，一眼可見。
技能導入¶
claude2dsh_import_skills 把 Claude 技能複製爲 DSH 原生可發現資產，出現在 $DSH_HOME/skills 下，並進入 DSH 的技能發現流程。
全局指令遷移¶
claude2dsh_import_context 把用戶級的 ~/.claude/CLAUDE.md 遷入 DSH 全局指令。這一步先預覽再寫入，且不會覆蓋內容不同的 $DSH_HOME/AGENTS.md。
項目記憶遷移¶
claude2dsh_import_memory 把項目的 MEMORY.md 與 memory/*.md 變爲 DSH 可發現內容，每個項目對應創建一個 DSH 技能包。
導出與同步¶
方向反過來也行：把 DSH 會話導回爲可續的 Claude Code JSONL 轉錄。默認寫入 $DSH_HOME 下的安全副本，不碰原始 Claude 目錄。
瀏覽器 UI¶
以上能力在 dsh web 啓動的瀏覽器 UI 裏都有對應入口：Settings → Claude2DSH 提供遷移向導，覆蓋導入、導出、同步、合併。
安裝與啓用¶
環境要求：Node.js >=22.19.0、pnpm 和 dsh CLI。
dsh plugin --profile web add @claude2dsh/plugin@0.2.0-rc.5
dsh web
第一條把插件安裝進 DSH 的 web profile，第二條啓動瀏覽器 UI，終端會打印本地 URL，瀏覽器打開即可。
如果默認端口 3080 已被佔用，改用下面的命令，DSH 會換一個空閒端口並把 URL 打印在終端：
dsh web --port 0
如果克隆了倉庫，也可以用倉庫自帶的輔助腳本，效果相同：安裝到主 web profile 並在 DSH 默認本地端口 3080 啓動 UI。
bash scripts/install-claude2dsh.sh
典型用法¶
裝好後按嚮導走一遍即可：
1、打開 dsh web 打印的 URL，進入 Settings → Claude2DSH。
2、選擇界面語言，確認 Claude 會話目錄，可選包含 subagent/workflow 轉錄。
3、先點 Preview import。預覽是隻讀的，返回逐條的計劃和分類計數，此時還沒有任何 DSH 寫入。
4、檢查報告沒問題後點 Run import。導入成功的會話會出現在 DSH 的 Session sources 列表裏，可以直接續用。
嚮導的第一部分就是遷移指南，默認中文界面，英文可選。
適用場景與注意¶
適合的人：從 Claude Code 遷往 DSH、或兩邊並行使用的開發者，希望保留會話歷史而不是從頭開始；也適合把 Claude 的技能、全局指令和項目記憶當作資產整體搬進 DSH 的場景。
使用前注意：
- 0.2.0-rc.5 是候選版本，不是正式版。
- 原始 Claude 目錄默認只讀，導出/同步默認寫
$DSH_HOME下的安全副本，危險的寫回默認顯式門控；併發編輯時插件選擇暫停，而不是覆蓋任一側。 - README 中的 Awesome 徽章只表示被 awesome-dsh-plugin 列表（Sessions & Messages 分組）收錄；自動雷達 awesome-dsh-plugins 未將其標記爲 runtime-verified，徽章不代表這層驗證。
- 和所有 DSH 插件一樣，插件以當前 dsh 進程的權限運行。安裝前建議查看源碼與許可證（本項目爲 MIT），確認沒有問題再裝入常用 profile。
結尾¶
claude2dsh 做的事情很集中：把 Claude Code 一側的會話、技能、全局指令和項目記憶遷進 DSH，保持源目錄只讀，寫回顯式門控，遷移可以預覽，方向還可以反向。對於在兩套工具之間移動的開發者，這是一個把歷史資產帶走的直接辦法。
- 目錄頁：https://www.skillhub.cn/plugins/kirkchinese/claude2dsh
- GitHub：https://github.com/kirkchinese/claude2dsh
