DeepSeek Harness 團隊公開的 dsh-superagent-prototype,是一個把 GitHub 儲存庫訊息(以及可選的飛書訊息)轉成代理任務的研究原型。它不是已經完善的 DeepSeek 商業產品,也不是安裝後就能替團隊自動處理所有 Issue 的通用機器人。評估時,先了解它如何篩選請求、授予權限及隔離執行。
本文依據官方儲存庫的 README、SETUP 與設計文件整理。儲存庫明確標示這是供參考的研究原型,可能含有錯誤,不適合直接作為正式環境軟體。程式碼和設定可能變動,試用前請重新閱讀目前版本的說明。
Google Trends 中國區近 30 天的比較中,「DeepSeek」相對搜尋指數遠高於同組的 Python、Claude Code、OpenClaw 和 Ollama;「deepseek super agent」「deepseek superagent」等相關查詢顯示上升。Trends 的 0–100 指數是所選地區與時間範圍內的相對熱度,不代表搜尋量或流量。本網站已有 DeepSeek 相關代理內容,本文補充 dsh-superagent-prototype 這個具體專案的事件模型、界線與評估方式。
先釐清它是什麼,以及不是什麼
套件名稱是 dsh-superagent。它是主動式代理原型:監聽 GitHub 事件,也可選擇接收飛書訊息;再依照策略判斷請求是否獲准,把接受的請求整理成 Ticket,交由獨立的 DeepSeek Harness 工作階段執行。
「主動」不代表代理可以任意找工作。專案理念指出,代理只應在獲得允許的人提出請求,或團隊書面規則允許時行動。對尚未明確授權的自動觸發,文件建議先使用 observe 模式,記錄代理原本會採取的動作,而不直接修改儲存庫。
它也不是代管服務。使用者必須準備執行環境、模型或 Harness 設定、儲存庫權限、訊息入口和維運方式;原型程式碼無法代替組織進行身分與權限審查。
若只需要在聊天中詢問程式問題,DeepSeek Harness 或其他程式助手可能更直接。終端編碼互動可參考本站的 DeepSeek-TUI。其他多步驟代理可能著重研究或執行編排;它們處理的問題相近,但入口、授權和執行方式並不相同。
請求如何成為可執行任務
官方領域模型把流程拆成 Source、Trigger、Thread、Eval、Ticket、Mandate、Assignment、Executor 和 Channel。簡單來說,就是訊息進入、系統判斷是否受理、建立工作單、指派執行,再回傳結果。
|
|
Source 與 Trigger:區分入口和事件
Source 是訊息來源,例如 GitHub 儲存庫或已啟用的飛書連線。Trigger 則是該來源產生的特定事件。Issue、留言或聊天訊息可能成為 Trigger,但有訊息不等於必須執行程式碼。
分開這兩個概念,便於個別管理每種入口的驗證和策略。維運者要確認接入哪些儲存庫、討論串或對話,如何驗證事件來源,以及如何處理重複投遞。若把所有 webhook 都當成可信指令,就會意外擴大代理權限。
Thread 與 Eval:整理脈絡並判斷是否受理
Thread 用來組織相關脈絡。新事件可能附加到已訂閱該 Thread 的 Ticket,也可能交給 Eval 判斷它是否表達新的工作請求。遭忽略或暫時無法處理的事件也可留下紀錄,避免閒聊被自動升級成任務。
團隊真正需要決定的是誰能指派代理工作。理念文件提到明確名單,或團隊開放接收請求的對話;實際範圍仍由團隊定義。專案支援 GitHub 或飛書,不代表所有儲存庫或群組成員都具有相同權限。
Ticket 與 Mandate:讓授權伴隨任務
Eval 接受新工作後會建立 Ticket,並附上 Mandate。Mandate 定義任務範圍和依據,讓執行器取得的不只是單一留言,還包含相關脈絡和策略限制。
檢查原型時,要了解 Mandate 如何由請求與策略建立、哪些事件可建立 Ticket,以及策略變更如何傳遞給進行中的工作。不能只看代理是否能產生程式碼,也要能說明某個請求為何獲准,以及授權是否限制了實際工作。
Assignment 與 Executor:把各項工作交給獨立工作階段
Assignment 會把 Ticket 交給 Executor。儲存庫將執行描述為獨立的 DSH 工作階段,讓不同工作在工作階段層級分開,也較容易檢查狀態和結果。但這不代表已有完整容器沙箱或強式安全隔離;目錄、程序、憑證和網路能力實際隔離到何種程度,要看 DSH 設定與部署環境。
專案文件也列出 profile、監聽連接埠和分支前綴等預設值。這些只是部署指引,不保證在所有環境都安全。試用前應檢查現有 DSH 設定、連接埠衝突、工作目錄,以及該 profile 可存取的儲存庫。
Channel:把結果送回請求所在位置
Channel 將執行結果送回 Source。專案理念希望代理確認請求後減少過程訊息,在結果可用、需要人做決定或無法繼續時再發言。團隊仍應確認誰能看到結果,以及失敗細節是否會洩漏路徑或敏感內容。
GitHub 與飛書入口的設計考量
GitHub 入口可將儲存庫中的 Issue、留言或約定事件轉為工作請求。優點是需求、程式碼變更和審查可以留在同一協作脈絡;代價是必須管理 GitHub 身分、儲存庫權限、事件來源,以及代理變更的審查流程。
飛書是可選入口,適合從團隊對話提出請求。聊天提供較豐富的自然語言脈絡,但權限界線容易模糊:群組中誰能指派工作、轉傳訊息是否算授權、某則訊息能否觸發對儲存庫的存取,都需要明確策略。接上聊天機器人不該讓整個組織都能使用程式碼執行器。
建議先只啟用一種入口,搭配一次性測試儲存庫、明確的請求人名單和固定結果位置。入口越多,就越需要驗證身分對應、去重、拒絕行為和稽核路徑。支援某種入口不代表其正式環境維運已經成熟。
為什麼先用 observe 模式
對自動觸發或尚未建立信任的工作流程,SETUP 建議先使用 observe。團隊可以觀察事件是否被識別,以及代理打算採取什麼動作,同時避免執行造成副作用。
可用無害範例測試:允許名單中的人提出明確任務、名單外的人提出請求、無關留言、重複 webhook,以及缺少儲存庫脈絡的訊息。檢查預期請求是否進入 Ticket、不允許的請求是否只被忽略或記錄,以及系統能否說明判斷結果。
不要把「記錄了計畫」當成安全證明。計畫可能漏掉測試、誤讀權限,或受到惡意儲存庫內容影響。切換到執行前,仍要審查工具權限、工作區隔離、網路與憑證存取,並安排人員審查程式碼變更。
設定和權限審查
由於原型會接觸程式碼儲存庫,首次試驗應採最小權限。官方 SETUP 建議使用專用 GitHub agent 帳戶,只授予任務所需權限。該帳戶應與個人日常管理員身分分開,並先規劃撤銷與輪替憑證的方法。
不要把模型憑證、GitHub 登入資訊或飛書應用程式密鑰貼進聊天,也不要提交到儲存庫。SETUP 指出,需要操作者親自登入或輸入應用程式密鑰的步驟,應由操作者在自己的終端或應用程式中完成。檢查目前專案的憑證儲存方式與檔案權限,避免可讀密鑰進入共用工作區。
依序檢查以下項目:
- 身分:哪些 GitHub 使用者或飛書對話可以建立任務?身分驗證失敗時如何處理?
- 儲存庫範圍:代理帳戶可存取哪些儲存庫、分支和組織資源?能否先用測試儲存庫?
- 寫入權限:代理能否直接推送、建立分支或開 Pull Request?是否要求人工審查每項變更?
- 執行隔離:DSH 工作階段的目錄、程序和憑證是否分開?能否存取主機其他檔案?
- 網路存取:代理能否連線到任意主機?安裝依賴和建置會執行哪些程式碼?
- 稽核:能否從 Trigger 追溯到 Ticket、Assignment、執行結果和回覆?日誌是否保存秘密?
- 停止方式:如何關閉監聽器、撤銷 GitHub 授權、停用飛書入口並終止執行中的工作階段?
回答完這些問題後,再決定是否從觀察切換到執行。專用帳戶本身不足以證明工作區和憑證已隔離。
初步評估的環境需求
目前儲存庫文件列出 Node.js、pnpm、Git、tmux、Python、GitHub CLI 和受支援的 DSH 等相依項目。套件中繼資料也要求較新的 Node 版本。版本需求、alpha 相依套件和安裝步驟可能變動,不要照抄舊文章中的固定命令直接執行。
若準備試用,先閱讀目前版本的 README 和 SETUP,再檢查連結的理念文件。SETUP 對安裝流程設下刻意限制:先讀指定文件並執行一次環境探測,蒐集完回答後才整理計畫;操作人確認計畫前不要執行。這可避免過早取得憑證或變更環境。
測試環境至少要確認:
- 預定執行使用者可呼叫 Node、pnpm、Git、tmux、Python、
gh和dsh。 gh登入的是專用代理帳戶,而非誤用個人高權限帳戶。- 選用的 DSH profile 不與既有設定衝突;連接埠和工作目錄符合本機政策。
- 目標儲存庫專供測試,內容可丟棄或還原。
- 模型服務與憑證來源符合團隊要求,秘密不會出現在訊息或日誌。
- 若尚未審查身分和應用程式權限,先停用可選的飛書整合。
任一項不清楚時,先停留在閱讀文件或觀察階段。不要為了「跑起來」就臨時擴大組織權限或把個人密鑰交給代理。
適合用來評估的任務
第一次可選低影響且容易複核的工作,例如在測試儲存庫解釋範圍明確的 Issue、補充一小段文件,或提出有限修改。請求中應寫明允許修改的位置、禁止觸碰的目錄、必要檢查與交付方式。
不要以正式環境部署、權限管理、依賴升級或資料遷移作為首次測試,也不要讓代理自行批准或合併自己的變更。評估目標是確認端到端流程能理解、能審查、能中止,而不是追求自動化比例。
每次試驗後,比對原始請求、系統判斷、Mandate、實際修改、測試結果和回覆。若執行超出請求範圍,先修正策略和界線,再決定是否繼續。
常見問題與排查方式
發出訊息後沒有建立任務
檢查來源是否已接入、事件是否抵達 Source、請求人是否符合策略,以及訊息是否被判定為新工作。再查看 Thread 或紀錄是否顯示忽略、暫不可用或缺少脈絡。不要用授予所有人管理員權限來「修好」受理問題。
Ticket 已建立,但沒有執行
檢查 Ticket 是否有可執行的 Mandate、是否建立 Assignment,以及 Executor 和 DSH profile 是否可用。接著檢查本機相依項目與工作階段日誌。受理成功只代表請求轉成任務,不代表執行環境已就緒。
代理修改了無關檔案
停止後續自動工作,保存日誌和 diff 供調查,確認任務使用的儲存庫、工作區、脈絡和允許路徑。若隔離不足,先停用寫入或撤銷憑證。提示詞提醒無法彌補系統層級路徑和權限控制的缺口。
重複事件產生重複工作
檢查 Source 事件 ID、Thread 分組、訂閱狀態,以及 Ticket 是否指向相同請求。確認目前原型版本如何處理重試和重複投遞,再以測試事件驗證。不要為了掩蓋重複工作而刪除稽核紀錄。
結果沒有回到 GitHub 或飛書
沿流程檢查 Executor 最終狀態、Channel 綁定和 Source 回覆權限。區分「任務尚未完成」和「任務完成但通知失敗」,並確認錯誤回退方式。若回覆失敗會遺失結果,應確保本機日誌或 Ticket 仍可查詢。
用模擬請求檢查完整流程
接入真實儲存庫前,可建立不會造成破壞的模擬請求,逐步檢查事件流。範例只用來說明設計,不是支援的固定命令,也不表示專案內建特定測試工具。
|
|
檢查事件是否成為正確 Source 的 Trigger、Thread 是否包含 Issue 標題和相關留言,以及 Eval 是否判定為獲准的工作請求。若系統只能建立執行型 Ticket,無法強制唯讀,就不能假設自然語言已限制寫入;應在權限層禁止寫入。
接著確認 Ticket 的 Mandate 保留「只說明、不修改」。檢查 Assignment 指派給哪個 Executor,以及工作階段可讀寫哪些路徑。完成後確認 Channel 回覆包含結論、檔案位置和失敗資訊,且未洩漏環境變數或本機路徑。
記錄各階段證據:事件 ID、判斷結果、Ticket 識別碼、策略版本、執行工作階段和最終訊息。若某一步無法觀察,應列為試驗風險,而非假定內部行為正確。
測試請求界線的反例
再測試含糊請求,例如「順便把相關地方都修好」。Eval 接受前是否會要求限定範圍?Mandate 能否列出目錄、檢查項目和交付方式?若不能,任務應等待人員釐清,而不是讓代理自行擴大範圍。
再由不在允許名單中的帳戶提出相同請求。預期應拒絕受理或只記錄事件,不指派 Executor。測試拒絕流程時使用專用儲存庫和虛構內容,不要拿真實憑證反覆嘗試。
Thread 建立後再新增留言,確認它是原 Ticket 的脈絡更新,還是被誤判成新任務。重新投遞相同事件,也要確認不會建立兩個同時寫入相同工作區的 Ticket。
保留原型評估紀錄
把首次評估整理成簡短紀錄,包含版本或日期、測試環境、啟用入口、允許名單、權限範圍和停止方式。升級相依套件或更換原型版本後,團隊便能比較行為,而非只憑記憶判斷。
每個範例都記下輸入、預期、實際結果和證據位置,至少涵蓋以下情況:
- 獲准請求進入正確 Thread,並有明確 Mandate。
- 未授權使用者無法指派任務,拒絕結果可供稽核。
- 無關訊息不會被提升為程式碼工作。
- 重複事件不會悄悄建立重複寫入任務。
- DSH 不可用時,Ticket 留下可追蹤的失敗,而非宣稱成功。
- 人員可以獨立複核代理 diff 和測試輸出。
- 通知失敗後仍找得到結果,且不會因此重複執行。
- 關閉入口或撤銷憑證後,新事件無法啟動工作。
這些結果只描述該環境中受測的案例,不能證明所有輸入都安全。特別要檢查儲存庫是否含有提示注入、惡意建置指令或會讀取憑證的 hook;程式代理通常應把儲存庫內容視為不可信輸入。
通過條件應能從外部觀察
「代理理解了請求」很難衡量。更實際的條件是:獲准請求產生預期 Ticket;禁止請求沒有 Executor;Mandate 與授權一致;輸出可追溯到工作階段;人工能在合併前複核變更;操作人員可以停止系統並撤銷存取。
把這些條件當成擴大權限前的門檻。任何無法驗證的隔離保證仍屬未知,不要從專案名稱或設定註解推論它已成立。
與本站相關主題的差異
SuperAgent 是多步驟任務代理的廣泛稱呼,不是唯一的產品名稱。長任務代理可能著重本機研究和執行編排;DeepSeek-TUI 著重終端中的編碼對話和工具使用;dsh-superagent-prototype 則關心協作工具中的請求如何經策略轉為獨立執行任務。
比較時應看工作流程、入口、執行環境和成熟度,而不是只看模型名稱。兩個專案都可能呼叫程式代理,但事件觸發、身分規則、工作階段生命週期與維運責任都可能不同。
可先問團隊目前的瓶頸在哪裡:個人互動編碼可先試終端工具;研究和長任務編排可先評估相應代理的執行方式;若要把儲存庫對話連到可稽核 Ticket,再深入研究這個原型。
哪些人適合研究這個原型
它適合想研究「事件驅動的程式代理如何把團隊請求轉成受控任務」的開發者或平台工程師。可讀的領域概念、策略入口和執行流程,有助於討論代理權限、訊息噪音與人機交接。
若目標是立即取得穩定的企業自動化服務,或希望代理未經審查便持續寫入正式儲存庫,就不應讓這個原型承擔該角色。先閱讀程式碼、檢查相依項目、建立隔離測試,再依團隊安全要求補上監控、升級、備份和事故處理能力。
結論
dsh-superagent-prototype 的重點不是「DeepSeek 又推出一款自主程式產品」,而是嘗試把外部訊息、授權策略、Ticket 和獨立 Harness 執行串成可追溯流程。它明確處於研究原型階段,程式碼與權限是否適合仍由部署者自行判斷。
想繼續研究,可依序閱讀官方 README、SETUP、理念說明和領域模型。先在最小測試儲存庫觀察事件判斷,再審查隔離與權限,最後才考慮有限執行。