STARDUSTLC666/dsh-codex-port

English

dsh-codex-port

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

npm version npm downloads license stars

Awesome DSH Plugin

把 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  # 目标技能目录（默认 /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