DeepSeek Harness - Alibaba Cloud Model Studio

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

安裝 DeepSeek Harness

安裝 Node.js（v18.0 或更高版本）。
在終端機中執行以下命令啟動 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 的模型選擇器中選擇已配置的模型，傳送一則訊息。若模型正常返回回應，即表示配置成功。

常見問題

錯誤碼

設定過程中遇到報錯，參考對應套餐的常見問題文件：

按量計費：錯誤碼
Coding Plan：Coding Plan 常見問題
Token Plan 個人版：Token Plan 常見問題
Token Plan 團隊版：Token Plan 團隊版常見問題

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。