DeepSeek Harness
DeepSeek Harness alpha.2：工作樹與升級檢查
DeepSeek-V4 Team · 2026年10月8日 · 10 min read
Keywords: DeepSeek Harness 更新、Git 工作樹、SDK 遷移、代理程式工作流程
Published: 2026年10月8日 Author: DeepSeek-V4 Team
DeepSeek Harness dsh-v0.2.1-alpha.2 於 2026 年 10 月 9 日釋出，新增讓 AI 代理建立獨立 Git 工作樹的能力，也調整了自訂執行階段使用的若干介面。如果你已經在用 10 月 3 日釋出的 alpha.1，是否升級取決於具體需求：需要工作樹、某項故障修復，還是新版 SDK 的行為？
本文最初針對 alpha.1 撰寫，本次補充 alpha.2 的變化。依據是 alpha.2 官方釋出說明 和固定版本文件。下文提供的是可在自己環境中執行的驗收建議，不是跨平台效能評測，也不代表我們已經執行過 Harness 桌面版。
先看哪項變化與你的工作有關
新的 Git Worktrees 外掛允許 AI 代理新建分支和獨立工作目錄，然後在該目錄繼續當前工作階段。功能仍屬實驗性質，預設關閉。第一次可以只做一個小範圍嘗試：讓 AI 代理在主工作目錄之外修改一處文件，再檢查差異。
Alpha.2 還新增了實驗性的推理翻譯外掛。釋出說明列出 Bing、Google 翻譯，以及需要付費的 DeepSeek Flash 選項。它改變的是推理內容的呈現方式，不是釋出了新基礎模型，也不能據此判斷推理準確率提高。評估時應看實際譯文是否易讀，技術識別符號是否被錯誤改寫。
另一組變化針對已有工作流程的可靠性：回應串流停滯時能夠觸發閒置逾時；外掛中繼資料無法讀取時不再阻塞整個請求；背景任務也不再容易因上層回合結束而被誤標為中斷。這些是官方說明中的修復，在自己的環境中重現原本的問題並驗證後，才能確認問題確實解決。
| 當前情況 | 優先檢查什麼 | 保留哪些證據 |
|---|---|---|
| AI 代理修改與本地工作互相干擾 | Git Worktrees | 目錄、分支、起始提交和差異 |
| 背景任務被顯示為中斷 | 升級後重新執行同一任務 | 實際產物和最終任務狀態 |
| 維護自訂 SDK 執行階段 | 介面遷移要求 | 整合測試與事件處理結果 |
| 現有工作流程一直穩定 | 一次小範圍迴歸檢查 | 同一任務能否得到原有預期結果 |
工作樹分開了檔案，權限仍沿用原有策略
alpha.2 工作樹文件 說明，新工作目錄來自本地 Git 修訂版本。原目錄中尚未提交的檔案變化不會一起帶過去。如果 AI 代理需要的內容還只存在於編輯器裡，建立工作樹後也不會自動獲得它。
建立操作繼續受工作階段已有的檔案策略約束。新的路徑不等於新的安全邊界，也不會自動獲得向受限位置寫入的權限。目標目錄和共享的 Git 管理目錄都需要在現有策略下可寫。
編輯前應核對工具回傳的路徑。工作樹預設放在當前簽出目錄之下；如果從已有的關聯工作樹開始，就會在該工作樹內建立新的存放目錄。離開後，工作目錄和分支都會保留。工作樹入門教學 用一個便於檢查的小任務說明了這些步驟。
自訂整合需要單獨檢查遷移要求
Alpha.2 中影響較大的變化，未必能從普通介面上看出來。子 AI 代理工具現在立即回傳子工作階段 ID，自訂 SDK 執行階段需要支援 session/wait。如果舊程式碼把首次返回當作任務完成，就需要調整完成狀態的判斷方式。
工具呈現方式中的 both 已被移除，保留 native 和 ptc。Python PTC 開始使用工作階段的檔案系統沙箱，自訂組合需要提供沙箱及沙箱策略服務。這涉及設定和生命週期，不能只在檔案裡搜尋關鍵字後批次替換。
Agent Team 訊息改為直接投遞到目標 Inbox。依賴舊寄件匣、自動重試或重發去重邏輯的自訂外掛，應逐項對照遷移說明。傳送成功後，接收方是否產生了預期結果，比“沒有報錯”更能說明問題。
共享 agents 目錄現在支援 AGENTS.md，並可透過 DSH_AGENTS_HOME 指定替代目錄。另一個獨立變化是：AI 代理指令設定中逐行設定的 dshHome 選項被移除，改用處理程序層級 DSH_HOME 的預設值。檢查已有部署時，別把這兩個環境變數混為一談。
任務狀態顯示正確，還要檢查實際產物
背景任務狀態更準確，有助於定位故障，但不能證明所需產物已經存在。寫報告的任務要開啟報告；改程式碼的任務要檢查差異和測試結果。把這些證據與介面上的狀態一起保留，才方便追查。
例如，任務可能已經寫完報告，卻把檔案存到了另一個目錄。在核實程序的執行位置之前，“任務完成”和“沒有找到檔案”並不矛盾。Alpha.2 的 working_directory 工具和 SDK 目錄操作，讓工作階段位置成為可以明確檢查的一項資訊。
已有的定時工作流程也應這樣驗收：提醒是否送達，與提醒要求的工作是否完成，要分開檢查。自動化驗收教學 解釋了兩者的區別，任務顯示修復後，這個原則仍然適用。
分清 alpha.1 與 alpha.2 的變化
10 月 3 日的 alpha.1 版本 已經引入外掛建立入口、內建 Web 自動化，以及實驗性的 Claude Code Mods 相容能力。從更早版本升級的讀者需要了解這些背景，但它們不是 10 月 9 日新增的功能。
外掛維護者應同時檢查兩個版本的遷移說明。Alpha.1 移除了執行階段 invariant 外掛，並將訊息輸入框的統計項拆分為 activity 和 usage。安裝器也開始更清楚地顯示實際安裝版本，包括因釋出時效策略而選用舊套件的情況。請求安裝的版本與最終安裝的版本，仍然需要分別記錄。
首次安裝可先閱讀 本地快速入門；需要建立外掛時，可使用 Creator 教學。不必在同一次升級驗收中，把所有實驗性功能一起開啟。
用一次範圍明確的工作階段判斷是否升級
記錄當前 Harness 版本，並保留平常依賴的設定和工作階段資料。選一個預期結果明確的普通任務，升級後再執行一次。確認原有能力正常，再啟用需要的實驗性外掛，或測試已經修改的整合。
對工作樹而言，驗收應覆蓋起始提交、新分支、當前目錄和已檢查的差異；對 SDK 整合而言，應觀察子任務真正完成，並測試實際使用的介面。如果這些變化暫時不能改善你的工作，考慮到它仍是 alpha 版，先在獨立環境中試用也很合理。