Skip to main content

DeepSeek Harness

DeepSeek Harness 是由 DeepSeek 開源的 AI Agent 框架，支援 Web UI 和命令列兩種模式。透過阿里雲百煉，可以使用按量計費、Coding Plan、Token Plan 個人版或 Token Plan 團隊版接入 DeepSeek Harness。

安裝 DeepSeek Harness

  1. 安裝 Node.js（v22.19.0 或 v24.0.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 ID

bailian-tpp

Base URL

https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

API Protocol

openai-completions

API Key

Token Plan 個人版專屬 API Key

模型

填入模型 ID，如 auto

也可直接編輯 ~/.dsh/settings.yaml： 
agent-default-model:
  provider: bailian-tpp
  model: auto

llm-pi-ai:
  providers:
    bailian-tpp:
      api: openai-completions
      baseURL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
      apiKeyEnv: BAILIAN_API_KEY
      models:
        - id: auto
        - id: qwen3.8-max
        - id: qwen3.8-flash
        - 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 ID

bailian-tp

Base URL

https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

API Protocol

openai-completions

API Key

Token Plan 團隊版專屬 API Key

模型

填入模型 ID，如 auto

對應 ~/.dsh/settings.yaml 設定： 
agent-default-model:
  provider: bailian-tp
  model: auto

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

Coding Plan

將 YOUR_API_KEY 替換為 Coding Plan 專屬 API Key。可用模型請參閱 Coding Plan 支援的模型。

Provider ID

bailian-coding

Base URL

https://coding-intl.dashscope.aliyuncs.com/v1

API Protocol

openai-completions

API Key

Coding Plan 專屬 API Key

模型

填入模型 ID，如 qwen3.7-plus

對應 ~/.dsh/settings.yaml 設定： 
agent-default-model:
  provider: bailian-coding
  model: qwen3.7-plus

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

按量計費

將 YOUR_API_KEY 替換為阿里雲百煉 API Key。可用模型請參閱OpenAI 相容 - 支援的模型。 Base URL 依地域設定，請將 URL 中的 {WorkspaceId} 替換為實際的Workspace ID：
  • 華北 2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
  • 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  • 美國（維吉尼亞）：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1

Provider ID

bailian

Base URL

參見上方地域清單

API Protocol

openai-completions

API Key

百煉 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://{WorkspaceId}.ap-southeast-1.maas.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

百煉 OpenAI 相容端點不提供 GET /models 介面，點擊 Fetch available models 會返回 401 或 404。該按鈕可忽略，在 Model catalog 中手動輸入模型 ID 即可。

錯誤 MISSING_CREDENTIAL

在 Web UI 的 Settings → Models 中重新輸入 API Key 並儲存；或確認環境變數 BAILIAN_API_KEY 已設定並重新啟動 DeepSeek Harness。