前言¶
DeepSeek Harness（DSH）把模型配置、插件、MCP 服務器、Skills、工作區等內容集中在一套環境裏。換電腦、重裝系統或要在多臺機器間保持一致時，逐項手動重裝和重配既費時，也容易漏掉路徑、密鑰或全局指令（如 AGENTS.md）。
常見做法是手寫腳本拷貝 ~/.dsh 目錄，或分別導出各子模塊配置。這類方式往往缺少完整性校驗、衝突處理和密鑰隔離，一旦中途失敗還可能把當前環境弄亂。
下面介紹 dsh-config-manager（維護者 xiajiajun516）。它是 DSH 生態中的 admin-security 類插件，在 SkillHub 社區目錄可安裝，GitHub 倉庫當前約 14 stars，許可證爲 MIT。插件把導出、導入、遷移、定時備份和遠程同步收攏到同一套流程裏，默認不導出 API Key 等敏感信息。
這是什麼¶
DSH Config Manager 是 DSH 的配置備份與遷移插件。安裝後，DSH 設置頁會出現「Backup & Migration」（備份與遷移）入口，用於把 settings、模型提供商、插件及其配置、MCP 服務器、Skills、Agent 預設、工作區和全局指令打包爲單個 ZIP，再在新機器上一鍵恢復。
插件同時提供 CLI（dsh-config-manager）和圖形界面，界面語言跟隨 DSH 應用語言（中文 / English）。
核心功能¶
導出與導入¶
支持兩種導出模式：
| 模式 | 說明 |
|---|---|
| Quick Export（推薦） | 一鍵打包設置、UI、模型、插件、MCP、Skills、Agent 預設、AGENTS.md、工作區等 |
| Custom Export | 按類別勾選需要導出的內容 |
導出流程爲：讀取配置 → 剝離密鑰 → 生成 manifest → 計算校驗和 → 打包爲 ZIP。輸出文件名形如 dsh-config-2026-08-14.zip，導出報告會確認包內不含密鑰。
導入前會先校驗文件完整性、schema 和兼容性，生成導入預覽，不會靜默修改現有配置。應用前自動備份當前環境；中途失敗會自動回滾。
衝突與路徑處理¶
導入預覽階段可逐項查看變更。存在衝突時，可選擇「保留當前」或「使用導入項」。插件會檢測失效的絕對路徑，支持批量前綴映射，便於跨機器遷移。
非加密導入時，被剝離的 API Key 等密鑰需在導入後按提示重新填寫；加密備份可用密碼恢復密鑰。
快照與回滾¶
每次導入前自動創建快照。導入失敗時自動恢復；也可在之後手動執行快照還原，包括卸載本次導入新增的插件（CLI 與 GUI 均支持）。
定時備份¶
可開啓定時全量備份，間隔支持 6h、12h、24h、7d，或自定義每週星期與時間。定時備份同樣默認不含密鑰，可安全存放在本地磁盤。連續失敗時，設置卡片會以紅色高亮提示。
遠程同步¶
可通過私有 Git 倉庫或 WebDAV 推送 / 拉取可移植配置，密鑰不參與同步。
配置市場¶
內置官方配置市場，可瀏覽社區共享的模型提供商、插件、MCP、Skills、Agent 預設等配置。安裝前提供 dry-run 預覽，展示供應鏈警告，且每個分區需顯式確認後纔會寫入。
Profiles¶
支持保存多套配置方案（如 Work / Personal），切換時可預覽，並附帶自動備份與回滾。
Agent 工具¶
在 Agent 會話中可直接調用備份、快照、還原、同步等工具。
安裝與啓用¶
這是標準 DSH 插件，安裝分兩步：
# 安裝插件
dsh plugin --profile web add dsh-config-manager@latest
@latest 會解析到 npm 上的最新版本。若因 pnpm 11 的 minimumReleaseAge 策略裝到較舊版本，可指定確切版本安裝一次（例如 dsh-config-manager@0.1.8），或在 profile 的 pnpm-workspace.yaml 頂部添加 minimumReleaseAge: 0。
安裝完成後重啓 DSH，設置頁會出現「Backup & Migration」入口。
插件要求 Node ^22.19.0 || >=24.0.0，當前發佈版本爲 v0.1.54。
典型用法¶
單機備份¶
- 打開 DSH → Settings →「Backup & Migration」
- 點擊「Export Configuration」，選擇「Quick Export」
- 得到
dsh-config-YYYY-MM-DD.zip，查看報告確認無密鑰導出
跨機器遷移¶
在源機器（Machine A）完成導出後，將 ZIP 複製到目標機器（Machine B）：
- 打開 DSH →「Backup & Migration」→「Import Configuration」
- 選擇 ZIP，等待分析，查看「Import Preview」
- 如有路徑問題，選擇新路徑（支持批量映射）
- 如有衝突，選擇「Keep Current」或「Use Imported」
- 確認導入，等待完成
- 按提示重新輸入缺失的 API Key
- 設置、插件、MCP、Skills、工作區、AGENTS.md 等恢復完成
遠程同步¶
在「Backup & Migration」中配置 Git 私有倉庫或 WebDAV 端點，按需執行 push / pull，使多臺機器保持配置一致。
適用場景與注意¶
適合誰：
- 需要在 Windows、macOS、Linux 之間遷移 DSH 環境
- 希望定期自動備份完整配置，而非手動拷貝目錄
- 有多臺開發機，想通過 Git 或 WebDAV 同步可移植配置
- 想從配置市場快速安裝經過預覽的社區配置
安全注意：
- 默認不導出 API Key、Token、Password 等密鑰；這是設計行爲，不是遺漏
- 加密備份可選憑據保護；非加密導入需手動補填密鑰
- 配置市場安裝會展示供應鏈警告，需逐項確認
- 插件以當前 DSH 進程權限運行，安裝前應檢查 源碼 與 MIT 許可證，確認符合你的安全要求
鏈接¶
- SkillHub 目錄頁：xiajiajun516/dsh-config-manager
- GitHub 倉庫：xiajiajun516/dsh-config-manager
DSH 生態遵循「一切皆插件」的思路；SkillHub 是社區維護的插件目錄，與 DeepSeek / 幻方無官方從屬關係。dsh-config-manager 把備份、遷移、同步和配置市場集中在一處，適合需要完整搬遷或定期保全 DSH 工作環境的用戶。
