English
dsh-codex-port
Codex 全家桶，一条命令进 DSH：实测 186 插件、583 技能、移植 577 个 0 失败。
把 Codex 官方插件全家桶一键搬进 DSH：扫描 ~/.codex 里的解包插件与插件缓存，把它们的技能批量移植为 DSH 技能（frontmatter 自动转换、codex 专属文件剔除、名称清洗、幂等跳过）。
本机实测：186 个 Codex 官方插件、583 个技能，一次移植 577 个成功、0 失败。
兼容性
已在官方 @deepseek-ai/dsh@0.1.5-rc.1、Node 24.16.0 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 cordis.patch.yml + dsh.bundle.patch 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
安装
dsh plugin --profile web add dsh-codex-port
需要本机装有 Codex CLI（~/.codex 目录存在即可）。
卸载
dsh plugin --profile web remove dsh-codex-port
卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile cordis.patch.yml 中覆盖的插件行。
配置
全部可选，默认即可用：
- id: codex-port
name: 'dsh-codex-port'
config:
# codexHome: C:\Users\you\.codex # Codex 家目录（默认 ~/.codex）
# targetDir: C:\Users\you\.dsh\skills # 目标技能目录（默认 <DSH_HOME>/skills）
# overwrite: true # 覆盖同名技能（默认跳过）
工具一览
| 工具 | 作用 | 关键参数 |
|---|
codex_list | 列出发现的 Codex 插件与技能 | plugin/skill 过滤，limit 1-200 |
codex_port | 批量移植为 DSH 技能 | plugins/skills 过滤，targetDir，overwrite |
codex_status | 对比源与目标：已移植/未移植统计 | 无 |
示例
codex_list {} # 看看 Codex 里有什么
codex_list { plugin: remotion } # 只看某个插件
codex_port {} # 全部移植（同名自动跳过）
codex_port { plugins: [remotion, hyperframes] }
codex_port { skills: [video-best], overwrite: true }
codex_status {} # 还有多少没移植
移植后 DSH 技能目录立即可用，agent 按技能描述自动触发。
跨平台使用
targetDir 不限于 DSH：指向任何支持 Agent Skills（SKILL.md）格式的 agent 技能目录，即可把 Codex 全家桶移植给它们：
| Agent | 建议 targetDir |
|---|
| DSH | ~/.dsh/skills（默认） |
| Claude Code | ~/.claude/skills/ |
| Cursor | .cursor/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
codex_port { targetDir: ~/.claude/skills }
移植规则
- frontmatter 转换：Codex 的
name/description/metadata → DSH 的 name/description/compatibility/allowed-tools，多行描述完整保留
- 剔除 codex 专属文件：
agents/*.yaml 等子代理描述不带走
- 名称清洗：非法字符替换为下划线，
.. 路径穿越直接拒绝
- 宿主可加载性校验：覆盖前要求转换后的技能名符合 DSH 的小写短横线命名规则、与目标目录同名，且描述为非空字符串；大写、下划线、点号或清洗后不同名的技能不会替换旧版。
- 幂等：同名技能默认跳过，
overwrite=true 才覆盖
- 覆盖失败可恢复：先在目标根内的唯一
.dsh-port-<技能名>-* 目录中复制、转换并回读校验；成功后才把旧技能移到事务目录的 previous/，再切换新技能。复制或转换失败不会改动旧技能，切换失败会尝试恢复旧技能；恢复失败时保留两份资料，并在失败原因中给出恢复路径。不会删除已存在的其他写入。
- 备份与目录边界：成功覆盖也保留
previous/ 及 recovery.json，会额外占用磁盘空间；确认不需要恢复后可自行归档。事务目录顶层不含 SKILL.md，不会被当前 DSH 的单层技能发现重复注册。拒绝源/目标重叠、目标符号链接或目录联接、路径越界及 Windows 设备名称。多次目录重命名不构成 Windows 上全程原子的事务；进程或系统中断后可按 recovery.json 检查和恢复。
- 安全：纯文件系统操作，零运行时依赖（仅 yaml 解析）
开发
pnpm install
pnpm test # 构建 + 离线测试；fixture 只写入工作区 .harness-validation/codex-port-tests
License
MIT
