← 幫助中心 · 桌面 / 終端

用 DeepSeek Harness 連接 Newcclm

1. 概述

DSH 的模型層是 pi-ai。它自帶的 DeepSeek 目錄走的是 Anthropic 協議（往 /anthropic/v1/messages 發請求）， 而 Newcclm 只提供 OpenAI 兼容的 /v1。

所以：必須添加一個自定義提供方，並且協議要選 openai-completions。 不要改 DeepSeek 目錄裏的 Base URL —— 那欄的協議不對，填了也連不上。

一句話理解：DSH 預設會走 DeepSeek 官方那條 Anthropic 通道。 我們不在那條通道上，所以你得自己加一個走 OpenAI 協議的入口。

2. 添加自定義提供方

  1. 打開 DSH Web UI → Settings → Models → 點 Add a custom provider。 不要點「Add provider」裏的 DeepSeek 或 Anthropic 目錄。
  2. 協議（API）選 openai-completions。 不要選 anthropic-messages 或 openai-responses。
  3. Base URL 填 https://sccclm.com/v1， 模型至少加上 newcclm（其餘三個可以一起加上）。
Provider IDnewcclm
Base URLhttps://sccclm.com/v1
APIopenai-completions
Modelsnewcclm · newcclm-fast · newcclm-coding · newcclm-free

「獲取可用模型」可以點。帶 Key 時 GET /v1/models 會返回 200， 列表裏就是上面這四個名字 —— 看不到別的底層型號。

3. 寫入 settings.yaml

如果你想直接改設定檔，路徑一般在 ~/.dsh/settings.yaml（即 $DSH_HOME/settings.yaml）。加上這一段：

llm-pi-ai:
  providers:
    newcclm:
      displayName: Newcclm
      api: openai-completions
      baseURL: https://sccclm.com/v1
      apiKeyEnv: NEWCCLM_API_KEY
      compat:
        supportsDeveloperRole: false
        maxTokensField: max_tokens
      models:
        - id: newcclm
        - id: newcclm-fast
        - id: newcclm-coding
        - id: newcclm-free

4. 設置環境變量

Key 不要寫進 yaml。把它放到環境變量裏：

export NEWCCLM_API_KEY="YOUR_API_KEY"
Windows 上用 set NEWCCLM_API_KEY=...，或者寫進系統環境變量。 密鑰的申請方式見幫助中心第 5 節。

5. 不要這樣配

這四種是最常見的錯法：

不要選 Anthropic 協議

# 错误 —— 会连不上
api: anthropic-messages

# 正确
api: openai-completions

不要填真實模型名

# 错误 —— 我们只认自己的档位名
models:
  - id: deepseek-chat
  - id: gpt-4o

# 正确
models:
  - id: newcclm
  - id: newcclm-fast
  - id: newcclm-coding
  - id: newcclm-free

不要在 baseURL 後面再加 /chat/completions

# 错误
baseURL: https://sccclm.com/v1/chat/completions

# 正确
baseURL: https://sccclm.com/v1

不要把新提供方塞進 DeepSeek 的預設裏

有些版本的 DSH 會在檢測到 deepseek 字樣時套用官方預設參數， 導致請求發錯地方。Provider ID 用 newcclm 就好。

6. 測一下

保存後回到 DSH，在模型選擇器裏選 newcclm/newcclm，發一句「你好」。 能正常回復就通了。

如果 DSH 裏報的是 Anthropic 相關的 404，可以忽略 —— 那是它在探測 DeepSeek 官方通道，不影響我們用 OpenAI 那條路。

想單獨驗證地址和密鑰？

打開終端跑這一條（不經過 DSH，直接打我們的接口）：

curl https://sccclm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"newcclm-fast","messages":[{"role":"user","content":"你好"}]}'

返回帶內容的 JSON 就說明密鑰和地址都沒問題 —— 那 DSH 裏報錯就是配置寫法的問題。 如果這條也失敗，先解決密鑰/網路，再看 DSH 的配置。

報 both_paths_failed 是怎麼回事？

八成不是故障，是提供方加錯了位置。

DSH 加了自定義提供方之後會同時探測兩條路徑： OpenAI 的 /v1 和 Anthropic 的 /anthropic/v1。 我們只有 OpenAI 那條，所以 Anthropic 那條會 404 —— 兩邊一綜合，DSH 就報 both_paths_failed。

怎麼辦：確認協議是 openai-completions， 並且你沒有把它加到 DeepSeek 或 Anthropic 的官方目錄裏。 官方目錄自帶 Anthropic 協議，填我們的地址也連不上。

報錯怎麼讀：
· Invalid token → 密鑰不對或沒填進環境變量
· model not found → 模型名寫錯了，只能是那四個檔位名
· both_paths_failed → 見上面那條，通常是加錯目錄
· 500–504 → 服務端或上游臨時問題，先別改配置，等幾秒重試
· 401 且消息裏帶 upstream → 是我們這邊的問題，不是你的配置

還是不行？

把這三樣發給我們：

1. settings.yaml 里你写的那一段（密钥打码）
2. DSH 报的完整错误
3. 上面那条 curl 的输出

← 返回幫助中心 · Newcclm 客戶端 →