KeyFrame內部研究專用

一天七万Star,DeepSeek藏了半年的东西, DeepSeek Harness 有啥不同?

Why QQ·8月15日週六·12 min中文

三句話摘要

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 只會顯示它真正能驗證的內容。

更多「AI 技術」的內容

🔬“We have foundation models for language, not for physics” — Anima Anandkumar, Bren Professor of Computing
編輯精選
83 min
AI 技術英文PODCAST8月26日

🔬“We have foundation models for language, not for physics” — Anima Anandkumar, Bren Professor of Computing

Latent Space

  • 加速傳統物理模擬的典範轉移:氣象科學家原本認為 AI 無法匹敵數十年的物理建模工作,但傅里葉神經算子不僅達到同等精度,還快了一萬多倍。原本需要超級計算機的計算現在用消費級 GPU 就能完成,這改變了整個領域的思維方式。
  • 傅里葉域的非局部現象捕捉:傅里葉域能有效表示非局部現象(如大氣河流跨越千里的影響),且計算複雜度為準線性,遠優於完全連接的全局模型。這特別適合流體動力學、量子化學等自然現象中普遍存在的非局部相互作用。
  • 多解析度連續函數表示:神經算子將輸入輸出視為連續函數而非固定維度向量,可在推論時以任意解析度查詢,並能在更高解析度上疊加物理約束或額外數據,克服了固定解析度神經網路的限制。
Between Two Nerds: Attribution is dead, long live attribution
32 min
AI 技術英文PODCAST8月25日

Between Two Nerds: Attribution is dead, long live attribution

Risky Business

  • 工具成本的破壞性下降 — 傳統上,攻擊者必須重複使用昂貴自製的惡意軟體或工具組,因為開發和維護成本極高。這種成本結構使得安全研究人員可以通過工具特徵和程式碼簽名來追蹤攻擊者。LLM 自動化了代碼生成與維護工作流,使得攻擊者可以輕易為每個目標生成新工具,或改用通用系統工具,導致傳統的工具特徵分析失效。
  • 所有取證證據都在攻擊者掌控之中 — 無論是使用的 IP 位址、惡意軟體類型或戰術流程,這些都是攻擊者的主動選擇。即使看似是隨機巧合,攻擊者仍有能力在事前決定留下什麼痕跡。因此,所有可恢復的取證證據本質上都是攻擊者願意暴露的信息。
  • LLM 削弱工具簽名但保留高階行為特徵 — LLM 經過公開駭客技術訓練,使不同使用者產生相似的攻擊模式。然而,勒索軟體集團、國家級行為者的受害者選擇、贖金要求方式或目標模式等高階特徵仍具有識別價值。例如,鎖定加密交易所的攻擊幾乎只能指向朝鮮。
Why the Next AI Breakthrough May Come from Physics with Max Welling - #774
55 min
AI 技術英文PODCAST8月25日

Why the Next AI Breakthrough May Come from Physics with Max Welling - #774

TWIML AI

  • 多層篩選的材料設計流程:先搜尋文獻資料庫找現有材料,若無合適的就用生成模型產生數十萬個候選分子,用機器學習力場進行分子動力學模擬篩選,再進行實驗驗證。這套流程相比傳統量子力學計算能加速效率數個數量級。
  • 生成AI與熱力學的數學等價性:資訊論是兩個領域的共同基礎,生成模型的擴散過程與非平衡統計力學描述資訊損失的過程在數學上完全對應,許多開發出來的方法工具在兩領域都有精確對應的形式。
  • 基礎模型的遷移學習策略:先在廣泛材料資料集上訓練基礎力場表示,再針對特定材料類別進行蒸餾微調,既能保持計算效率也能獲得專一性。