Plugin Porter · DSH 插件搬家工具

把 DSH 的插件、配置、记忆、会话，打包带走。 换电脑、换 profile、给别人分享工作环境——一个包搞定。

Plugin Porter is a plugin migrator / backup tool for DeepSeek Harness (DSH): export a migration bundle, import it on another machine, copy plugins to a different profile, or move the whole environment — config, memory, sessions, attachments, plugin sources — in one checksummed, multi-volume archive. Cross-machine, cross-profile, one command.

---

这东西解决什么问题

装了几十个插件、调了半天配置、攒了几百条记忆——换台电脑全没了。这个插件就是干这个的。

你的处境	它怎么帮你
买了新电脑，不想重装一遍插件	整机迁移：一个包，配置/记忆/会话/插件全带走
只想把某几个插件搬到另一台机器	迁移包：勾选 → 导出 → 那边导入
想让同事体验你的插件组合	全量整合包：连"怎么装、有什么坑"一起打包，附一段提示词
想试试 headless 模式又不想重装	搬到别的 profile：一键复制过去

---

三分钟装好

方式 A：从设置里装（推荐）

1. 打开 DSH → 设置 → 插件 → 添加插件

2. 填这一行：

   github:chenzhihan1751-cyber/dsh-plugin-porter
   

3. 装完重启 DSH（关窗口，再双击图标）

4. 设置里多出一个 「插件迁移」 页

方式 B：下载 zip 手动装

1. 点右上角 Code → Download ZIP
2. 解压到任意目录（比如 D:\plugin-porter）
3. 双击目录里的 install.bat
4. 重启 DSH

装不上？见 FAQ。

---

五个功能，一眼看懂

打开 设置 → 插件迁移，面板上一排五个区块：

#	功能	一句话
①	导出迁移包	勾选插件 → 打包成一个 zip
②	导入迁移包	选包 → 恢复到本机
③	搬到别的 profile	web → headless，插件复制过去
④	全量整合包	连"怎么装、有哪些坑"一起打包
⑤	整机迁移	配置+记忆+会话+插件，换电脑用一个包

---

① 导出迁移包

什么时候用：只想搬插件，不想搬别的。

1. 左侧列表勾选要带走的插件
2. 右侧选输出目录（点 选择目录… 有可视化浏览，不用手打路径）
3. 点 导出迁移包

产出一个文件夹 + 一个 zip：

plugin-migration-20261018-1430/
├── manifest.json        ← 清单：有哪些插件、版本、来源
├── restore.mjs          ← 恢复脚本（包自带，换电脑不用先装本插件）
├── restore.bat          ← Windows 双击也能跑
└── plugins/
    └── dsh-xxx/         ← 本地插件连源码一起打包

远程插件（从 npm / GitHub 装的）只记版本号，恢复时自动重新拉取，包体很小。

---

② 导入迁移包

最省事的做法：把整个包拷到新电脑，双击包里的 restore.bat。

想先看看会发生什么（推荐）：

node restore.mjs --list

包里 6 个插件：
  dsh-ai-memory        0.9.2   本地源码
  dsh-cost-meter       0.4.1   本地源码
  dshmarket            1.66.9  npm
  ...

预览（不写任何文件）：

node restore.mjs --profile web --dry-run

确认没问题再真正恢复：

node restore.mjs --profile web --root D:\我的插件

也可以回到 DSH 界面里做：插件迁移 → ② 导入迁移包 → 选择包…（zip 或文件夹都行）→ 导入。

恢复完必须重启 DSH，插件才会真正加载。

---

③ 搬到本机另一个 profile

什么时候用：你平时用 web，想再开一个 headless 跑后台任务，插件想复用。

1. 勾选插件
2. 在 ③ 区块填目标 profile（比如 headless）
3. 点 复制到目标 profile

它会做三件事：写依赖声明、建目录链接、迁移 patch 条目（自动按 id 去重，不会造成启动崩溃）。

---

④ 全量整合包：把"使用经验"也打包

什么时候用：把环境交给一台全新的 DSH，或者分享给别人。

跟 ① 的区别：① 只给"插件本体"，对方还得自己摸索怎么装；④ 把踩过的坑、搭建步骤、提示词一起抽出来。

点 ④ 全量整合包 → 生成整合包（后台），跑完得到：

文件	内容
PROMPT.md	一段提示词，整段粘给新 DSH 的对话框，它自己照着搭
TRICKS.md	通用踩坑总集
catalog/插件名.md	每个插件一页：功能、依赖、装配要点、版本变迁
plugins/ + restore.mjs	插件本体与恢复脚本

用法：新机器上装好 DSH → 开个对话 → 粘贴 PROMPT.md 全文 → 它自己开工。

---

⑤ 整机迁移：换电脑的终极方案

什么时候用：真的换机器了，想把这一整套环境原样搬过去。

勾选范围（三档）：

档位	包含	体积
essential	配置 + 记忆 + 技能	最小，够用
standard	上面 + 会话 + 附件 + 插件源码	日常推荐
everything	上面 + 整个工作区	可能几个 GB

点 生成整机迁移包，它会：

• 打成分卷（默认每卷 1.8GB，方便网盘/U 盘传）
• 每卷附 sha256 校验清单（传坏了能发现）
• 包内自带 恢复-DSH.bat / restore-dsh.mjs

新电脑上：解压 → 双击 恢复-DSH.bat → 按提示选目标目录 → 完事。

⚠️ 包里含 API 密钥。要传给别人的话，先只选 essential，或者手动删掉密钥段。

---

迁移包里到底装了什么

manifest.json    清单（版本、来源、校验和）
restore.mjs      恢复脚本 —— 纯 Node，不依赖本插件
restore.bat      Windows 双击入口
plugins/         本地插件的源码快照

关键点：恢复脚本跟着包走。所以新电脑上不需要先装 Plugin Porter，直接 node restore.mjs 就行。

---

安全吗

它可能碰到	保护措施
profiles/<名字>/package.json	改之前先存 package.json.bak-时间戳
profiles/<名字>/cordis.patch.yml	先备份；按 id 去重，防 duplicate loader entry id 启动崩溃
你的插件源码目录	目标已存在就原样保留，要覆盖必须显式加 --force
导出的包	只新建目录，不覆盖已有同名目录

它不碰 DSH 主程序代码，也不改你的插件源码（导出时只给快照副本补字段）。

---

启动体检：装完先自检

DSH 新版本对插件有个硬要求：每个插件必须在 package.json 里声明 dsh.bundle.patch，缺了启动直接失败。

面板上的 「启动体检」 按钮 = 用 DSH 自己的加载逻辑先跑一遍，不用重启就知道下次启动会不会挂。

也可以用命令行：

node tools/check-profile-boot.mjs --profile web

退出码 0 = 没问题，非 0 = 启动会失败（会告诉你是哪个插件）。

真出问题了，面板上有 「修复选中：dsh.bundle」，一键补齐并备份原文件。

---

恢复后怎么生效

重启 DSH。桌面版：关掉窗口，再双击图标。

重启前设置页里只是列表刷新了而已，插件代码还没加载。

---

FAQ

Q：装完设置里没看到「插件迁移」？ 重启 DSH。插件的 UI 是启动时挂载的，热更新不覆盖这一层。

Q：导入后插件列表有了，但功能没生效？ 同上，重启。列表刷新 ≠ 插件加载。

Q：恢复脚本报 Cannot find module？ Node 版本太低。要求 Node ≥ 22：node -v 看一下。

Q：包传过去 sha256 对不上？ 传输过程损坏（网盘/U 盘常见）。重新传那一卷，别硬解压。

Q：会覆盖我现有的插件吗？ 不会。目标目录已存在时保留原样；要覆盖得自己加 --force。

Q：能只导出某一个插件吗？ 可以，列表里只勾那一个就行。

Q：和「插件市场」有什么区别？ 市场负责装新插件，这个负责搬已有的。两者不冲突，可以同时装。

---

开发者

• 零构建：lib/ 里的 JS 就是源码，改完重启即生效
• 不 spawn 子进程：zip 用自带的 lib/zip.mjs 压缩/解压
• 实现细节、边界、设计取舍 → docs/INTERNALS.md
• Agent 工具：plugin_migrator_list / _export / _import / _copy

git clone https://github.com/chenzhihan1751-cyber/dsh-plugin-porter.git
cd plugin-porter
node install.mjs        # 装进本机 DSH

---

License

BSD-3-Clause