前言¶

在 DeepSeek Harness（DSH）里接 Magpie 等聚合网关时，模型列表往往来自上游的 /v1/models。DSH 内置的 dsh-llm-pi-ai 在拉取该接口时会丢掉部分扩展字段，结果是：你在 Magpie 侧已经宣告的多模态输入、推理档位等信息，本地模型元数据里对不上，Web 里选模型、配 reasoning effort 时只能手填或猜。

下面介绍社区插件 @ovv/dsh-magpie-sync（仓库 outloudvi/dsh-magpie-sync），它按 Magpie 宣告的能力写回 DSH 现有模型配置，并在 Web 设置里提供一键同步。维护者为 outloudvi，在插件目录中归类为「模型推理」。

这是什么¶

一句话：@ovv/dsh-magpie-sync 为 DSH 增加「利用 Magpie 宣告的输入模态及 thinking level 信息」的能力。

插件通过 Cordis patch 与 Web 客户端注入（依赖 @deepseek-ai/dsh-client-ui-settings-models 等），在 设置 → 模型 界面为指定服务提供方（默认 magpie）提供 立即同步 操作，无需改上游网关本身。

核心功能¶

同步逻辑针对 DSH 已存在的模型条目做更新，而不是凭空创建整套 catalog。上游 /v1/models 可能返回类似下面的能力描述：

{
  "id": "copilot/gpt-6-sol",
  "modalities": { "input": ["text", "image"] },
  "reasoning": true,
  "reasoning_levels": ["none", "low", "medium", "high", "xhigh", "max", "ultra"]
}

经过插件处理后，大致会做以下几件事：

1. 输入模态：解析 modalities.input，并兼容 input_modalities、inputModalities，把支持的文本、图片等写入现有模型的 input 字段。
2. 推理档位：兼容 supported_reasoning_levels（对象数组或字符串数组）与 reasoning_levels 字符串数组，更新现有模型的 reasoningEfforts。
3. none → off：将上游的 none 映射为 DSH 档位键 off（对应服务端值如 off: "none"），并保留模型里已有的 off: null 等现存值。
4. 过滤 DSH 不支持的档位：DSH 所用 llm-pi-ai 适配器在 catalog 定义 里只允许 off、minimal、low、medium、high、xhigh、max 七档，没有 ultra。若把 ultra 写进配置，整份服务提供方配置会校验失败；因此同步会自动过滤 ultra 等非法档位，并在结果中说明原因。README 亦注明：插件暂未提供将 max 映射到上游语义上 ultra 的能力。

当前 npm 包版本为 0.4.0（见仓库 package.json），协议 MIT。

安装与启用¶

官方 README 给出的安装方式为向 web profile 添加插件并启用 watch：

dsh plugin --profile web add @ovv/dsh-magpie-sync -w

说明：--profile web 与包内 dsh.client.platform: "web" 一致；-w 便于开发时监听变更。插件以当前 DSH 进程权限运行，安装前建议自行查看 GitHub 源码 与许可证。

典型用法¶

1. 完成上述安装后，打开 DSH Web GUI。
2. 左侧进入 设置 → 模型。
3. 确认目标服务提供方（默认 magpie）。
4. 点击 立即同步，等待提示（README 示例文案为「Magpie 模型能力同步：已更新 1 个现有模型的元数据」一类反馈）。

同步只更新已在 DSH 中配置的模型；若列表为空或 id 对不上，需要先保证 Magpie 提供方与模型 id 与上游一致，再执行同步。

适用场景与注意¶

适合谁：已在 DSH 中接 Magpie、且希望 Web 里模型输入类型（文本/图片等）与 reasoning effort 选项与 Magpie /v1/models 保持一致，又不想手工维护 reasoningEfforts 的开发者。

注意：

• 档位名称必须以 DSH 内置 Schema 为准；上游多出来的 ultra 会被丢弃，不是 Magpie 侧 bug，而是 DSH 校验约束。
• 社区插件目录 skillhub.cn 条目 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文仅作能力说明，不构成安全审计。
• peer 依赖包括 @deepseek-ai/cordis（^4.0.2）、@deepseek-ai/schemastery（^3.18.2），需与本地 DSH 版本匹配。

结尾¶

dsh-magpie-sync 把 Magpie 宣告的输入模态与 thinking level 写回 DSH 现有模型元数据，并过滤 DSH 不接受的档位，减少手工对齐成本。进一步了解可访问插件目录页与仓库：

• 目录：https://www.skillhub.cn/plugins/outloudvi/dsh-magpie-sync
• GitHub：https://github.com/outloudvi/dsh-magpie-sync