前言¶
在 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
