前言¶
在 DeepSeek Harness（DSH）里做插件，常见卡点不在某一行业务代码，而在形态选错、挂载合同没对齐、本地门禁没过就急着改功能。官方文档分散在合同、验证和踩坑说明里，自己拼一套「先规划再脚手架再发布」的流程成本高。
下面介绍 SkillHub 上的 DSH插件脚手架（@user_62a0c738/dsh-plugin-scaffold）。它把需求澄清、三种插件形态决策、脚手架生成命令、业务实现约束、本地验证与发布准备串成带决策门的 7 个阶段，并附带 references/ 里的合同与验证章节，适合让 AI Agent 按同一套节奏带你走完 DSH 插件全流程。
这是什么¶
DSH插件脚手架 是一条面向 DeepSeek Harness 插件 的 Agent Skill：从规划到发布，覆盖需求与形态决策、脚手架生成、业务实现、本地验证、发布准备和最终发布。
- 坐标：
@user_62a0c738/dsh-plugin-scaffold - 版本：1.0.0（社区来源，分类 dev-programming）
- 维护与源码：goatbroai/dsh-plugin-scaffold
- SkillHub 页面：DSH插件脚手架
- 标签：
requires_api_key=false，安装本 Skill 本身不需要 API Key
当你在对话里要 规划、创建、脚手架初始化、开发、验证或发布 DSH 插件/扩展，或问「如何端到端做一个 DeepSeek Harness 插件」时，Agent 会按 Skill 内 SKILL.md 的阶段执行；若只是局部问题（例如挂载失败），Skill 要求直接查 references/ 对应章节，而不是重跑全流程。
核心功能¶
以下能力均来自官方 Skill 说明与 GitHub 仓库中的 SKILL.md，未超出已公开内容。
七个阶段与决策门¶
全流程分为阶段 0～6，每阶段有明确产出；上一阶段未定论或未通过验证，不得进入下一阶段。阶段决策持续写入生成目录中的 docs/plugin-plan.md。
| 阶段 | 内容 |
|---|---|
| 0 | 明确插件名、一句话目标、能力面（工具/服务/HTTP/浏览器 UI/skill/MCP 等）、目标 profile（默认 web） |
| 1 | 按能力面选择插件形态与分发方式（git / 本地目录 / npm）、包管理器（默认 pnpm） |
| 2 | 调用脚手架脚本生成工程，并跑通 install / bundle / gates |
| 3 | 按选定形态实现业务（ctx.*、ctx.effect()、client slots 等） |
| 4 | 本地验证：构建、门禁、npm pack --dry-run、安装与浏览器冒烟 |
| 5 | 发布准备：git remote、README ref、截图、lib/ 提交、再次门禁 |
| 6 | 按分发方式发布，并从最终源重装验收 |
三种插件形态¶
| 能力面 | 形态 | scaffold 参数 |
|---|---|---|
| 仅 Node 工具/服务/事件处理 | pure Cordis | --kind pure |
| 需要组合层或随包分发多个挂载 | bundle | --kind bundle |
| Node half + 浏览器 client bundle | bundle-client | --kind bundle-client |
若需完全替换默认 web shell 根布局，Skill 说明由 Agent 在实现阶段通过 ctx.slots.register({ name: 'root' }) 等方式处理，脚手架无单独参数。
脚手架与门禁¶
Skill 关联仓库提供 scripts/scaffold.py，用于生成带构建脚本与门禁（pnpm run gates）的插件骨架。Skill 内还引用 references/contracts.md、gotchas.md、verification.md，分别对应 package/entry/client 合同、构建打包坑、安装与浏览器验证。
安装与启用¶
通过 SkillHub 安装 Skill¶
先确认本机是否有 SkillHub CLI（见 SkillHub 安装说明）。安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。
command -v skillhub && skillhub --version
未安装 CLI 时，可按官方文档执行完整安装（示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
将 Skill 装到对应客户端目录（路径以你当前环境为准）：
# Cursor 示例
skillhub install user_62a0c738/dsh-plugin-scaffold --dir ~/.cursor/skills/
# Claude Code 示例
skillhub install user_62a0c738/dsh-plugin-scaffold --dir ~/.claude/skills/
# Codex 示例（常见路径之一）
skillhub install user_62a0c738/dsh-plugin-scaffold --dir ~/.codex/skills/
SkillHub 页面也支持把下面提示交给 AI，让其按安装文档拉取 @user_62a0c738/dsh-plugin-scaffold：
请根据 https://skillhub.cn/install/skillhub.md，安装
@user_62a0c738/dsh-plugin-scaffold。
安装后按你所用客户端要求刷新或重启，使 Skill 生效。本 Skill 不要求配置 API Key。
典型用法¶
启用 Skill 后，在对话中说明你要做的 DSH 插件目标即可；Agent 应按阶段 0 起逐步推进。下面摘录官方 阶段 2 的可复现命令（需在已克隆或已解压的 dsh-plugin-scaffold 仓库根目录执行，或按 Skill 指引定位 scripts/scaffold.py）。
生成脚手架：
python3 scripts/scaffold.py <plugin-name> \
--out <output-directory> \
--kind <pure|bundle|bundle-client> \
--description "Short description"
进入生成目录并验证骨架：
cd <output-directory>/<plugin-name>
pnpm install
pnpm run bundle
pnpm run gates
三条命令全部通过后，再按阶段 3 写业务；改 src/ 后执行 pnpm run bundle，不要手改 lib/。
阶段 4 本地验证顺序（官方）：
pnpm run bundle
pnpm run gates
npm pack --dry-run
随后按 references/verification.md 做安装冒烟与浏览器验证。发布阶段按阶段 1 选定的 git 或 npm 路径执行 git push / npm publish，并从最终分发源重装，确认无 plugin tree failed to load、无 slot entry crashed，且功能符合阶段 0 目标。
适用场景与注意¶
适合谁
- 第一次在 DSH 上做插件，需要在 pure / bundle / bundle-client 之间做清晰选择的人。
- 希望用统一门禁（
gates）和验证清单，避免「能编过但装不上、浏览器一打开就崩」的团队或个人。 - 愿意让 Agent 按
docs/plugin-plan.md记录决策、分阶段推进，而不是零散改代码的对话方式。
限制与注意
- 本 Skill 指导的是 DSH 插件工程 全流程；
scaffold.py与模板在 GitHub 仓库中，安装 Skill 不等于自动把脚手架脚本装进你的插件目录，生成步骤仍需在含该脚本的上下文中执行（通常由 Agent 按 Skill 说明操作）。 - 验证失败时，Skill 规定：业务问题回阶段 3；形态或 contract 问题才允许回阶段 1，避免在错误形态上堆功能。
- SkillHub 统计（截至页面展示）：下载约 1498、安装约 268；具体数字以 SkillHub 为准。
结尾¶
DSH插件脚手架 把 DeepSeek Harness 插件从「想做什么」到「从分发源重装验收」拆成 7 个带决策门的阶段，并绑定三种形态与脚手架、门禁命令，适合作为 Agent 侧的可重复 playbook。
- SkillHub：https://www.skillhub.cn/skills/user_62a0c738/dsh-plugin-scaffold
- API 坐标页：https://api.skillhub.cn/user_62a0c738/dsh-plugin-scaffold
- 源码与 Skill 正文：https://github.com/goatbroai/dsh-plugin-scaffold
