前言¶

DeepSeek Harness（DSH）把用戶數據集中在安裝目錄下的 data\dsh-home，並通過目錄聯接把程序默認查找的位置指過去。一旦更新把某條聯接換成空目錄、或把程序裝到新路徑，界面會像剛安裝一樣空白，而真實數據往往還在原處。手動拷貝文件夾無法還原「聯接應該指向哪裏」這一層結構，遷移和恢復容易踩坑。下面介紹社區插件 dsh-travel-kit，它把對話、工作區、插件、配置以及聯接佈局一起打成可校驗的包，並附帶可讀報告。

這是什麼¶

dsh-travel-kit 由維護者 visitor257 發佈，在 SkillHub 上歸類爲 admin-security。定位是：對一臺機器上的 DSH 做完整打包（對話、工作區、插件與配置、憑證、界面狀態、目錄聯接結構），生成可讀報告；也可從包恢復，或遷移到另一臺電腦。當前 GitHub 倉庫星標爲 0；package.json 中版本爲 0.1.4，許可證 MIT，依賴 Node >=22。

DSH 側典型聯接關係如下（資料以 Windows 路徑爲例）：

~/.dsh                                         -> <安裝>\data\dsh-home
%APPDATA%\@deepseek-ai\dsh-desktop             -> <安裝>\data\electron-userdata
%LOCALAPPDATA%\dsh-dafeiyu                     -> <安裝>\data\dafeiyu-runtime

本插件把「結構」寫進報告與 layout/，恢復時不只知道文件在哪，還知道它們該怎麼指。

核心功能¶

安裝後提供四個工具，配套 skill dsh-travel-kit 會提示模型：先診斷再動手、恢復前先 dryRun、恢復後必須重啓 DSH。

包結構¶

導出目錄形如 DSH-Travel-<主機>-<時間>/：

DSH-Travel-<主機>-<時間>/
  report.md            人/agent 可讀的完整說明
  manifest.json        文件清單 + 哈希 + 統計
  data/dsh-home/       對話、工作區、profile 配置、插件啓用狀態、憑證
  data/electron-userdata/  窗口與本地存儲
  layout/layout.json   安裝路徑、聯接映射、環境變量
  layout/plugins.json  插件清單
  layout/workspaces.json 工作區清單

不打包 dsh-runtimes（可重建，按需下載）。默認打包各插件目錄下的 node_modules（資料稱約 235 MB），還原後不依賴 pnpm、換盤換路徑也能用；導出時可設 includeModules: false 得到約 12 MB 精簡包，但還原後需聯網重裝插件。

0.1.3 及更早的包不含 node_modules；還原到不同路徑時程序可能用 pnpm 重裝，而舊包內 node_modules/.modules.yaml 記錄舊機器絕對路徑，可能觸發 ERR_PNPM_UNEXPECTED_STORE。0.1.4 起還原時會清除該文件。

安全相關行爲¶

• 包內可能含明文 .credentials.yaml，不要外傳；travel_export 支持 includeCredentials: false 排除憑證。
• 恢復時會把現有數據改名留存爲 dsh-home.pre-restore-<時間>，不刪除原有內容。

安裝與啓用¶

官方 README 給出的安裝方式爲使用本插件的 .tgz 包（具體包文件名以你下載的發佈物爲準）：

dsh plugin --profile desktop add <本包>.tgz

安裝後重啓 DSH 生效。插件以當前 DSH 進程權限運行；安裝前應自行查看 GitHub 源碼 與 LICENSE，確認符合你的安全策略。

典型用法¶

建議按「診斷 → 導出 → 校驗 → 試跑恢復 → 正式恢復」順序操作。

1. 先看現狀：用 travel_status 確認安裝路徑、三條聯接是否正常，以及工作區、插件清單。
2. 導出：調用 travel_export 生成旅行包；需要對外分享或上雲時，考慮 includeCredentials: false；若接受還原後重裝插件依賴，可設 includeModules: false 縮小體積。
3. 遷移前校驗：在新環境或拷貝完成後，用 travel_inspect 覈對 manifest 與文件。
4. 恢復：先用 travel_restore 的默認 dryRun 看將要寫入的路徑與聯接計劃；確認無誤後再執行真正恢復，並重啓 DSH。

具體參數與調用方式以插件在 DSH 內暴露的工具爲準；詳細字段說明見包內 report.md 與倉庫 README。

適用場景與注意¶

適合：換機、重裝 DSH、盤符或安裝路徑變更、需要做可驗證的離線備份與災備的桌面 DSH 用戶。

注意：

• 旅行包含敏感配置時務必本地保管，勿隨意外傳。
• 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立生態信息源，與 DeepSeek / 幻方無官方從屬關係；安裝命令須使用資料原文形式，勿自行拼接未在文檔出現的 dsh plugin add github:... 寫法。
• 精簡包（不含 node_modules）還原後需網絡重裝插件；完整包體積較大，但更適合離線、換路徑場景。

結尾¶

dsh-travel-kit 解決的不只是「拷文件」，而是把 DSH 依賴的聯接佈局一併備份與恢復，並用 manifest 與報告讓人和 agent 都能覈對內容。需要進一步瞭解分類與簡介時，可打開 SkillHub 目錄頁；實現細節與版本說明以 GitHub 倉庫爲準。

• 目錄頁：https://www.skillhub.cn/plugins/visitor257/dsh-travel-kit
• GitHub：https://github.com/visitor257/dsh-travel-kit