插件市场
DSH 官方插件索引(format 1)在 Studio 里的接入方式:索引源、请求模型、内置社区索引与安装路径。
插件市场使用 DSH 官方的插件索引。这是一份 format: 1 静态 JSON,列出可安装的 bundle 及其标题、图标、作者、版本、engines.dsh 兼容范围与安装源。Studio 通过 Host 的 pluginMarket 服务读取索引。桌面版可以预置产品索引,随包内置的社区索引也可作为没有配置任何索引源的 profile 的默认源。
- 内置社区索引:
assets/plugin-market/index.json,由 Host 在GET /api/agentkit.plugin-market/index.json提供给官方读取器。 - 用户索引源:属于当前 profile,可在「发现」页添加、删除、切换。
- 安装、启用/停用、更新、卸载仍由官方 DSH 插件管理器执行。
为什么不再自建聚合
旧实现每次冷加载要打 16 个外部请求(npm 搜索 + GitHub 搜索 + 14 份完整 packument),串行叠加最坏 24 秒,还受 GitHub 未授权 10 次/分的限流。索引方案把列表页需要的全部信息放进一份文档:一个市场页只需 1 次 GET / 索引源,搜索、筛选、排序与翻页都在 Host 内存里完成。
请求模型
| 操作 | 外部请求数 |
|---|---|
列出索引源(listIndexes) | 0(只读配置) |
| 首次读取某个源 | 1 |
| 10 分钟 TTL 内再次读取 | 0 |
显式刷新(refresh: true) | 1 |
| 翻第 2 页及以后 | 0(fetchedAt 锚定同一份文档) |
| 搜索 / 筛选 / 排序 | 0(Host 侧内存索引) |
主机参数:cacheTtlMs 默认 600000(10 分钟)、fetchTimeoutMs 默认 15000、maxBytes 默认 128 MiB;单页最多 100 条。索引文档在 Worker 线程里解析,不阻塞 Host 事件循环。
索引格式
根字段:format(必须为 1)、title(必填,LocalizedText)、description、metadata、plugins[]。插件字段:name(npm 包名,索引内唯一)、title、description、icon、author、homepage、repository、metadata、versions[]。版本字段:version(精确 SemVer)、publishTimestamp(Unix 秒)、source({"type":"npm"}、{"type":"git","url","commit","path"} 或 {"type":"tarball","url"})、engines.dsh(SemVer range)。
{
"format": 1,
"title": { "en": "DSH Community Plugins", "zh": "DSH 社区插件" },
"metadata": {
"sortKeys": { "downloads": { "title": { "en": "Downloads", "zh": "下载量" }, "order": "desc" } }
},
"plugins": [
{
"name": "dshmarket",
"title": { "en": "dshmarket", "zh": "dshmarket" },
"metadata": { "keywords": ["dsh-plugin"], "sortKeys": { "downloads": 1289262 } },
"versions": [
{ "version": "1.73.20", "publishTimestamp": 1790476800, "source": { "type": "npm" }, "engines": { "dsh": ">=0.2.0" } }
]
}
]
}未定义的成员会被忽略(可扩展);格式违规会整份拒绝并给出 JSON 路径——没有一个坏条目能悄悄消失。
内置社区索引
| 文件 | 作用 |
|---|---|
assets/plugin-market/index.json | 索引文档(format: 1),随包分发,由 Host 提供 |
assets/plugin-market/sources.txt | 生成输入:每行一个 npm 包名 |
scripts/build-plugin-market-index.mjs | 生成器 / 校验器 |
pnpm build:plugin-index # 重新生成(读 sources.txt,为空时按下载量取前 80 个包)
pnpm check:plugin-index # 不联网,只校验已提交的产物收录规则:只保留合法 SemVer、有发布时间、未弃用、未私有的版本,每个插件最多 20 个;输出按下载量降序、同分按包名升序,确定性(无时间戳、无随机),因此刷新在 review 里只体现为数据变化。
桌面版默认索引
在 src/product.json 中设置 desktop.defaultPluginIndexUrl。地址指向可直接读取的 HTTPS 索引文档,省去凭据、查询参数和片段。macOS 和 Windows 安装包都会携带这个配置。使用 null 可关闭预置。
首次启动带有该地址的桌面版本时,Studio 将它放在当前 profile 的索引列表首位,保留其它索引顺序并合并重复 URL。「发现」会默认打开首个索引,用户可随时切换。手动删除产品索引后,同一桌面版本重启会保留该修改。
把索引留在固定的 KS3 URL。新增插件或更新版本时,先上传带版本号的 .tgz,再把新的版本和下载地址写进同一个 index.json。打开「发现」并刷新即可重新读取,索引内容更新无需重新打包桌面版。
安装路径
Host 将 npm 版本解析为 name@version(可带 registry),Git 版本解析为 git+<url>.git#<commit>(子目录追加 &path:/<dir>),tarball 版本使用下载地址。用户确认后,DSH 插件管理器负责下载、兼容性检查、构建脚本批准和失败回滚。
从对象存储安装
把构建好的 DSH bundle 打成 npm tarball,上传到 KS3 等对象存储,并为该文件提供可直接读取的 HTTPS 地址。地址使用版本化的文件名,以 .tgz 或 .tar.gz 结尾,省去凭据、查询参数和片段。索引的包名和版本应与包内的 package.json 一致,包需声明 dsh.bundle。
{
"format": 1,
"title": "Studio plugins",
"plugins": [
{
"name": "@example/dsh-workspace-tools",
"versions": [
{
"version": "1.2.3",
"publishTimestamp": 1794600000,
"source": {
"type": "tarball",
"url": "https://downloads.example.com/plugins/workspace-tools-1.2.3.tgz"
}
}
]
}
]
}发布 index.json 后,在「插件 → 发现 → 索引源」添加它的 URL,再选择该索引并点击「安装」。主包从对象存储下载,依赖仍由包管理器解析。客户端需要使用支持 tarball 来源的 Studio Host。
维护远程索引
在 Git 中维护 index.json,将审核后的版本发布到一个固定的 HTTPS 地址。用户在当前 profile 中添加一次该地址即可,以后的目录更新可以独立于 Studio 发版。
- 先上传带版本号的新
.tgz,从用户可访问的网络确认能下载。新插件加入plugins,已有插件在同一包名的versions中新增一项,填写实际发布时间、下载地址和包声明的engines.dsh(如有)。每个版本使用独立的文件路径。 - 在测试 profile 添加预览索引,确认「发现」能加载新目录并试装。通过后更新固定地址上的
index.json。用户可点击「发现」的刷新按钮重新读取索引。经 CDN 分发时,同时更新index.json的 CDN 缓存。 - 下架时从
versions移除对应版本。如果移除的是最后一个版本,就删除整个插件条目。回滚目录时重新发布之前的index.json,并保留它引用的包。已安装插件的启停和卸载由各 profile 的插件管理器处理。
未启用时
官方索引服务只随实验性 bundle @deepseek-ai/dsh-experimental-plugin-market-bundle(「自定义插件索引」)挂载。Studio 会在每个 profile 第一次以某个 DSH 版本启动时自动启用它(同一份默认清单还会启用 Computer Use 的 @deepseek-ai/dsh-cua-bundle),所以市场默认可用;启用失败或安装不含该 bundle 时,市场返回 PLUGIN_MARKET_UNAVAILABLE 并给出一键启用入口。
默认值每个 DSH 版本只应用一次:用户关掉某个默认 bundle 后不会被重新打开,可重试的失败(网络、pnpm)不写标记、下次启动重试;AGENTKIT_STUDIO_DEFAULT_BUNDLES=0 可整体关闭这个对齐。
安全与信任
索引是第三方内容:标题、作者、标签、来源都由索引声明,DSH 只校验格式、不验证声明。http: 索引(含其中列出的安装 spec)可能在传输途中被篡改,不受你控制的网络必须使用 https:;URL 图标由浏览器直接请求,会向图片主机暴露你的 IP 地址。安装前请核对确认框中的来源。
相关源码
| 关注点 | 位置 |
|---|---|
| 内置索引源(默认源、文档读取) | src/plugin-market.mjs |
| 内置索引路由 | src/host/routes/plugin-market-index.mjs |
| 默认启用的 bundle | src/host/default-bundles.mjs |
| 安装 / 启停 / 更新 | 官方 pluginManager(Studio 不再包一层) |
| 索引生成器 | scripts/build-plugin-market-index.mjs |