在 DeepSeek Harness 中使用 Wokey API

1. 1

   安裝 0.2.1 預覽版

   npm 的 latest 標籤仍是 0.2.0；DeepSeek 建議 V4.1-Flash-1017 使用 v0.2.1-rc.1 或更新版本，因此請安裝 @next。

2. 2

   設定 API 金鑰變數

   設定檔只寫 apiKeyEnv 的名稱，金鑰不會落在檔案中。你也可以在網頁介面的 Settings → Models 中儲存金鑰。

3. 3

   新增供應商

   編輯 ~/.dsh/profiles/web/cordis.patch.yml（dsh headless 則是 profiles/headless）。此範例兩個模型都使用 Anthropic Messages，Base URL 為 https://api.wokey.ai。若改用 OpenAI Chat Completions，請另外建立一個供應商並使用 https://api.wokey.ai/v1。

4. 4

   宣告圖片輸入

   DeepSeek Harness 會把未宣告的自訂模型視為純文字，因此即使 Wokey 模型支援視覺，也可能在請求送到 Wokey 之前就拒絕圖片。Opus 5.5、Haiku 5.5 或其他視覺模型，請在該模型下加上 input: [text, image]；在介面中則是 Settings → Models → 編輯供應商 → Customized settings → 展開模型列 → Input types → Image。儲存後開始新的工作階段。

5. 5

   保留既有供應商

   這個覆寫會取代整個 llm-pi-ai 項目的設定，所以若你已在介面中新增過供應商，也要把它們列在 providers 下。所有縮排都使用空格，不要在 YAML 中混用 Tab。儲存後開始新的工作階段。

# 1. 安裝或更新到 0.2.1
npm install -g @deepseek-ai/dsh@next
export WOKEY_API_KEY="YOUR_API_KEY"

# 2. ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-pi-ai
  config:
    providers:
      wokey:
        displayName: Wokey
        apiKeyEnv: WOKEY_API_KEY
        api: anthropic-messages
        baseURL: https://api.wokey.ai
        models:
          - id: claude-opus-5-5
            name: Claude Opus 5.5
            contextWindow: 1000000
            input: [text, image]
          - id: deepseek-v4.1-flash
            name: DeepSeek-V4.1-Flash
            contextWindow: 1000000
            maxTokens: 393216
            input: [text, image]
- id: agent-default-model
  config:
    provider: wokey
    model: claude-opus-5-5

# 3. 啟動
dsh web

設定位置: ~/.dsh/profiles/web/cordis.patch.yml

Wokey 提供本頁列出的模型推論介面，不提供 /v1/tools/search 或 /v1/tools/fetch 獨立端點。支援工具呼叫不等於支援所有上游內建的聯網工具；模型請求中的伺服器端搜尋取決於實際供給路徑，目前未列為 Wokey 已驗證、一致支援的能力，本頁也未公布 Wokey 的 Search/Fetch 按次報價。需要有文件明確支援的獨立搜尋與擷取時，請使用 DeepSeek API 金鑰呼叫 api.deepseek.com，並與 Wokey 的模型呼叫分開設定與計費。

• 「The current model does not support images」：這是 Harness 本機的能力檢查，並不代表 Wokey 或 Opus 5.5 不支援視覺。請為該模型啟用 Image，或在它的 YAML 項目中加上 input: [text, image]。
• 儲存後圖片仍被拒絕：開始新的工作階段並重新選擇模型；既有的工作階段會保留當時記錄的模型能力與附件。
• 圖片請求回傳 400：讓協定與 Base URL 一致。Anthropic Messages 使用不帶 /v1 的 https://api.wokey.ai；OpenAI Chat Completions 使用 https://api.wokey.ai/v1。deepseek-v4.1-flash 兩種格式都支援，但用戶端仍需送出所選協定的格式。
• 應用程式無法啟動或回報 YAML 行號：檢查 input 是否巢狀在正確的模型下、每個模型的破折號是否對齊，以及檔案中是否沒有 Tab。還原備份後，只用空格重新儲存。
• 應用程式啟動後顯示「Select a model」：檢查 agent-default-model 是否仍指向存在的供應商與模型。刪除或重新命名供應商後請一併更新。
• 探索後模型有出現但沒有圖片能力：Fetch available models 主要只填入 ID 與容量欄位。請為每個自訂視覺模型明確宣告 input: [text, image]，而不是把所有模型都標記為支援視覺。
• 儲存後其他供應商消失了：cordis.patch.yml 覆寫會取代整個 llm-pi-ai 項目，因此請把所有既有供應商保留在 providers 下。

DeepSeek Harness 預設使用 OpenAI Chat Completions 格式。這個請求回傳 200，代表金鑰和 Base URL 都正確；送出前請把 YOUR_API_KEY 換成你的金鑰。

curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

DeepSeek Harness 的 baseURL 要不要加 /v1？

看 provider 的 api 欄位。anthropic-messages 填 https://api.wokey.ai，不加 /v1；OpenAI Chat Completions 需要另建一個 provider，位址填 https://api.wokey.ai/v1。

為什麼提示「目前的模型不支援圖片」？

這是 Harness 的本機能力檢查，自訂模型預設只宣告文字輸入。在模型條目中加上 input: [text, image]，儲存後在新的工作階段再試一次。

儲存設定後其他 provider 為什麼不見了？

cordis.patch.yml 中對 llm-pi-ai 的覆寫會取代整個條目。請把原有的其他 provider 和 Wokey 一起寫進 providers。