夜雨聆风学习资料网

ARTICLE · 1245043

还有人不会用dsh官方插件市场?干货分享来了

还有人不会用dsh官方插件市场?干货分享来了

朋友你好,欢迎光临万事屋。

最近看到不止一个人在问同一件事:DSH 的插件市场,打开「发现」是一片空白,什么都没有。有人以为功能坏了,有人填了地址一直读不出来,也有人装完插件发现升级不了。

我把踩过的坑和验证过的配置写成这篇。不讲实现、不讲代码,只讲怎么用、在哪儿配、填什么,和两个能直接复制走的索引源。

第一件事要知道的:「发现」是个空壳

DSH 出厂状态是不带任何插件市场的。官方文档写得很直白:不内置任何索引源,用户添加之前不发任何市场请求。

所以「发现」页刚打开时那句「还没有插件市场」不是 bug,是设计。它是个读取器,你得先告诉它去读哪个文件,它才有东西可列。那个文件叫 index.json,浏览器里就能打开,添加索引源要填的就是它的网址。

第二步:把「自定义插件市场」这个开关打开

它属于实验性插件,默认是关的:左侧栏「插件」,往下找到「实验性插件」,把「自定义插件市场」打开。列表里找不到这一项的话,点右边的「更多」展开再开。

开完插件页顶上就会多出两个标签:「已安装」和「发现」。后面所有操作都在「发现」里。

图一是这一步的样子,红框那行就是必须打开的开关。

图一 · 在「实验性插件」里打开「自定义插件市场」(找不到就点右边「更多」)

第三步:添加索引源

在「发现」页点「添加索引源」,弹出一个小窗口,输入框里填索引文件的完整网址,点「添加」就行。

填的时候有三个小规矩:要填到 index.json 本身,别只填目录;地址里不要带用户名密码,也不要带 # 后面的片段;网址会跳转的(301、302 那种)要填跳转后的最终地址,DSH 不跟跳转。同一个地址只能加一次。

窗口底部有一行橙色提示,别跳过:索引由第三方提供,只添加你信任的来源,里面的插件装完之后以你的权限运行。意思是——市场里的名字、作者、评分都是提供方自己写的,DSH 不替你核实。

图二是这一步。

图二 · 「索引源」窗口:填 index.json 的完整网址,点「+ 添加」

第四步:浏览、搜索、安装

配好源之后,「发现」页顶上有四样东西:市场切换器、搜索框、分类标签、排序。

加了两个源的话,左上角那个下拉就是切换市场的,浏览的内容跟着它变,底下最后一项是「管理索引源」。红框标出来的就是这个下拉。

图三是一个已经配好的市场长什么样。

图三 · 配好之后:左上角红框是市场切换下拉,卡片右边是「安装」

搜索是模糊匹配,而且对中文友好——你打「插件市场」,不用空格也能搜到。搜不到某个插件的时候,先看左上角切在哪个市场上:第三方插件商店里看到的东西,官方「发现」里不一定有,这是两套独立的数据。

安装就是点卡片右边的「安装」。点完会弹一个确认框,上面写清楚了这次要装的是哪个版本号、来源是哪里。不点确认就什么都不会装。 这一步值得看一眼,装完想复盘也知道装了什么。

配好之后,有四条值得记住

第一条最容易撞:不支持原地升级。索引里出现新版本,卡片会显示有更新,但不能直接升级,得先卸载再安装。

第二条:想改索引源,界面里改、文件里改都行,改的是同一份东西,界面最省事。但别同时开两个窗口改,后保存的会覆盖先保存的。

第三条:至少配两个源互备。我见过 CDN 突然连不上、市场整页空掉的情况,有第二个源就不慌。

第四条:只用 https 的地址。http 的索引在传输路上被人动过手你也不知道。

两个索引源,可以直接复制

第一个,条目最多,我实测读取最快,独立域名:

https://awesome-dsh-plugin.com/index.json

第二个,GitHub Pages 托管,条目少一些,读取慢一点:

https://polang233.github.io/dsh-plugin-index/index.json

我今天在本地实测拉取的数据:第一个是 3444 个插件、2.7 MB、1.2 秒读完;第二个是 881 个插件、1.3 MB、17 秒读完。慢是因为 GitHub Pages 那边慢,不是文件有问题。这两份索引的格式版本都是 1,都是社区维护的第三方市场,跟官方没有隶属关系。

数字每天在变,你自己添加之后以你看到的为准。

几个常见现象,对一下就好

「发现」整页空白,提示还没有插件市场——正常出厂状态,加索引源。

提示读不到索引源——先在浏览器里把这个网址打开看一眼,打不开是网络问题,能打开就点「重试」,超时上限十五秒。

提示格式无效——那份索引不合规,让发布者修,你这边绕不过。

提示用 http 或 https 地址且不要包含什么——检查地址里有没有账号密码和 # 片段。

卡片显示有更新但点不动——就是第一条,卸载再安装。

装的时候被拒绝、说兼容性不满足——那个版本要求和你当前的 DSH 版本对得上,换一个匹配的版本。

某个源整个市场全空——网络到那个域名的链路问题,切另一个源,别在死链路上重试。

最后

这件事真正麻烦的地方不在操作,在很多人卡在「发现是空的」那一步,误以为是自己装坏了,于是去重装、去查设置。它是空的,因为你还没喂它。

也提醒一句:插件装进来就以你的身份运行。所以别追求插件数量,装自己需要的、来源看得清的。两个源里四千多个插件,绝大多数你用不上,这很正常。

—— 星梦同学,万事屋店长

想看更多,把「星梦同学的万事屋」放在常看的号里就行。

有问题、想看什么,直接后台回复——每条我都会看。

文中事实来源

  • DSH 官方插件市场服务文档与索引格式规范(deepseek-ai/deepseek-harness 仓库 master 分支,plugin-market README 与 2026-10-02 索引格式说明)
  • 本地实测:2026-10-25 直接 GET 两个索引文件,均返回 200 且未发生跳转,顶层格式版本为 1;条目数、体积、耗时见正文
  • 本机配置核查:profile 的 cordis.patch.yml 中 plugin-market 一项的 indexes 字段,界面「添加索引源」写入的就是这份文件
  • 插件数量统计取自当日索引文件快照,已存本项目 01_sources/snapshots 目录
  • 两个索引源均为社区第三方维护,标题与插件条目由提供方自行声明,本文未做背书

本文由 AI 辅助撰写、经人工审校。操作步骤与提示文案依据官方文档与本机实测核对,插件数量与读取耗时为当日本地实测值,会随时间变化。

如果觉得文章有帮助的话,记得多多转发让更多人看到哦。

相关学习资料