前言¶
如果本機已經裝過 Codex CLI，~/.codex 裏可能已經有一批插件緩存和技能。DSH 側如果希望複用這些技能，手動複製會遇到 frontmatter 字段不一致、插件目錄裏混有 Codex 專屬文件、同名技能覆蓋等問題。
dsh-codex-port 是一個 DSH 插件，用於掃描本機 Codex 插件目錄，把可用的技能批量移植爲 DSH 技能，也支持輸出到其他支持 Agent Skills（SKILL.md）格式的目錄。
這是什麼¶
dsh-codex-port 的倉庫地址是 STARDUSTLC666/dsh-codex-port。它主要做三件事：列出本機 Codex 插件與技能、批量移植技能、對比移植狀態。許可證爲 MIT。
核心功能¶
下面按可落地的能力列出。
- 掃描
~/.codex中的解包插件與插件緩存。 - 把 Codex 官方插件的技能批量移植爲 DSH 技能。
- 自動轉換 frontmatter：
name/description/metadata轉爲name/description/compatibility/allowed-tools，多行描述完整保留。 - 剔除 Codex 專屬文件，例如
agents/*.yaml等子代理描述不會帶入目標目錄。 - 名稱清洗：非法字符替換爲下劃線，
..路徑穿越直接拒絕。 - 冪等處理：同名技能默認跳過，設置
overwrite=true才覆蓋。 - 安全邊界：按已覈實信息，它是純文件系統操作，運行時依賴僅
yaml解析；package.json聲明node >=22。
安裝與啓用¶
本機需要已安裝 Codex CLI，至少 ~/.codex 目錄存在。
添加插件：
dsh plugin --profile web add dsh-codex-port
配置項全部可選，默認即可用。可配置項包括：
codexHome
targetDir
overwrite
codexHome：Codex 家目錄，默認爲~/.codex。targetDir：目標技能目錄。overwrite：是否覆蓋同名技能，默認跳過。
卸載：
dsh plugin --profile web remove dsh-codex-port
卸載後重啓 Web 服務。如需徹底清理，可再手動刪除自己 profile 的 cordis.patch.yml 中覆蓋的插件行。
工具與典型用法¶
插件提供三個工具：codex_list、codex_port、codex_status。
查看¶
codex_list {}
codex_list { plugin: remotion }
codex_list 用於列出發現的 Codex 插件與技能，支持 plugin/skill 過濾，limit 範圍爲 1-200。
移植¶
codex_port {}
codex_port { plugins: [remotion, hyperframes] }
codex_port { skills: [video-best], overwrite: true }
codex_port { targetDir: ~/.claude/skills }
codex_port 用於批量移植爲 DSH 技能，支持 plugins/skills 過濾、targetDir、overwrite。targetDir 不限於 DSH，也可以指向 Claude Code、Cursor、Gemini CLI 等支持 Agent Skills（SKILL.md）格式的目錄。
狀態¶
codex_status {}
codex_status 用於對比源與目標，統計已移植與未移植情況。
適用場景與注意¶
適合這類情況：
- 本機已有 Codex CLI，並且
~/.codex中存在可掃描的插件或緩存。 - 希望把 Codex 技能帶到 DSH 技能目錄，或帶到 Claude Code 等其他 Agent Skills 目錄。
- 希望用
codex_status查看還差哪些未移植。
注意：
- 插件以當前運行 DSH 的進程權限訪問本機文件系統，安裝前建議檢查源碼與許可證（MIT）。
- 該插件在
@deepseek-ai/dsh@0.1.1-rc.2上驗證過（2026-08-26）。 - 同名技能默認不覆蓋；需要覆蓋時顯式傳
overwrite=true。 - 目標目錄如果指向其他 agent，請確認對方支持 Agent Skills / SKILL.md 格式，並自行確認目標目錄權限。
相關鏈接¶
https://github.com/STARDUSTLC666/dsh-codex-port
