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

DSH 插件开发

Release
Validate
License: MIT

DSH 插件开发是一个可移植的 Agent Skill，用于设计、实现、打包、审查和诊断 DeepSeek Harness 插件。同一个规范 Skill 目录可同时用于 Codex、Claude Code 和 DSH。可选的 DSH bundle 适配器增加了 profile 作用域的安装和可逆移除功能，而无需创建工作流的另一份副本。

Beta 且非官方。此社区项目不隶属于 DeepSeek，也未获得其认可。DeepSeek Harness 处于开发者预览阶段，因此当前仓库说明、可执行约束、类型、清单和 Loader 行为仍具有权威性。

项目结构

| 部分 | 用途 |
| --- | --- |
| skills/dsh-plugin-development | 规范的可移植 Skill 及其按需参考文档和脚本。 |
| skills/dsh-plugin-development/agents/openai.yaml | 可选的 Codex UI 元数据；它不会分叉 Skill 指令。 |
| index.js 和 cordis.patch.yml | 轻量可选适配器，在 DSH profile 中注册规范 Skill。 |
| .codex-plugin / .claude-plugin | 有意缺失。两个宿主都不需要插件即可使用该 Skill。 |

该 Skill 在应用模式特定规则之前，会区分实时动态 Cordis 插件、源码支持的 DSH 工作区包和树外可安装 bundle。它不添加任何 MCP 服务器、账户、凭据或远程服务依赖。

Codex

将规范目录安装或链接为以下任一形式：

- 位于 ~/.codex/skills/dsh-plugin-development 的个人 Skill；或
- 位于 /.agents/skills/dsh-plugin-development 的仓库 Skill。

你也可以让 $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 的个人 Skill；或
- 位于 /.claude/skills/dsh-plugin-development 的仓库 Skill。
使用 /dsh-plugin-development 调用它，或让 Claude 在处理匹配工作时自动加载它。该目录使用可移植的 Agent Skills frontmatter 子集，不依赖 Claude 专有的参数、shell 注入、subagent 字段或路径变量。不需要 Claude Code 插件。

DeepSeek Harness

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

- /.dsh/skills/dsh-plugin-development；
- /.agents/skills/dsh-plugin-development；或
- /skills/dsh-plugin-development。

仓库中的 .agents/skills 位置由 Codex 和 DSH 共享，因此这两个宿主可以共用一份已检入的副本。

可选的 DSH bundle 适配器

仅当你希望由 dsh plugin 负责 profile 范围的安装、版本管理、组合和移除时，才使用该 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。该适配器从打包的规范 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 安装，请使用经过审查的提交 SHA，而不是可移动的分支。

可移植兼容性契约

规范目录遵循 Agent Skills 规范：

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

格式兼容并不会让不可用的工具出现。动态运行时工作仍然需要实时的 Cordis 检查、定义和运行工具。没有它们，Skill 必须止步于有来源支撑的设计或诊断，并报告激活未经验证。

该 Skill 涵盖的内容

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

该工作流还涵盖 Loader 导出失败、Service Definition/Provider/Consumer 所有权、模型可见日志记录、Client Slots、CLI 界面、配置、生命周期处置、配置文件优先级、Git 构建风险和仅审计授权。市场列表和解决方案包（整合包）属于 dsh-marketplace-publish。

优先级和生命周期

直接项目 Skills 仍遵循宿主的正常发现和优先级规则。在 DSH 中，项目本地条目可以按名称覆盖可选的运行时注册。移除捆绑包只会处置其注册；它不会删除单独安装的个人或项目 Skill 目录。

验证

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

npm test
npm pack --dry-run

Codex 维护者还可以针对规范目录运行内置 Skill 验证器：

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 主目录中，检查 --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 — 社区讨论和开源分享。

常见问题

这个 Skill 会创建市场解决方案包吗？

不会。目录列表和解决方案包（整合包）属于 dsh-marketplace-publish。这个 Skill 止步于插件实现和验证。

这是一个 Skill 还是一个 DSH 插件？

所维护的产品是一个可移植的 Agent Skill。该仓库还为偏好配置文件管理安装的用户提供了一个可选的 DSH 捆绑包适配器。

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

没有。三者都使用相同的 skills/dsh-plugin-development 源。只有发现路径、可选 UI 元数据和 DSH 安装适配器不同。
安装是否会执行包构建脚本？

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

应如何报告兼容性问题？

提交 issue，并附上主机及版本、DSH 版本或提交、所选插件模式、目标入口路径、确切的请求或命令、观察到的结果以及缺失的证据。请勿包含凭据或私有运行时数据。

许可证

MIT