鹊桥网关 hualuo520-h/dsh-magpie-lite

dsh-magpie-lite

把本地 magpie-lite 网关当成一个普通 DSH 供应商，装好就能在模型选择器里选。

DeepSeek Harness 的模型选择器会多出一组 magpie-lite，列出你在网关控制台里启用的所有模型 — 一处配置，DSH / Claude Code / Codex 共用同一批模型。

安装

从插件市场安装（推荐）

DSH 设置 → 插件市场 → 搜 dsh-magpie-lite → 安装。
这一条路走 npm 预构建包，不需要 pnpm 的 allowBuilds 授权。

命令行安装

dsh plugin --profile web add dsh-magpie-lite

手动安装

Copy-Item -Path "<仓库>\*" -Destination "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-magpie-lite" -Recurse -Force

装好后在 profiles/desktop/package.json 的 dsh.profile.bundles 里加上 dsh-magpie-lite，然后重启 DSH 桌面端。

从源码安装时 pnpm 会拦 build scripts，需要在 profile 的 pnpm-workspace.yaml 里手动加 allowBuilds；
npm 包是预构建的，没有这个问题。

它怎么工作

DSH 模型选择器 │ 选中 magpie-lite/deepseek-chat ▼ dsh-magpie-lite（本插件） │ 定位网关的 config.json（见下） │ 用 pi-ai 的 openAICompletionsApi 建 provider │ ctx.llm.registerAdapter(['magpie-lite'], adapter) ▼ magpie-lite 网关 http://127.0.0.1:19998/v1 │ 按 provider/model 前缀转发 ▼ DeepSeek / GLM / Kimi / OpenCode Zen / OpenRouter / Ollama / Pollinations

插件不碰请求内容 — 协议转换、流式、工具调用全部由网关负责。

插件怎么找到网关的配置

网关的安装位置因人而异，所以插件不写死任何路径。按优先级尝试：

1. MAGPIE_LITE_CONFIG 环境变量 —— 指向你的 config.json
2. $MAGPIE_LITE_HOME/config.json —— 网关闭套件的安装目录
3. 指针文件 <DSH home>/magpie-lite.json —— 网关启动时自动写入，记录它自己那份 config.json 的绝对路径。这是最主要的方式，网关装在哪儿都能找到
4. <DSH home>/magpie-lite/config.json —— 约定位置，供网关没在跑时兜底
5. 插件自带的 config.json

<DSH home> 取 $DSH_HOME，否则 ~/.dsh。

网关跑着的时候指针文件一定是最新的；网关没跑，插件按约定位置找，找不到就报告期望位置而不是静默显示 0 个模型。

前提条件

1. 网关在跑。你需要先装 magpie-lite 网关本身（<https://github.com/magpie-lite>）——本插件只是桥，网关才做实际转发。
网关侧的开机自启：powershell -ExecutionPolicy Bypass -File <网关目录>\register-autostart.ps1
2. 至少启用一个供应商。打开 <http://127.0.0.1:19998/admin>，填 Key、打开开关。
没启用时插件仍会加载，只是模型组为空（DSH 会隐藏空组）。

常见操作

改了网关配置/新增模型

不用重启 DSH — 插件监听了 config.json，自动重新注册（约 400ms 防抖）。

网关换端口或密钥

改 config.json 的 port / gatewayKey，插件下一次重读即生效。
注意端口变化时，网关地址也随之变，插件读的是同一个文件，所以天然一致。
但如果指针文件里的 baseUrl 是旧的（比如网关用 PORT=xxxx 手动起过一次），以 config.json 里的 port 为准 —— 插件最终用的是 config 的地址。

网关配置文件不在默认位置

设环境变量 MAGPIE_LITE_CONFIG 指向你的 config.json，然后重启 DSH。
网关闭套件装在别处时，也可以设 MAGPIE_LITE_HOME 指向它的目录。

诊断

CLI 能单独跑，不依赖 DSH：

node "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-magpie-lite\lib\bin.js"

输出路由地址、密钥前后缀、以及会注册的模型清单。若这里模型数为 0，问题在网关侧而非 DSH。
它会打印实际使用的 config.json 路径 —— 若不是你预期的那个，检查 MAGPIE_LITE_CONFIG / MAGPIE_LITE_HOME 和指针文件。

网关日志：<网关闭目录>\data\gateway.watch.log（守护重启记录）、data\boot.log。

已知限制

- 模型清单来自 config.json，不实时查询上游。网关《模型》页显示什么，插件就注册什么。
- 只声明了 text 模态。图片能否用取决于上游模型本身。
- stop 序列不支持 — 这是 pi-ai 的通用限制，不是本插件的问题。

模型名后缀

免费模型在显示名后带 （免费） 后缀（DSH 模型选择器里显示为 openai（免费））。
判据是 config.json 里该供应商的 free: true：

{ "id": "pollinations", "free": true, "models": ["openai", "openai-fast"] }

必须是显式声明 free: true，不能按「没填 apiKey」推断 —— 否则 DeepSeek / 智谱 / Kimi 这些要付费、只是 Key 还没填的供应商会被误标成免费。
后缀只改显示名，模型 id（provider/model）不变，路由和调用不受影响。