DeepSeek 線束 API 設定

DeepSeek Harness (dsh) 可以從其模型頁面將 TokenHub 新增為自訂提供者。每個提供者必須聲明網關實際公開的一種協定。對於 TokenHub OpenAI Chat Completions，請使用 openai-completions 和 https://us-api.tokenhub.com/v1。

DeepSeek Harness 仍處於開發者預覽版中，其維護者警告稱，該版本可能包含重大更改。在使用真實儲存庫之前驗證與低風險任務的連線。

當這種整合合適時

DeepSeek Harness 適用於將模型、工具和工作區組合到代理程式中的開發工作流程。它保留提供者、模型和會話設定。在建立之前選擇一個穩定的提供者 ID，以便您以後不必遷移預設模型和會話參考。

啟動 DeepSeek Harness

使用官方指令啟動其本機Web UI：

npx @deepseek-ai/dsh web

這將啟動本機 UI 並嘗試在瀏覽器中開啟它。在 SSH 上或在遠端環境中執行時，請依照專案的 Web UI 指南取得存取位址。在配置提供者之前確認 UI 是可存取的。

準備TokenHub憑證和模型

在 TokenHub 儀表板中建立 API 金鑰，並從模型目錄複製準確的模型 ID。切勿將金鑰提交到儲存庫或共用它。

新增 TokenHub 自訂提供者

1. 開啟Settings → Models。
2. 選擇Add a custom provider。不要将 TokenHub 配置为内置提供程序之一。
3. 输入小写的提供商 ID、显示名称、基本 URL、API 协议和 API 密钥。
4. 將至少一個準確的 TokenHub 型號 ID 加入到型號清單中並儲存。
5. 返回模型選擇器，選擇您已儲存的提供者和模型，然後建立新會話來驗證它。

一個提供者只能使用一種協定。如果網關公開 OpenAI Chat Completions、回應和 Anthropic Messages，請為每個協定建立單獨的提供程序，而不是混合它們。

儲存的會話、預設模型和憑證引用提供者 ID。要重新命名它，請建立一個新的提供程序，選擇一個新的預設模型，然後根據需要遷移舊設定。

發現失敗時手動新增模型

Model catalog 可以使用 Fetch available models 檢索型號列表。這取決於相容的列表模型響應，並且是一種便利，而不是先決條件。

如果取得失敗或傳回空列表：

1. 保留正確的基礎 URL、協定和 API 金鑰。
2. 手動輸入 TokenHub 中的完整型號 ID。
3. 儲存提供者並從新會話發送簡單的請求。
4. 确认TokenHub请求日志中的型号、状态和使用情况。

發現失敗本身並不意味著模型不可用。

settings.yaml 中的進階配置

模型頁面涵蓋路由欄位：API 金鑰、顯示名稱、基礎 URL、協定和模型 ID。在 $DSH_HOME/settings.yaml 中設定影像輸入、推理工作、相容性覆寫、請求標頭、逾時和重試策略。

例如，僅在確切模型支援時才聲明影像輸入：

llm-pi-ai:
  providers:
    tokenhub:
      apiKeyEnv: TOKENHUB_API_KEY
      api: openai-completions
      baseURL: __API_BASE_URL__/v1
      models:
        - id: YOUR_TOKENHUB_MODEL_ID
          input: [text, image]

官方指南稱適配器會在下一個請求時讀取已儲存的 settings.yaml 更改，通常無需重新啟動。不要推測性地添加 supportsDeveloperRole 或 maxTokensField 等覆蓋；僅當網關需要它們或拒絕預設請求時才使用它們。

驗證請求是否到達 TokenHub

1. 确认提供商和模型已保存在“模型”页面上。
2. 创建一个新会话并选择 TokenHub 模型。
3. 运行一项低风险任务，例如解释一个文件或总结一小段代码。
4. 在 TokenHub 日誌中確認確切的模型 ID、回應狀態和使用情況。
5. 然後一次測試工具、長任務和影像輸入的一項功能。

現有會話將模型記錄在其會話日誌中。更改預設值後，使用新會話進行驗證。

故障排除

官方參考資料

• DeepSeek Harness專案
• DeepSeek Harness 提供者指南
• DeepSeek Harness配置目錄