DeepSeek Harness 插件：ttxl314/dsh-skill-lord-serf

前言¶

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在進行復雜的多智能體協作開發時，開發者往往面臨狀態難以持久化、任務流轉缺乏統一協議以及驗證規則不明確等問題。ttxl314/dsh-skill-lord-serf 插件旨在解決上述問題，它將基於文件的多智能體編排協議 0.5 引入了 DSH 生態，爲分佈式任務執行提供了一個確定的流程框架。

插件簡介¶

該插件由 ttxl314 維護，是一個 DeepSeek Harness 插件。它提供了 lord（編排者）和 serf（執行者）兩種技能，允許 DSH 在同一會話中扮演這兩種角色。其核心價值在於將複雜的協作邏輯轉化爲基於文件的協議，通過明確的 Schema 驗證和生命週期管理，確保任務從規劃到最終交付的每一步都可追蹤、可驗證。

核心功能¶

根據已覈實的事實，該插件包含以下能力：

雙角色技能：內置 Lord 和 Serf 技能，分別負責全局編排和有界執行。
文件化編排：利用文件系統存儲項目狀態、需求和決策（如 TASKS.md、REVIEWS/ 目錄），而非僅依賴對話上下文。
Schema 驗證：對任務包、微任務、調度指令以及提交報告進行 JSON Schema 驗證（基於 2020-12 草案）。
子代理扇出：支持在 Serf 的執行邊界內，通過 subagent 工具進行子任務的分發。
標準生命週期：定義了從計劃到決策的完整工作流：plan → package → dispatch → execute → submit → review → decide。
DSH 綁定：將協議概念映射到 DSH 的原生機制，如使用 subagent 工具調用 Serf，使用 /lord 和 /serf 技能手勢。

安裝與配置¶

方式一：作爲 Bundle 安裝（全局）¶

該插件提供了預編譯的 ESM 打包文件，無需手動構建。安裝後需重啓 Web 服務。

dsh plugin --profile <name> add github:ttxl314/dsh-skill-lord-serf#<commit-sha>

安裝完成後，進入 GUI 的設置頁面檢查插件是否生效。如果僅需要項目範圍的使用，且不想重啓服務，可採用方式二。

方式二：作爲文件系統技能（項目級）¶

通過創建 Junction 鏈接將技能目錄掛載到項目的 .dsh/skills 下，文件系統監視器會自動發現，無需重啓。

New-Item -ItemType Junction -Path .dsh\skills\lord -Target <checkout>\skills\lord
New-Item -ItemType Junction -Path .dsh\skills\serf -Target <checkout>\skills\serf

典型用法¶

Lord 會話¶

在 Lord 會話中，可以通過輸入 /lord 或直接下達指令來啓動。Lord 負責制定計劃、生成任務包，並通過 subagent 工具分發任務。它維護權威的任務狀態源，並在收到報告後進行審查和最終決定。

Serf 會話¶

Serf 負責執行具體的任務包。可以通過輸入 /serf 或直接提供任務包路徑來啓動。Serf 需要加載任務包，並在執行過程中（必要時）通過 subagent 進行子工作拆分。完成後，Serf 會基於模板生成提交報告（狀態包括 REVIEW、BLOCKED 或 CHANGE_REQUEST）。

工作流示例¶

Plan：Lord 分析需求並制定計劃。
Package：Lord 生成包含 Schema 驗證的任務包。
Dispatch：Lord 通過 subagent 工具將任務包發送給 Serf。
Execute：Serf 執行任務，必要時拆分子步驟。
Submit：Serf 生成報告文件。
Review：Lord 讀取報告文件並驗證實際輸出。
Decide：Lord 更新狀態並決定下一步行動。

技術細節與依賴¶

依賴項：
- @deepseek-ai/cordis ^4.0.1
- @deepseek-ai/dsh-skill ^0.1.0-rc.6（由 @deepseek-ai/dsh-base bundle 提供）
資源結構：
- assets/schemas/：包含任務包、調度指令、報告等 Schema 定義。
- assets/templates/：包含任務包、調度指令、報告的模板文件。
自測：
插件包含一套自測套件，運行命令如下：

    node test\self-test.mjs

該套件會檢查 26 項內容，包括 Provider 合約、Schema 編譯、模板與 Schema 一致性等。

注意事項¶

權限與重啓：作爲 Bundle 安裝時，必須重啓 Web 服務以加載插件。作爲文件系統技能安裝時，無需重啓。
許可證：該插件基於 MIT 許可證發佈。
適用場景：適合需要嚴格狀態管理、可審計的工作流以及多智能體協作的場景。

結語¶

ttxl314/dsh-skill-lord-serf 通過將協議標準化爲文件操作和 Schema 驗證，降低了多智能體協作的複雜度。對於需要構建長期運行、狀態敏感的開發流程的開發者而言，這是一個可靠的工具。更多細節可查閱 GitHub 倉庫。