dsh-magpie-connect

dsh-magpie-connect

把 Magpie 网关上的模型接进 DeepSeek Harness（DSH）的模型选择器。

装好之后，你就能在 DSH 里直接选用网关提供的模型，不需要额外跑进程，也不用配代理。

功能

• 模型自动同步 — 网关列出的模型全部进入 DSH 模型选择器，想显示哪些由你决定。
• 图片识别 — 网关声明支持图片的模型可以直接发图。
• 思考档位 — 网关支持的思考档位（含 none、ultra）原样出现在选择器里。

安装

dsh plugin --profile web add dsh-magpie-connect

安装后重启 dsh web。

已有安装用同一条命令即可更新到最新版本。

需要：DSH 的 web profile、Node.js ≥ 20、能访问网关。

使用

第一步：填网关地址和 Key

打开 设置 → Magpie 网关，确认两项：

• API 地址 — 网关地址，要带版本号。默认已填好 http://127.0.0.1:3425/v1，网关不在本机时改成实际地址。
• API Key — 网关凭据，必填。

> Key 保存后不会再回显到页面；输入框留空表示沿用已保存的 Key，只有填入新值才会替换。

> 「测试连接」和「获取可用模型」同样复用已保存的 Key。设置文件里仍然是原来的 JSON 结构

> （baseUrl / apiKey / enabledModels），所以降级回旧版本也能直接读取。

> 插件自有状态目录在 POSIX 系统上为 0700、settings.json 为 0600；旧版本留下的宽权限

> 会在下次读取时自动收紧（只读文件系统或非 POSIX 平台会跳过，不影响设置读取）。

点「保存」后，可以点「测试连接」确认通不通（会告诉你网关上有多少模型）。两项都齐了才会生效——

地址有默认值，Key 没有，所以没填 Key 之前模型选择器是空的。

> 地址一定要带版本段（如 /v1）。插件只在你填的地址后面接资源名，不会自己补

> 版本号——所以网关以后升级到 /v2、/v3，你只要改这一个字符串。

第二步：选择要显示的模型

点 获取可用模型，会弹出网关当前的模型列表：勾选你想要的，再点「应用选择」。

弹窗里可以搜索、全选、取消全选。

模型选择器、已选模型列表和弹窗统一显示 <组名>/<模型名>：模型名直接取 API 的

display_name；组名优先取 magpie_label 最后一个 · 右边的部分。若 magpie_label

缺失或没有可解析的组名，则取 id 第一个 / 前的部分，并仅将首字母大写（例如

workbuddy-ai/hy4free → Workbuddy-ai/Hy4）。auto/ 和 group/ 是特例：组名始终从 id 前缀

生成（Auto、Group），不使用 magpie_label 中的通用组名。

原始路由 id 只在鼠标悬停时显示，请求、会话历史和白名单里始终是 id，所以改显示名

不会影响已保存的选择或历史会话。搜索可以同时按显示名和 id 匹配，列表按显示名排序。

> 如果 API 没有返回 display_name，显示名回落到原始 id。旧版本留下的本地模型缓存

> 暂时以 id 显示，等下一次成功读取网关目录后自动换成新标签。

模型列表是白名单，和 DSH 自带的「模型」设置语义一致：列表里有什么，选择器就提供

什么。不想要的点该行末尾的「删除」，它就从列表和选择器里一起消失；想加回来，点

「获取可用模型」，在弹窗里勾上它再「应用选择」。

新增的模型不会自己出现：网关新上架的模型要你在弹窗里勾选并应用后才会进入列表。

这是白名单的代价，也是它的好处——网关某条 lane 抖动（临时掉线又恢复）不会把你删掉的

模型偷偷放回来。

「恢复默认模型」：清掉自定义列表，回到「直接使用网关的完整目录」。列表为空

（[]）和继承网关目录是两种不同状态：前者一个模型都不提供，后者全提供。

「获取可用模型」会同步本地目录：弹窗拿到的就是网关此刻的完整目录，读取成功后本地

目录整体替换成它，所以网关已下架的模型会同时从弹窗和列表消失；读取失败（地址错、

Key 无效、网关不通）不会清空本地目录，避免把选择器误清成空。

> 行末的 内置快照 标签说明这条来自插件的兜底快照（网关暂时不可达时），不是网关当前列表。

> 弹窗查的是你当前填的地址和 Key（哪怕还没保存），所以换网关是一趟的事。

> 连不上也不会卡住——失败原因会显示在列表下方，已列出的行仍然可以操作。

什么时候需要保存

• 地址和 Key：点「保存」才生效。
• 模型增删：自动保存，不用点任何按钮。

常见问题

模型选择器是空的？

先确认地址和 Key 都填了并且已经保存，再点「测试连接」。最常见的原因是地址缺了版本段

（比如填成 http://127.0.0.1:3425，而应该是 http://127.0.0.1:3425/v1）。

删掉的模型怎么加回来？

点「获取可用模型」，在弹窗里勾上它再「应用选择」。弹窗列出的是网关当前提供的全部

模型，勾选会替换整份列表——只想保留某几个，就只勾那几个。