前言¶

DeepSeek Harness（DSH）把模型接入做成可插拔的 provider。若你已經在魔搭社區（ModelScope）開通推理、手裏有 ms- 訪問令牌，卻還要自己拼 OpenAI 兼容端點、在對話裏另開頁面查餘額，會多佔不少注意力。下面介紹的 dsh-connect-modelscope 是社區維護者 IFFCheckPass 發佈的 bundle 插件（分類：模型推理），把 ModelScope 註冊爲 DSH 的 modelscope 路由，並在選中該 provider 的模型時，於對話輸入框旁顯示剩餘魔粒。

這是什麼¶

dsh-connect-modelscope（npm 包名 dsh-connect-modelscope，顯示名 DSH Connect ModelScope，當前版本 0.1.0，MIT 許可證）把 魔搭社區 接到 DeepSeek Harness。

裝上之後主要做三件事：

• 在 DSH 裏提供 ModelScope 的 OpenAI 兼容推理端點 https://api-inference.modelscope.cn/v1。
• 在插件設置頁保存訪問令牌、勾選要暴露給 DSH 的模型；模型列表從官方 /v1/models 實時拉取。
• 當前會話選用 ModelScope 模型時，對話欄顯示形如 魔粒 550 的餘額讀數（純文本，點擊可刷新）。

令牌寫入 DSH 憑據服務，插件配置文件不落明文；若環境裏已有 MODELSCOPE_API_KEY（憑據庫或環境變量），可直接複用。

核心功能¶

實現上覆用 @deepseek-ai/dsh-llm-pi-ai 的 PiAiAdapter 與 pi-ai 的 openAICompletionsApi，不自寫 SSE 轉換。瀏覽器側不接觸令牌：client 半隻讀同源路由 /plugins/dsh-connect-modelscope/*，且該路由僅接受迴環來源。

安裝與啓用¶

在 DSH 中安裝 bundle（安裝後需重啓 DSH，host 半僅在啓動時加載）：

# 從 npm
dsh plugin add dsh-connect-modelscope --profile <profile>

# 或者本地目錄（開發時）
# plugin_manager → install_bundle → 指向本倉庫目錄

Node 引擎要求：^22.19.0 || >=24.0.0（見 package.json）。

插件以當前 DSH 進程權限運行；安裝前建議自行查看 GitHub 源碼 與 MIT 許可證，確認符合你的環境策略。

典型用法¶

1. 打開 設置 → 插件 → 魔搭連接器。
2. 在 訪問令牌 生成 ms- 開頭令牌，粘貼到「訪問令牌」並點「保存令牌」。
3. 在「啓用模型」勾選要用的模型，點「保存模型」。
4. 在對話的模型選擇器裏選 ModelScope 下的模型，輸入框左側會出現魔粒讀數。

若需覆蓋某模型的上下文窗口（插件默認對未知窗口報保守值 131072），可在 ~/.dsh/modelscope.json 中配置：

{
  "enabledModelIds": null,
  "contextWindows": { "deepseek-ai/DeepSeek-V4-Pro": 262144 }
}

適用場景與注意¶

適合誰： 已在魔搭開通 API、希望在 DSH 智能體工作流裏統一選模型，並希望在對話欄一眼看到魔粒餘量，而不是頻繁打開控制台的用戶。

魔粒計費： 魔粒按「模型請求」計費，不是按 token。Agent 循環裏每輪工具調用往往對應多次請求，長任務消耗可能快於直覺。餘額耗盡時上游返回 QuotaLimitExceed / E3027，插件顯示「魔粒 不足」。

賬號與合規： 官方要求綁定阿里雲中國站並完成實名認證，否則推理接口可能 401；僅讀餘額、能選模型不代表請求一定能通。官方聲明 API 不宜用於高併發或強 SLA 的線上任務。

已知限制：

• 魔搭不對外提供各模型魔粒單價 API，插件不顯示單價（prices.json 當前爲空）。
• /v1/models 不返回 context window，插件統一報 128K 保守值；僅發佈文本對話模型，跳過的多模態類型會在設置卡片中列出。

結尾¶

dsh-connect-modelscope 把 ModelScope 推理與魔粒餘額收進 DSH 同一套界面：設置頁管令牌與模型，對話欄管餘額。目錄與源碼：

• 社區目錄：https://www.skillhub.cn/plugins/IFFCheckPass/dsh-connect-modelscope
• GitHub：https://github.com/IFFCheckPass/dsh-connect-modelscope