前言¶
如果你已经在 Codex、Claude Code、Qoder 或 OpenCode 中积累了一些配置信号和会话历史，并准备在 DeepSeek Harness 中继续工作，手动复制往往有几个风险：可能误改源文件，可能把凭据带到新环境，也可能在未审查的情况下自动套用 MCP 配置。
下面介绍 DeepSeek Harness External Migration。它是一个 DSH 插件，用于把上述来源中的配置信号和会话历史迁入 DeepSeek Harness，并在导入前保留人工确认环节。
这是什么¶
DeepSeek Harness External Migration 的定位是外部智能体历史迁移工具。它提供三个模型侧工具：
external_migration_scan：只读盘点来源，不返回会话正文，不返回凭据，不写入。external_migration_preview：只读解析，并给出简短的会话预览。external_migration_import：要求confirm=true后写入原生 Harness 会话，并导出可审查的配置包。
该插件不修改来源文件，不复制凭据。MCP secrets 会被替换为环境变量引用，生成的 MCP 配置不会自动应用。
仓库许可证为 MIT。
安装与启用¶
安装前需要确认环境满足：DeepSeek Harness 0.1.0-rc.5 或兼容的后续版本，以及 Node.js 22.19+ 或 24+。
使用本地包安装：
dsh plugin --profile web add /absolute/path/deepseek-harness-external-migration-0.1.0.tgz
这个包声明了 dsh.bundle.patch，所以 dsh plugin 会把它作为 profile layer 激活。安装后重启对应 profile。
如果你从源码校验插件包，可以运行：
npm install
npm test
npm pack --dry-run
典型用法¶
经过上面的步骤，在 Harness 中按顺序请求处理目标来源：
1、先调用 external_migration_scan，确认有哪些可迁移来源。
2、再调用 external_migration_preview，查看简短解析结果。
3、最后调用 external_migration_import，并传入 confirm=true，完成写入。
默认情况下，可审查的配置包会写到：
$DSH_HOME/migrations/external-agents/
导入前，先检查这个目录中的配置包，再决定是否在 Harness 中使用相关配置。
适用场景与注意¶
这个插件适合需要把已有智能体工具中的配置信号和会话历史迁入 DeepSeek Harness 的使用者，尤其是希望“先盘点、再预览、最后显式确认导入”的场景。
需要注意几点：
- 该插件通过
dsh plugin激活，并以当前 DSH 进程所拥有的权限运行；安装前应检查源码、许可证和待迁移来源。 external_migration_import会写入原生 Harness 会话并导出配置包，因此必须显式传入confirm=true。- 生成的 MCP 配置只是导出供审查，不会自动应用。
- 凭据不会被复制，MCP secrets 会替换为环境变量引用。
- 来源文件不会被修改。
结尾¶
DeepSeek Harness External Migration 的价值在于把“跨工具迁移”拆成只读盘点、只读预览和显式导入三步，减少误改源文件、凭据扩散和配置自动套用的风险。
仓库地址：
https://github.com/buguoshixc/deepseek-harness-external-migration
