dsh-workplan:先出計劃、再派子 Agent、左側欄看進度

前言

在 DeepSeek Harness(DSH)裏交給 AI 的複雜任務,常見節奏是「邊想邊做」:做到一半才發現階段劃分不對、並行度不夠,或者對話裏口頭說「我在做 A 和 B」,卻看不到誰在跑、卡在哪。社區插件 dsh-workplan(維護者 abbaababa)把流程收成三拍:先產出可驗收的任務分解,再派發真實的 DSH 子 Agent 執行,並在 Web 左側欄用「任務進度」對齊同一份狀態。它不裝獨立 App、不改 DSH 源碼、不換頁面;分類上屬於工作流類插件,當前 npm 包版本 1.12.0,GitHub 倉庫星標爲 1(以目錄頁與倉庫公開信息爲準)。

這是什麼

dsh-workplan 是給 DSH 官方 Web 版(dsh web / --profile web)用的插件:在對話裏先出現【任務分解】(階段、子任務、部門、驗收標準),確認後由主 Agent 通過內置工具派發計劃;最多 5 個子 Agent 並行,結果寫回會話。簡介裏另一層表述是:安全相關說明按 ISO/IEC 15408:2026 的結構公開材料(安全目標、脆弱性評定、自評估、SBOM、安全策略、自動化測試等),不是聲稱「已通過 CC 認證」——沒有證書編號就不該那樣說;倉庫 README 明確區分「對齊 2026 結構、公開自評證據」與第三方實驗室評測。

社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係;DSH 生態理念是「一切皆插件」,本文只描述該插件在資料中寫明的行爲。

核心功能

計劃優先的執行節奏

  1. 先排計劃:發出有實際目標的任務後,主 Agent 在真正動手前先寫計劃——階段、具體工作、負責部門、做法、驗收標準、可能風險。
  2. 計劃先給你看:以【任務分解】出現在對話裏,帶依據與驗收標準,而不是一句話帶過。
  3. 真的派人去做:每件具體工作交給真實的 DSH 子 Agent(最多 5 個並行);主 Agent 須先派發並等待部門結果,才能繼續往下答。純打招呼、道謝、問進度不會觸發拆解。

左側欄「任務進度」

裝好後在 DSH Web 左側可打開「任務進度」,頂部有五類計數:任務數、已分配工作、做好、正在做、卡住。計劃卡分「進行中」「已結束」「已完成」;展開可看階段進度、部門與每項狀態。README 說明 1.4.3 起統計來自單一狀態源,避免面板數字與列表矛盾(例如顯示 0 個正在做但下面仍有進行中項)。

九個模型工具(由主 Agent / 子 Agent 按規則調用)

使用者通常不直接調工具;它們定義了計劃如何派發、查狀態、改計劃、上報阻塞等。摘要如下:

工具 作用
dsh_workplan_dispatch 派發當前計劃;mode:"wait" 默認等到結束,mode:"async" 後臺繼續;冪等
dsh_workplan_status 只讀進度;刷新後可從會話重建
dsh_workplan_update 主 Agent 覈對並修正子任務;帶 expectedRevision;運行中默認需 force:true
dsh_workplan_cancel 取消未派發的計劃
dsh_workplan_replan 需求變更:cancel / replace / add,版本遞增
dsh_workplan_escalate 子 Agent 遇阻上報
dsh_workplan_instruct 主 Agent 答覆請示並下達指示
dsh_workplan_handoff 跨部門需求:list / assign / resolve / close
dsh_workplan_followup 預算/超時中止但產物已落盤時的收尾說明

plan 模式下只展示計劃,dispatch 會被攔下並說明原因,不會偷偷開跑。

部門標籤與協作邊界

計劃項帶部門標籤(工程研發、研究分析、設計、產品、數據、質量驗證、安全、運維、文檔寫作、運營、法務合規、財務等)。標籤決定提示詞與統計,不是真實組織架構:部門之間不能直接對話,跨部門信息由主 Agent 或工作區可讀文件轉達;依賴關係由 dependsOn 決定,階段(stage)主要用於展示分組。細節見倉庫 協作契約 與 部門職責。

預算、超時與續跑

項 默認值 環境變量
單輪派發預算 20 分鐘 DSH_WORKPLAN_TOTAL_TIMEOUT_MS
單個子 Agent 上限 15 分鐘 DSH_WORKPLAN_CHILD_TIMEOUT_MS
無進展判定 5 分鐘 DSH_WORKPLAN_IDLE_TIMEOUT_MS
自動續跑次數 4 次 DSH_WORKPLAN_MAX_RESUMES
併發子 Agent 5(固定) —

預算用盡時計劃可標記爲「本輪預算用盡,可續跑」,已完成項不重跑。也可在 cordis.patch.yml 的 config 裏寫例如 { "totalTimeoutMs": 1800000 }(30 分鐘)。

安全與依賴(資料中的自述)

  • 運行時 dependencies 爲空,無第三方運行時 npm 依賴。
  • README 稱源碼中無 writeFileSync / child_process / 對外 fetch(面板僅同源請求 /dsh-workplan/plans);結果寫入 DSH 會話記錄。
  • 圖表使用隨包分發的 Chart.js(vendor/chart.umd.js),不加載 CDN。
  • 獨立複檢與 470 項測試、npm run verify 等屬於倉庫自證流程;ATE 實驗室見證、獨立滲透等 CC 流程項 README 標明爲固有殘留,需認可實驗室完成。

安裝前若關心權限與數據邊界,應自行閱讀源碼、SECURITY.md 與許可證,插件以當前 DSH 進程權限運行。

安裝與啓用

環境要求

要求 說明
DeepSeek Harness 官方 Web 版
Node.js 22 或更高(node -v)
網絡 安裝時需訪問 npm registry

一鍵安裝

下面命令來自倉庫 README 原文:

dsh plugin --profile web add dsh-workplan@1.12.0

裝完重啓一次 DSH Web(或重新載入頁面)使插件生效。若 PATH 中沒有 dsh,需先確認 CLI 可用;用 npx 啓動 DSH 時,可對同一 dsh 可執行文件使用上述命令。

典型用法

  1. 打開 DSH Web,發送有實際目標的任務,例如「幫我把這個目錄的測試補到 80% 覆蓋」。
  2. 稍等片刻,對話中出現【任務分解】:階段、子任務、部門、驗收標準齊全。
  3. 正常對話即可;主 Agent 按規則派發,需拍板時會提問。
  4. 點擊左側 「任務進度」 查看彙總數字與計劃卡;若計劃處於「已結束」但未做完,README 說明可說「繼續」接着推進。

適用場景與注意

適合:多步驟、可拆成並行子任務、且希望在執行前看到驗收標準的開發或分析類工作(在 DSH Web 內完成)。

注意:

  • 僅針對 Web profile;需 Node ≥22。
  • 子 Agent 併發上限爲 5;長任務受默認 20 分鐘單輪預算等限制,可通過環境變量或插件 config 調整。
  • 安全證據包與自評估文檔在倉庫 docs/cc/ 等路徑;這是公開材料與自測口徑,不等於產品已獲 CC 證書。
  • 插件來自社區維護者,安裝前請覈對 GitHub 倉庫 源碼與 MIT 許可證,並理解其在 DSH 進程內的權限範圍。

結尾

dsh-workplan 把 DSH Web 上的複雜任務改成「先分解、再真派子 Agent、進度可對照」的工作流,並用 ISO/IEC 15408:2026 結構的公開安全材料供自行覈對。一鍵安裝命令爲 dsh plugin --profile web add dsh-workplan@1.12.0;更多細節見 SkillHub 目錄頁 與 GitHub README。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜