本目录是给 DeepSeek Harness 的 Discover 页面用的市场索引,格式遵循
@deepseek-ai/dsh-plugin-market-index 的 format 1。它也是本仓库的 GitHub Pages
发布源(main 分支的 /docs),因此部署后索引地址就是仓库 Pages 根下的 index.json。
| 文件 | 作用 |
|---|---|
index.json |
市场索引:标题/分类/标签 + 插件条目 + 每个版本的 npm 来源与兼容范围 |
icon.svg |
插件图标(index.json 里用相对路径 icon.svg 引用,按索引 URL 解析) |
README.md |
本说明 |
索引已用官方校验器(format 1)验证通过。发布前建议再跑一次:
node -e '
const { parseMarketIndex, marketInstallTarget } = await import("@deepseek-ai/dsh-plugin-market-index")
const doc = JSON.parse(require("fs").readFileSync("docs/index.json", "utf8"))
const parsed = parseMarketIndex(doc, "https://xixi-kitchen.github.io/dsh-quickbar/index.json")
for (const p of parsed.plugins) for (const v of p.versions) console.log(marketInstallTarget(p.name, v))
'
(该包随 DSH 安装提供;也可用 node --input-type=module 从 DSH 运行目录引用。)
Settings → Pages:Source 选 Deploy from a branch,分支 main,目录 /docs。生效后索引地址为:
https://xixi-kitchen.github.io/dsh-quickbar/index.json
设置 → 插件 → Discover → 添加索引,粘贴上面的 URL。快捷唤起 或 quickbar 即可看到插件;安装时市场会把版本解析成
dsh-quickbar@0.1.0 交给 plugin_manager install_bundle。要求:索引与图标都必须通过 HTTPS 提供(或与索引同源)。图标也可以用
data:image/svg+xml;base64,…内联(≤32 KiB),这样单文件index.json即可。
package.json 升 version,npm publish;在 docs/index.json 的 plugins[0].versions 最前面加一条:
{ "version": "0.2.0", "publishTimestamp": <Unix 秒>, "source": { "type": "npm" }, "engines": { "dsh": ">=0.2.1-rc.2 <0.3.0-0" } }
dsh-plugin-market 有缓存,默认 10 分钟)。engines.dshengines.dsh 决定 Discover 里的兼容性判断。插件使用 Typert Remote 与
ctx.subprocess/ctx.llm/ctx.workspaceRegistry,已在 DSH 0.2.1-rc.3 上验证;
当前写的是 >=0.2.1-rc.2 <0.3.0-0,如果后续验证了更宽的范围可以放宽。