DeepSeek Harness Plugin Hub
所有指南

写你的第一个 DSH 插件

从脚手架到发布上架的完整流程:init、validate、publish、claim。

初始化项目

使用 CLI 生成一个完整的插件骨架:

dsh-hub init my-plugin --repository your-name/my-plugin

# 使用 scoped 包名
dsh-hub init my-plugin --name @your-scope/my-plugin --repository your-name/my-plugin

项目结构

生成的项目包含三个核心文件:

package.json — 包含 npm 元数据和 DSH manifest(dsh.bundle、hub 列表信息、兼容性声明)。

cordis.patch.yml — 定义插件的 Cordis entry,描述插件在系统中的注册行为。

src/ — 插件源代码目录。

本地验证

发布前用 validate 命令检查所有格式要求:

dsh-hub validate my-plugin

发布到 npm

验证通过后,像普通 npm 包一样发布:

cd my-plugin
npm publish

在 Hub 上展示

发布后,插件会在下一轮 6 小时同步中自动出现。你也可以在插件页面手动提交包名加速。

要管理列表信息(截图、分类、描述),需要认领插件:登录 Hub,安装 GitHub App 到你的仓库,系统验证后你就可以直接在 Dashboard 编辑。

相关指南

插件安装失败排查

插件安装时报错?按这个清单逐步排查包名、manifest、版本格式和网络问题。

DSH 版本不兼容

插件声明的 DSH 版本范围和当前环境不匹配时的排查和修复方法。

插件 HMR 不工作

理解 DSH 的四种 HMR 模式,选择正确的模式并排查热更新失效的原因。

写你的第一个 DSH 插件 — DSH Plugin Hub