跳转到主要内容
千问AI平台 home page
文档
客户端与工具

DeepSeek Harness

在千问AI平台中使用 DeepSeek Harness

安装 DeepSeek Harness

  1. 安装 Node.js（v18.0 或更高版本）。
  2. 在终端中执行以下命令启动 DeepSeek Harness Web UI：
npx @deepseek-ai/dsh web
命令执行后，Web UI 默认运行在 http://127.0.0.1:3080。

配置接入凭证

编辑配置文件 ~/.dsh/settings.yaml，添加供应商和默认模型。也可启动 Web UI 后在 Settings > Models > Add a custom provider 中通过界面配置。

Token Plan 个人版

将 YOUR_API_KEY 替换为 Token Plan 个人版专属 API Key。可用模型参见 Token Plan 个人版支持的模型。
配置项值
Provider IDbailian-tpp
Base URLhttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
API Protocolopenai-completions
API KeyToken Plan 个人版专属 API Key
模型填入模型 ID，如 qwen3.8-max
也可直接编辑 ~/.dsh/settings.yaml： 
agent-default-model:
  provider: bailian-tpp
  model: qwen3.8-max

llm-pi-ai:
  providers:
    bailian-tpp:
      api: openai-completions
      baseURL: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.8-max
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash
设置环境变量 BAILIAN_API_KEY 为你的 Token Plan 个人版 API Key： 
export BAILIAN_API_KEY="YOUR_API_KEY"
也可在 Web UI 的 Settings > Models 页面直接填入 API Key。

Token Plan 团队版

将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。可用模型参见 Token Plan 团队版支持的模型。
配置项值
Provider IDbailian-tp
Base URLhttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
API Protocolopenai-completions
API KeyToken Plan 团队版专属 API Key
模型填入模型 ID，如 qwen3.8-max
对应 ~/.dsh/settings.yaml 配置： 
agent-default-model:
  provider: bailian-tp
  model: qwen3.8-max

llm-pi-ai:
  providers:
    bailian-tp:
      api: openai-completions
      baseURL: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.8-max
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash

按量计费

将 YOUR_API_KEY 替换为千问AI平台 API Key。可用模型参见 OpenAI 兼容 - 支持的模型。
配置项值
Provider IDbailian
Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1
API Protocolopenai-completions
API Key千问AI平台 API Key（sk- 开头）
模型填入模型 ID，如 qwen3.7-max
对应 ~/.dsh/settings.yaml 配置： 
agent-default-model:
  provider: bailian
  model: qwen3.7-max

llm-pi-ai:
  providers:
    bailian:
      api: openai-completions
      baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: qwen3.7-max
        - id: qwen3.7-plus
        - id: qwen3.6-flash

验证配置

配置保存后，在 Web UI 的模型选择器中选择已配置的模型，发送一条消息。若模型正常返回响应，配置成功。

常见问题

错误码

配置过程中遇到报错，参考对应套餐的常见问题文档：

Fetch available models 返回 401

千问AI平台 OpenAI 兼容端点不提供 GET /models 接口，点击 Fetch available models 会返回 401 或 404。该按钮可忽略，在 Model catalog 中手动输入模型 ID 即可。

报错 MISSING_CREDENTIAL

在 Web UI 的 Settings > Models 中重新输入 API Key 并保存；或确认环境变量 BAILIAN_API_KEY 已设置并重启 DeepSeek Harness。
DeepSeek Harness - 千问AI平台