在构建或迁移智能体工作流时，积累的配置（MCP 服务器、技能、全局指令）往往难以直接复用。DeepSeek Harness (DSH) 作为一个插件化架构，需要将旧有环境（如 OpenAI Codex CLI / Desktop）的资产适配进来。直接手动迁移不仅繁琐，还容易遗漏细节。
codex2dsh 是一个 DSH 插件，由 BigBlueBaby 维护。它将 Codex 的 MCP 服务器、技能、全局配置、记忆以适配 DSH 的形式迁移进来。
核心功能¶
- 可视化迁移面板：提供图形化界面，用于查看状态、选择迁移项和执行操作。
- MCP 镜像生成：解析 Codex 的 MCP 服务器配置，生成可合并的 YAML 文件。
- 技能转换：将 Codex 的技能文件转换为 DSH 格式。
- 全局指令适配：适配
AGENTS.md等全局指令文件。 - 记忆迁移与导入：迁移 Codex 记忆，并支持导入至
dsh-mnemon引擎。 - 会话导入与标题回填：导入会话历史，并修复可能丢失的标题信息。
- 工作区归组：整理非工作区会话，统一归组。
- 迁移体检：检查迁移状态和资产完整性。
安装¶
安装插件：
dsh plugin --profile desktop add codex2dsh
安装后重启 DSH，即可在「设置 → 插件」中找到「Codex 迁移」面板。
典型用法¶
可视化操作¶
- 打开 设置 → 插件。
- 找到 「Codex 迁移」 标签页。
- 通过面板进行可视化操作，查看状态、预览或执行迁移。
命令行操作¶
codex2dsh preview # 预览可迁移资产
codex2dsh mcp --apply # 执行 MCP 迁移
codex2dsh doctor # 检查迁移状态
注意事项¶
- 源码安全：源码只读，不修改 Codex 配置。
- 密钥处理：密钥默认原样迁移（可脱敏），请勿提交公开仓库。
- 执行策略：默认 dry-run 预览，确认后执行。
- 配置合并：MCP 服务器配置需手动合并进 profile。
- 环境要求：仅支持 Node.js >= 22.13。
总结¶
该插件提供了从 Codex 到 DSH 的无缝资产迁移路径，适合需要保留旧有配置的开发者。
