一天七万Star,DeepSeek藏了半年的东西, DeepSeek Harness 有啥不同?
三句話摘要
DeepSeek 開源的 Harness 智能體框架採用全插件化架構,把模型變成真正可運行的 Agent 的工程層。 模型是發動機,Harness 是整輛車,往後要比的不是發動機參數,而是整輛車的工程設計。 --- 補充建議:如果你對這個框架感興趣,現在就裝一個跑起來,把架構文檔當教材讀一遍,試著寫個小插件。這波紅利屬於動手早的人。開發者預覽版會有破壞性變更,別上生產環境;YML 沒認證,別暴露到公網;暫時不接受外部 PR,參與要走插件生態和 discussions。 Model + Harness = Agent:模型負責「想」,Harness 負責把想法落地,涵蓋調度上下文、調用工具、管理任務狀態、處理反饋、守住權限邊界,這一層是模型強也無法跳過的。
重點整理
重點- 1
Model + Harness = Agent:模型負責「想」,Harness 負責把想法落地,涵蓋調度上下文、調用工具、管理任務狀態、處理反饋、守住權限邊界,這一層是模型強也無法跳過的。
- 2
插件框架的終極形態:不只是工具可以插件化(主流框架已有),連 Agent 循環本身都做成了事件鉤子化設計,pre/post 鉤子貫穿每一步,讓使用者無需 Fork 原碼就能改變 Agent 的整體行為。
- 3
事件溯源設計:採用追加日誌記錄所有執行事件,支援恢復、分叉、檢索、回放,長任務崩潰時不丟棄已執行步驟,只補合成終止標記,這是 WAL 與版本控制的工程思維在 Agent 領域的體現。
- 4
生態戰略:框架免費開源,但運行時要燒模型 API token,同時 API 漲價推進開發者轉向採用框架,這是控制面(框架)與資源面(API 計費)的經典雲廠商模式。
實用技巧與重點
乾貨- 發布時間:2026 年 8 月 13 日
- 開源位置:GitHub Deepseak Harness 倉庫
- 開源協議:MIT,可商用
- 技術棧:TypeScript、Monorepo、前後端一體
- 啟動方式:`npm install` + `pnpm build` + `dsh` 命令行 + 本地 127.0.0.1:3080 網頁界面
- 核心概念:
- Step = 一次模型請求 + 工具調用
- Turn = 0 個或多個 step 組成的循環
- 事件鉤子:agent:preStep、tool:pre、tool:post 等
- 運行模式:
- 標準模式(完整工具調用)
- PTC 模式(程序化工具組合,少跑來回)
- 極簡模式(只留 shell 和文件編輯)
- 創造模式(模型自動寫插件)
- 架構分層:
- Base 層:模型、工具、技能、存儲等能力
- External 層:瀏覽器界面
- Headless 層:無服務器單次運行
- 啟動時可用 `dsh dump config` 檢視實際運行的插件列表
- 插件系統:模型適配器、畫布策略、Agent 循環本身都是插件
- 開發筆記公開:GitHub Notes 目錄按日期歸檔架構決策、Bug 修復、4 篇事故復盤
- 實測表現:V4 Flash 一次提示完成第一人稱喪失遊戲原型(30 分鐘)、3D 世界生成
- 安全提醒:YML 沒有認證,別暴露到局域網或公網
- 社區狀態:發布一天已有 Docker 桌面端、UI 封裝、ChatGPT 插件等衍生品
結論
結論“模型是發動機,Harness 是整輛車,往後要比的不是發動機參數,而是整輛車的工程設計。 --- 補充建議:如果你對這個框架感興趣,現在就裝一個跑起來,把架構文檔當教材讀一遍,試著寫個小插件。這波紅利屬於動手早的人。開發者預覽版會有破壞性變更,別上生產環境;YML 沒認證,別暴露到公網;暫時不接受外部 PR,參與要走插件生態和 discussions。”
完整解析
詳細DeepSeek 在 8 月 13 日凌晨發布 V4 Pro 後,當天又在 GitHub 開源了 Harness 框架,一天內衝到 6.9k star。這不是又一個 Agent 工具箱,而是對「如何讓模型成為真正可運行的 Agent」的完整工程解答。
官方給的定義很清晰:Model 加 Harness 等於 Agent。模型負責「想」,Harness 負責落地——調度上下文、調用工具、管理任務狀態、處理反饋、守住權限邊界。沒有這一層,模型再強也只能聊天。這回答了為什麼市面上 Agent 框架那麼多,DeepSeek 還要自己做一套。
架構的核心是「一切皆插件」。不同於主流框架只讓你加工具、改不了主流程,Harness 把 Agent 的循環本身也做成了插件。它定義了 Step(一次模型請求加工具調用)和 Turn(0 個或多個 step),用事件鉤子貫穿整個流程:agent:preStep 能在模型請求前改寫甚至拒絕消息,tool:pre 和 tool:post 能在工具調用前後插邏輯。這意味著你不用 Fork 原碼就能改變 Agent 的整體行為。框架採用分層設計,有 Base 層(模型、工具、技能)、External 層(UI)、Headless 層(無服務器)、Profile(用戶自定義組合)、Patch(配置替換),啟動時 `dsh dump config` 能完整打印實際運行的插件數。
第二個亮點是事件溯源日誌。每次運行,模型看到的一切都寫進一條追加日誌,底層思路和數據庫的 WAL 一樣。好處直接:恢復、分叉、檢索、回放共享同一份事件流。關鍵是「模型能看到的東西必須能從日誌裡重建」。長任務的一個 Turn 可能有幾十步、無法丟棄,崩潰時不是阿段丟掉未完成部分,而是補一個合成的終止標記寫 Reason 為 Interrupted,前面的事件一個不動。這是 WAL 重放的思路,只修復不篡改。
官方列了四種運行模式。標準模式是完整工具調用。PTC 模式讓模型寫代碼組合多個工具調用,少跑很多來回、省 Token。極簡模式只留 shell 和文件編輯,用來測模型裸能力。最有意思的是創造模式,會檢查當前運行時,在內存裡組合出新的模式,甚至讓模型自己寫插件實時裝上生效。四種模式本質是四套默認插件組合,理論上使用者也能配出第五種、第六種。
框架背後還有激進的思路:模型可以在不打斷任務的情況下自己寫插件、自己裝上、立刻生效。這對應 Anthropic 自我改進博客之後大家都在聊的自進化話題。DeepSeek 把這條路講得最具體。社區共識是對普通用戶暫時用處不大(需要高質量插件生態沉澱),但對極客來說是給後人眾數的機會。
官方還公開了開發筆記,架構決策、Bug 修復、事故復盤全攤在那,你能看出多少是 Agent 參與開發、每次決策的理由。這個項目至少悶頭開發了兩個月,實測用 V4 Flash 跑 Harness,一次提示沒人工干預,30 分鐘做出第一人稱喪失遊戲原型(能玩但不完美),也做過 3D 世界生成。這些示範看看就好,但能一次跑出可運行原型說明工具鏈穩定。
真正拉開差距的是常任務的上下文管理。這到達的問題是「谁的框架被更多人接受,谁就能把整個社區的生產力變成自己的資產」。框架免費開源 MIT 協議,但要燒模型 API token,而 API 漲價推進開發者轉向框架。這是當年雲廠商開源 Kubernetes 的邏輯:控制面免費,資源上轉回來。官方挂了數據處理政策和使用政策頁面,提前把隱私問題攤上台面。
評估框架值不值得投入,用三問框架:第一問可替換性,每一層能不能換、換的時候要不要改原碼。第二問可觀測性,出事時能不能精確判斷它看到了什麼、做了什麼。第三問可組合性,能力能不能像積木沉澱成自己的資產。拿這三問套任何新框架,五分鐘就能判斷。
關鍵時刻
Pipeline v2帶時間戳的重點,會在逐字稿層級分析上線後產生。目前請先透過原始影片觀看。
事實查核
Pipeline v2說法查證是下一次管線升級的一部分。KeyFrame 只會顯示它真正能驗證的內容。


