dsh-conf-sync
一键在设备之间导出/导入 DSH 和任意软件配置文件（局域网 / 本地存档 / Alist WebDAV）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:6027-gthb/dsh-conf-sync#38077b867bbb77e117f2f1d230830b9680fa54ceConf Sync 以 dsh-conf-sync 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一键导出 / 导入 DeepSeek Harness（DSH）及任意软件的配置文件，在其他设备之间迁移"设置及一切参数"。支持三种传输通道：
| 通道 | 说明 | 典型场景 |
|---|---|---|
local | 写入/读取本地 .tar.gz 快照 | 移动硬盘 / U盘 / 直接拷贝到另一台机器 |
http | 本机起一个临时 HTTP 服务器，打印 URL | 同一局域网内两台设备秒传 |
webdav | 推送到 / 拉取自 Alist / Nextcloud WebDAV | 云盘中转，跨网络、跨地域 |
快照是标准的 .tar.gz，内含 dsh-conf-sync-manifest.json 清单与原路径映射。
# ① GitHub 仓库安装（推荐 · 多设备复用，需提交到 GitHub）
dsh plugin --profile web add github:你的用户名/dsh-conf-sync
# ② 本地 tarball 安装（免发布，单机最快）
dsh plugin --profile web add ./dsh-conf-sync-0.1.0.tgz
# ③ 作为 npm 包安装（若已发布）
dsh plugin --profile web add dsh-conf-sync
# 验证已挂载
dsh --profile web --dump-config
从 GitHub 安装会拉取源码，DSH 会自动运行包的
prepare/build脚本编译lib/；若 pnpm ≥ 10 首次安装拒绝运行构建脚本，请在 profile 的pnpm-workspace.yaml中添加allowBuilds授权（按报错提示复制 key）。安全建议：安装时锁定提交github:你的用户名/dsh-conf-sync#<完整commit-sha>。
前置：Node.js
^22.19.0 || >=24、pnpm（npm install -g pnpm）。开发预览期官方会有破坏性变更，若接口变动请以dsh --dump-config实际输出为准。
在 profile（或 $DSH_HOME/cordis.patch.yml）里为插件装配配置。默认已捕获 DSH 自身配置（$DSH_HOME 或 ~/.dsh、~/.config/dsh），可按需追加其他软件：
- id: dsh-conf-sync
config:
targets:
- name: DeepSeek Harness
patterns:
- C:\Users\you\.dsh
- C:\Users\you\.config\dsh
- name: VS Code
patterns:
- C:\Users\you\AppData\Roaming\Code\User\settings.json
- C:\Users\you\AppData\Roaming\Code\User\keybindings.json
outputDir: D:\backups\conf
httpPort: 3088 # 可省略，0=随机端口
webdav:
url: https://alist.example.com/dav/snapshots/
username: admin
password: 'your-token'
noBackup: false # true 则导入时直接覆盖、不备份
提示：用
dsh --profile web --patch ./overlay.yml <任务>可临时叠加配置进行调试，不影响正式 profile。
# 1) 写成本地文件
dsh_conf_export channel="local" output="D:\backups\conf\snap.tar.gz"
dsh_conf_export channel="local" # 省略 output，自动生成到 outputDir
# 2) 起局域网 HTTP 服务器，拿到分享 URL
dsh_conf_export channel="http" port=0
# 3) 推送到云盘（Alist WebDAV）
dsh_conf_export channel="webdav" name="my-machine"
导出的结果里会包含 location（路径 / URL / 远端名）、文件数与来源主机名。HTTP 通道会打印一条分享 URL。
originalPath 由 manifest 自动定位）dsh_conf_import channel="local" source="D:\backups\conf\snap.tar.gz"
dsh_conf_import channel="http" source="http://192.168.1.5:3088/snapshot-xxx.tar.gz"
dsh_conf_import channel="webdav" source="my-machine"
# 只恢复匹配的路径（正则，可选）
dsh_conf_import channel="local" source="...tar.gz" pattern="settings.json"
# 覆盖式导入（不做备份）
dsh_conf_import channel="local" source="...tar.gz" backup=false
导入时默认会把已存在的目标文件备份为 <路径>.bak-<时间戳>，再写入。
dsh_conf_close # 关闭本机所有 dsh_conf_export channel=http 启动的临时共享服务器
HTTP 服务器默认随插件卸载 / DSH 退出自动关闭，
dsh_conf_close用于运行时及时回收。
targets 展开 glob → 每个文件复制到临时目录（files/<i>），生成 manifest（含原绝对路径映射）→ 用 tar + gzip 打成 .tar.gz。files/<i> 写回 originalPath（按需备份）。tar 天然拒绝 .. 越界路径，保证安全。npm install
npm run typecheck # tsc --noEmit
npm run build # 产出 lib/
npm run pack # 构建 + 打 tarball
node ./scripts/smoke.mjs # 三条通道的端到端冒烟测试
dsh-conf-sync/
├── package.json # 声明 dsh.bundle → cordis.patch.yml，自动进 bundle 层
├── cordis.patch.yml # bundle patch：按行 id 插入插件
├── tsconfig.json
├── src/
│ ├── index.ts # 插件入口：name/inject/Config/apply + 3 个工具
│ ├── types.ts # 配置与 manifest 类型
│ ├── glob.ts # glob / 目录展开
│ ├── archive.ts # tar.gz 打包 / 解包 / 回写（含备份）
│ └── channels.ts # local / http / webdav 三个通道
└── scripts/
├── smoke.mjs # 端到端冒烟测试
└── davtest.mjs # WebDAV 通道单独测试
.tar.gz，若含令牌请通过私有 WebDAV / 局域网传输，勿走公开网络。MIT