前言¶
在 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"]
}
經過插件處理後，大致會做以下幾件事：
- 輸入模態：解析
modalities.input，併兼容input_modalities、inputModalities，把支持的文本、圖片等寫入現有模型的input字段。 - 推理檔位：兼容
supported_reasoning_levels（對象數組或字符串數組）與reasoning_levels字符串數組，更新現有模型的reasoningEfforts。 none→off：將上游的none映射爲 DSH 檔位鍵off（對應服務端值如off: "none"），並保留模型裏已有的off: null等現存值。- 過濾 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 源碼 與許可證。
典型用法¶
- 完成上述安裝後，打開 DSH Web GUI。
- 左側進入 設置 → 模型。
- 確認目標服務提供方（默認 magpie）。
- 點擊 立即同步，等待提示（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 不接受的檔位，減少手工對齊成本。進一步瞭解可訪問插件目錄頁與倉庫：
