DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

niechao136 /

niechao136/dsh-foreman

Verified

This plugin has no description yet.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: master@2975cb74

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  本地直跑,不走网络

怎么用

装好之后,日常只有四件事。全部在 Web 面板里做,不需要碰命令行。

1. 装上去

dsh plugin --profile loop add dsh-foreman

dsh-foreman 是 bundle:安装后自动向 profile 的 cordis.patch.yml 追加插件行, 不需要你手写配置。完整步骤(独立 DSH_HOME、独立端口、systemd 托管)见 独立实例 runbook;已经有一个实例要搬家见迁机。

主 loop 上只装 dsh-foreman。 dsh-foreman-node 只装在被派活的机器上——它进主 loop 就等于把设备侧插件也装到服务器,两侧职责会打架。

2. 配来源(谁能让智能体干活)

设置 › 来源。每张卡片三件事:

项 说明
程序 下拉选本机的 gh / lark-cli;旁边 ⟳ 重新扫描 PATH。留空 = 自动查找
凭据 选中程序后出现输入框,加密存进 foreman 自己的数据库,不写 CLI 的配置
仓库 / 群 一行一个 owner/name 或群;仓库可以直接下拉选已加入的群聊

保存时会当场校验:用你刚填的凭据跑一次 gh api user,并逐个检查仓库的推送权限。 校验不过就不保存,报错直接指向这张卡片。

凭据输入框留空 = 保持不变,不是清空。要移除凭据,取消选择程序即可。

2.5 配项目对应(活在哪里做)

设置 › 项目对应。一个项目 = 一个目录 + 一组仓库:

  • 一个目录可以服务多个仓库(比如 dsh-foreman 和 dsh-foreman-node 共用一个工作目录), 勾选即可,不用重复填路径。
  • 仓库里的请求落到它所在项目的目录;没登记的仓库只能在本机执行,因为工单不知道自己的项目就选不了设备。
  • 飞书群也在这页映射:哪个群属于哪个项目。

3. 配策略(什么请求会被接)

设置 › 策略,三部分:

  • 接单规则——智能体按规则判断一条请求该不该接。默认三条:Copy fixes(错别字/措辞)、 Visual fixes(局部间距/对齐/溢出)、Status answers(查证/回答)。规则是自然语言, 写清楚"什么算"和"什么不算"。
  • 各来源的名单——谁能通过这个来源发起工作。飞书填 open_id(或用「同步来源群」跟群成员走), GitHub 填账号名。名单为空 = 谁都不能发起,这正是"发送者不在名单里"的来源。
  • 准入表——每个接收范围里,算明确请求、推断的候选、还是忽略。

接单模式在「设置 › 评估」里,决定推断的候选怎么处理:

模式 行为
observe 只记录"本会接单",什么都不做。先用它观察判断准不准
auto 按规则真的接单、开工
off 只接明确请求,不推断

4. 看工单

面板的工单页列出每张工单的状态、决策理由、和它派给了哪台设备。

  • 判定 页是流水:每条触发进来后,准入的结果和理由("发送者不在这个来源的名单里" 就是这样出来的)。
  • 一条请求不接时,理由一定是这两类之一:发送者不在名单(设置 › 策略 里加人), 或准入表设为忽略(改准入表)。两者都指向设置里的具体一格,不是玄学。

状态

早期开发中。 设备注册表、Selector、ForemanExecutor、Hub、回报规则、设备侧插件、文本渲染、 迁移脚本、面板设备页、飞书群路由都已落地,测试 1332 项。设计与实现计划见:

  • 设计
  • 实现计划
  • 交接文档

部署两件事各有一份 runbook:独立实例 与 迁机。

一眼看懂它怎么派人

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。

—/ 5

No ratings yet

Verified DSH bundle

Commit 2975cb74c598

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout