程式工具
DeepSeek Harness
在 Harness 中配置 TokenLab 模型、驗證請求,並選擇 MCP、Skills 或提供者套件 (provider bundle)
選擇您需要的連線方式
若要將 TokenLab 作為 Agent 的主要模型,請在 Harness Web UI 中新增一個 custom provider。此操作獨立於選用的 TokenLab 提供者套件。您可以新增 MCP tools 以使用媒體及其他 API,或新增 Skill 以獲取 API 指令;這兩者本身都不會變更主要模型。
Harness 目前處於開發者預覽階段。這些 Web UI 步驟遵循 @deepseek-ai/dsh 0.2.0-rc.2 的官方文件,這是截至 2026 年 10 月 12 日的 npm latest 標籤版本。上述步驟最後一次進行端到端測試是在 0.1.5-rc.3 版本;下方的請求檢查尚未針對 0.2.0-rc.2 重新執行。下方的選用套件仍針對 0.1.5-rc.3,請另外檢查其與其他 Harness 版本的相容性。
將此任務交給您的 Agent
Read https://tokenlab.sh/docs/zh-TW/integrations/deepseek-harness and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.啟動 Harness
在 macOS、Linux 或 Windows 上使用 Node CLI,並搭配支援的 Node 版本;Node 24 LTS 是一個合適的起點。從您的專案目錄中,在終端機或 PowerShell 執行:
node --version
npx @deepseek-ai/dsh web若未指定版本,npx 會安裝 npm latest 標籤,該版本可能比這些步驟所驗證的 0.2.0-rc.2 版本更新。它不會安裝 alpha 標籤。
開啟指令所顯示的本地 URL。在全新的 Web UI 中,請先使用 Choose workspace 新增並選擇您的專案目錄,然後再傳送訊息。這些指令使用 web 設定檔;Electron 應用程式的 desktop 設定檔不受此 CLI 工作流程管理。請參閱官方 startup guide 與 Web UI guide。
配置一個 TokenLab 提供者
- 開啟 Settings → Models,選擇 Add model provider,然後將卡片切換為 Custom model API。(Harness 0.1.5-rc.3 將此稱為 Add a custom provider。)請保留任何現有的提供者與權限。
- 輸入小寫的 Provider ID(例如
tokenlab-chat),並在下方選擇一種協定及其對應的 Base URL。每個提供者僅使用一種協定。 - 在本地表單中輸入您的 TokenLab API key。Harness 會將 UI 管理的金鑰儲存在
$DSH_HOME/.credentials.yaml中;設定檔僅保留其憑證參照。請勿在聊天中傳送金鑰或將其提交。提供者及其協定會儲存在$DSH_HOME/profiles/<profile>/cordis.patch.yml中,對於標準的dsh web設定檔,路徑為$DSH_HOME/profiles/web/cordis.patch.yml。 - 從 TokenLab Models 新增一個目前的模型 ID。請在 model detail API 中檢查其
tokenlab.accepted_request_formats,而不是僅憑名稱猜測支援情況。 - 儲存提供者,選擇其模型,並開始一個 new session。已傳送過請求的現有工作階段會保留其記錄的模型。
| Provider ID 範例 | Harness API 協定 | Base URL | 必要的公開請求格式 |
|---|---|---|---|
tokenlab-chat | openai-completions | https://api.tokenlab.sh/v1 | openai_chat_completions |
tokenlab-responses | openai-responses | https://api.tokenlab.sh/v1 | openai_responses |
tokenlab-messages | anthropic-messages | https://api.tokenlab.sh | anthropic_messages |
對於第一次文字請求,目前可用的 gpt-5.6-luna 項目可以使用 Chat 列。Fetch available models → Add selected 有助於填入自訂提供者,但列出成功並不代表驗證了協定支援或產生了計費請求;請在之後儲存提供者。若無法自動發現,請手動輸入 ID。
Harness 在此處不提供 Gemini 原生的自訂提供者協定。僅當該模型的詳細資訊將 Chat Completions 列為接受的請求格式時,才使用 Chat。影像輸入與推理控制可能需要在 $DSH_HOME/profiles/web/cordis.patch.yml 中加入額外欄位;請在啟用前遵循 Harness provider configuration 以及所選模型支援的欄位。(尚未在 0.2.0-rc.2 上重新測試。)
驗證一個小型請求
在新的工作階段中,傳送:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.此請求會產生費用。請檢查回覆以及 TokenLab Requests 中的對應模型、時間與狀態。在此文字檢查後請停止;建立第一次連線並不需要測試三種協定或產生付費媒體。僅憑模型列表或 MCP 發現功能無法驗證金鑰的產生存取權。
選用:TokenLab 套件
@tokenlabai/dsh-provider@0.1.6 針對 Harness 0.1.5-rc.3:其對等依賴項 (peer dependencies) 仍為 @deepseek-ai/dsh-tools 與 @deepseek-ai/dsh-mcp-client 0.1.5-rc.3。它尚未在 Harness 0.2 上進行測試。若要使用此套件,請啟動對應版本:npx @deepseek-ai/dsh@0.1.5-rc.3 web。使用上述的原生自訂提供者步驟來配置一個模型,或安裝此套件以使用其預設的模型路由與工具。
該套件包含一個 2026 年 10 月 3 日檢查的 145 個公開聊天模型的固定快照:Responses 28 個、Messages 11 個、Chat 106 個。每個模型僅出現在一個路由上。它鎖定了 @tokenlabai/mcp-server@0.6.25 並包含獨立的 tokenlab_wait_task 工具。安裝此版本不會重新整理模型目錄。請對照即時目錄檢查 ID,並在需要時透過自訂提供者新增較新的模型。
對於現有的相容 Harness 安裝,請先確保 pnpm 已加入 PATH。安裝與啟動時請使用相同的 dsh 可執行檔/版本與設定檔;若您透過 npx 啟動,請將下方的 dsh 替換為該相同版本的啟動器:
dsh --version
pnpm --version
dsh plugin --profile web add --workspace-root @tokenlabai/dsh-provider@0.1.6在啟動該設定檔之前,請在啟動環境或其 .env 檔案中設定金鑰:
TOKENLAB_API_KEY=sk-your-tokenlab-keyHarness 會讀取您啟動它所在目錄以及 $DSH_HOME(通常為 ~/.dsh)中的 .env 檔案;繼承的環境變數優先權較高。稍後選擇工作區並不會選擇不同的 .env。請勿將該檔案納入 git,並在變更後重新啟動。為 UI 中的自訂提供者儲存的金鑰不會自動提供此套件的 TOKENLAB_API_KEY。
重新啟動相同的設定檔,然後檢查其模型與工具列表。對於 headless,請安裝至 headless 並啟動它,而不是 web;安裝至一個設定檔並不會配置另一個。
在 Harness 0.1.5-rc.3(套件的目標版本)上,Harness 會依提供者金鑰合併已儲存的 llm-pi-ai.providers。具有不同金鑰的提供者可以共存。已儲存的 tokenlab-responses、tokenlab-messages 或 tokenlab-chat 項目會覆寫對應的套件路由;升級舊目錄時請檢查這些項目。請保留 $DSH_HOME/settings.yaml 中的其他提供者與模型;請勿使用 Cordis patch 取代整個設定文件。
公開模型詳細資訊會識別推理能力,但不會列出每個模型的支援努力值 (effort values)。因此,該套件將 reasoningEfforts 留為未宣告。Harness 不為這些自訂路由提供努力等級;這不會停用伺服器端推理。若您自行配置 reasoningEfforts,請僅在提供者的 models 列表中的模型項目上使用個別驗證過的值,並保留其他模型。僅憑推理能力並不能建立對 xhigh 或 max 的支援。
該套件預設為 TOKENLAB_MCP_TOOL_PROFILE=core,包含 32 個 MCP 工具與 TOKENLAB_MCP_SCHEMA_MODE=portable。若僅需發現功能,請選擇 catalog(6 個工具);若需所有 89 個工具(包含額外的回應生命週期、批次、Seedance 資產/群組以及世界操作),請選擇 full。獨立的 tokenlab_wait_task 輪詢器在每個設定檔中皆可用,且不包含在這些 MCP 計數中。TOKENLAB_API_BASE 與 TOKENLAB_ANTHROPIC_BASE_URL 預設為 https://api.tokenlab.sh;TOKENLAB_OPENAI_BASE_URL 預設為 https://api.tokenlab.sh/v1。
對於套件媒體工具,請檢查 delivery.mode:直接消耗 complete 輸出;將 async 結果的 delivery.task_id 傳遞給 tokenlab_wait_task,並讀取其終端 status、response 與 result_urls。等待逾時並不代表任務已完成。請保留對計費或破壞性工具的核准。請參閱 async tasks。
若要移除套件,請使用相同的啟動器與設定檔,然後重新啟動:
dsh plugin --profile web remove --workspace-root @tokenlabai/dsh-provider若發生錯誤
- Composer 已停用: 請同時選擇工作區與模型。
MISSING_CREDENTIAL或 401: 檢查所選提供者的憑證。對於套件工具,請檢查啟動環境中的TOKENLAB_API_KEY;UI 儲存的模型金鑰是獨立的設定。UNKNOWN_MODEL或已停用的 ID: 檢查即時目錄,配置目前的正確 ID,然後建立新的工作階段。重新安裝套件0.1.6不會更新其快照。- URL 可連線但產生失敗: 比較協定、Base URL 與模型接受的格式。請勿僅為了將錯誤轉為成功檢查而移除歷史記錄、工具或影像輸入。
- 缺少
dsh或pnpm: 使用npx @deepseek-ai/dsh web(或套件使用@0.1.5-rc.3);在使用外掛程式指令前請先安裝 pnpm。外掛程式安裝失敗並非 API 金鑰失敗。
MCP 與 Skills 是獨立的選擇
手動自訂提供者不會安裝工具。若您需要在沒有套件的情況下使用可呼叫的 API 工具,請遵循 TokenLab MCP guide,並在產生前檢查發現功能。
對於 TokenLab Skills,請將完整的 skill 資料夾保留在專案根目錄下的 .dsh/skills/tokenlab-api-integration/,包含 SKILL.md 與參照的檔案。Harness 也會發現 .agents/skills/。這些說明不會安裝提供者、MCP 伺服器或金鑰。官方的 filesystem Skills reference 定義了支援的位置。
Jev / System One 與 Webhooks
在 core 或 full 中使用 mcp__tokenlab__evaluate_decisions 進行 Jev (POST /v1/systemone)。請先發現 category=decision 並檢查模型。這些是同步決策,而非聊天模型或非同步任務;請勿使用模型選擇器或 tokenlab_wait_task。
Webhook 管理需要 full 以及啟動環境中獨立的 TOKENLAB_MANAGEMENT_TOKEN=mt-...,並由套件明確傳遞給 MCP。推論金鑰無法替代它。管理金鑰具有 Webhook 以外的工作區層級權限;註冊 Webhook 並不會使 Harness 成為接收者。