插件订阅市场zoahdev/dsh-subscribe

dsh-subscribe

CI
License: MIT
Registry

CI
Release
Storefront
awesome-dsh-plugin

面向 DeepSeek Harness 的 Steam 风格插件市场。 在网页商店中浏览 900+
个社区插件，订阅你想要的插件，
然后运行 一条命令 即可将所有插件安装到你的 dsh 配置中。包含一个
零依赖 CLI 和一个 harness 内插件（可在聊天中使用 search/stats/install 命令）。

- 🏪 商店：
- 📦 注册表：registry.json — 908 个插件，其中 21 个由
zoahdev 验证，数据来自 awesome-dsh-plugin.com
- 🔧 CLI：node scripts/dsh-subscribe.mjs sync --profile web
- 🤖 Harness 内插件：market_search、market_stats、
market_install_command

快速开始（网页）

1. 打开商店，搜索或
浏览，然后在你想要的每个插件上点击 Subscribe。
2. 点击 Export 下载 subscriptions.json（或复制同步
命令——页面还为每个插件提供了一键 复制安装命令）。
3. 运行一次同步：

git clone https://github.com/zoahdev/dsh-subscribe
cd dsh-subscribe
put the exported subscriptions.json here
node scripts/dsh-subscribe.mjs sync --profile web

就这样。每个已订阅的插件都会安装到 web 配置中。

CLI

node scripts/dsh-subscribe.mjs list [query]            # list/search plugins
node scripts/dsh-subscribe.mjs subscribe           # add a subscription
node scripts/dsh-subscribe.mjs unsubscribe         # remove a subscription
node scripts/dsh-subscribe.mjs status                  # subscribed vs installed
node scripts/dsh-subscribe.mjs export                  # write/normalize subscriptions.json
node scripts/dsh-subscribe.mjs install             # install ONE plugin now
node scripts/dsh-subscribe.mjs sync [--profile web]    # install all subscriptions
node scripts/dsh-subscribe.mjs sync --dry-run          # preview without installing

示例：

node scripts/dsh-subscribe.mjs subscribe dsh-plugin-doctorsh
node scripts/dsh-subscribe.mjs install dsh-github-intelligence --profile web
node scripts/dsh-subscribe.mjs sync --profile web

该 CLI 具有零运行时依赖（Node ≥ 18），并在底层驱动真实的 dsh
CLI：pnpm dlx @deepseek-ai/dsh plugin --profile  add 。

框架内插件

在 DeepSeek Harness 内部安装该市场，这样智能体就能为你查找插件：
sh
dsh plugin --profile web add github:zoahdev/dsh-subscribe#path:/plugin

重启 dsh web，然后让你的智能体搜索该市场。该插件注册了三个工具：

| 工具 | 用途 |
| --- | --- |
| market_search | 按查询/分类/已验证标志搜索 900+ 个插件，按星标排序 |
| market_stats | 总数/已验证数量以及按分类的细分 |
| market_install_command | 返回供用户运行的准确 dsh plugin add 命令 |

该插件附带一个捆绑的注册表快照，因此可以离线继续工作。
该插件还在
http://localhost:/dsh-subscribe/ 挂载了一个完整的框架内店面——浏览/搜索注册表，
然后直接在浏览器中一键安装、卸载、更新并批准构建脚本。
每个按钮都会驱动你机器上真实的 dsh CLI；
变更请求需要同源 POST，并且安装仅限于
精选的注册表规范（或显式的 file:/link: 规范）。

HTTP API（同源）：

| 路由 | 方法 | 用途 |
| --- | --- | --- |
| /dsh-subscribe/registry | GET | 注册表 + 统计信息 |
| /dsh-subscribe/installed | GET | 已安装的插件 |
| /dsh-subscribe/status | GET | 实时安装进度 |
| /dsh-subscribe/updates | GET | 更新可用性 |
| /dsh-subscribe/logs | GET | 经过清理的纯文本日志导出 |
| /dsh-subscribe/install | POST | 一键安装（精选或 file:/link:） |
| /dsh-subscribe/uninstall | POST | 一键卸载 |
| /dsh-subscribe/update | POST | 一键更新 |
| /dsh-subscribe/approve-builds | POST | 允许已安装包的构建脚本 |
| /dsh-subscribe/cancel | POST | 取消正在进行的操作 |
| /dsh-subscribe/ | GET | 框架内店面 UI |

使用 cd plugin && pnpm install && pnpm pack 在本地构建它，然后
dsh plugin --profile web add ./dsh-subscribe-0.3.1.tgz。

注册表与“已验证”标志

registry.json 是店面、CLI 和
插件的唯一事实来源。

- verified: true 表示 zoahdev 已审计该插件：CI、发布/标签、
安装路径以及运行时冒烟测试均已实际执行。这是一个真实
但有限的保证——它不是安全审计。
- 所有其他条目均镜像自
awesome-dsh-plugin.com/plugins.json
以供发现（verified: false）。在信任任何
第三方插件之前，请检查其来源：列出 ≠ 认可。

要刷新社区快照并重建合并后的注册表：
sh
curl -sf https://awesome-dsh-plugin.com/plugins.json -o data/registry-snapshot.json
node scripts/build-registry.mjs
node scripts/check-registry.mjs

故障排除

pnpm 阻止 git 安装（allowBuilds）

dsh plugin add github:... 可能会失败，并报错 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED
或 Ignored build scripts。这是 pnpm 的默认安全门禁，而不是插件
缺陷。修复方法：

1. 重新运行命令，读取 pnpm 打印出的确切包键名。
2. 打开你配置文件中的 pnpm-workspace.yaml（默认位于 ~/.dsh/profiles/web/
内），将该键名添加到 allowBuilds。
3. 重新运行 sync（或安装命令）。

CLI 会检测到这种失败模式，并自动打印相同的提示。

店面显示的是旧注册表

该页面从 raw.githubusercontent.com 获取 registry.json，推送后它可能会
缓存几分钟。请强制刷新（Ctrl/Cmd+Shift+R）或稍等片刻，
然后重新加载。

market_search 返回的结果比预期少

该插件会先尝试实时注册表，离线时回退到捆绑的
快照。如果你处于离线状态，就会使用快照，它可能比
店面落后几个小时。请稍后重试，或使用网页店面。

Node 版本

CLI：Node ≥ 18。插件：Node ≥ 20（使用 AbortSignal.any 进行有界抓取）。

验证（CI 实际证明了什么）

CI 流水线有意保持严格——它不会止步于“插件
能加载”：

1. node scripts/check-registry.mjs —— 结构化注册表契约（唯一的
id/spec，已验证条目声明版本，有效的安装 spec）。
2. node --test tests/cli.test.mjs —— CLI 端到端：subscribe → sync
--dry-run，合并后的注册表 >= 500 个插件。
3. node --test test/plugin.test.mjs —— 纯搜索/统计/命令逻辑以及
离线回退。
4. pnpm pack + scripts/runtime-smoke.mjs —— 打包后的 tarball 会被
安装到一个全新项目中，bundle 会通过真实的
apply()/ctx.tools.register 路径加载，并且所有三个处理程序都会被执行
并断言（而不仅仅是导入）。
5. scripts/dsh-smoke.ps1 —— 将打包后的 tarball 安装到全新的 DSH
配置文件中，验证 dsh-subscribe 出现在 --dump-config 中，并启动
dsh web 直到 HTTP 200（有界 30 秒重试，后台进程会被清理）。

这验证了：manifest/package 有效性、依赖兼容性、bundle
可加载性、DSH 启动，以及实际工具可调用性。这是一个社区
项目——不是官方 DeepSeek 模板，此处任何内容都
未经安全审计。

与 dsh-market 对比

dsh-market 是一个出色的可视化市场，位于
DSH 网页 UI 内部（浏览 → 一键安装 → 主题 → 更新）。dsh-subscribe
是一种互补方案，而不是替代品：

| | dsh-subscribe | dsh-market |
| --- | --- | --- |
| 注册表规模 | 571+（awesome-dsh-plugin 镜像 + 已验证策展） | 300+（awesome-dsh-plugin 实时） |
| 网页 UI 内一键安装 | —（复制命令 / CLI 同步） | ✅ |
| Steam 式订阅工作流 | ✅ | — |
| 对话内 agent 工具（搜索/统计/命令） | ✅ | — |
| 零依赖 CLI | ✅ | — |
| 离线注册表快照 | ✅（插件） | ✅（内置快照） |
| 主题/更新 UI | — | ✅ |
| 同源安装防护、构建审批 UX | — | ✅ |

两者结合使用：用 dsh-market 可视化浏览和安装；用 dsh-subscribe 订阅、同步，
并让你的 agent 查找插件。

贡献

- 发现失效条目或缺失插件？向
awesome-dsh-plugin
提交 PR（快照会自动收录），或在此处开 issue。
- 想让你的插件标记为 verified？开一个 issue，附上你的仓库、CI 徽章、
发布标签和安装路径；经过真实审计后即可获得该徽章。

许可证

MIT — dsh-subscribe ·
storefront

中文

dsh-subscribe —— DeepSeek Harness 的 Steam 式插件市场：在网页商店浏览
571+ 社区插件、一键订阅，然后一条命令把全部订阅装进你的 dsh
profile。自带零依赖 CLI 和 in-harness 插件（对话里直接搜索/统计/生成安装命令）。

快速开始（网页）

1. 打开商店页，搜索并点击
「订阅」；
2. 点「导出清单」下载 subscriptions.json（每个插件卡片也有「复制安装命令」）；
3. 跑一次同步：

git clone https://github.com/zoahdev/dsh-subscribe
cd dsh-subscribe
把导出的 subscriptions.json 放在这里
node scripts/dsh-subscribe.mjs sync --profile web

CLI

node scripts/dsh-subscribe.mjs list [query]      # 列出/搜索插件
node scripts/dsh-subscribe.mjs subscribe     # 添加订阅
node scripts/dsh-subscribe.mjs unsubscribe   # 取消订阅
node scripts/dsh-subscribe.mjs status            # 订阅 vs 已安装
node scripts/dsh-subscribe.mjs install       # 立即安装单个插件
node scripts/dsh-subscribe.mjs sync [--profile web]   # 安装全部订阅
node scripts/dsh-subscribe.mjs sync --dry-run    # 只预览不安装

CLI 零运行时依赖（Node ≥ 18），底层调用真实的
pnpm dlx @deepseek-ai/dsh plugin --profile  add 。

装进 Harness

dsh plugin --profile web add github:zoahdev/dsh-subscribe#path:/plugin

重启 dsh web 后，agent 可以直接调用 market_search（搜索）、
market_stats（统计）、market_install_command（生成安装命令，需用户确认后
在终端执行）。插件内置注册表快照，离线也能用。

verified 的含义

verified: true = zoahdev 审计过（CI/发布/安装路径/运行时冒烟都实测过）。
这是真实但有限的保证，不是安全审计。其余条目来自
awesome-dsh-plugin.com，仅作发现用途；
「列出一项 ≠ 背书」。

排障

- allowBuilds 拦截：dsh plugin add github:... 报
ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 时，按 pnpm 打印的包名，在 profile
的 pnpm-workspace.yaml 的 allowBuilds 里加一行，再重跑 sync。CLI 会
自动提示这个修复。
- 商店页数据旧：raw.githubusercontent 有几分钟缓存，强制刷新即可。
- 插件搜索结果少：离线时用内置快照，可能比网页版晚几个小时。

CI 真的验证了什么

不只是「插件能加载」：注册表结构校验 → CLI 端到端（订阅→dry-run 同步）→
插件单元测试 → 打包产物安装到全新工程、真实注册工具、真实执行三个
handler 并断言 → 装进全新 DSH profile、--dump-config 验证、dsh web
启动到 HTTP 200（30 秒有界重试）。社区项目，非官方模板，无安全审计。

和 dsh-market 的关系

互补而非替代：dsh-market 在 Web UI 里做可视化一键安装/主题/更新；
dsh-subscribe 提供 Steam 式订阅同步、零依赖 CLI、对话内 agent 工具和
571+ 全量注册表。两个一起用体验最佳。

许可证

MIT