DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-workflow-kit

s

dsh-workflow-kit

Manifest valid

Companion to dsh-superagent: dispatch work between receivers, record failures, wake sleeping sessions. Zero external dependencies.

hasBundlePatch

dsh-workflow-kit

官方 dsh-superagent 的补足版——它管「一个仓库里的自主 agent」,我们管「多个接收方之间怎么分活、怎么留证、被谁叫醒」。

不 fork、不重写、不替代。只在它明确没有的地方补。

这是一个脚本 + 一份说明书:装完怎么用取决于你。包里不含任何特定团队的分工,接收方的名字由你自己定(alice/bob/财务机器人都行)。


English overview

dsh-workflow-kit is a companion to the official dsh-superagent (MIT). superagent handles one repo, one autonomous agent; this kit handles how work moves between several receivers — who gets a task, how completion is reported, how failures are recorded, who wakes a sleeping session.

  • What you get: mailbox dispatch, work-order state machine with dependency gates, auto-take, scheduled wake-ups, failure ledger (errors must be pasted verbatim), duplicate-work check, cost ledger, local channel (zero external services).
  • What we do not redo: superagent's Ticket/Assignment state machine, web panel, model-based gating, Outbox reliability.
  • Install: copy the folder → cp config.example.json config.json → node bin/init.mjs → node bin/selfcheck.mjs → mount the 20-minute check-in reminder.
  • Requirements: Node 18+, no network calls, no account needed.
  • Receivers are yours to name: alice, bob, finance-bot — whatever fits your setup.

See FEATURES.md for the checkmark-by-checkmark comparison.


一、为什么需要它(先说清分工)

DSH 官方 2026-10-31 开源了 deepseek-ai/dsh-superagent-prototype(MIT),是个很完整的单仓库自主 agent:监听 GitHub/Feishu,收到请求就开 Ticket、起独立 session、开 PR、用 Web 面板展示待办。

但它有一个明确的架构假设:一个仓库 + 一个 agent。

真实接活/交付场景不是这样:一个人同时有 3-5 个接收方(不同项目、不同角色),活要从 A 派到 B,卡了要有人看见,没人盯的时候要能被叫醒。这些 superagent 不管,我们从零补上。

所以两者的关系是:

        ┌──────────────────────────────┐
        │  dsh-superagent(官方,MIT)  │
        │  单仓库 · Source 驱动 · 面板  │
        │  Ticket/Assignment · 判分模型 │
        └──────────────┬───────────────┘
                       │ 它没有的部分 ↓
        ┌──────────────┴───────────────┐
        │   dsh-workflow-kit(本套件)  │
        │  多接收方 · 定时唤醒 · 失败留证  │
        │  完成查重 · 成本台账 · 依赖门 │
        └──────────────────────────────┘

两者可以同时装:superagent 管单仓库的自主交付,本套件管跨接收方的分发与治理。


二、补足清单(superagent 没有、本套件补上)

完整对照表见 FEATURES.md(两列打勾,一眼看完谁有什么)。

#功能说明文件
1定时唤醒到点叫醒睡着的会话,不用人盯docs/02-巡检prompt.md
2失败强制留证报错必须写进 failures.jsonl 并贴原文,禁止静默绕过lib/fail-hook.mjs、bin/wo.mjs block
3开工前查重先查最近完成记录,做过就关单,不重复劳动docs/01
4成本与资源台账支出记账 + 进程/内存守门docs/03
5本地频道汇报写本地 channel.jsonl,不依赖任何外部服务lib/store.mjs、bin/say.mjs
6工单依赖门依赖没完成,不允许领bin/wo.mjs take
7派单路由检查派错接收方时提示bin/routing-guard.mjs
8优先级配额P1 每日有上限,超了自动降 P2bin/wo.mjs list
9自动接单没人盯时自己领活,单接收方有并发上限bin/autotake.mjs
10巡检速览一行看全局:信箱/队列/工单/失败(速览命令组合见 docs/02-巡检prompt.md)docs/02-巡检prompt.md
11阶段摘要换会话前落摘要,交接不丢信息docs/03
12安装自检装完自证环境可用(15 项)bin/selfcheck.mjs

三、它解决什么具体问题

没有这套东西时,多接收方协作会撞上四个问题:

  1. 谁该干哪条 —— 靠人在群里喊,喊完忘了
  2. 干完了怎么让人知道 —— 干完不说,上游一直等
  3. 卡住了怎么让人看见 —— 静默失败,三天后才发现
  4. 没人管的时候谁来叫醒 —— 接收方睡着,活堆着

本套件把四个问题变成文件 + 几条命令:

问题机制落点
谁干哪条信箱投递 + 工单自取tasks/mailbox/<接收方>/*.md、tasks/workorders/pool.json
干完怎么回写dispatch done / wo submittasks/dispatch.jsonl、工单 evidence
卡住怎么留证fail 必须贴原文tasks/failures.jsonl
谁叫醒20 分钟巡检提醒DSH schedule

三条设计原则:

  • 状态在文件里,不在人脑里 —— 换会话/换机器都能接着干
  • 失败必须贴原文 —— 绕一次等于藏一个 bug
  • 只做流转,不做智能 —— 判断留给人和模型,套件只保证「不丢、不漏、不静默」

四、安装

两种装法:当 DSH 插件装(推荐,工具直接进模型工具列表)或当脚本装(不装插件,只跑 CLI)。

方式 A:dsh plugin add(cordis bundle)

dsh plugin add github:stayw1thme999/dsh-workflow-kit

装完宿主会加载 cordis.patch.yml,注册 6 个工具:workflow_list / workflow_take / workflow_report / workflow_submit / workflow_accept / workflow_block。插件只做转发,真正的状态机在 bin/wo.mjs 里——CLI 用法和插件用法永远一致。

插件形态需要宿主提供 @deepseek-ai/dsh-tools(peer dependency,DSH 自带)。

方式 B:脚本安装(不装插件)

1. 复制目录 + 配置

cp -r dsh-workflow-kit ~/dsh-workflow-kit && cd ~/dsh-workflow-kit
cp config.example.json config.json

改 config.json:

{
  "workspace": "~/dsh-workspace",
  "receivers": ["alice", "bob"],
  "channelFile": "data/channel.jsonl",
  "qqNotify": false,
  "checkMinutes": 20,
  "maxDoingPerReceiver": 3,
  "redlines": ["不花钱", "不删除", "不对外提交", "不改生产", "不承诺"]
}

2. 初始化 + 自检

node bin/init.mjs        # 建目录/台账/接收方信箱(幂等)
node bin/selfcheck.mjs   # 15 项自检:配置/目录/权限/脱敏扫描/命令在位

init 会把解析出的绝对频道路径回写进 config.json,保证所有脚本写同一个 channel.jsonl。

3. 挂巡检提醒(每个接活会话挂一次)

把 docs/02-巡检prompt.md 里那段作为提醒内容,间隔 20 分钟。

DSH 的提醒跟会话走,不跟接收方名走——换会话要重挂。


五、一轮完整流程(可复制)

# 建单(spec 是 JSON,字段见 templates/工单-spec.md)
node bin/wo.mjs new -f spec.json
node bin/wo.mjs check WO-20261104-0001      # 校验验收标准/依赖
node bin/wo.mjs assign WO-20261104-0001 alice  # 派给接收方
node bin/wo.mjs take alice                     # 接收方自取(依赖未完成会拒)
node bin/wo.mjs report WO-20261104-0001 "进度"
node bin/wo.mjs submit WO-20261104-0001 "证据:路径 + 输出原文"
node bin/wo.mjs accept WO-20261104-0001 "验收通过"

六、命令速查

命令用途
node bin/init.mjs初始化工作区(幂等)
node bin/selfcheck.mjs自检(配置/目录/权限/脱敏/命令)
node bin/wo.mjs new -f spec.json建工单
node bin/wo.mjs list [--receiver r]列工单
node bin/wo.mjs take <接收方>自取(自动判依赖)
node bin/wo.mjs report/submit/block/accept上报/交验收/报卡点/验收
node bin/dispatch.mjs list <接收方> / done <id>接收方队列 / 结单
node bin/autotake.mjs [--dry]自动接单
node bin/routing-guard.mjs路由守门
node bin/take.mjs --receiver r收信箱
node bin/progress.mjs --receiver r "..."报进度
node bin/say.mjs "..." --receiver r --kind done发频道
node scripts/scan-secrets.mjs .脱敏扫描(发布前必跑)

数据目录:默认 ./data,可用 DSH_WORKFLOW_DATA 覆盖。 频道:data/channel.jsonl,一行一条 {at,who,kind,text}。


七、可配置项

配置默认说明
workspace~/dsh-workspace活数据根目录(不进仓库)
receivers[]接收方名列表(名字随你起)
channelFiledata/channel.jsonl频道文件(相对 workspace)
qqNotifyfalse外部通知开关;false 时零外部调用
checkMinutes20巡检间隔
progressMinutes10进度上报间隔
maxDoingPerReceiver3单接收方并发上限
redlines五条红线关键词,命中即要求人确认

八、常见问题

Q1:必须多台机器吗? 不用。单机开几个 DSH 会话即可,接收方只是会话标签;多人多机时把 workspace 指到共享目录。

Q2:和 superagent 冲突吗? 不冲突,可同时装。它管单仓库自主交付,本套件管跨接收方分发;两者都写文件,不抢同一个数据目录即可。

Q3:工单和信箱有什么区别? 信箱是投递(一封信一个文件,收完进 _done);工单是状态(queued→doing→review→done,带验收和依赖)。小活用信箱,要验收的用工单。

Q4:为什么失败必须贴原文? 因为「失败了但绕过去了」是最难查的 bug。fail-hook 会在未捕获异常时自动落 failures.jsonl,wo.mjs block 也强制写卡点原文。


九、目录

bin/        命令(init/selfcheck/wo/dispatch/autotake/routing-guard/take/list/progress/say)
lib/        核心(config/store/fail-hook/quarantine)
docs/       手册 00-05
templates/  工单 spec、数据处理调用模板
scripts/    脱敏扫描
config.json 你的配置(.gitignore 掉,不入库)

十、联系 / Contact

中文:发现 bug、想加功能、或者想让我帮你改造成你自己团队的流程,都可以直接联系我。

  • QQ:1181622043 (加好友备注「dsh-workflow-kit」)
  • 邮箱:1181622043@qq.com

English: Found a bug, need a feature, or want this adapted to your team's workflow? Reach out.

  • QQ: 1181622043 (add a note "dsh-workflow-kit")
  • Email: 1181622043@qq.com

License

MIT

Comments

Loading…

Similar plugins

dsh-chaos

by hanxuanliang

Durable multi-agent collaboration for DeepSeek Harness: channels, threads, tasks, and resumable agent sessions.

Workflow & AutomationManifest valid

★ 5

↓ 217/wk

MIT

TypeScript

Aug 24, 2026

dsh plugin --profile web add @hanxuanliang/dsh-chaos

DevFlow multi-agent workflow orchestration plugin for DeepSeek Harness

Workflow & AutomationTerminal & ClientsManifest valid

★ 0

dsh plugin --profile web add @xiaoxie-ide/dsh-devflow

by sxwer001

DSH native collaboration: main-agent architecture and validated plans, parallel workers, verification and independent review.

Workflow & AutomationManifest valid

★ 1

MIT

JavaScript

Oct 13, 2026

dsh plugin --profile web add dsh-collab-dev

Mirrors other coding agents' sessions into DeepSeek Harness as continuable tasks, one workspace per application.

Terminal & ClientsSessions & MessagesManifest valid

★ 0

dsh plugin --profile web add @local/agent-sync

by Kayungko

Supervisor-style workflow orchestration over top-level sessions: confirmation-gated batch dispatch, team workstreams, steering running tasks, idle-wait collection and live model-route discovery across

Workflow & AutomationManifest valid

★ 4

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add dsh-plugin-task-coordinator

by Neo65536-engineer

Read-only work reports for DeepSeek Harness: reconstruct what an agent task actually did from session logs — tools used, files read/written, commands run, test results, failures, token usage, and whether it finished. Fully offline, no API key, no data leaves your machine.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 2

MIT

JavaScript

Sep 26, 2026

dsh plugin --profile web add dsh-agent-log