要在倉庫裡跑編碼 Agent
需要讀改檔案、執行 Shell、檢索網頁，並讓模型連續完成多步工程任務。
開發者預覽 · MIT 開源 · 2026-08
DeepSeek Harness：讓模型在真實環境裡持續工作
DeepSeek Harness（dsh）不是新的聊天模型，而是開源 Agent 運行層。模型負責思考，Harness 負責工具、會話、沙箱與可回放日誌。公式很簡單：Agent = 模型 + Harness。
頁面更新於 2026-08-18 · 依據官方開發者預覽公開資訊整理
DeepSeek Harness 是什麼？
先分清「模型」和「Harness」，再決定你要裝哪一層。
Agent = 模型 + Harness
模型是靈魂：負責推理、拆任務、決定下一步。
Harness 是手腳與現場：理解環境、呼叫工具，並在真實倉庫裡連續工作。
DeepSeek Harness 是 DeepSeek 於 2026 年 8 月面向全球開發者放出的 Agent 運行基礎設施（開發者預覽）。原始碼以 MIT 協議開放，npm 套件名為 @deepseek-ai/dsh，倉庫地址在 GitHub 的 deepseek-ai/deepseek-harness。
它解決的不是「再發一個會聊天的模型」，而是：模型已經會推理，如何在真實目錄裡改檔案、跑命令、調工具、記日誌，並在失敗後恢復。沒有 Harness，你多半停在對話框；有了 Harness，模型才能在受控邊界裡連續執行。
官方口號是「一切皆外掛」。預設路徑仍需設定 DeepSeek API Key。Web UI 可以免費打開，真正跑 Agent 會產生模型呼叫費用。目前屬於 v0.1 系列預覽，核心外掛與 API 可能出現破壞性變更。
誰適合用 DeepSeek Harness？
和本站網頁版對話不是同一類入口，按任務選工具。
-
-
要做外掛或自訂 preset
希望在不改 Harness 主幹的前提下，替換模型、工具、沙箱或 UI，組裝自己的 Agent。
-
只想打開瀏覽器聊天
不必安裝 Node.js。請用本站 DeepSeek 網頁版入口，直接與 DeepSeek-V4 對話。
架構要點：一切皆外掛
DeepSeek Harness 基於 Cordis。核心只管載入與依賴，具體能力全部由外掛提供。
-
01
Cordis 核心
只負責外掛的掛載、卸載和依賴關係，不把 Agent 業務寫進主幹，避免一改能力就要分叉整倉。
-
02
能力都是外掛
模型適配器、工具、技能、會話、沙箱、儲存、迴圈、排程和介面均可作為外掛組合，透過服務與事件協作。
-
03
設定層重組
開發者無需改 Harness 原始碼，即可在設定層選擇、替換或擴展任一能力，按場景組裝 Agent。
四種運行模式
同一套外掛核心，預設載入不同組合，涵蓋日常編碼、程式化調工具、基準測試和自訂 preset。
標準模式
功能完整的編碼 Agent。
支援檔案編輯、Shell、檔案與網頁檢索、Skills、計畫、目標、子代理和工作流程，適合日常倉庫任務。
PTC 模式
用一段程式碼組合多輪工具呼叫。
具備標準模式能力，並透過 Code Mode SDK 呈現工具，讓模型用 TypeScript 程式編排多步操作。
極簡模式
最小工具面，便於基準測試。
通常只保留持久 bash 與檔案編輯（str_replace_editor），用來觀察模型在最小化環境中的表現。
創造模式
檢查運行時並創作自訂 preset。
用於查看目前外掛、在記憶體中試驗 Cordis 外掛，並組合出新的運行模式。
每一次運行都有跡可循
會話按僅追加事件流記錄，恢復、分叉、檢索與回放共用同一份日誌。
-
系統提示詞、思維鏈、工具呼叫與結果會寫入會話日誌
-
子 Agent 調度與每一次上下文注入可按來源查看
-
Trajectory 檢視幫助你稽核模型看見了什麼、做了什麼
-
高風險操作應配合權限與審批，而不是把倉庫裸交給模型
開始使用
快速體驗或從原始碼安裝
需要本機已安裝 Node.js。版本要求以官方倉庫 README 為準。
快速體驗
安裝 Node.js 後，可透過 npx 啟動 Web UI。預設在本機 3080 連接埠打開：http://127.0.0.1:3080
$ npx @deepseek-ai/dsh web原始碼安裝
取得完整專案原始碼，並按照倉庫說明完成安裝（pnpm install、pnpm run build、pnpm dsh web）。
$ git clone https://github.com/deepseek-ai/deepseek-harness設定 API Key 與模型
在介面中設定 DeepSeek API Key，並選擇 DeepSeek-V4-Flash 或 DeepSeek-V4-Pro。建議先用 Flash 試跑。
指定工作區與權限
選好倉庫目錄，收緊檔案與命令權限後再下發任務。預覽階段命令與設定可能變化，請以倉庫文件為準。
網頁對話和 Harness 有什麼不同？
本站 DeepSeek 網頁版解決「打開就能聊」；Harness 解決「在倉庫裡連續執行」。
| 對比項 | DeepSeek 網頁版對話 | DeepSeek Harness |
|---|---|---|
| 你在找什麼 | 免安裝線上對話入口 | 本機 / 原始碼級 Agent 運行層 |
| 典型使用者 | 學習、辦公、寫作、問答 | 開發者、做 Agent 與外掛的人 |
| 能否改倉庫檔案 | 以對話為主 | 可在權限範圍內讀寫檔案、跑命令 |
| 如何開始 | 瀏覽器打開本站入口 | npx 啟動 Web UI 或複製原始碼 |
DeepSeek Harness 常見問題
關於開源協議、費用、模型選擇與網頁版差異。
DeepSeek Harness 是官方新模型嗎？
不是。它是 DeepSeek 開源的 Agent 運行框架（Harness），用來連接模型、工具、會話與介面。聊天與推理能力仍來自 DeepSeek-V4 等模型。
DeepSeek Harness 免費嗎？
框架原始碼按 MIT 協議開源，可免費取得。運行 Agent 通常要呼叫 DeepSeek API，會產生 token 費用。以官方定價和你的金鑰餘額為準。
和本站 DeepSeek 網頁版是一回事嗎？
不是。網頁版面向打開瀏覽器即對話；Harness 面向開發者在真實環境裡跑編碼 Agent。需要聊天請用本站入口，需要改程式碼、跑工具請用 Harness。
用 Harness 必須本機部署大模型嗎？
不必。公開文件的常見路徑是使用 DeepSeek 雲端 API。你需要 Node.js、API Key 和瀏覽器，不必須自備 GPU。
現在能用於生產環境嗎？
官方標明開發者預覽，並提示會有相容性破壞變更。適合學習、試驗與外掛開發；生產接入請自行評估穩定性，並鎖定你驗證過的版本。
dsh 是什麼？怎麼啟動？
dsh 是 DeepSeek Harness 的常用縮寫與 CLI 名。安裝 Node.js 後執行 npx @deepseek-ai/dsh web，預設在 http://127.0.0.1:3080 打開 Web UI。
本頁由 DeepSeek-V4 站點根據 DeepSeek 官方 Harness 頁面與 GitHub 倉庫公開資訊整理，便於檢索與對照，並非 DeepSeek 官方站點。安裝、設定與相容性以官方文件和倉庫 README 為準。