codex2dsh

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

打开迁移面板

安装插件并重启 DSH 后：

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

面板功能一览

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

推荐流程（首次迁移）

1. 看状态：打开面板先看「状态总览」——确认源配置根正确、了解有哪些资产、注意黄色凭据警告
2. 走向导：点「开始全量迁移」
   • 第 1 步 预览：查看各分类资产规模（零副作用）
   • 第 2 步 选择：勾选要迁移的分类；MCP 与技能可在下方分类卡片细化勾选
   • 第 3 步 执行：自动按 MCP → 技能 → 指令 → 记忆 → 配置 顺序执行，显示进度
   • 第 4 步 完成：查看每类结果汇总（成功 / 跳过 / 警告）
3. 细化选择（可选）：在「分类迁移」里
   • MCP 服务器：勾选要迁移的服务器（如只留 google-mcp-toolbox），本地工具目录会自动随迁并重写路径
   • 技能：勾选想要的技能；用「排除前缀」批量取消勾选整套技能（如输入 ccpanes- 排除全部 ccpanes 技能）
4. 收尾：迁移产物（如 mcp-mirror.cordis.yml）生成后，按产物中的提示人工审阅并合并进 DSH profile 即可使用（见 常见问题）

💡 每个「执行」按钮点击前都有确认框；所有写盘操作默认先「预览」，确认后再执行。

---