kol-mm/dsh-config-migrate

dsh-config-migrate

License
Syntax

English: README.en.md

DeepSeek Harness 配置迁移插件 —— 一键导出/导入 ${DSH_HOME} 配置（settings、凭据、profiles、external-plugins、agent presets），跨平台支持 Windows / macOS / Linux，专为「换新设备零折腾」设计。

功能

导出（export）
- 打包 ${DSH_HOME} 下的配置：
- 顶层：settings.yaml、settings.yaml.bak、.credentials.yaml、.anonymous-user-id
- 目录：profiles/、external-plugins/、.agent-presets/*
- 自动排除：node_modules、sessions、storages、.git
- 文本文件 UTF-8 直存；二进制资源（图片等）以 base64 打包，导出结果报告二进制数量
- profiles//package.json 里指向 external-plugins 的绝对 link: 路径自动改写为相对路径（link:../../external-plugins/），跨机器有效
- 凭据加密：可指定 password，对 .credentials.yaml 用 AES-256-GCM + scrypt 加密（node crypto），导出结果显示「凭据已加密」
- 依赖检测：扫描 external-plugins//package.json，识别 DSH 不自带的 npm 依赖写入 pluginDeps，导入前预警
- 可选：排除凭据（skipCredentials）、自定义输出路径、dryRun 预览清单

导入（import / importLast）
- 自动发现备份包：启动时扫描工作区 dsh-config-export.json，或读取 .dshmig-state.json 记住的自定义导出路径
- 一键导入（importLast）：直接恢复上次导出的备份，无需填路径
- 内容相同的文件自动跳过；覆盖前备份为 .bak-
- 写回后校验：文本回读比对、二进制校验字节数，失败进 verifyErrors 报告
- 加密凭据解密：检测到 encrypted 条目时用 password 解密；口令错误明确拒绝（不静默出垃圾数据）
- 外部插件自动恢复：
- 还原 external-plugins/*（含二进制资源）
- 重建 node_modules/@dsh-external/ 链接：Windows 用 junction，macOS/Linux 用符号链接
- 链接失败进 linkErrors 并提示（可能需要在新设备 pnpm install）
- v1/v2 兼容：旧备份包（link 为绝对路径）在导入时自动相对化
- 可选：仅恢复缺失文件（onlyMissing）、排除凭据、dryRun 预览

导出包结构示例

{
"format": "dsh-config-migration",
"version": 3,
"exportedAt": "2026-08-15T08:00:00.000Z",
"sourceHome": "C:\\Users\\xxx\\.dsh",
"platform": "Windows",
"pluginDeps": ["axios"],
"files": {
"settings.yaml":                       { "encoding": "utf8",    "content": "ui-onboarding: ..." },
".credentials.yaml":                   { "encoding": "encrypted", "payload": { "salt": "...", "iv": "...", "tag": "...", "data": "..." } },
"profiles/web/package.json":           { "encoding": "utf8",    "content": "{ ... \"link:../../external-plugins/...\" ... }" },
"external-plugins/.../assets/x.webp":  { "encoding": "base64",  "content": "UklGRi4B..." }
}
}

使用方式

方式一：动态插件（推荐快速体验）
在 DeepSeek Harness 会话中通过 Cordis 动态插件机制加载 host.js / client.js（见「代码结构」），运行后：
- 设置面板：设置 → 「配置迁移」页面，含导出/导入/预览、DSH_HOME 覆盖、凭据与仅缺失选项、口令加密
- 模型工具：dsh_config_migrate（action: status/export/import/importLast）

方式二：作为外部插件部署
将本仓库放入 ${DSH_HOME}/external-plugins/ 并在 profile 的 package.json 中引用（参考 @dsh-external 的链接方式）。

代码结构

| 文件 | 说明 |
| --- | --- |
| host.js | Host half：RPC handlers（config/status、config/export、config/import、config/importLast）+ 动态工具 dsh_config_migrate |
| client.js | Client half：设置页「配置迁移」UI（settings.section 槽位） |
| .github/workflows/syntax-check.yml | CI：new Function() 包裹校验两个函数体的语法 + package.json 合法性 |

两个 JS 文件均为 Cordis 插件函数体（return { apply(ctx) { ... } }），可直接作为动态 Package 的 code.host / code.client 加载。

跨平台实现要点

- 无 process.platform 可用（沙箱），平台由路径推断：含盘符/反斜杠 → Windows，否则 Unix
- 路径分隔符按目标平台自动选择
- 二进制写回与链接重建统一走 node（subprocess 中 powershell.exe/openssl 不一定可用）：Buffer.from(base64) 解码、fs.symlinkSync(type: junction|dir) 建链接
- 凭据加密/解密用 node crypto（AES-256-GCM + scrypt）
- 迁移包本身平台无关：Windows 导出 → Mac/Linux 导入均可

安全说明

- 导出默认包含凭据（.credentials.yaml）；可用 password 加密或 skipCredentials 排除
- 加密条目为 encoding: "encrypted"，无口令无法读取；口令错误导入会被明确拒绝
- 导入写回 ${DSH_HOME}（会话工作区之外）使用完整访问权限，界面有明确提示
- 路径安全：拒绝 .. / 绝对路径逃逸条目

License

MIT