插件源聚合器 Stolyarovmn/dsh-ui-registry-aggregator

DeepSeek Harness 的注册表聚合器

注册表聚合器是 DeepSeek Harness 的一个联邦式插件发现 UI。它将受信任的插件注册表、GitHub 仓库以及兼容的 JSON 目录整合到一个规范化索引中，同时将安装和插件生命周期管理交由原生 DSH 插件管理器处理。

截图

已连接的源

内置的 npm 和 GitHub 源会经过健康检查、计数，并在 Sources 视图中进行管理。

注册表聚合器 — 已连接的源

浏览与搜索

在已连接的源中搜索、筛选结果、查看证据，并安装经过验证的 DSH 包，而无需离开 DeepSeek Harness。

注册表聚合器 — 浏览搜索

亮点

- 联邦式源 — 整合 npm、GitHub 以及兼容的 JSON 目录。
- 浏览 — 将所有启用的源作为单一去重索引进行搜索。
- 经过验证的 DSH 包 — npm/GitHub 候选包在被作为可安装结果展示之前，会检查其根目录下是否存在 dsh.bundle.patch。
- 证据 — 在可用时显示发布渠道、GitHub star 数、npm 30 天下载量、新鲜度、源元数据以及声明的 DSH 兼容性。
- 筛选 — 稳定版本、时效、类别以及 DSH 元数据。
- 多重排序 — 组合 Stars、Downloads、Freshness 和 Name；每个条件均可升序或降序。
- 分页 — 每页 20、50 或 100 项，结果上方和下方均提供导航。
- 原生安装 — 通过 DSH 插件管理器 Host API 一键安装。
- 回退命令 — 可安装结果还会展示其 dsh plugin add … 命令。
- 响应式热度元数据 — 缺失的 GitHub star 数会在 Browse 渲染后补充加载，因此 GitHub 元数据不会阻塞初始搜索结果。

0.4.14 中的新内容

0.4.14 是首个从重命名后的 Stolyarovmn/dsh-ui-registry-aggregator 仓库通过 npm Trusted Publishing 发布的版本。它保持 0.4.13 中快速的 Browse/search 路径不变。

- 从规范的 dsh-ui-registry-aggregator 仓库发布；
- npm Trusted Publisher 已接入 .github/workflows/publish.yml；
- README 截图和仓库元数据指向重命名后的仓库；
- 搜索、源计数、包验证以及异步 GitHub star 补充加载与 0.4.13 相比保持不变。

架构

Plugins → Installed → @stolyarovmn/dsh-ui-registry-aggregator
├─ Sources / Browse UI
├─ ctx.configForms → source configuration
├─ authenticated Connection RPC (/api/plugin-sources/*)
│ └─ Host adapters
│ └─ normalize → deduplicate → verify → filter → sort → paginate
└─ ctx.remote.pluginManager
├─ inspect(spec)
└─ installBundle(spec)

浏览器不会直接获取任意目录 URL。外部源访问在 Host 侧通过经过身份验证的 DSH Connection RPC 边界进行。
GitHub star 补充与 Browse 关键路径有意分离：

Browse 请求 → 发现 / 验证 / 过滤 / 排序 / 分页 → 渲染卡片 → 为可见仓库请求缺失的 GitHub star → 就地更新卡片

安装

npm

dsh plugin --profile web add @stolyarovmn/dsh-ui-registry-aggregator

如果你通过 pnpm dlx 运行 DSH：

pnpm dlx @deepseek-ai/dsh@0.1.7-rc.1 plugin --profile web add @stolyarovmn/dsh-ui-registry-aggregator

GitHub

pnpm dlx @deepseek-ai/dsh@0.1.7-rc.1 plugin --profile web add "git+https://github.com/Stolyarovmn/dsh-ui-registry-aggregator.git"

启用已安装的 bundle，然后打开：

Plugins → Installed → @stolyarovmn/dsh-ui-registry-aggregator

npm 和 GitHub 源会在首次使用时自动添加。

源类型

| 类型 | 行为 |
| npm | 使用 DSH 相关包元数据和关键词进行 npm registry 发现。 |
| github | 使用 DeepSeek-Harness 特定的 topic 交集进行 GitHub 仓库发现。 |
| dsh-plugin-shop | 用于兼容源端点的 JSON 目录适配器。 |
| dshplugin-app | 用于兼容 dshplugin.app 端点的 JSON 目录适配器。 |
| custom-json | 公共 JSON 目录。 |
| corporate | 由 Host 控制私有网络和凭据权限的 JSON 目录。 |

JSON 源可以返回裸数组，或包含 plugins、items 或 results 的对象。

示例：

{
"plugins": [
{
"id": "pdf-tools",
"name": "PDF Tools",
"description": "Extract and merge PDF documents.",
"version": "1.2.0",
"package": "@example/dsh-plugin-pdf",
"repository": "https://github.com/example/dsh-plugin-pdf",
"install": {
"type": "npm",
"spec": "@example/dsh-plugin-pdf@1.2.0"
}
}
]
}

身份优先级依次为 npm 包、规范仓库 URL，然后是源特定的 id。重复记录会保留来源归属、版本和规范化类别标签。

发现质量

Registry Aggregator 将 registry 搜索命中视为候选，而非自动视为可安装的 DSH 插件。

- npm 候选会根据其已发布的包元数据进行验证。
- 精确的 npm 包名可以从 registry packument 解析，而不必仅依赖最终一致的搜索索引。
- 短查询和部分查询会将缓存发现与查询特定的 npm/GitHub 发现相结合。
- GitHub 发现使用 DeepSeek-Harness 特定的 topic 交集，而不是仅使用宽泛的 dsh-plugin topic。
- npm/GitHub 候选必须声明根级 dsh.bundle.patch，UI 才会显示 Install 或回退命令。
- 不是有效 DSH bundle 的候选会在总数统计、排序、分页和渲染之前被移除。
- npm/GitHub 源计数器表示经过验证的可安装 bundle 候选，而不是原始关键词/topic 基数。

流行度证据
- npm 下载量来自 npm 包/下载元数据。
- GitHub 星标取自 GitHub discovery，当结果中已包含它们时。
- 如果某个可见的 npm 发现的插件有 GitHub 仓库但没有星标数，客户端会在 Browse 结果渲染后 请求缺失的仓库统计信息。
- 异步星标查询会被缓存，并仅限于可见结果；失败会被忽略，而不会导致 Browse 失败。

排序

排序标准相互独立且可组合：

- Stars
- Downloads
- Freshness
- Name

点击某个标准会循环切换：

off → descending → ascending → off

标准启用的顺序决定了优先级。

兼容性

- DSH：>=0.1.7-rc.1 <0.2.0
- 已使用 DSH 0.1.7-rc.1 测试

当发布者声明时，确切的包兼容性会从包元数据中读取。安装会由原生 DSH Plugin Manager 再次验证。

安全性

浏览器可编辑的源设置绝不包含凭据。

主机保护包括：

- 仅允许 HTTP(S) 源 URL；
- 拒绝 URL 内嵌凭据；
- 默认阻止环回、链路本地、私有、组播、保留以及其他非全局单播目的地；
- DNS 固定和重定向目的地重新验证；
- 源、响应大小、结果数量、并发和 RPC 大小限制；
- 由主机控制的私有源和环境 bearer token 允许列表；
- 在命令被暴露或发送到 Plugin Manager 之前进行安装规范验证。

Install 操作会通过原生 DSH Plugin Manager 执行第三方代码。安装前请审查源和包。

主机配置

- id: registry-aggregator
name: '@stolyarovmn/dsh-ui-registry-aggregator'
config:
timeoutMs: 10000
maxResponseBytes: 2097152
maxPlugins: 2000
maxSources: 20
maxTotalPlugins: 5000
maxRpcBytes: 4194304
concurrency: 4
privateSourceIds:
- corporate
auth:
- sourceId: corporate
tokenEnv: DSH_CORPORATE_REGISTRY_TOKEN

开发

npm install
npm test
npm run test:pack

许可证

MIT