插件开发技能包 w2112515/dsh-plugin-development

DSH 插件开发

DSH Plugin Development 是一个可移植的 Agent Skill，用来设计、实现、打包、审查和诊断 DeepSeek Harness 插件。同一份规范技能目录，在 Codex、Claude Code 和 DSH 里都能用。可选的 DSH bundle 适配器额外提供按配置档安装和可回滚卸载，不用再复制一份工作流。

Beta 版，非官方。这个社区项目与 DeepSeek 没有隶属关系，也未获其背书。DeepSeek Harness 还在开发者预览阶段，所以当前仓库里的说明、可执行约束、类型、清单和 Loader 行为才是准绳。

项目结构

| 部分 | 用途 |
| skills/dsh-plugin-development | 规范的可移植技能，以及按需加载的参考文档和脚本。 |
| skills/dsh-plugin-development/agents/openai.yaml | 可选的 Codex UI 元数据；不会另起一套技能说明。 |
| index.js 和 cordis.patch.yml | 轻量可选适配器，把规范技能注册到 DSH 配置档里。 |
| .codex-plugin / .claude-plugin | 有意不提供。两个宿主都不需要插件就能使用这个技能。 |

技能会先区分三种形态——运行中的动态 Cordis 插件、有源码的 DSH 工作区包、树外可安装 bundle——再套用各自的规则。它不引入 MCP 服务器、账号、凭据，也不依赖任何远程服务。

Codex

把规范目录安装或链接为下面任意一种：

- 个人技能，放在 ~/.codex/skills/dsh-plugin-development；或者
- 仓库技能，放在 <repo>/.agents/skills/dsh-plugin-development。

你也可以让 $skill-installer 安装这个 GitHub 目录：

https://github.com/w2112515/dsh-plugin-development/tree/main/skills/dsh-plugin-development

用 $dsh-plugin-development 显式调用，或者让它根据描述，在处理匹配的 DSH 插件工作时自动触发。不需要 Codex 插件。

Claude Code

把同一份规范目录安装或链接为下面任意一种：

- 个人技能，放在 ~/.claude/skills/dsh-plugin-development；或者
- 仓库技能，放在 <repo>/.claude/skills/dsh-plugin-development。
用 /dsh-plugin-development 调用它，或者让 Claude 在处理匹配的工作时自动加载。该目录使用可移植的 Agent Skills frontmatter 子集，不依赖 Claude 专有的 arguments、shell injection、subagent 字段或 path variables。不需要 Claude Code 插件。

DeepSeek Harness

DSH 可以直接从以下位置发现同一个目录：

- <repo>/.dsh/skills/dsh-plugin-development；
- <repo>/.agents/skills/dsh-plugin-development；或
- <dshHome>/skills/dsh-plugin-development。

仓库里的 .agents/skills 位置由 Codex 和 DSH 共用，所以这两个宿主可以消费同一份签入的副本。

可选的 DSH bundle 适配器

只有当你希望由 dsh plugin 负责配置档范围内的安装、版本管理、组合与移除时，才使用 bundle：

下面的命令安装当前的 v0.2.0-beta.1 适配器。此前的 v0.1.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 层和行 ID dsh-plugin-development-skill。适配器从打包的 canonical Skill 读取元数据和指令，通过 ctx.skills 注册它，并在移除时注销该注册。

本地开发适配器时：

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

对可靠性要求更高的 Git 安装，请使用经过审查的 commit SHA，而不是可移动的分支。

可移植兼容性契约

canonical 目录遵循 Agent Skills 规范：

- SKILL.md 只使用共享的 name 和 description frontmatter 字段；
- 目录名与 Skill 名一致；
- 引用和脚本使用相对于 Skill 目录的路径；
- 详细的模式指引按需加载；以及
- 宿主专有的 UI 元数据不会改变工作流。

格式兼容并不能让不可用的工具凭空出现。动态运行时的工作仍然需要实时的 Cordis inspection、definition 和 run 工具。没有这些工具时，Skill 必须停在有源码支撑的设计或诊断阶段，并报告激活未经验证。

技能覆盖的内容

| DSH 插件模式 | 典型请求 | 完成证据 |
| 动态运行时 Cordis 插件 | 用实时 Cordis 工具定义进程内的 Host 或 Client 行为 | 实时的 provider 和 Slot inspection、define/run 状态，以及最终诊断 |
| DSH 工作区插件 | 新增或修改 DSH 仓库中附带的包 | 当前仓库 authority、聚焦测试、真实 Loader 组合、生命周期证明，以及产品可见时的快照 |
| 可安装的 DSH 整合包 | 用 dsh.bundle 和 cordis.patch.yml 发布外部包 | 打包文件、隔离配置档安装、--dump-config、打包启动，以及清理证据 |

这套工作流还覆盖 Loader 导出失败、Service Definition/Provider/Consumer 归属、模型可见日志、Client Slots、命令行界面、配置、生命周期销毁、配置档优先级、Git 构建风险，以及仅审计授权。市场上架与整合包属于 dsh-marketplace-publish。

优先级与生命周期

项目自带的技能仍遵循宿主正常的发现与优先级规则。在 DSH 中，项目本地条目可以按名称覆盖可选的运行时注册。移除整合包只会销毁它自己的注册，不会删除单独安装的个人或项目技能目录。

验证

运行自包含检查，并查看打包后的 DSH 适配器：

npm test
npm pack --dry-run

Codex 维护者还可以对规范目录运行内置的技能校验器：

python path/to/skill-creator/scripts/quick_validate.py skills/dsh-plugin-development

运行时消费方检查接受一份已构建的 DeepSeek Harness 检出，并同时演练直接文件系统发现和可选的整合包注册：

node scripts/verify-dsh-runtime.mjs path/to/deepseek-harness

要拿到发布证据，把打包好的 tarball 原样安装到隔离的 DSH home，查看 --dump-config，加载已安装的入口，并验证注册、销毁和移除。静态检查永远替代不了这些消费方路径。

打包好的只读辅助脚本为插件作者提供两项早期检查：

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

可发现性

仓库使用 GitHub 的 dsh-plugin 和 Agent Skill 主题。它不声称自己属于项目尚未定义的独立 DSH 注册表。

社区

- LINUX DO —— 社区讨论与开源分享。

常见问题

这个技能会创建市场上架用的整合包吗？

不会。目录上架与整合包属于 dsh-marketplace-publish。这个技能只做到插件实现与验证。

这是技能还是 DSH 插件？

维护的产品是一个可移植的 Agent Skill。仓库还附带一个可选的 DSH 整合包适配器，给偏好配置档管理安装的用户使用。

有单独的 Codex、Claude Code 和 DSH 版本吗？

没有。三者消费同一份 skills/dsh-plugin-development 源码。区别只在发现路径、可选的 UI 元数据，以及 DSH 安装适配器。

安装时会执行包的构建脚本吗？

不会。DSH 适配器没有 prepare、install 或 postinstall 脚本。安装前请务必检查第三方源码和确切的产物。

兼容性问题应该怎么反馈？

开 issue，附上主机与版本、DSH 版本或 commit、选定的插件模式、目标入口路径、确切的请求或命令、观察到的结果，以及无法获取的证据。不要包含凭据或私有运行时数据。

许可证

MIT