DeepSeek Harness

使用本指南將開源專案 DeepSeek Harness 接入 Felo API Platform 提供的模型。推薦方式是沿用 Harness 內建的 deepseek-official adapter；你也可以在 Web UI 中把 Felo 新增為獨立的自訂 OpenAI-compatible provider。

DeepSeek Harness 目前仍處於開發者預覽階段，後續可能出現破壞相容性的變更。如果選項或介面與本文不同，請同時查看上游專案的最新發布說明。

開始前準備

你需要安裝 Node.js，並準備一個 Felo API Platform key。不要把 key 提交到版本控制系統。

export FELO_API_KEY="YOUR_API_KEY"

以下範例使用 deepseek-v4-flash。如需選擇其他模型 ID，請先查看模型與價格。

推薦方式：使用內建 DeepSeek Adapter

DeepSeek Harness 透過 DEEPSEEK_API_KEY 讀取內建 adapter 的憑據，透過 DEEPSEEK_BASE_URL 讀取 endpoint。

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

開啟 http://127.0.0.1:3080，然後：

1. 新增或選擇你的專案工作區。
2. 開啟設定 → 模型。
3. 選擇 deepseek-official provider 和 deepseek-v4-flash 模型。
4. 建立新對話並送出一個簡單的 repository 任務。

不要在 Base URL 後加上 /chat/completions。內建 adapter 會自行請求 {DEEPSEEK_BASE_URL}/chat/completions。

持久保存環境變數

DeepSeek Harness 可以讀取啟動目錄下的 .env 檔案。如果不想每次都執行 export，可以把以下內容儲存到未納入版本控制的 .env 檔案：

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

不要提交這個檔案。需要使用者層級設定時，也可以使用 $DSH_HOME 下的 Harness 憑據與設定檔案。

備選方式：自訂 OpenAI-compatible Provider

如果希望 Felo 以獨立 provider 顯示，而不是覆寫內建 DeepSeek 連線，請使用這個方式。

1. 執行 npx @deepseek-ai/dsh web 啟動 Web UI。
2. 開啟設定 → 模型。
3. 選擇新增自訂提供方。
4. 填入下列值並儲存。

如果模型探索失敗，請手動新增模型 ID。提供方的取得可用模型操作依賴 OpenAI-compatible GET /models 路由，手動設定不要求這個操作成功。

驗證設定

建立新對話並送出：

總結這個 repository，並指出其中的主要 package。

如果對話使用 deepseek-v4-flash 正常完成，且沒有認證或模型不存在錯誤，表示設定成功。

使用推薦 adapter 時，也可以在目標工作區執行非互動式檢查：

npx @deepseek-ai/dsh --profile headless "列出這個工作區的頂層檔案。"

Web Search 說明

以上設定只負責把模型請求路由到 Felo。DeepSeek Harness 內建的 web_search provider 有獨立的 endpoint 要求，儘管它預設也使用 DEEPSEEK_API_KEY。除非你接入的是明確相容的搜尋 endpoint，否則不要把 DEEPSEEK_SEARCH_BASE_URL 指向 Felo。需要使用 Felo 搜尋時，請另外呼叫 Felo 的 Chat API 或安裝相應 Felo Skills。

疑難排解

下一步

• DeepSeek Harness repository
• LLM API 參考
• Chat API 參考
• 適用於 AI Agent 的 Felo Skills