AIREITERDeepSeek 在 2026 年 8 月 13 日讓 V4-Pro 正式進入 GA 的同一天，也於 npm 釋出 DeepSeek Harness（DSH）。這套面向 V4-Pro 與 V4-Flash 的 Coding Agent 執行框架，套件名稱是 @deepseek-ai/dsh，只要四個步驟、搭配一般的 DeepSeek API Key 就能啟用，並隨附外掛系統。安裝前有一點務必留意：PyPI 上從 5 月起就有另一個完全無關的 Python 套件 deepseek-harness，同樣提供 dsh 指令；兩者並不是同一個工具。
DeepSeek Harness（DSH）究竟是什麼？
Coding Agent 的 harness，可理解為模型外圍的執行與調度層：它負責挑選上下文、處理工具呼叫錯誤、重新規劃任務，以及判斷工作是否完成。即使底層模型不變，harness 的設定不同，基準測試分數也會跟著改變；因此 DeepSeek 在公布 Agent 評測時，同時揭露 harness 設定，而非只給出裸模型成績。
常見例子包括：Claude Code 是 Anthropic Claude 模型的 harness；Cursor 將多家模型供應商整合到 IDE；GitHub Copilot 則在 VS Code 中為 OpenAI 模型提供這層能力。模型搭配 harness 後，才成為能編輯檔案、執行指令與呼叫 API 的 Agent，而不只是回覆單一提示詞的聊天模型。DSH 就是為 V4-Pro 與 V4-Flash 補上這個角色。
DSH 是 DeepSeek 的第一方 harness，之於 V4-Pro 與 V4-Flash，類似 Claude Code 之於 Sonnet 和 Opus。DeepSeek 在 7 月 31 日的 V4-Flash beta 更新日誌中首次公開提到它，並表示 Agent 基準測試採用「DeepSeek Harness minimal mode（即將推出）」，設定為 effort=max、top_p=0.95 與 temperature=1.0。
所謂「minimal mode」，是以最高推理強度和固定取樣參數組成的精簡設定，目標是讓 Agent benchmark 可以重現，而不是為每個測試項目個別調校。正式產品的範圍則更廣，包含 beta 報導中已暗示的外掛系統，不只是一套用來跑出公開分數的 benchmark runner。
V4-Pro 與 V4-Flash 都支援 100 萬 token 上下文視窗，並提供三種推理強度：簡單任務用 low、一般 Agent 工作用 high、複雜工作用 max（官方更新日誌，8 月 13 日條目）。
如何安裝 @deepseek-ai/dsh
需要 Node.js 18 或更新版本，這也是 DeepSeek 官方 Claude Code 整合指南所列的最低要求。
- 確認 Node 版本：
node --version。必須是 18 以上；macOS 若尚未安裝，可使用brew install node。 - 全域安裝：
npm install -g @deepseek-ai/dsh。 - 設定 API Key：從 DeepSeek platform取得金鑰後，執行
export DEEPSEEK_API_KEY=<your key>。 - 啟動工具：
cd /path/to/my-project && dsh。
macOS 在全域安裝 npm 套件時，很常遇到權限錯誤。npm 建議的做法是設定一個目前使用者可寫入的全域 prefix：npm config set prefix ~/.npm-global。使用 sudo 雖然能解決當下問題，卻可能讓後續套件更新出現檔案權限衝突。
目前沒有公布 harness 軟體本身的獨立價格。不過，其背後模型 API 的計價會在 8 月 16 日 16:00 UTC 調整：V4 系列將改採尖峰／離峰費率，離峰價格是尖峰的一半（官方更新日誌）。
從 V4-Pro GA 跑分看 Harness 的影響
以下是 DeepSeek 在 8 月 13 日更新日誌公布的官方數據，全部使用前述 harness 設定產生：
| 基準測試 | V4-Pro GA | V4-Flash beta |
|---|---|---|
| Terminal Bench 2.1 | 87.9 | 82.7 |
| Cybergym | 83.3 | 76.7 |
| Toolathlon-Verified | 74.1 | 70.3 |
| DSBench-FullStack | 71.1 | 68.7 |
| DSBench-Hard | 67.2 | 59.6 |
| DeepSWE | 62.7 | 54.4 |
| NL2Repo | 61.5 | 54.2 |
| Agents' Last Exam | 25.7 | 25.2 |
| HLE（搭配工具） | 60.0 | — |
在這些 benchmark 中，V4-Pro 領先 Flash 0.5 到 8.3 分，其中 DeepSWE 的差距最大，為 +8.3 分；NL2Repo 則為 +7.3 分。最醒目的成績是 Terminal Bench 2.1 的 87.9 分。r/LocalLLaMA 上有一項使用公開 harness 的獨立重現測試，在 445 次試驗中測得 Flash 0731 為 82.7，考量設定差異的容許範圍後，與 DeepSeek 的說法一致。DSBench-FullStack 與 DSBench-Hard 屬於內部評測集，因此這兩列是 DeepSeek 自行量測的結果。
所有公開 benchmark 都使用 max 推理強度。實際部署時，DeepSeek 的建議仍是：簡單任務選 low，一般 Agent 工作選 high，複雜任務才使用 max。
@deepseek-ai/dsh 和 pip install deepseek-harness 別搞混
名稱幾乎一樣的兩個套件，相隔數月推出，但彼此毫無關聯。
@deepseek-ai/dsh（npm） | deepseek-harness（PyPI） | |
|---|---|---|
| 維護者 | DeepSeek（官方 scope） | Henry Zhang，非官方關聯 |
| 首次發布 | 2026 年 8 月 13 日 | 2026 年 5 月 9 日 |
| 語言 | Node.js | Python |
| 用途 | Coding Agent harness | 協定轉接程式庫 |
| 安裝方式 | npm install -g @deepseek-ai/dsh | pip install deepseek-harness |
| 授權 | 尚未確認 | MIT |
PyPI 專案是一套協定轉接程式庫，不是 Coding Agent。作者針對 16 項 V4 API 行為完成 270 多次測試，將結果整理為 10 條規則的合約，並提供四種形式：Python 程式庫、dsh CLI、MCP server，以及 Anthropic Skill。以下三項發現，最容易讓基於 V4 開發的人踩雷：
- 多輪工具呼叫若沒有在 assistant 訊息中保留
reasoning_content，就會回傳 HTTP 400；兩個模型都以 3/3 次重現。 /beta端點會在未提示的情況下，將v4-pro改映射為deepseek-reasoner。- 快取命中會在 1,024-token 前綴之後，以 256-token 區塊出現；某個五輪迴圈達到 95% 平衡命中率，讓有效輸入成本約降至 1/50。
兩個套件都會提供 dsh 指令，這正是混淆的主要來源。透過 pip 安裝的是轉接程式庫；透過 npm 且位於 @deepseek-ai scope 下安裝的，才是 harness。
不使用 DSH，也能把 DeepSeek V4 當 Coding Agent
如果你想在 DSH 文件趨於穩定前，先使用 DeepSeek 驅動的 Coding Agent，DeepSeek 的官方整合指南列出三種支援路徑：
| 工具 | 設定方式 | DeepSeek 模型 | 適用情境 | |
|---|---|---|---|---|
| Claude Code | 環境變數、Anthropic 相容端點 | V4-Pro（主模型）、V4-Flash（子 Agent） | 以 max effort 進行終端機開發 | |
| OpenCode | /connect 流程，選擇 DeepSeek provider | V4-Pro | 開源、可互動選擇 provider（需要 v1.14.24+） | |
| OpenClaw | `curl -fsSL https://openclaw.ai/install.sh \ | bash` | V4-Pro 或 V4-Flash | 具備 Skills 與聊天整合的個人助理 |
Claude Code 的設定方式，是把 DeepSeek 模型映射至 Claude Code 對應的模型欄位：
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max這裡有個映射細節：請求 claude-sonnet 時，實際會解析為 Flash，而非 Pro。DeepSeek 的文件將 Pro 對應到 Opus 欄位、Flash 對應到 Haiku 欄位。這三項工具都被列為第三方整合，DeepSeek 不保證其效果或安全性。想看更完整的比較，可參考我們的Coding Agent LLM 比較與V4-Pro GA API 指南。
FAQ
@deepseek-ai/dsh 是官方的 DeepSeek Harness 嗎？
@deepseek-ai 這個 npm scope 與 DeepSeek 的 GitHub 組織一致，發布日期也符合 7 月 31 日更新日誌承諾的時程。社群貼文確認套件可以安裝。不過，DeepSeek 8 月 13 日的更新日誌雖記錄 V4-Pro GA，並未直接點名 harness；此外 npm 也阻擋自動化驗證套件頁面。
DSH 和 PyPI 上的 deepseek-harness 有何不同？
它們是由不同維護者推出的不同產品。@deepseek-ai/dsh 是 8 月 13 日發布於 npm 的 Coding Agent harness；pip install deepseek-harness 則會安裝 Henry Zhang 製作、MIT 授權、5 月 9 日發布的獨立 Python 協定轉接程式庫，主要處理 V4 API 的特殊行為。兩者都提供 dsh 指令。
使用 DSH 需要 DeepSeek API Key 嗎？
需要。harness 是透過DeepSeek API執行 V4-Pro 和 V4-Flash，因此會依 token 用量計費。npm 套件本身可免費安裝，成本來自 API 用量。V4 系列價格將在 8 月 16 日 16:00 UTC 改為尖峰／離峰費率，離峰價格為尖峰的一半。
DSH 與 Claude Code 相比如何？
Claude Code 是成熟、文件完整的終端機 Coding Agent，目前已能透過 Anthropic 相容端點搭配 DeepSeek 使用。DSH 的賣點在於針對模型本身最佳化：它是依 V4 的協定行為打造，而不是後續適配 V4。從公開 benchmark 設定可看出這項優勢具有合理性，但在 DSH 文件與社群測試跟上前，仍缺乏獨立使用情境下的驗證。
AI harness 和 AI agent 差在哪裡？
Harness 是基礎設施層，處理上下文管理、工具路由與任務編排；Agent 則是完整組合，也就是模型在 harness 中運行後，具備多步驟行動能力的系統。每個 Agent 都需要 harness，但同一套 harness 可以服務不同模型。Claude Code、Cursor、Copilot 和 DSH 都是 harness；由模型驅動並能採取行動時，才構成我們所說的「Agent」。
發布現況：哪些已獲官方確認，哪些來自社群？
本文資訊來自兩個層級的證據。
官方已確認（DeepSeek API 更新日誌，含日期條目）：
deepseek-v4-pro在 8 月 13 日進入 GA，原生支援 OpenAI Responses API，並提供三種推理強度（更新日誌）。- V4-Flash 於 7 月 31 日進入公開 beta，benchmark 使用「DeepSeek Harness minimal mode（即將推出）」產生。
- 所有 V4-Pro GA 與 V4-Flash beta 的 benchmark 數字，均來自這些更新日誌條目。
- V4 系列價格於 8 月 16 日 16:00 UTC 改採尖峰／離峰費率。
- Claude Code、OpenCode 與 OpenClaw 整合指南是官方文件。
社群回報（Reddit 貼文、重現截圖）：
@deepseek-ai/dsh可安裝且能運作。u/Testx01 在 8 月 13 日 12:56 UTC 貼出套件連結，u/Available_Yam_6267 在數分鐘後跟進。@deepseek-ainpm scope 與 DeepSeek 的GitHub 組織一致。- npm 的套件頁面阻擋自動化抓取，因此版本、授權與維護者中繼資料目前無法透過 registry 確認。
「Deepseek harness is out on npm :)」—— u/Testx01，r/DeepSeek，8 月 13 日
- 一則重現的內部 beta 訊息提到，369 名成員的 beta 群組在 8 月 11 日推送最終內部版本，並要求外掛開發者在 8 月 13 日公開 beta 前，為儲存庫加上
#dsh標籤；產品上線後，外掛可轉移至個人帳號。 - 社群報導引用中國科技媒體於 5 月的說法，指出 DeepSeek 正在組建專責 harness 團隊，並招募 Agent Harness 產品職位。
在 DeepSeek 於自家網站發布正式文件前，DSH 的功能、CLI 與外掛相關說法，都應視為僅獲社群確認。