dsh-foreman
Verifieddsh-foreman · v0.5.7 · MIT · Web UI
dsh-foreman:主 loop 在多设备上派单的 DSH bundle:需求来自本机操作者的主会话而不是 GitHub/飞书,每个工作区各有一条主会话,主会话只负责路由,真正的活儿派给 Worker 在该工作区目录里执行。
Install
dsh plugin add dsh-foreman Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-foreman
Not an official DeepSeek product. 这是第三方项目,与 DeepSeek 官方无关。
一句话:一个常驻的主 loop,把工单派给多台在线设备上各自完整运行的 DSH,账本只有一份。
你在服务器上装 dsh-foreman,它拥有全部工单、策略和评估;你在每台个人机器上装
dsh-foreman-node,它只负责接单、在本地跑、
把结构化回报交回来。设备上不建工单、不评估、不持有策略、不打开数据库。
┌──────────── 服务器:dsh-foreman(唯一账本)────────────┐
│ Engine / SQLite / Policy / Tickets / Evals / 设备表 │
│ 每个项目一个主会话入口 ← 你在这里说话 │
│ Selector:accept 时决定这活交给哪台机器 │
│ Foreman Hub:设备主动连上来 │
└──────────────────────┬─────────────────────────────────┘
│ 设备外连(wss,稳定域名)
┌──────────────┼──────────────┐
▼ ▼ ▼
公司笔记本 宿舍电脑 服务器本机
dsh-foreman-node dsh-foreman-node 本地直跑,不走网络
状态
早期开发中。 设备注册表、Selector、ForemanExecutor、Hub、回报规则、设备侧插件、文本渲染、 迁移脚本、面板设备页、飞书群路由都已落地,测试 1332 项。设计与实现计划见:
一眼看懂它怎么派人
accept 一张工单时,prepareTicket 这一步就选定了设备,写进 Ticket.target,再由 newAssignment
复制到 Assignment.target——不是 Executor 选的(Executor 没有写库通道)。之后:
target.kind === 'local':原样交给本机的DshExecutor,行为与没有设备时完全一样。- 远端:变成一帧
assign发给那台设备。设备不在线就报blocked,不伪造 failed,也不悄悄改成本机跑。
断线绝不自动重派:设备可能还在跑,重派就是同一件事执行两遍。超时只转 blocked,交给人。
由来与致谢
本项目不是一个 git fork,但代码以 dsh-superagent-local 为起点, 而后者是 dsh-superagent-prototype (DeepSeek Harness 团队)的改编版。三者的关系:
| 项目 | 作者 | 与本项目的关系 |
|---|---|---|
| dsh-superagent-prototype | DeepSeek Harness Team | 原始研究原型;本项目的架构思想来源 |
| dsh-superagent-local | mengzhongjie | 上述原型的本地化改编;本项目代码基线 |
| dsh-foreman | niechao136 | 在多设备与迁移方向上的重写与扩展 |
原始代码以 MIT 许可发布,Copyright (c) 2026 DeepSeek Harness Team,LICENSE 予以保留。 本仓库的 git 历史从本项目自己的初始提交开始,不携带上游历史;这不是假装原创,而是为了 避免把一份无法与上游对齐的三方历史混进来。要核对上游改动,请直接比对上面两个仓库。
架构思想来自 DeepSeek Harness 团队的《Super-agent 设计探索:迈向更自主的 Agent 系统》。 本项目借用了其中已经落地的部分(双层架构、Trigger/Thread/Subscription、计算与执行环境分离), 并对该文第八节自己承认为未解的问题(尤其是 A2A 与安全)给出了自己的取舍,而不是声称解决。
许可
MIT,见 LICENSE。