🔁 Codex2DSH

把 Codex（OpenAI Codex CLI / Desktop）的 MCP 服务器、技能、全局配置、记忆，一键迁移进 DeepSeek Harness（DSH）—— 全程可视化操作，无需命令行。

🖥️ 可视化使用指南 · 📥 安装 · ✨ 功能 · 🔒 安全说明 · ❓ 常见问题 · 📚 文档

一句话：Codex 的配置是资产，不是牢笼。codex2dsh 帮你把多年积累的 MCP 服务器、技能、全局规则、记忆「翻译」成 DSH 原生形态——迁移全程可视化操作、源码只读、密钥按原样迁移、dry-run 预览、人工确认。

🖥️ 可视化使用指南（推荐）

打开迁移面板

安装插件并重启 DSH 后：

打开 设置 → 插件
找到 「Codex 迁移」 标签页
面板包含 5 个区域，从下到上操作即可完成迁移

面板功能一览

区域	功能
① 状态总览	源配置根路径、全部可迁移资产清单（MCP/技能/指令/记忆/会话）、迁移台账条数、凭据文件黄色警告
② 迁移选项	「密钥脱敏」开关（默认原样迁移，直接可用）、「随迁本地工具目录」开关（默认开）
③ 全量迁移向导	一键走完 1 预览 → 2 选择 → 3 执行 → 4 完成四步全流程（推荐首次迁移使用）
④ 分类迁移	7 张独立卡片：MCP 服务器、技能、全局指令、记忆、配置建议、会话导入、迁移体检——每张卡片有勾选清单 + 「预览 / 执行」按钮
⑤ 最近结果	最近一次执行的徽章式结果（已迁移=绿 / 跳过=灰 / 无效=红 / 预览=蓝）+ 警告列表

📥 安装

环境要求

Node.js ≥ 22.13
DeepSeek Harness dsh ≥ 0.1.x（本插件在 0.1.1-rc.2 实测）
本机已有 Codex 配置（~/.codex/，Windows 为 C:\Users\<你>\.codex\）

方式一：npm 包安装（推荐）

# DSH Desktop 用户（desktop profile）：
dsh plugin --profile desktop add codex2dsh

# 或 dsh CLI / Web profile 用户：
dsh plugin --profile web add codex2dsh

安装后重启 DSH，即可在「设置 → 插件」看到「Codex 迁移」面板。

方式二：本地开发 / 试用最新版

dsh plugin --profile desktop add -w link:D:/Projects/codex2dsh   # 替换为你的项目路径

卸载：dsh plugin --profile <name> remove codex2dsh，已迁移的资产不会被删除。

✨ 功能

能力	入口	说明
🖥️ 可视化迁移面板	设置 → 插件 → Codex 迁移	状态总览 + 迁移选项 + 全量迁移向导（预览→选择→执行→完成）+ 分类迁移卡片 + 结果徽章
全量迁移向导	面板「开始全量迁移」	四步向导一键迁移全部资产，逐步展示进度与结果
MCP 镜像	面板 MCP 卡片 / `migrate_codex_mcp`	解析 `config.toml` 的 `[mcp_servers.]` 生成可合并的 DSH MCP client YAML；密钥默认原样迁移（可选脱敏）；`include/exclude` 选择性迁移；本地工具目录（如 mcp-toolbox）随迁并重写路径*
技能转换	面板技能卡片 / `migrate_codex_skills`	`~/.codex/skills/<name>/SKILL.md` → DSH 技能资产（frontmatter 适配 `kind: dsh`），脚本目录随迁，冲突自动消歧、幂等跳过；支持按前缀批量排除（如 `ccpanes-`）
全局指令	面板指令卡片 / `migrate_codex_instructions`	`AGENTS.md` / `instructions.md` → DSH 指令资产（原文完整保留），项目级规则给出挂载建议
记忆迁移	面板记忆卡片 / `migrate_codex_memory`	Codex 记忆（含 sqlite 只读探测）→ DSH 记忆资产，不可读时降级报告
配置建议	面板配置卡片 / `migrate_codex_config`	模型 / Provider / 权限 / 项目信任 → 只读建议片段（绝不自动改 `settings.yaml`）
会话导入	面板会话卡片 / `migrate_codex_sessions`	统计会话规模并委托 `import_codex`（dsh-chat-import）导入为可续聊会话
迁移体检	面板体检卡片 / `codex2dsh_doctor`	逐资产状态：已迁移 / 待迁移 / 不可迁移 / 密钥残留
命令行	`codex2dsh`	无 GUI 环境的同能力 CLI：`preview / mcp / skills / instructions / memory / config / sessions / doctor / ledger`

🔧 命令行（可选）

codex2dsh preview                      # 只读预览全部可迁移资产
codex2dsh mcp --apply                  # 生成 MCP 镜像（密钥默认原样；--mask-secrets 脱敏）
codex2dsh skills --apply --exclude ccpanes-*   # 技能迁移（排除 ccpanes）
codex2dsh doctor                       # 迁移体检
codex2dsh ledger                       # 查看迁移台账

🔒 安全说明

承诺	说明
源码只读	`~/.codex/**` 任何文件永不写入、永不移动、永不删除
密钥原样迁移（默认）	为让迁移后配置直接可用，`password/token` 等敏感值按原样写入产物；产物含真实凭据，请勿提交公开仓库；面板「迁移选项」可一键切换为脱敏（`****`）
凭据文件不触碰	`auth.json`、`.codex-global-state.json` 等只报告存在，不读取、不迁移
默认预览	一切写盘操作默认 dry-run，确认后才执行
profile 不自动改	MCP / 配置只生成待审阅片段，由你人工合并，绝不自动修改
幂等不覆盖	目标已存在且内容不同时拒绝覆盖（需 force），防覆盖人工修改

❓ 常见问题

MCP 迁移后如何让 DSH 真正用上这些服务器？

迁移生成的是待审阅片段（如 ~/.dsh/codex2dsh/mcp-mirror.cordis.yml）。请把片段中的 - insert: dsh-mcp-client 块合并进 profile 的 cordis.patch.yml（~/.dsh/profiles/<你的profile>/cordis.patch.yml），然后重启 DSH。

我该用哪个 profile？

DSH Desktop 用户看「设置 → 关于/插件」里当前激活的 profile（通常是 desktop 或你切换后的 web）——插件要装到当前激活的 profile 才会出现在设置里。用 dsh plugin --profile <当前profile> add codex2dsh。

连接 MCP 服务器失败？

部分服务器（如 Google MCP Toolbox）的 stdio transport 走 NDJSON 而非标准帧格式，DSH 的 MCP 客户端可能连不上。此时可改用 HTTP 模式：toolbox serve 常驻 + 镜像配置 type: http（url: http://127.0.0.1:5000/mcp）。如遇此类问题，可在 Issues 反馈，我们会给出适配指引。

迁移后技能/指令去哪了？

技能 → ~/.agents/skills/<name>/（可用 DSH_AGENTS_HOME 覆盖）
指令 → ~/.agents/instructions/
记忆 → ~/.dsh/memories/codex/
MCP 镜像与台账 → ~/.dsh/codex2dsh/

卸载后数据会丢吗？

不会。插件从不自动删除已迁移资产；卸载只移除插件本身。

📚 文档

文档	内容
01-总体架构	项目目标、DSH 插件体系、技术栈
02-Codex配置解剖	Codex 配置全解剖（config.toml / skills / 记忆 / 凭据）
03-映射规范	逐项映射规范（MCP / 技能 / 指令 / 记忆 / 配置）
04-插件API参考	开发者：插件 API 与 client 注入契约
05-实现方案	开发者：模块划分与实现细节
06-测试与验收	测试策略与验收矩阵
07-发布与分享	开发者：npm 发布与社区市场收录
08-路线图	里程碑与需求清单
09-安全边界	安全承诺与密钥策略

🤝 参与

使用中发现问题或有新想法 → Issues
想直接上手 → CONTRIBUTING.md 与 docs/05-实现方案.md
版本历史 → CHANGELOG.md

📄 许可

MIT License —— 见 LICENSE。

⚠️ 免责声明：本插件只负责「翻译」配置，不承担目标服务器、凭据与访问策略的合规责任；迁移含密钥的 MCP 配置前请务必阅读 docs/09-安全边界.md。

codex2dsh

Установка

README