前言¶
在 DeepSeek Harness（DSH）上做插件，常见难点不在「会不会写代码」，而在扩展点选错、配方（recipe）结构不对、本地装不上或 slot 一跑就崩。官方文档分散，命令行与 UI 扩展形态又多，从零搭一套可验证的插件往往要反复查规范、改目录、再试安装。
下面介绍 SkillHub 上的 DSH插件开发助手（@davtime/dsh-plugin-studio）。它面向「要在 DSH 上创建、扩展、验证或发布插件」的场景，把需求澄清、形态决策、配方装配、代码生成、本地验证、安装冒烟与发布串成一条可跟进的流程；也覆盖插件不加载、服务注入失败、样式丢失等排障诉求。
这是什么¶
DSH插件开发助手 是发布在 SkillHub 上的 Agent Skill，坐标 @davtime/dsh-plugin-studio，当前版本 v1.0.2，分类为 dev-programming，来源标注为 enterprise，发布者为 达维。页面标注 requires_api_key=false，安装该 Skill 本身不要求额外 API Key。
Skill 基于通用 SKILL.md 格式：安装后由 AI Agent 读取技能说明，在用户提出 DSH 插件相关目标时按技能内工作流执行，而不是单独提供一个本地 GUI 或 CLI 二进制。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/davtime/dsh-plugin-studio
- API 坐标页：https://api.skillhub.cn/davtime/dsh-plugin-studio
核心功能¶
以下能力均来自 SkillHub 简介与页面说明，未单独列出的细节不在本文展开。
端到端开发流程¶
从用户给出的「一句话功能描述」出发，技能侧引导完成：
- 需求澄清：把模糊目标收成可实现的插件能力边界。
- 形态决策：在命令/工具、HTTP、服务、事件、定时任务、设置面板、工作区/仪表盘、状态栏、根布局替换等形态中选定合适组合。
- 配方装配：按 DSH 插件约定组织 recipe 与扩展点。
- 代码生成：产出与所选形态匹配的插件代码骨架与实现要点。
- 本地验证：在本地环境做构建与基本校验。
- 安装冒烟：安装到 Harness 后做最小可用性检查。
- 发布：在流程末尾衔接发布相关步骤（以技能内说明为准）。
支持的插件能力类型¶
简介中明确覆盖的常见能力包括：
- 命令 / 工具（commands / tools）
- HTTP 接口
- 服务提供（service provision）
- 事件订阅
- 定时任务
- 设置面板
- 工作区 / 仪表盘
- 状态栏
- 根布局替换
排障场景¶
同一 Skill 也用于排查典型运行时问题，例如：
- 插件不加载
- slot 崩溃
- 服务注入失败
- 样式丢失
具体诊断步骤以安装后的 SKILL.md 与工作流为准。
安装与启用¶
方式一：让 AI 按官方安装文档执行¶
SkillHub 页面给出的提示词为：请 Agent 根据安装文档完成安装。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@davtime/dsh-plugin-studio`。
Agent 会按 SkillHub 安装与优先源配置 检查 skillhub CLI、选择当前环境的 skills 目录并执行安装。
方式二：手动使用 skillhub CLI¶
先确认 CLI 是否已安装：
command -v skillhub && skillhub --version
未安装时，可按官方文档执行完整安装（节选）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。官方文档列出的常用路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（将 <skills 目录> 换成上面对应路径）：
skillhub install @davtime/dsh-plugin-studio --dir <skills 目录>
安装后按所用客户端要求重启或刷新 Agent，使新 Skill 被加载。
典型用法¶
公开页面未附带独立的长篇教程或可复制的一键命令示例；典型用法即：在已启用该 Skill 的对话里，用自然语言说明 DSH 插件目标，由 Agent 按技能工作流推进。
可参考的表述方式：
- 新建插件：说明一句话功能，例如「在 DSH 里加一个定时同步某 API 的状态栏指示器」，并注明希望用到的扩展类型（若已确定）。
- 扩展现有插件：说明当前插件做什么、要新增的能力，以及是否已遇到加载或 slot 问题。
- 验证与发布：说明本地是否已能构建、安装是否失败、需要冒烟检查还是走发布步骤。
- 排障：直接描述现象（不加载、slot 崩溃、服务注入失败、样式丢失等）及已尝试步骤，便于技能侧对照 DSH 插件约定排查。
经过上面的步骤，Agent 应依次推进澄清、形态与配方、生成代码、本地验证与安装检查；具体命令与文件路径以会话中技能输出为准，本文不编造未在官方资料出现的配置项或案例。
适用场景与注意¶
适合谁
- 需要在 DeepSeek Harness（DSH） 上交付或维护插件的开发者。
- 希望用对话把「想法 → 配方 → 代码 → 本地验证 → 安装」串起来，而不是只靠零散文档手写全流程的人。
- 遇到插件加载、slot、注入、样式等问题，希望按 DSH 插件模型系统排查时。
使用注意
- 本 Skill 描述的是 Agent 侧工作流，不能替代本机 DSH / Harness 运行环境与官方插件规范；本地仍需具备对应的构建与安装条件。
- SkillHub 页面统计（截至抓取）：评分 100000，下载 20103；与第三方转载的数字可能不一致，以 SkillHub 为准。
- 安装目录错误是常见坑：务必
skillhub install ... --dir指向当前客户端的 skills 路径。 - 未在官方资料中写明的 Cursor / Codex / Claude Code 差异化配置，本文不臆测；差异主要体现在 skills 目录路径上。
结尾¶
DSH插件开发助手 把 DSH 插件从需求到发布（及常见故障）收成一条 Agent 可执行的技能链，适合从「一句话功能」起步、又要覆盖多种扩展形态的场景。需要安装或查看说明时，请打开 SkillHub 官方页面：https://www.skillhub.cn/skills/davtime/dsh-plugin-studio
