前言¶
在 DSH 裏用 Magpie 聚合的多供應商模型，常見做法是手動配網關 URL、導入模型列表，或在瀏覽器裏單獨打開 Magpie 管理頁查額度。模型一多，分組、路由和額度往往分散在多處，和 DSH 會話裏的模型選擇也對不齊。下面介紹社區插件 dsh-plugin-magpie：在不動 Magpie 核心、不接管賬號策略的前提下，把目錄同步、聊天補全路由和桌面端原生後臺收進 DSH 一套流程。
這是什麼¶
dsh-plugin-magpie 由 jesongit 維護，歸類爲「模型推理」。定位是輕量 Magpie → DSH 連接器：不修改 Magpie 或 DSH、不攜帶 Magpie 前端包、不復制供應商登錄態或改路由/賬號。
插件從 Magpie 的 /v1/models 自動同步，按 provider（供應商） 在 DSH 裏註冊獨立分組（路由組單獨展示）；所有分組共用一個 Chat Completions 適配器，完整上游模型 ID 原樣發送，賬號輪詢與回退仍由 Magpie 決定。桌面端可在工作區通過受管原生 webview 打開 Magpie 原版管理後臺，並用一次性啓動憑證完成 POST 自動登錄；當前會話選中本插件註冊的 Magpie 模型時，輸入框下方會出現按模型路由匹配的額度入口與彈窗。
核心功能¶
連接與模型目錄¶
- 在 DSH 設置 → Magpie 填寫管理後臺 URL 與頁面登錄密鑰（不是僅模型接口的網關端口，也不能把 API Key 當作後臺密鑰）。
- 可顯式允許創建 DSH 專用網關 Key，或在高級設置中填寫已有網關 Key；高級設置可指定外部可達的網關 URL。
- 目錄約每五分鐘共享刷新，失敗時保留上次目錄並標記過期；後臺頁面與模型調用彼此獨立。
- 支持流式文本、reasoning、工具調用與結果、圖片附件、用量、取消；推理檔位與上下文來自目錄。0.2.0 起過濾推理檔位
default，未選時默認high；對聲明priority服務檔的模型提供 Codex 速度選擇（標準/快速），快速時請求帶service_tier: "priority"。
桌面原生後臺¶
- 須先配置 URL + 密鑰併成功連接，工作區上方 Magpie 導航項纔會加載後臺；否則友好引導。
- 桌面 DSH 用協議版本 1 的受管 webview 加載 Magpie 原版後臺，無 Browser 工具欄；首次打開通過一次性內存憑證 POST 登錄，不再在頁面裏重複輸入已配置的密鑰。
- 首次打開後只保留一個原生網頁容器，切到其他面板僅隱藏，不重複加載或丟失後臺頁籤狀態；斷開、換 URL、成功重連或卸載插件時釋放。
- 純 Web 端可用模型與設置，但打開後臺會明確提示需使用 DSH 桌面窗口，不自動降級 iframe。
按模型的額度入口¶
- 額度入口僅在當前會話選中本插件註冊的 Magpie 模型時出現，按模型路由精確匹配供應商，不按 GPT/Claude 等名稱猜測。
- 彈窗只列該供應商合併額度，排除名稱、池或單位中明確標爲工具、MCP、搜索等非推理額度；只讀 Magpie
kept=1快照，Host 共享緩存，當前 Magpie 模型顯示期間低頻讀緩存，彈窗打開可更新快照。 - 入口與彈窗使用結構化時間展示（
R=距重置、L=距到期），圖標優先使用 Magpie 內嵌供應商 logo，匹配不到則回落喜鵲單色圖標（當前版本 0.2.4）。
安全與存儲（摘要）¶
- 服務端敏感狀態保存在
$DSH_HOME/plugins/magpie/connection.json（含後臺/網關密鑰等），原子替換、Unix mode 0600，非加密存儲；保護 DSH 用戶目錄與備份。 - 普通狀態 RPC 不返回密鑰；啓動專用 RPC 僅對已鑑權 owner 返回一次臨時登錄 POST 描述。插件以當前 DSH 進程權限運行，安裝前宜自行查看源碼與 MIT 許可證。
安裝與啓用¶
要求 DSH 0.2.1-rc.5+、Cordis 4.0.5、Node 24，且原生後臺面板依賴 DSH 桌面端。使用與正在運行的 DSH 對應的 CLI 與 profile；桌面安裝版自帶 CLI 位於應用 resources/runtime/cli/bin。
從 GitHub 安裝（Git 直裝）：
dsh plugin --profile desktop add github:jesongit/dsh-plugin-magpie
添加後重新加載插件或重啓 DSH 使服務端生效。插件通過 dsh.bundle.patch 自動掛載，編譯完成後無需改 DSH 核心或另起替代 Web 服務。
典型用法¶
- 在 Magpie 開啓現有的 Browser access，或使用已有
magpie web管理服務。 - DSH → 設置 → Magpie，填寫管理後臺 URL 與頁面登錄密鑰；按需選擇允許創建 DSH 專用網關 Key，或在高級設置填寫現有網關 Key。
- 點擊連接並同步。
- 在模型選擇器使用
Magpie · Codex、Magpie · WorkBuddy等分組；現有手動導入配置不會被修改，默認模型不會被切換。 - 桌面端從工作區 Magpie 導航進入原版管理後臺；選中某 Magpie 模型後，可在輸入框下方查看該供應商額度彈窗。
遠程模型訪問需已具備 Magpie 所要求的共享與 Key 權限；插件不會開啓網絡共享、改路由/賬號。
適用場景與注意¶
適合：已在用 Magpie 做多賬號/多供應商聚合，希望在 DSH 裏按 provider 分組選模型、走統一 Chat Completions 適配，並在桌面端內嵌打開管理頁、按當前模型看供應商額度，而不想再維護一套平行配置。
注意：
- 插件不讀取
.env；連接信息寫入本機connection.json，請以源碼與 README 中的安全說明爲準。 - 協議選擇通用 Chat Completions，由 Magpie 翻譯上游；不宣稱無損保留所有廠商私有 Responses replay/加密推理狀態。
- 社區插件目錄 SkillHub 上的條目 與 GitHub 倉庫由維護者發佈，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，安裝前請覈對倉庫與許可證。
結尾¶
dsh-plugin-magpie 把 Magpie 的模型目錄、調用鏈路與（桌面端）管理後臺接到 DSH，邊界清晰：不改 Magpie 賬號策略、不自帶 Magpie 前端分發包。需要細節、構建命令與驗證限制時，以倉庫 README 及 docs/verification.md 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/jesongit/dsh-plugin-magpie
- GitHub：https://github.com/jesongit/dsh-plugin-magpie
