前言¶
在 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 結構、公開自評證據」與第三方實驗室評測。
- 目錄頁:https://www.skillhub.cn/plugins/abbaababa/dsh-workplan
- 源碼與文檔:https://github.com/abbaababa/dsh-workplan
- 許可證:MIT(見
package.json)
社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係;DSH 生態理念是「一切皆插件」,本文只描述該插件在資料中寫明的行爲。
核心功能¶
計劃優先的執行節奏¶
- 先排計劃:發出有實際目標的任務後,主 Agent 在真正動手前先寫計劃——階段、具體工作、負責部門、做法、驗收標準、可能風險。
- 計劃先給你看:以【任務分解】出現在對話裏,帶依據與驗收標準,而不是一句話帶過。
- 真的派人去做:每件具體工作交給真實的 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 可執行文件使用上述命令。
典型用法¶
- 打開 DSH Web,發送有實際目標的任務,例如「幫我把這個目錄的測試補到 80% 覆蓋」。
- 稍等片刻,對話中出現【任務分解】:階段、子任務、部門、驗收標準齊全。
- 正常對話即可;主 Agent 按規則派發,需拍板時會提問。
- 點擊左側 「任務進度」 查看彙總數字與計劃卡;若計劃處於「已結束」但未做完,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。