前言¶

在 DeepSeek Harness（DSH）裏接第三方推理，常見做法是單獨配 OpenAI 兼容端點、自己記調用次數，官方免費額度往往要另開頁面查。魔搭社區（modelscope.cn）的 API-Inference 免費檔用訪問令牌即可調用，但和 DSH 的插件頁、模型選擇器、本地用量統計並不天然打通。

dsh-connect-modelscope-token-plan 由維護者 eghrhegpe 發佈，分類爲模型推理，目標是把魔搭 API-Inference 免費額度 做成 DSH Plugins 頁內聯面板，並可選把魔搭註冊爲 DSH 的 LLM provider（id modelscope-token-plan，OpenAI 兼容）。同族結構可參考姊妹插件 dsh-connect-sensenova-token-plan、dsh-connect-agnes-token-plan。

這是什麼¶

插件在 npm 上的包名爲 dsh-connect-modelscope-token-plan，當前資料中的版本爲 0.6.4，許可證 MIT。簡介（目錄與 GitHub 一致）：ModelScope connect bundle for the DeepSeek Harness——本地用量看板（面向免費 API-Inference 檔）加可選的 provider 註冊。

不打開 provider 時，它主要是一塊額度與本地統計面板；打開「接入爲 DSH 模型」後，魔搭模型進入 DSH 模型選擇器，可直接對話；還可單獨開啓出圖工具（文生圖 / 圖生圖）。二者默認均爲關閉（opt-in）。

核心功能¶

Plugins 頁三 tab 面板¶

面板嵌在插件卡內，不在側邊欄，三個 tab：額度 / 模型 / 接入。

額度：頭條展示官方 魔粒餘額（真實值）；下方爲經本插件的本地調用分佈與趨勢（豎向柱狀，可切換顯示天數：默認 / 7 / 14 / 30 / 90）。本地計數按 profile（客戶端） 分段——桌面端與 Web 端各記各的、互不可見；讀不到數據時顯示「—」，不會把未知畫成 0。

模型：模型按廠商分組，勾選啓用；頂部可搜索。開關「接入爲 DSH 模型」將魔搭註冊爲 provider。同一 tab 下有「出圖工具」卡（與 provider 開關獨立）；開啓後支持文生圖、圖生圖與多圖編輯，工具掛載發生在下次 Host 啓動。另有「上下文窗口覆蓋」（不覆蓋 / 128K / 256K / 512K / 1M），因魔搭目錄不返回窗口字段，插件按目錄聲明、用戶檔位、內置策展表、128K 兜底四級策略處理。

接入：粘貼形如 ms-… 的魔搭訪問令牌（在魔搭「個人中心 > 訪問令牌」生成）。令牌不入日誌、不進插件目錄。無 OAuth、無密碼、無刷新。

憑據與環境變量¶

只需一枚 API Key。MODELSCOPE_API_KEY 在 DSH 啓動時讀一次，且優先級高於面板保存值；資料建議在面板「接入」tab 保存令牌以便立即生效、不依賴重啓。

對話框用量膠囊（v0.2 起）¶

註冊 provider 且當前選中 provider 爲 modelscope-token-plan 時，輸入框工具欄會出現用量膠囊，例如：

魔搭 · 143 魔粒 · 今日本地 7 次

前半爲官方魔粒餘額，後半爲今日本地調用次數（必須帶「本地」字樣，來源不同）。切到其他 provider 時膠囊消失且不發起請求。讀不到時顯示「—」；官方確爲 0 時用告警色。

與 DSH 全局賬本的關係¶

本地計數刻意不與 harness 全局 @linxin666/dsh-usage 合併：後者只記成功調用的 token；本插件補充經本插件的分佈、趨勢，以及 429 / 錯誤事件流。每次流結束記一次 call（含失敗、含用戶中斷）；重試各記一次。

免費額度說明（不參與面板計算）¶

資料中的 2026-10 快照（社區公開信息，非官方，規則可能調整）：賬戶級每日免費調用約 2000 次/天（需綁定阿里雲與實名）；單模型另有社區數據約 500 次/天與每分鐘限頻；耗盡返回 429。/v1/models 免認證可讀、不消耗額度。面板不消費次數上限，無法從插件算出「還剩幾次」；頭條魔粒餘額纔是官方真實餘額。

安裝與啓用¶

1、在 DSH「插件」頁搜索 dsh-connect-modelscope-token-plan 點擊安裝，或按 profile 執行：

dsh plugin --profile web add dsh-connect-modelscope-token-plan       # Web 端
dsh plugin --profile desktop add dsh-connect-modelscope-token-plan  # 桌面端

2、完全退出 DSH（含托盤）再啓動。

3、打開 Plugins 頁，在本插件卡內使用面板（非側邊欄）。

裝到 npm 的發佈包不含 docs/，README 中指向 docs/* 的鏈接需在 GitHub 倉庫 查看。

典型用法¶

只看額度¶

安裝並重啓後，在「接入」tab 保存 ms-… 令牌，在「額度」tab 查看魔粒餘額與本地趨勢即可。不打開「接入爲 DSH 模型」與「出圖工具」時，插件就是額度看板。

把魔搭當 DSH 模型源¶

在「模型」tab 打開「接入爲 DSH 模型」，勾選需要的模型。保存後 provider id 爲 modelscope-token-plan，在 DSH 模型選擇器中選魔搭模型對話。輸入框旁會出現用量膠囊（當選中該 provider 時）。

出圖¶

在「模型」tab 開啓「出圖工具」，重啓 Host 後工具掛載。出圖爲異步：若返回 status: pending 與 jobId，帶上 jobId 再調可續查。協議細節見倉庫 docs/SPIKE-image-gen.md（npm 包內無該文件）。

運維：當前 profile 是否開了 provider¶

生效值在插件私有狀態文件中，按 profile 分段。在插件源碼目錄可運行（Host 未起也可）：

npm run doctor          # 人類可讀：各 profile 的 provider / draw 開關與模型清單
npm run doctor:json     # JSON，便於巡檢腳本

適用場景與注意¶

適合誰：已在魔搭開通 API-Inference、希望用 DSH 統一選模型對話，同時想在插件頁看官方魔粒與本地調用分佈的用戶；需要 OpenAI 兼容 provider、可選出圖時，再打開對應開關。

權限與安全：插件以當前 DSH 進程權限運行；安裝前應查看 GitHub 源碼 與 MIT 許可證，自行評估是否滿足環境要求。

默認與失敗行爲：provider 與出圖默認關；任一項接入失敗時面板仍可用，只是該模塊缺席。

已知限制（資料原文）：reasoning 恆爲 false，不發 reasoning_effort；輸出上限默認走 harness 的 32768（魔搭 /v1/models 不返回輸出上限）；單模型「額度耗盡」爲推斷而非官方 per-model 讀數；429 響應按 OpenAI 慣例解析，形狀漂移時面板可能給出 shapeWarnings。

生態說明：DSH 主張「一切皆插件」；社區目錄站點（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係，本文介紹的是社區插件，非官方應用商店條目。

結尾¶

dsh-connect-modelscope-token-plan 用一枚魔搭訪問令牌，把免費 API-Inference 的魔粒餘額、本地調用統計與可選的 LLM provider / 出圖能力收進 DSH Plugins 頁；需要深度設計說明時到 GitHub 閱讀 docs/PROVIDER-M4.md 等文檔。

• 目錄頁：https://www.skillhub.cn/plugins/eghrhegpe/dsh-connect-modelscope-token-plan
• GitHub：https://github.com/eghrhegpe/dsh-connect-modelscope-token-plan