DeepSeek 更新 Harness 框架？14 項變更解析

DeepSeek 更新 Harness 框架？DeepSeek Harness v0.1.0-rc.8 的發布帶來了 14 項變更，重大更新涵蓋多模態輸入、子代理程式、工具鏈與執行效能，建立了一個解耦且以外掛程式為先的排程層，原生整合圖片請求，並將 Claude Code 和 Codex 等外部工具管理為模組化的子代理程式。隨著人工智慧架構從單一聊天機器人包裝器轉型為分散式代理程式執行環境，開發人員需要具備擴充性的框架來管理任務拆解、工具編排與記憶體持久化。過去，部署自主編碼助理會將工程工作流程綁定至單一封閉原始碼供應商堆疊。如今，由於開源執行環境框架讓開發人員能夠動態替換模型、工具與子代理程式，技術團隊正評估如何建構代理程式編排與下游上下文交接機制。

架構概觀：DeepSeek 如何更新 Harness 框架以進行代理程式編排

重點一覽

DeepSeek Harness v0.1.0-rc.8 引入原生圖片請求支援，讓 /goal 和 /plan 等指令能直接接受混合文字與圖片的輸入。
包含 Claude Code 與 Codex 在內的子代理程式被封裝為隨選設定檔套裝（Profile Bundles），具備非互動式執行模式與父任務喚醒功能。
在 Cordis 外掛程式框架的驅動下，該執行環境將模型、工具、記憶體與主代理程式迴圈視為基於 MIT 授權條款的完全可替換外掛程式。

基礎語言模型與自主代理程式之間的工程界線正變得日益明確。雖然基礎模型提供原始的推理與生成能力，但實際的任務執行需要外部工程外殼來解析檔案系統、叫用 shell 指令、管理對話歷史紀錄以及處理執行重試。DeepSeek 透過一個清晰的公式定義了這種關係：模型 + Harness = 代理程式。

繼 2026 年 8 月首次開源發布 Harness v0.1 後，該專案經歷了開發人員的快速採用。v0.1.0-rc.8 的發布直接建立在此基礎之上，增加了可設定的圖片請求支援並擴展了子代理程式排程能力。

DeepSeek Harness 架構概觀，展示模型與外部 harness 工具之間的模組化關係

rc.8 的重要性在於其「一切皆外掛程式」的設計哲學。在 Cordis 的驅動下（它為 Harness 提供可組合的外掛程式上下文），沒有任何元件是永久寫死（hardcoded）的。開發人員可以替換底層模型介面卡、更換本地儲存引擎、掛載獨立的沙箱環境，或自訂主代理程式執行迴圈。

DeepSeek Harness Git 提交歷史與開源發展軌跡

底層機制：多模態工具鏈、子代理程式與執行管線

在通訊協定層級，DeepSeek Harness v0.1.0-rc.8 將其更新組織在核心功能領域中：原生多模態處理、子代理程式編排與工具鏈效能。

1. 可設定的多模態輸入

更新後的介面卡支援原生圖片請求，將圖片輸入序列化為請求主體中的 base64 資料網址（Data URLs），同時模型回應則繼續透過伺服器發送事件（SSE）進行串流傳輸。包括 /goal 和 /plan 在內的核心指令現在接受混合文字與圖片的負載，而組合器的 @ 選單也擴展為參照活動工作階段與圖片檔案。系統將 base64 圖片負載限制在 20 MiB（maxRequestImageBytes），在標準 30 MiB 請求限制下保留了緩衝空間。

在原生介面卡架構下，配置了圖片功能的模型會直接接收 base64 資料負載，而純文字模型則會在網路傳輸之前拒絕圖片輸入。社群開發人員曾分別探索第三方視覺外掛程式，以為純文字後端提供外部 OCR 與版面解析，但原生的 rc.8 管線專注於針對具備視覺能力的模型配置進行直接圖片直通。

DeepSeek Harness 模型選擇與多模態配置介面

2. 子代理程式排程與設定檔套裝

Claude Code 與 Codex 不會分發外部助理到主程式碼庫中，而是被封裝為隨選設定檔套裝。Codex 獲得了支援無人看管或無頭（headless）執行情境的非互動式權限模式，並具備用於維護多個不同 Codex 配置的命名實例。reportDelivery 機制在子代理程式完成時會自動通知並喚醒父任務，從而減少對持續輪詢迴圈的需求。

下圖說明了任務與子代理程式如何在框架中進行路由：

[User Multimodal Goal / Plan Input]
                │
                ▼
     [Cordis Plugin Context]
                │
  ┌─────────────┼─────────────┐
  ▼             ▼             ▼
[Configured LLM Adapter] [Claude Code] [Codex Bundle]
(Text or Vision Model)   (Sub-Agent)   (Sub-Agent)
  │             │             │
  └─────────────┼─────────────┘
                ▼
  [Tool / Plugin Dispatch Layer]
(Concurrent WebSearch / PTY Terminal)

3. 工具鏈併發與傳輸後設資料

該執行環境引入了對 web_search 的併發查詢支援、Windows PTY 終端機內的持久化 PowerShell 工作階段，以及優化的 SQLite 讀寫與工作階段分支效能。在傳輸層，DeepSeek 介面卡會在供應商請求上發送傳輸層級的身分與工作階段後設資料，包含來自 @deepseek-ai/dsh-anonymous-user-id 的 x-deepseek-harness-user-id，同時將該識別碼保持在模型可見的請求內容與權杖計算之外。

DeepSeek Harness 子代理程式作業管理面板，顯示活動中的 Codex 與 Claude Code 執行緒

開發人員可以使用標準配置結構描述動態配置介面卡設定：

- id: llm-deepseek
  name: '@deepseek-ai/dsh-llm-deepseek'
  config:
    apiKeyEnv: DEEPSEEK_API_KEY
    baseURL: https://api.deepseek.com
    thinking: enabled
    reasoningEffort: high
    maxTokens: 256000
    streamIdleTimeoutMs: 300000
    maxRequestImageBytes: 20971520
    defaultContextWindow: 1000000
    models:
      - id: deepseek-v4-flash
        name: DeepSeek-V4-Flash
      - id: private-vision
        name: Private Vision
        inputModalities: [text, image]

具狀態的工作流程編排與行動應用程式分發上下文連續性

DeepSeek Harness 的模組化架構展示了軟體執行如何朝向分散式、多代理程式工作流程發展。當主要代理程式在多個工具與模型之間委派子任務時，harness 會維護執行上下文、追蹤子代理程式狀態，並將輸出聚合為一致的最終結果。

雖然桌面與伺服器端代理程式執行環境在活動外掛程式與本地處理程序之間維護狀態，但當自動化旅程跨越行動應用程式分發邊界時，會出現相鄰的架構挑戰。

在生命週期邊界之間搭起上下文連續性的橋樑

在 Harness 內，工作階段連續性是透過執行環境工作階段狀態與持久化層來維持的。然而，在行動應用程式分發中，當行銷活動、網頁推薦或共用推薦將使用者導向尚未安裝的應用程式時，預先安裝的行銷活動或目的地上下文並不會在「商店安裝-首次啟動」的轉換過程中自動存活。

專門的行動連結架構，例如 OpoInstall，透過延遲深度連結（deferred deep linking）與參數傳遞能力來解決這種上下文不連續的問題。這些框架在安裝前擷取行銷活動或目的地後設資料，並在應用程式首次啟動時還原這些參數，從而實現即時上下文路由。這兩種機制解決了不同生命週期階段中的不同技術問題，但兩者都突顯出跨越碎片化應用程式邊界對可靠上下文連續性的日益增長的需求。

工程檢查清單：在正式環境中部署模組化代理程式 Harness

在正式環境中部署可擴充的代理程式執行環境需要結構化的治理，以平衡執行彈性與營運穩定性。

開發人員實作檢查清單

管理 SQLite 結構描述移轉：在跨小版本升級時，確保資料庫儲存格式乾淨更新，以防止因不相容的表格結構而產生資料錯誤。
配置子代理程式執行模式：在執行無人看管的處理程序時，在自動化的 Codex 實例上啟用非互動式權限旗標。
設定圖片負載限制：將傳入的 base64 圖片負載限制在 20 MiB（maxRequestImageBytes），以防止在多輪對話期間超出供應商的主體上限。

架構與成長策略檢查清單

稽核傳輸識別碼：驗證匿名識別碼（x-deepseek-harness-user-id）與工作階段標頭是否符合當地隱私政策。
優化多代理程式權杖預算：實作模型仲裁，將子任務路由至具成本效益的模型，同時為複雜規劃保留前沿模型。
確保跨平台上下文保留：在網頁入口點與原生行動應用程式之間搭起使用者工作流程橋樑時，部署伺服器端參數還原框架。

常見問題 (FAQ)

DeepSeek Harness 背後的核心架構哲學是什麼？

DeepSeek Harness 建立在由 Cordis 外掛程式框架驅動的「一切皆外掛程式」設計之上。模型、工具、執行迴圈、沙箱、記憶體儲存與使用者介面全數實作為基於 MIT 授權條款的可互換外掛程式，讓開發人員能夠自訂或替換任何元件。

DeepSeek Harness 如何在模型配置中處理視覺輸入？

DeepSeek Harness v0.1.0-rc.8 透過針對具備視覺能力模型的介面卡配置，實現了原生圖片請求處理。對於配置了圖片模態的模型，諸如 `/goal` 和 `/plan` 等指令可以直接處理混合文字與圖片的負載，圖片會在請求主體中序列化為 base64 資料網址，上限為 20 MiB。

子代理程式設定檔套裝如何向父任務進行通訊？

Claude Code 與 Codex 等子代理程式作為執行環境中的隔離任務執行。在完成其指派的工作負載後，`reportDelivery` 機制會自動將結構化結果傳輸回父任務並喚醒等待中的處理程序，從而減少持續輪詢的需求。

工程團隊的關鍵要點

像 DeepSeek Harness 這樣的開源代理程式執行環境的快速演進，標誌著從以模型為中心的競爭轉向工作流程與編排層主導地位。隨著模型後端在模組化代理程式架構中變得日益可互換，協調子代理程式、管理工具並維護執行狀態的軟體層成為開發人員控制的主要核心。

建構下一代代理程式系統的工程團隊必須優先考慮模組化、明確的權限邊界以及強健的狀態管理。透過將代理程式編排解耦為可擴充的外掛程式，並在網頁與行動裝置觸點之間實作具備韌性的上下文交接機制，組織能夠建構出具備適應性且不綁定特定供應商的自動化管線。

參考資料

DeepSeek AI. DeepSeek Harness 發布說明 (v0.1.0-rc.8). https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.0-rc.8
DeepSeek AI. DeepSeek LLM 介面卡文件. https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.1.0-rc.8/packages/llm/llm-deepseek/README.md
DeepSeek AI. DeepSeek Harness 官方儲存庫. https://github.com/deepseek-ai/deepseek-harness
OpoInstall. 如何實作具備延遲深度連結與安裝歸因的推薦追蹤 SDK. https://www.opoinstall.com/blog/referral-tracking-sdk-deferred-deep-linking