前言¶
如果你已經在 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