前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，插件形態並不單一：既有進程內動態 Cordis 插件，也有隨 DSH 倉庫交付的工作區包，還有帶 dsh.bundle 與 cordis.patch.yml 的可安裝 bundle。三種模式在 Loader 組合、生命週期、驗收證據上各有差異，單靠通用編碼助手很難按模式給出可落地的步驟。
下面介紹社區項目 w2112515/dsh-plugin-development。它是一個可移植的 Agent Skill，面向 DSH 插件的設計、實現、打包、審查與診斷；同一套 canonical 目錄可在 Codex、Claude Code 與 DSH 中共用，並可選通過 DSH bundle 適配器做 profile 級安裝與可逆卸載。
這是什麼¶
dsh-plugin-development 由維護者 w2112515 發佈，在 SkillHub 分類爲工作流，當前版本 v0.2.0-beta.1，GitHub 14 stars，許可證 MIT。
項目定位：Portable Agent Skill for developing and auditing DeepSeek Harness plugins, with an optional profile-installable DSH bundle adapter。它不新增 MCP 服務器、賬號或遠程服務依賴；倉庫標註爲 Beta 且非官方，與 DeepSeek / 幻方無從屬關係，具體約束仍以 DeepSeek Harness 官方文檔爲準。
項目結構¶
倉庫按職責拆成幾塊，便於在不同宿主間複用：
| 部分 | 用途 |
|---|---|
skills/dsh-plugin-development |
可移植 Skill 本體，含按需加載的 reference 與腳本 |
skills/dsh-plugin-development/agents/openai.yaml |
可選 Codex UI 元數據，不 fork Skill 指令 |
index.js 與 cordis.patch.yml |
可選 DSH bundle 適配器，向 profile 註冊 canonical Skill |
.codex-plugin / .claude-plugin |
故意缺失；各宿主可直接使用 Skill，無需額外插件包 |
核心功能¶
Skill 在動手前會先區分三種 DSH 插件模式，再套用對應規則：
| DSH 插件模式 | 典型請求 | 完成證據 |
|---|---|---|
| 動態運行時 Cordis 插件 | 用 live Cordis 工具定義進程內 Host 或 Client 行爲 | live provider 與 Slot 檢查、define/run 狀態、最終診斷 |
| DSH 工作區插件 | 在 DSH 倉庫內增改隨倉交付的包 | 當前倉庫權威來源、聚焦測試、真實 Loader 組合、生命週期證明、產品可見時的快照 |
| 可安裝 DSH bundle | 對外發布帶 dsh.bundle 與 cordis.patch.yml 的包 |
打包文件、隔離 profile 安裝、--dump-config、打包啓動與清理證據 |
工作流還覆蓋 Loader 導出失敗、Service Definition/Provider/Consumer 歸屬、模型可見日誌、Client Slots、CLI 面、配置、生命週期 disposal、profile 優先級、Git 構建風險，以及僅審計場景的授權邊界。市場上架與整合包屬於獨立項目 dsh-marketplace-publish。
若宿主缺少 live Cordis 檢查、define、run 等動態工具，Skill 會停在源碼級設計或診斷，並說明激活未經驗證。
倉庫附帶只讀輔助腳本，供作者做早期檢查：
node skills/dsh-plugin-development/scripts/check-artifact.mjs workspace-function path/to/index.ts
node skills/dsh-plugin-development/scripts/check-artifact.mjs bundle path/to/package
安裝與啓用¶
安裝方式分兩類：直接掛載 canonical Skill 目錄，或通過可選 DSH bundle 讓 dsh plugin 管理 profile 級安裝。
在 DSH 中直接發現 Skill¶
DSH 可從以下路徑發現同一目錄：
<repo>/.dsh/skills/dsh-plugin-development<repo>/.agents/skills/dsh-plugin-development（與 Codex 共用）<dshHome>/skills/dsh-plugin-development
項目內 Skill 條目可按宿主正常優先級覆蓋可選 bundle 的同名註冊；卸載 bundle 僅 dispose 其註冊，不會刪除單獨安裝的個人或項目 Skill 目錄。
可選 DSH bundle 適配器¶
僅在需要 profile 級安裝、版本管理、組合與可逆移除時使用 bundle。官方 README 給出的安裝命令如下。
安裝當前 v0.2.0-beta.1 發佈包：
dsh plugin --profile web add https://github.com/w2112515/dsh-plugin-development/releases/download/v0.2.0-beta.1/dsh-plugin-development-0.2.0-beta.1.tgz
dsh --profile web --dump-config
導出配置中應出現 dsh-plugin-development layer 與 row ID dsh-plugin-development-skill。適配器從打包的 canonical Skill 讀取元數據與指令，經 ctx.skills 註冊，移除時 dispose 該註冊。
本地開發適配器時：
dsh plugin --profile web add .
Git 安裝（無需 prepare 或 pnpm allowBuilds，包爲純 JavaScript 與 Markdown）：
dsh plugin --profile web add github:w2112515/dsh-plugin-development#v0.2.0-beta.1
更高把握的安裝可改用經審查的 commit SHA，而非可移動分支。
Codex 與 Claude Code¶
同一 canonical 目錄也可鏈接到：
- Codex：
~/.codex/skills/dsh-plugin-development或<repo>/.agents/skills/dsh-plugin-development；顯式調用$dsh-plugin-development - Claude Code：
~/.claude/skills/dsh-plugin-development或<repo>/.claude/skills/dsh-plugin-development；顯式調用/dsh-plugin-development
Codex 亦可通過 $skill-installer 安裝：
https://github.com/w2112515/dsh-plugin-development/tree/main/skills/dsh-plugin-development
bundle 安裝要求 Node ^22.19.0 || >=24.0.0（見 package.json 的 engines 字段）。
典型用法¶
安裝或鏈接 Skill 後，在 DSH 插件相關任務中顯式喚起，或依賴其 description 自動匹配。按目標模式推進：
- 確認當前任務是動態 Cordis、工作區包還是可安裝 bundle。
- 按模式收集完成證據（live 檢查、Loader 組合、
--dump-config、打包啓動等）。 - 需要早期靜態檢查時，運行
check-artifact.mjs對應子命令。
維護者自檢可運行：
npm test
npm pack --dry-run
若本地有 DeepSeek Harness 檢出，可驗證直接發現與 bundle 註冊：
node scripts/verify-dsh-runtime.mjs path/to/deepseek-harness
適用場景與注意¶
適合誰： 正在編寫或審查 DSH 插件的開發者；需要在 Codex、Claude Code、DSH 間共用同一套工作流的人；希望用 bundle 做 profile 級安裝又不想複製一份 workflow 的 DSH 用戶。
使用前注意：
- 插件以當前 dsh 進程權限運行；安裝 bundle 或鏈接 Skill 前，應閱讀倉庫源碼與 MIT 許可證，確認行爲符合預期。
- 項目爲社區 Beta，DeepSeek Harness 仍處 developer preview，manifest、Loader 行爲等以官方倉庫爲準。
- SkillHub（目錄頁）是獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。
- 格式兼容不能讓缺失的工具憑空出現；無 live Cordis 環境時，工作流止於源碼級輸出。
結尾¶
dsh-plugin-development 把 DSH 三種插件模式的分工、驗收證據與跨宿主 Skill 目錄收斂到一處，可選 bundle 適配器則補上 profile 級安裝與可逆卸載。若你正在做 DSH 插件開發或審計，可從 SkillHub 目錄頁或 GitHub 倉庫入手：
- 目錄頁：https://www.skillhub.cn/plugins/w2112515/dsh-plugin-development
- GitHub：https://github.com/w2112515/dsh-plugin-development
