在 DeepSeek Harness 中配置 Qwen / DashScope
把标准 DashScope 和 Qwen Token Plan 分开配置，因为两者使用不同凭据和端点。
本页内容
下面的 endpoint、协议和环境变量来自 Provider 官方文档或当前上游 Provider 源码。模型目录会变化，模型选择时以你当前 DSH 版本实际显示的 ID 为准。
开始前
先确认 DSH 已经通过 npx @deepseek-ai/dsh web 启动，默认 Web UI 地址是 http://127.0.0.1:3080。如果 DSH 本身没有启动，先看启动排查。
不要把真实 Key 写进仓库、截图、Prompt 或公开报错信息。
获取 Qwen / DashScope API Key
打开 DashScope API Keys，登录后创建 Key，并在离开页面前复制保存。
如果使用 YAML，变量名必须与下表的 apiKeyEnv 完全一致；变量名不是 Key 本身。
在 DSH 中添加服务商
进入 Settings → Models。如果当前目录里有 Qwen / DashScope，选择 Add provider，再粘贴 API Key 并保存。
普通 DashScope 推理使用对应区域的 compatible-mode 地址创建自定义 Provider。Qwen Token Plan 则在 Add provider 中选择匹配的内置 Token Plan 条目；不要用 DashScope Key 或端点替代它。
官方 Provider 指南说明，模型和服务商修改会在下一次请求生效。保存后直接创建新会话测试。
核对当前路由值
| 路由 | Provider ID | apiKeyEnv | Base URL | API |
|---|---|---|---|---|
| DashScope 国际区 · 自定义 | dashscope-custom | DASHSCOPE_API_KEY | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 | openai-completions |
| Qwen Token Plan 国际区 · 内置 | qwen-token-plan | QWEN_TOKEN_PLAN_API_KEY | https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 | openai-completions |
| Qwen Token Plan 中国区 · 内置 | qwen-token-plan-cn | QWEN_TOKEN_PLAN_CN_API_KEY | https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 | openai-completions |
不要把不同区域、不同套餐或不同协议的 Key 与 Base URL 混在一起。表格里的内置路由只在你的 DSH 版本实际提供该目录时使用。
选择模型
自定义 DashScope 路由使用 `/models` 返回的模型 ID；Token Plan 则从已安装目录选择。区域、Key 和模型路由要保持一致。
如果模型不在选择器里，不要连续猜模型名。对 OpenAI-compatible 自定义路由使用 Fetch available models；失败时再根据服务商返回的真实 ID 手动添加。
内置目录没有时：创建自定义 Provider
进入 Settings → Models → Add a custom provider，Provider ID 使用小写且一次想好，例如 qwen-dashscope-custom。
Base URL
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
API protocol
openai-completions
凭据
DASHSCOPE_API_KEY 对应的 Key
模型
点击 Fetch available models，搜索并 Add selected。
如果接口没有返回模型列表，确认 Key、Base URL 和模型 ID 后手动添加；模型发现失败不等于聊天接口一定失败。
需要手动写 YAML 时
普通用户使用 Web UI 就够了。只有在要固定自定义路由或界面无法表达的设置时，才编辑 <code>$DSH_HOME/settings.yaml</code>。下面的模型 ID 必须替换为服务商返回的真实值。
llm-pi-ai:
providers:
qwen-dashscope-custom:
apiKeyEnv: DASHSCOPE_API_KEY
api: openai-completions
baseURL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
models:
- id: <copy the exact model id from the provider>Key 只通过 <code>apiKeyEnv</code> 引用，不要把密钥正文写进配置文件。自定义路由的 <code>models</code> 列表会替换该路由的模型目录。
发送一次安全测试请求
选择测试工作区，创建新会话，选中刚配置的模型，然后发送：
看到正常回答后，再进行需要读文件或执行工具的任务。这样可以把凭据/路由问题与工具权限问题分开。
常见错误
MISSING_CREDENTIAL
回到 Settings → Models 保存 Key；如果使用 YAML，确认 apiKeyEnv 对应的变量在 DSH 启动前已经存在。
UNKNOWN_MODEL
使用当前 Provider 下真实存在的 Model ID；不要把显示名称、别名或旧教程里的名称当成 ID。
401 / authentication failed
DashScope 和 Token Plan 不能互换。模型发现返回 401 时，先检查产品类型和区域，不要先随意更换模型名。
Fetch available models 为空或失败
先检查当前表单中的 Base URL、协议和 Key。如果服务商没有兼容的模型列表接口，确认模型 ID 后手动添加。
模型切换后仍像在用旧模型
已经发过请求的 Session 会保留自己的模型记录。创建新会话再验证切换结果。