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 仓库。