ARTICLE · 1386410
免费模型装上了却用不了?DSH 插件的三道关
AI 工具 · DSH 装插件
免费模型装上了
为什么设置里看不见?
适用:在 DSH(DeepSeek Harness)里装各类第三方插件的用户
用法:先认形态,再选通道,最后按三个信号验收
判断口径:装成功不看提示语,看 profile、catalog 和模型选择器三处对不对得上
本页导航
一、插件装的是 profile,不是软件
二、第一关:先认你手上是哪种 DSH
三、第二关:通道选错,等于白装
四、第三关:拿三个信号验收
五、四条红线:能跑不等于能放心用
六、五分钟排障表
一、插件装的是 profile,不是软件
几乎所有"装完找不到"的事故,都卡在同一个认知偏差上:我们习惯以为插件是装给这个软件的,实际上它是装给这个软件正在用的那份 profile 的。
DSH 的全部个人数据都收在一个 .dsh 目录里,这个目录就是它的 DSH_HOME。目录下有一个 profiles 文件夹,每一个子目录都是一套互相隔离的配置:装了什么插件、挂了哪些模型、连的是哪套凭证,全都各算各的。
同一个 DSH_HOME 里可以有 web、desktop 好几份并存。宿主启动时只认自己那一份,别的一概不读——你装进 A 抽屉,B 抽屉当然什么都没有。
①源码 CLI / dsh web 读 profiles/web
命令行 dsh plugin 能直接管,改完重启即生效
②官方桌面客户端 读 profiles/desktop
profile 由 app 独占管理,命令行写不进去
③社区壳 / 打包版 各有各的 profile
同样走它自带的管理器,别指望命令行
典型的连败两次:第一回按老经验把插件送进 profiles/web,桌面端重启后设置里空空如也;查了半天才发现这个客户端读的是 profiles/desktop——而且那个目录是第一次打开新版客户端那天才自动生成的,之前根本不存在。第二次改对 profile,入口立刻就出来了。
所以排障的第一步不是重装,是先确认目标 profile 是哪一个。一条命令就够:列出 .dsh/profiles 下都有哪些目录,再对照目录的创建时间——桌面端那份的生成时间,往往正好是你头一次启动它的那一天。
二、第一关:先认你手上是哪种 DSH
同一个插件包,装在不同形态上,手法完全不是一回事。开工前先花一分钟对号,能省掉后面半小时的试错。
1看有没有插件管理器的日志目录
如果 .dsh 下存在 .plugin-manager/logs,说明这台机器上的客户端自带插件管理通道,安装记录也会落在那里。
有日志目录,基本可以判定为"客户端独占型",命令行方案直接放弃。
2试一条只读命令
能正常输出插件清单、并且认得 --profile 参数的,是源码 CLI 那条线;报"该 profile 被独占管理"的,是客户端那条线。
这条提示不是故障,是宿主在明确告诉你:此路不通,换门。
3数一数 profiles 里有几份
只有 web 一份,多数是早期源码安装;web 和 desktop 并存,说明你也装了新版客户端,而它只吃 desktop 那份。
这一步同时回答了"我到底该往哪儿装"。
最常见的误判:三者都叫 dsh,就以为一套命令吃遍天下。实际上一份配置归一个宿主独占,跨形态套用命令,最好的结果是报错,最坏的结果是装进一个永远不会被读到的目录,然后你对着"安装成功"的提示白等。
三、第二关:通道选错,等于白装
认完形态,接下来选通道。三条路各自对应一类宿主,混着用就会撞墙。
A命令行:只对 web profile 有效
用 dsh plugin --profile web add 加包名或本地路径;装完完整退出再启动,不要只关窗口。生效的标志是 profile 的 package.json 里两处同时到位:dependencies 里有这个包,dsh.profile.bundles 里有这个包名。
少写任何一处,宿主都不会加载它——这才是"装了但没生效"的第二个隐藏原因。
B客户端插件管理器:桌面端的正门
进设置里的插件页安装。它会走自己的供应链校验,装完的登记信息在 .plugin-manager/logs 里能查到。
这是唯一正路,绕开它去改文件,多半会被下一次启动重置。
C手工 vendor:被闸门挡住时的兜底
在目标 profile 下建 vendor 目录,把插件打成 tgz 放进去,package.json 的 dependencies 写成 file:./vendor/包名-版本.tgz,再把包名追加到 bundles 末尾。
打完包要整目录复制齐全,adapter、src、locale、vendor 一个都不能漏,缺一个渠道就加载失败。另外别再往 cordis.patch.yml 里重复登记,会报 id 冲突。
两个必踩的坑:一是直接用目录路径安装,宿主会建符号链接,插件从自己目录去找宿主的 @deepseek-ai/* 就找不到了,报依赖无法解析——必须打成 tgz 再装。二是 Windows 上 npm 的 sh 包装脚本不是 cmd,命令一并发就找不到 pnpm,PATH 不修好,命令行通道全程失效。
包名必须带 scope:插件作者在仓库里点名警告过,npm 上那个不带 scope 的同名包是第三方重新打包的,源码被动过手脚,还多塞了仓库里并不存在的文件。官方发布的是带 @ebony-vinyl 前缀的版本,装前先看清。同理,版本对不上也别硬扛——它的 peer 声明只覆盖少数几个内核版本段,超前或落后的内核即使启动成功,也只是碰巧。
四、第三关:拿三个信号验收
"安装成功"这句话只能证明文件写进去了,证明不了插件活着。真正靠谱的验收,是下面三个信号同时成立。
①设置侧栏多出独立入口 说明 bundle 已被宿主接管
只有这一条不算数,入口能开而内容空白,属于渠道没加载
②本地目录里生成了模型清单 插件目录下的 catalog 文件有实际内容
按当时的版本,这里应有 8 条匿名免费车道加 17 个 Kilo 模型,例如 mimo、nemotron、kilo-auto 之类
③面板数字对得上 可用、地区受限、暂不可用、限流四栏相加等于总数
水位就是未受限可选数除以总数;未探测的只算候选,不等于能跑
三个信号齐了,再按顺序做两件事:先刷新清单,把上游最新的模型列表拉下来(它不存静态快照,所以清单会随上游变);再重新探测可用性,用你这台机器的实际出口去试。等探测跑完,打开新会话,在模型选择器里找到插件对应的分组,从里面挑一个——免费模型不是自动变成默认模型,得手动选一次。
通过标准:入口在、清单有内容、选择器里能选中并跑通一轮对话。三条缺一条都当没装好,别急着往下用。
容易误会的两点:第一,面板里出现的模型和对话框里能选的模型不是同一批——面板列全部候选,选择器只播已确认可用的。第二,改完配置必须真的重启,热重载一般只管代码改动,管不到插件清单。
五、四条红线:能跑不等于能放心用
免费额度好用,但它是别人贴钱换来的通道,规矩和自建 API 完全不同。下面四条建议在装之前就想清楚。
1工作内容不要过这条路。免费池的上游明确写过,提交的内容可能被记录并用于服务改进。公司代码、客户资料、合同条款,一律别往里贴。
2账号类渠道少碰。插件里那几组借用商业产品登录态的渠道,违反对方条款是常态,代价可能是账号被停,而不是报个错就算了。
3包名认准 scope。不带前缀的同名包已被改过,等于主动给自己开后门,这一条没有例外。
4免费不等于无限。它按会话统计速率,打满就返回 429 并标记"已达限额",下一轮自动恢复;部分模型还有地区限制,部分上游首字延迟能拖到三十秒以上,长思考阶段静默一分钟也不奇怪。
想要稳定,还是得回到"自带 Key 的聚合渠道"或者自建网关那条路。免费车道适合试模型、写草稿、跑点不敏感的小任务——把它当试驾,而不是当座驾。
六、五分钟排障表
按现象对号入座,比从头再装一遍快得多。
设置里压根没有这个入口
装进了没被读取的 profile
查 profiles 下有几份,改装到客户端实际使用的那一份,再完整重启。
入口有了,但模型列表是空的
渠道没加载起来
多半是目录安装或复制不全,重新打成 tgz 装一遍,确认 catalog 文件有内容。
命令报该 profile 被独占管理
桌面端不允许外部写入
改用设置里的插件页安装,别再试命令行。
依赖解析失败 / 找不到宿主包
目录安装走了符号链接
换成 tgz 本地包,让依赖在宿主目录下解析。
模型能用但动不动报错限流
免费池速率到顶或地区受限
刷新清单后重新探测,把受限模型移出选择,或换一条渠道。
想撤销
先备份再删
用 remove 子命令摘掉插件,删之前把 profile 的 package.json 复制一份,改坏了能退回去。
回头看,这类工具真正考验的不是手速,而是有没有先摸清宿主的结构。免费的模型天天在变,profile 和 bundles 这套装配关系却相对稳定;把"装给谁"想明白了,后面换任何插件都只是重复同一个动作。
如果这份内容帮到了你,欢迎转发给需要的同学和家长















































































