前言¶

在 DeepSeek Harness（DSH）裏做多任務智能體協作時，常見做法是自己在多個會話之間來回切換：派活、盯進度、收結果、再開一輪 review。任務一多，注意力會耗在「哪個會話卡住了」而不是「要交付什麼」。社區維護者 fengshenx 提供的 dsh-leader-agent（npm 包名；早期目錄名 dsh-leader-kit 已棄用並重命名）是一套 Leader / Worker 編排插件：一個 Leader 會話負責拆任務、派發、跟蹤完成與 review；Worker 在後臺執行並自動回報；項目維度的交付看板把任務卡片、執行槽位和狀態集中展示。下面介紹它是什麼、能做什麼，以及如何安裝與從舊包遷移。

這是什麼¶

dsh-leader-agent 是面向 DSH 的 Leader / Worker 編排 bundle，簡介可概括爲：項目樹、交付看板（delivery board）、Worker 會話管理。維護者爲 fengshenx，在插件生態裏常歸類爲工作流。README 標明狀態爲 developer preview，許可證爲 MIT（見倉庫徽章）。

與「單會話裏自己記 todo」相比，這套 bundle 把編排協議、Leader 側工具鏈和 Web / Desktop 客戶端裏的看板 UI 綁在一起：你向 Leader 陳述目標一次，由 Leader 建卡、spawn Worker、投遞首條消息啓動工作，並在 Worker 結束後驗收與組織 review。倉庫說明：每個任務一個 git worktree 是該項目的慣例，並非 bundle 的硬性要求。

核心功能¶

一個 Leader 驅動開發與 review¶

Leader 會話是項目唯一的指揮方。它通過工具鏈記錄要做什麼、如何驗收，創建 Worker 會話並在投遞消息後立即返回；Worker 在後臺幹活並自動回報。目標是讓你把注意力放在「要什麼結果」，而不是逐個 babysit 智能體；README 表述爲可同時推進多個 feature（例如「ten features in flight」）。

右側 SidePanel 交付看板¶

每個項目一塊看板。卡片帶執行槽位（slot）與實時狀態指示；備註以 Markdown 渲染，鏈接可就地編輯。點卡片看規格（目標、範圍、驗收、鏈接）；點槽位可鑽取該 Agent 的會話並繼續對話。Worker 回報以 Worker 身份展示，同樣 Markdown 渲染。界面佈局（README Preview）：左側項目樹與各 Leader 派生的 Worker；中間 Leader 會話（任務、派發、回報、結論）；右側該項目交付看板。

LEADER.md 與 SLOTS.md 配置角色¶

兩個文件負責編排規則，無需重建會話即可改行爲：

• LEADER.md：Leader 的 prompt 與本項目的編排規則（邊界、派發要求、驗收標準）。
• SLOTS.md：各 Worker 角色（dev / review 等）的獨立規則。

二者在每次模型請求前評估，僅當文本變更時才追加到上下文。

leader-mode 技能¶

內置 leader-mode skill，提供分階段 playbook：討論 → 設計 → 實現與交付 → review → merge，並包含並行協作與交接指引。README 強調這是編排協議，而非泛泛的「你是 tech lead」式提示。

多項目並行¶

添加項目會將 Leader 會話綁定到該項目；項目樹列出該 Leader spawn 的 Worker，行可拖拽排序。刪除項目只刪記錄，不刪文件夾與會話（dsh workspace 不受影響）。可爲項目更換 Leader，現有 Worker 與未交付的 report 會遷移，新 Leader 可立即繼續派發。

read_worker_session：只讀回看 Worker¶

read_worker_session 直接讀取 Worker 會話日誌，返回各輪的任務、正文、調用的工具及失敗原因。只讀：不會喚醒 Worker，也不會觸發模型調用。完成通知告訴你「出了什麼」；此工具幫助理解「怎麼做到的」，便於調試而無需再開一輪對話。

運行鏈路（Leader 側工具）¶

README「How it runs」節選如下邏輯：

you ──────▶ Leader (the leader session, sole commander of the project)
             │  create_card      record what to build and how it is accepted
             │  spawn_worker     create the worker session, return immediately
             │  message_worker   deliver the first message — that is what starts work
             ▼
      worker ─ ...

即：先 create_card 記錄交付與驗收，再 spawn_worker 建會話，最後用 message_worker 投遞首條消息真正開工。

安裝與啓用¶

插件以 npm 包 dsh-leader-agent 發佈（抓取資料中 package.json 版本爲 0.3.1）。運行環境要求：Node.js >= 24.9.0，dsh >= 0.2.1-rc.2 且 < 0.3.0（README 安裝章節與 engines 字段一致）。

Web profile¶

安裝 profile 必須爲 web；自定義 profile 名不在 PROFILE_TEMPLATES 中，會導致缺少 web-app bundle、客戶端無法加載。

dsh plugin --profile web add dsh-leader-agent
dsh web

Desktop profile¶

Desktop 使用獨立 profile：$DSH_HOME/profiles/desktop，與 web 分離。系統自帶的 dsh CLI 不能管理 desktop profile，需使用 Desktop 安裝目錄內的 CLI。

GUI：左側 Plugins → 右上角 Add plugin → 輸入 dsh-leader-agent → Install。

CLI（macOS 示例，需先完全退出應用）：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add dsh-leader-agent

Windows / Linux 請改用安裝目錄下的 runtime/cli/bin/dsh。應用僅在啓動時讀取 profile，同一時刻只能掛載一個插件版本；DSH_HOME 須爲絕對路徑或以 ~/ 開頭。會話、項目與卡片與 web 共享；插件包與激活狀態各 profile 獨立。

從 dsh-leader-kit 升級¶

包已從 dsh-leader-kit 重命名爲 dsh-leader-agent，無兼容並存路徑。若舊包未移除，dsh.profile.bundles 會同時記錄兩個包名，工具重複註冊、兩個 dispatcher 處理同一 turn/end（重複通知與喚醒）。請在同一 profile 先刪後加：

dsh plugin --profile web remove dsh-leader-kit
dsh plugin --profile web add dsh-leader-agent

數據目錄隨包名變更（$DSH_HOME/dsh-leader-kit → $DSH_HOME/dsh-leader-agent），不會自動遷移：看板爲空，Worker 註冊在首次啓動時重建。舊包已 deprecated，請以 dsh-leader-agent 爲準。

更細的版本 pin、卸載、開發安裝等見倉庫 Development 文檔。

典型用法¶

1. 在 web 或 desktop profile 安裝並啓動 DSH Web / Desktop 客戶端。
2. 爲倉庫或需求添加項目，綁定 Leader 會話；按需編輯項目下的 LEADER.md、SLOTS.md。
3. 在 Leader 會話中說明目標；Leader 按 leader-mode 與編排規則 create_card，對 dev / review 等槽位 spawn_worker，再 message_worker 啓動具體 Worker。
4. 在右側看板查看卡片狀態；需要介入某 Worker 時點擊槽位進入其會話；需要排查過程時 Leader 可調用 read_worker_session 只讀日誌。
5. Worker 完成後 Leader 驗收並組織 review；多任務可並行多張卡片、多個 Worker。

適用場景與注意¶

適合：希望在 DSH 裏用結構化 Leader / Worker 分工、並行多條交付線，並能在 UI 上看板 + 項目樹統一管理的開發者或團隊。

注意：

• 插件在 當前 dsh 進程的權限下運行；安裝前請閱讀 fengshenx/dsh-leader-agent 源碼與 MIT 許可證，確認工具與會話訪問範圍可接受。
• 仍爲 developer preview，API 與數據目錄行爲可能隨版本調整；從 dsh-leader-kit 升級時看板數據不遷移，需心理預期。
• DSH 社區插件目錄（如 SkillHub 上的 fengshenx/dsh-leader-kit 條目）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；目錄名可能仍指向舊包名，安裝請以 npm dsh-leader-agent 與 GitHub README 爲準。

結尾¶

dsh-leader-agent 把 Leader 驅動的派發、Worker 後臺執行、交付看板與可編輯編排文件收進一個 DSH 工作流插件，減輕多會話手工盯場的成本。查閱目錄信息與討論 issue 可訪問 GitHub 倉庫；從舊 dsh-leader-kit 遷移時務必先 remove 再 add，避免雙 bundle 疊加。

• 社區目錄（歷史包名）：https://www.skillhub.cn/plugins/fengshenx/dsh-leader-kit
• GitHub（當前維護倉庫）：https://github.com/fengshenx/dsh-leader-agent