夜雨聆风学习资料网

ARTICLE · 1362771

装插件我踩了四个坑:包名、版本、重启、启用

装插件我踩了四个坑:包名、版本、重启、启用

昨天装五个插件,从晚上八点弄到十点。不是插件难用,是装的过程一直在撞墙。今天不聊插件能干什么,只聊怎么把它装进去。

四个坑,四个报错,原文我都留着。你照着我的顺序走,能省掉那两小时。

一、包名不是网址,也不是中文名

先说装的地方。DSH 左侧有个「插件」页,点进去两个页签:「已安装」「插件市场」。市场页顶部一行小字写着「全部(10.6k)」,下面有「最近收录」。点卡片上的「安装」就行。

这是最顺的路。但我第一次没走这条,我想手动装。

「添加插件」里要填的是包名。不是网址,不是中文名,不是 GitHub 链接。比如 dshmarket、billion-context、dsh-vision-router、@liustack/modsearch。

这里踩过一个坑。我填 modsearch,提示找不到。后来才看到前面带 @liustack/,作用域包必须写全。少一个斜杠都白搭。

划重点:包名就是你在市场卡片上看到的那个字符串,原样复制,别自己改。

是不是很多人卡在这一步?觉得「名字差不多就行」。不行,差一个字符都不行。

二、版本闸:差两个 rc 版本,装不进去

坑一,版本不兼容。我装 dsh-vision-router,报错原文:

install: dsh-vision-router exit=1 err=... Pick a compatible version; to install this exact one anyway, grant the host's exact-version exemption for it first (plugin manager, or dsh's allow-version) and retry

翻译成人话:版本对不上,要么换个兼容的版本,要么开豁免强装。

原因我后来查了。3.2.1 的 package.json 里写着 engines.dsh: >=0.2.1-rc.5 <0.3.0-0。我宿主是 0.2.1-rc.3。差两个 rc 版本,被版本闸拦下。

两个选择。①装旧版:我装了 3.1.5,它的 engines 是 >=0.2.0-rc.2 <0.3.0-0,能对上。②升级宿主到 0.2.1-rc.5 以上,再装最新版。

我选了①。为什么不硬开 exact-version 豁免?因为强装之后,插件调用的接口可能跟宿主对不上,后面出问题更难查。

顺带一提,装 3.1.5 那一刻,DSH 自动重启了。

三、重启不是小事:端口从 36500 变成 13674

坑二,装完会重启宿主。这是我没预料到的。

重启的瞬间,本地网页端口从 36500 变成了 13674。我正在跑的会话被打断。不是数据丢了,是那个页面连不上了,得重新开。

如果你在写长文、跑任务,中途装插件,就是给自己找麻烦。

我现在的习惯:装插件之前,先把手上正在跑的东西停掉。等它重启完,端口稳定了,再继续。

划重点:别在干活中途装插件。重启不挑时间,它想重启就重启。

这里要注意一点,端口变了之后,你之前收藏的本地地址就失效了。重新从 DSH 里点开,别用旧链接。

四、装上了,不等于能用

坑三,这个最隐蔽。dsh-vision-router 装好了,显示「已安装」。我第一次调用,报 VISION_TIMEOUT。

它默认配了四个免费视觉后端:Qwen3.5-397B、Qwen2.5-VL-72B、Qwen3.6-27B、Qwen3.5-9B。我这网络,一个都连不上。

不是插件坏了,是后端连不通。

解法:改 ~/.dsh/profiles/desktop/cordis.patch.yml。找到 - id: vision-router 那一段,加 httpProviders,指向你能连通的 OpenAI 兼容端点。

我加的是智谱:

baseURL https://open.bigmodel.cn/api/paas/v4model glm-4v-flashapiKeyEnv ZHIPUAI_API_KEY

改完立刻见效。我让它读公众号后台截图,五条记录连阅读数一起读了出来。

划重点:装上只是第一步,能不能用,取决于后端配没配通。

老实说,这一步对不会写代码的人不友好。但配置文件就是几行字,照着填,别怕。

五、最后一道门:启用

坑四,要启用。市场里装完,显示「已安装」。但插件可能还没启用。

有些要在插件页单独开开关。有些要在设置里选模型、填 key。不启用,它就在那儿躺着,你以为装好了,其实没干活。

我一开始也想不通:都显示已安装了,为什么还要再点一下?后来明白了,「安装」是把文件放进来,「启用」是告诉宿主可以调用它。两件事。

怎么查装没装上?两个土办法。

一,插件页「已安装」里能不能看到它。二,去 ~/.dsh/profiles/desktop/package.json 的 dependencies 里搜包名,看版本号对不对。

这两个办法不高级,但管用。

六、我的顺序:先看 engines,再装,装完立刻试

撞完这四个坑,我总结了一个顺序。

先看 engines 要求。在市场卡片或 package.json 里,看它要的宿主版本。对不上,直接装兼容的旧版,别硬来。

再装。装之前停掉手头的活,接受它会重启。

装完立刻试用。别等。马上调一次,看报什么错。能用就留下,不能用就查后端配置。

最后确认启用。开关开了,模型选了,key 填了,才算完。

装插件最省事的顺序是「先看 engines 要求→再装→装完立刻试用→不能用就查后端配置」,不要一上来装最新版。最新版往往要求最新的宿主,你宿主没升,就是给自己找报错。

现在你可以打开插件页,数一数「已安装」里有多少个是真在用的。我数了一下,五个里有两个还在跑,另外三个装完就没动过。

你那几个呢?

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料