STARDUSTLC666/dsh-codex-port

English

dsh-codex-port

0.2.4 更新（2026-09-27）

Codex 目录按显式 codexHome、CODEX_HOME、默认 ~/.codex 的顺序解析，修复自定义或隔离目录无法发现插件技能的问题。

验证宿主：官方源码构建的 Harness 0.2.0-rc.1（commit 407e65c8）+ Node 24.16.0（2026-09-28）。53 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 4 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。

Codex 全家桶，一条命令进 DSH：实测 186 插件、583 技能、移植 577 个 0 失败。

把 Codex 官方插件全家桶一键搬进 DSH：扫描 ~/.codex 里的解包插件与插件缓存，把它们的技能批量移植为 DSH 技能（frontmatter 自动转换、codex 专属文件剔除、名称清洗、幂等跳过）。

本机实测：186 个 Codex 官方插件、583 个技能，一次移植 577 个成功、0 失败。

兼容性

安装

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