DeepSeek Harness · 開發者預覽版

DeepSeek Harness 一切皆外掛 · Agent 執行階段

模型是 Agent 的靈魂,Harness 讓 Agent 理解環境、使用工具,並在真實場景中持續工作。DeepSeek Harness(dsh)已開源:先開啟 DeepSeek 網頁版與 DeepSeek-V4 對話驗證任務,再按需於本機用外掛組合完整 Agent。

MIT

開源授權

DeepSeek Harness 商用友善

外掛

一切皆外掛

模型到 UI 均可替換

4

執行模式

標準 / PTC / 極簡 / 創造

V4

DeepSeek-V4

先網頁版驗證再本機跑

Agent = Model + Harness

Harness 讓 DeepSeek Agent 在真實場景持續工作

DeepSeek-V4 提供推理與對話;DeepSeek Harness 提供環境、工具與可追蹤執行。兩者疊加,才是可落地的 Agent。

Cordis 核心

Cordis 只負責外掛的載入、卸載與相依性,不承載 Agent 的具體能力。DeepSeek Harness 把「能做什麼」全部交給外掛。

DeepSeek Harness Cordis

外掛提供能力

模型、工具、技能、會話、沙箱、儲存、迴圈、排程、UI 等所有 Agent 能力均由外掛提供,並透過 Cordis 服務與事件彼此協作。

DeepSeek 一切皆外掛

設定層自由組合

開發者無需改 DeepSeek Harness 原始碼,即可在設定層選擇、替換或擴充任一能力,快速試驗適合 DeepSeek-V4 的工具組合。

DeepSeek Harness 可組合
DeepSeek Harness 核心能力

六項能力,定義開源 Agent 執行階段

面向 Harness 開發者的預覽版:開源、可替換、可追蹤。適合與 DeepSeek 網頁版、DeepSeek-V4 組成「對話驗證 + 本機執行」工作流程。

一切皆外掛

DeepSeek Harness 基於 Cordis 外掛系統。模型適配、工具註冊、會話日誌、Agent 迴圈乃至 UI 都是外掛,可在設定中自由替換。

DeepSeek Harness 外掛

執行有跡可循

模型看到的一切寫入僅附加會話日誌:系統提示、思維鏈、工具呼叫與結果、子 Agent 排程與上下文注入。Trajectory 檢視依來源回放。

DeepSeek Trajectory

四種執行模式

標準模式提供完整工具;PTC(Code)模式用產生的程式碼編排多步呼叫;極簡模式用於基準測試;創造模式用於試驗外掛並創作新 preset。

DeepSeek Harness 模式

與 DeepSeek-V4 互補

DeepSeek 網頁版適合先把任務說清楚、對比 Pro / Flash;Harness 適合把同一任務放到帶沙箱與工具的本機 Agent 中連續執行。

DeepSeek-V4 Agent

Web UI 一鍵拉起

安裝 Node.js 後執行 npx @deepseek-ai/dsh web,預設開啟本機 Web UI(127.0.0.1:3080)。原始碼安裝可用 pnpm 建置後執行同一命令。

DeepSeek dsh web

開放外掛生態

為外掛儲存庫新增 GitHub topic「dsh-plugin」便於發現。核心外掛與 API 仍在迭代,官方明確提示將出現破壞性變更。

dsh-plugin 生態
DeepSeek Harness 速覽

開發者預覽版,你需要記住的事實

資訊來自 DeepSeek 官方介紹頁與 GitHub 儲存庫 README,便於檢索 DeepSeek Harness / dsh 相關問題。

dsh

命令列名稱

DeepSeek Harness 的 CLI 與套件名稱線索:npx @deepseek-ai/dsh web

Cordis

外掛核心

只管理載入 / 卸載 / 相依性,Agent 能力全部由外掛提供

MIT

開源授權

官方儲存庫 deepseek-ai/deepseek-harness 以 MIT 協議開放原始碼

4

內建模式

標準、PTC(Code)、極簡、創造,涵蓋編碼 Agent 到基準測試

3080

預設 Web 連接埠

npx 啟動後本機 Web UI 預設監聽 127.0.0.1:3080

預覽

開發者預覽

面向全球 Harness 開發者測試,核心外掛與 API 持續迭代

外掛

模型也可替換

含模型適配與 UI

日誌

僅附加會話

還原 / 分叉 / 回放同源

V4

DeepSeek-V4

網頁版先驗證意圖

開源

GitHub 同步

Discussions 收集回饋

DeepSeek Harness 仍處於開發者預覽,官方強調將出現破壞相容性的變更。正式環境請勿盲目鎖定版本;對話與方案驗證可先使用本站 DeepSeek 網頁版。

先在 DeepSeek 網頁版把任務說清楚

DeepSeek Harness 適合本機 Agent 執行;意圖、提示詞與 DeepSeek-V4 效果,建議先在網頁版驗證。

DeepSeek Harness 執行模式

四種模式,涵蓋從基準測試到自訂 Agent

無需改原始碼即可切換模式。詳細對比與適用場景見「執行模式」子頁。

標準模式

功能完整的編碼 Agent:檔案編輯、Shell、檔案與網頁檢索、Skills、計畫、目標、子代理和工作流程。適合日常研發任務。

DeepSeek Harness 標準模式

PTC / Code 模式

具備標準模式全部能力,並透過 Code Mode SDK 呈現工具,讓模型用一個 TypeScript 程式組合多步操作,減少來回工具呼叫。

DeepSeek PTC Code Mode

極簡模式

僅提供持久 bash 與 str_replace_editor 的雙工具編碼 Agent,用於最小化環境下的模型基準測試(含 DeepSeek-V4 相關評測場景)。

DeepSeek Harness 極簡模式

創造模式

用於建立自訂 Agent preset:具備標準模式能力,並提供執行階段檢查、記憶體中試驗 Cordis 外掛,以及 preset 創作指導。

DeepSeek Harness 創造模式

執行模式

設計思路

一切皆外掛,每一次執行都有跡可循

這是 DeepSeek 官方對 Harness 的核心表述,也是檢索「DeepSeek Harness 是什麼」時最該記住的三點。

01

一切皆外掛

DeepSeek Harness 基於 Cordis 外掛系統建構。模型、工具、技能、會話、沙箱、儲存、迴圈、排程、UI 均由外掛提供,並透過服務與事件協作。開發者不必 fork 原始碼即可在設定層重組能力。

02

每一次執行都有跡可循

系統提示詞、思維鏈、工具呼叫與結果、子 Agent 排程、每一次上下文注入,都會寫入僅附加會話日誌。還原、分叉、檢索與回放共享同一份事件流,Trajectory 檢視可依來源檢查。

03

多種執行模式

標準模式給完整工具組合;PTC 模式用模型產生的程式碼串聯多輪工具;極簡模式只留 shell 與檔案編輯,服務評測;創造模式檢查執行階段、試驗外掛並組合新模式。

快速體驗

本機拉起 Web UI,或從原始碼安裝

以下命令來自官方文件,供開發者對照。若你想先確認任務表述與 DeepSeek-V4 效果,建議從本站 DeepSeek 網頁版開始對話。

快速體驗

安裝 Node.js 後,可透過 npx 啟動 Web UI。

npx @deepseek-ai/dsh web

原始碼安裝

取得完整專案原始碼,並按照儲存庫說明完成安裝。

git clone https://github.com/deepseek-ai/deepseek-harness
DeepSeek Harness FAQ

關於 DeepSeek Harness 的常見疑問

它和 DeepSeek 網頁版、DeepSeek-V4 是什麼關係?能否用於正式環境?以下按官方口徑整理。

01 DeepSeek Harness 是什麼?

DeepSeek Harness(命令名 dsh)是 DeepSeek AI 開源的 Agent 執行階段(agent harness)。它讓模型理解環境、呼叫工具,並在真實場景中持續工作。架構口號是「一切皆外掛」,核心為 Cordis。

02 Harness 和 DeepSeek 網頁版、DeepSeek-V4 有何不同?

DeepSeek 網頁版與 DeepSeek-V4 解決「對話、推理、長上下文」;Harness 解決「工具、沙箱、會話日誌、可替換執行階段」。建議路徑:先在網頁版把任務說清楚,再按需用 dsh 於本機跑帶工具的 Agent。

03 現在能用於正式環境嗎?

官方定位為開發者預覽,並明確警告將出現破壞相容性的變更。適合試驗外掛、評測與學習架構,不適合把關鍵正式系統釘死在目前版本。

04 如何最快體驗 DeepSeek Harness?

安裝 Node.js 後執行 npx @deepseek-ai/dsh web,預設開啟 http://127.0.0.1:3080。也可 git clone 官方儲存庫後按 README 用 pnpm 安裝建置。想先對話驗證,請用本站「立即體驗」進入 DeepSeek 網頁版。

05 Cordis 是什麼?

Cordis 是 DeepSeek Harness 使用的外掛核心,負責外掛載入、卸載與相依性。Agent 的模型、工具、UI 等具體能力不在核心裡,而在外掛中,透過服務與事件協作。

06 PTC 模式和 Code 模式是一回事嗎?

官方中文頁稱 PTC 模式,英文頁稱 Code mode:都指用模型產生的一段程式碼(經 Code Mode SDK)組合多輪工具呼叫,同時保留標準模式能力。

07 極簡模式有什麼用?

極簡模式只保留持久 bash 與 str_replace_editor,用於最小化環境的模型基準測試。公開評測說明中,DeepSeek-V4-Flash 的部分 Code Agent 分數與極簡模式框架相關。

08 如何發布社群外掛?

在外掛儲存庫新增 GitHub topic「dsh-plugin」便於被發現。回饋與缺陷建議走官方 GitHub Discussions。核心外掛與基礎 API 仍會持續迭代。

09 會話可以回放嗎?

可以。模型看到的提示、思維鏈、工具結果與子 Agent 排程都會寫入僅附加日誌。還原、分叉、檢索與回放共用同一事件流,可在 Trajectory 檢視依來源查看。

10 必須改原始碼才能換模型或工具嗎?

不必。官方強調開發者無需改動 DeepSeek Harness 原始碼,即可在設定層選擇、替換或擴充任一能力,包括模型適配與 UI。

11 開源授權是什麼?

官方儲存庫以 MIT 協議開源,第三方相依套件見儲存庫內 THIRD_PARTY_NOTICES。商用前請自行閱讀授權條款與預覽版免責聲明。

12 不會裝本機環境時怎麼先用 DeepSeek?

先開啟本站 DeepSeek 網頁版,與 DeepSeek-V4 直接對話,確認提示詞與任務拆解;需要本機工具與沙箱時,再安裝 Node.js 執行 dsh。兩條路徑互補,並不互相替代。

DeepSeek-V4 + Harness,從對話到可執行 Agent

網頁版驗證思路,Harness 組合外掛與工具。從本站一鍵跳轉 DeepSeek 網頁版開始。