前言¶

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