返回目录

dsh-leader-agent

精选清单收录维护状态: 活跃

fengshenx/dsh-leader-agent

由一个主智能体拆分任务并运行多个后台会话,在项目看板汇总工作卡片和执行报告。

前往 GitHub项目主页
$ dsh plugin --profile web add dsh-leader-agent

23

星标

2

Fork

JavaScript

语言

MIT

许可证

2026-10-23

创建于

2026-11-20

最近推送

MIT 开源的 Leader/worker 编排套件:按卡片派工、每项目一块交付看板、可回读 worker 会话,编排规则写在 LEADER.md 与 SLOTS.md 里,worker 是常驻根会话。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-20

许可证

MIT

01它能帮你完成什么?

  • 同时推进十个功能,而不是一个个盯着

    一个 Leader 会话完成开卡、派工、等运行时回报、验收产出、组织 review 这一串动作

    一个人要管 20 个以上会话的场景;作者明确说目标是这个,而不是重造 dsh 自带的 super agent

  • 随时看清谁在干活,并能中途插进任何一个 agent

    每项目一块交付看板:一任务一卡、执行者槽位标签和实时状态灯,还有会话标签栏;点槽位直接打开那个 worker 的会话,不必经过 Leader 就能接着聊

    并行跑好几个 agent、需要一眼掌握全局的开发者

  • 把编排规则放进可评审的文件,而不是塞进一段超长提示词

    `LEADER.md` 与 `SLOTS.md` 的提示词注入、`leader-mode` 的讨论→设计→实现交付→评审→合入剧本,以及 `init-leader-agent` 把仓库约定合并进项目 `AGENTS.md` 的托管块

    希望跨项目、跨人复用同一套编排约定的人

02如何接入 DeepSeek Harness?

前置条件

  • dsh `>=0.2.1-rc.2 <0.3.0`
  • web 安装:profile 必须就叫 `web`——自定义名字缺少 web-app bundle,客户端那一半不会加载
  • 桌面安装:自己的 profile 在 `$DSH_HOME/profiles/desktop`,`DSH_HOME` 需为绝对路径或以 `~/` 开头,并使用应用自带的 CLI(系统 `dsh` 拒绝 desktop profile)
  • 长驻宿主(web/desktop/sdk);headless 是一次性 CLI,收不到完成报告
  • 真并行还需要 README 说的隔离:每个任务一个 worktree、一个 dsh 实例、一个数据根

安装步骤

  1. 01

    web:执行 `dsh plugin --profile web add dsh-leader-agent`,再用 `dsh web` 启动

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

  2. 02

    桌面端图形安装:左侧栏 Plugins → 右上角 Add plugin → 输入 `dsh-leader-agent` → Install

  3. 03

    桌面端命令行安装:先彻底退出应用(关窗口只是隐藏),再用自带 CLI,例如 `"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-leader-agent`

  4. 04

    在左侧栏 Projects 里点 Add project 选一个目录——项目会立刻创建并绑定一个 leader 会话

  5. 05

    在 leader 会话里加载 `leader-mode` skill;写好 `LEADER.md` 和 `SLOTS.md`(也可以让 `init-leader-agent` skill 生成骨架)

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

以 DSH 插件形式挂进 `web` 或 `desktop` profile:给宿主加上 Leader/worker 工具(`spawn_worker`、`message_worker`、`create_card`、`read_worker_session` 等)、左侧栏的项目树和右侧的交付看板,全部通过 DSH 会话驱动。

  • 派工(spawn_worker/message_worker)

    name、可选的 cardId + slot,以及作为首条消息的任务正文→立刻返回一个常驻的 worker 根会话(消息到达前它还没开工),并绑定到卡片对应的槽位

    worker 在派工时继承 Leader 的沙箱模式与审批策略,回执里写明它实际使用的权限
  • 交付看板与卡片工具

    Leader 侧的 `create_card`/`update_card`/`list_cards`,以及 worker 侧的 `read_card`→每项目一块看板:全局编号的卡片带 spec、链接、状态与执行槽位,Leader 开卡时看板会自动打开

    卡片详情只能改链接和硬删除卡片(需确认、不可撤销);模型没有删除工具,必须由人点击
  • read_worker_session 回读

    一个 worker 会话 id→每一轮的任务、正文、它调用了哪些工具、以及失败原因

    只读:不唤醒 worker,也不触发模型调用
  • worker 失联巡查

    被 Leader 派出、15 分钟没有任何报告的一轮任务→一条纯文本【后台巡查】提示,带会话 id、所持卡片、静默时长、最后一次报告和可复制的回读命令

    最多每 15 分钟一条,不轮询 worker
  • 文件驱动的编排

    `LEADER.md`、`SLOTS.md` 与 `leader-mode`/`init-leader-agent` 两个 skill→项目级 Leader 规则、按角色的 worker 人设和分阶段协议,只在文本变化时注入;项目没有 `SLOTS.md` 就回落到 `dev`/`review` 两个默认角色

    只贡献提示词文本,不授予任何工具权限

04适合谁?何时不该用?

适合

  • 一个人要管 20 个以上会话的场景;作者明确说目标是这个,而不是重造 dsh 自带的 super agent
  • 并行跑好几个 agent、需要一眼掌握全局的开发者
  • 希望跨项目、跨人复用同一套编排约定的人

不适合

  • 后台编排必须有长驻宿主(web/desktop/sdk)。headless 是一次性 CLI,这一轮结束会话就销毁,完成报告永远不会到达。
  • Leader 能干预 worker 但不能取消:宿主那套 `interrupt_agent` 对 worker 根会话不适用,卡死的 worker 只能由人到它自己的会话里处理。
  • 客户端与宿主版本耦合——对话框、菜单、图标都抄自宿主源码,会话标签栏还是插在会话头部上方的 DOM 层、状态存在浏览器 localStorage 里,宿主升级后需要同步这个仓库。

05兼容性、维护与安全提示

  • 后台编排必须有长驻宿主(web/desktop/sdk)。headless 是一次性 CLI,这一轮结束会话就销毁,完成报告永远不会到达。
  • Leader 能干预 worker 但不能取消:宿主那套 `interrupt_agent` 对 worker 根会话不适用,卡死的 worker 只能由人到它自己的会话里处理。
  • 看板只对项目会话可见:leader 与该项目的 worker 能看到,同目录下的普通会话或已卸任的 leader 只会收到通知,不在任何项目里的会话完全没有看板。
  • 客户端与宿主版本耦合——对话框、菜单、图标都抄自宿主源码,会话标签栏还是插在会话头部上方的 DOM 层、状态存在浏览器 localStorage 里,宿主升级后需要同步这个仓库。
2026-10-232026-11-17v0.6.0

MIT · 活跃维护中(最新 release v0.6.0,2026-11-17)· 开发者预览

06常见问题

web profile 和桌面端分别怎么装?

web:`dsh plugin --profile web add dsh-leader-agent`,然后 `dsh web`。桌面端:左侧栏 Plugins → 右上角 Add plugin → 输入 `dsh-leader-agent` → Install;或改用桌面端自带的 CLI(`runtime/cli/bin/dsh plugin --profile desktop add dsh-leader-agent`),因为系统 `dsh` 拒绝管理 desktop profile。装之前要彻底退出应用,关窗口只是隐藏。

对 dsh 版本和 profile 名字有要求吗?

需要 dsh `>=0.2.1-rc.2 <0.3.0`。web profile 必须就叫 `web`:自定义名字不在 `PROFILE_TEMPLATES` 里,装出来的包缺少 web-app bundle,客户端那一半根本不会加载。桌面端用自己的 profile(`$DSH_HOME/profiles/desktop`),且 `DSH_HOME` 必须是绝对路径或以 `~/` 开头。

Leader 能停掉跑偏的 worker 吗?

不能。Leader 只能用 `message_worker` 干预——消息会注入到它当前这一轮的下一步,但没有取消;宿主那套 `list_agents`/`interrupt_agent` 对 worker 这类根会话不适用。卡死的 worker 需要人到它自己的会话里处理,`read_worker_session` 可以只读地看看它在干什么。

LEADER.md 和 SLOTS.md 具体改变了什么?

这两个文件只贡献提示词文本,不给任何工具权限。`LEADER.md` 是这个项目的指挥规则,`SLOTS.md` 里每个角色(`dev`/`review` 等)一节,注入到绑定该槽位的 worker。两者都在每次模型请求前求值,只在文本变化时才追加,所以改文件即时生效、也不会重复注入。

为什么必须用长驻宿主?

后台编排依赖 worker 这一轮结束时由运行时唤醒 Leader 并递上报告。headless 是一次性 CLI,这一轮结束会话就销毁,没人接收完成报告;所以要用 web/desktop/sdk 宿主。

08数据与来源

  • 作者声明github.com96a18200bd44…

    A leader / worker orchestration bundle for DeepSeek Harness (dsh). The Leader splits work, dispatches it, tracks every w…

  • 作者声明github.com96a18200bd44…

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

  • 作者声明github.com96a18200bd44…

    **Identity decides the tool surface.** The Leader gets `spawn_worker` / `message_worker`; workers don't. The host trims…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-20。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。