dsh-dispatch-board 0.3.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,12 +6,12 @@
6
6
 
7
7
  > 包名:`dsh-dispatch-board`(npm / GitHub 同名)。内部运行时标识仍是 `taskboard`(存储目录 `~/.dsh/storages/dsh-taskboard/`、RPC 路由 `/taskboard`、预设 id `taskboard-*`、工具 `taskboard_*`),这样老安装和已有看板数据不会失效。
8
8
 
9
- > **你只管和主会话说话,活由工作区组长派给 worker 干。** v0.2.0 起默认「工作区组长模式」:
9
+ > **你只管和主会话说话,活由工作区组长派给 worker 干。** 默认「工作区组长模式」:
10
10
  > 你绑定一个主会话(普通对话),在看板加任务;插件按工作区自动找 / 建常驻工作区组长,
11
11
  > 组长派 worker 子 Agent 干活、审核并把结论写回看板;任务完成后插件把「【任务看板 · 汇报】」
12
12
  > 回执推给主会话,由它向你汇总。看板是唯一事实源与汇报通道,你只负责看结论和归档。
13
13
 
14
- ## 工作区组长模式怎么用(v0.2.0 默认)
14
+ ## 工作区组长模式怎么用(默认)
15
15
 
16
16
  v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务新建会话。默认链路是:
17
17
 
@@ -22,8 +22,12 @@ v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务
22
22
  任务加进「待开始」即可。你也可以直接对主会话说「把 XX 加进看板」,它用 `taskboard_add` 加
23
23
  (跨工作区时带 `workspace` 参数)。
24
24
  3. **组长自动派发**:插件每 15s 扫「待开始」,按任务工作区找到 / 创建该工作区的**常驻工作区组长**,
25
- 把任务投给它;组长先把任务置「进行中」,再用 `subagent` 派一个 **worker** 后台干活。
25
+ 把任务投给它;组长先把任务置「进行中」,再默认派一个 **worker** 后台干活(可拆任务见下)。
26
26
  - 一个工作区只有一个组长,任务不会挤进别的对话,也不会每个任务新建一个会话;
27
+ - **谁当组长**:插件懒创建的组长,或该工作区里第一个派 worker 的派单模式会话。工作区没有组长 /
28
+ 组长已归档时,你手动开的派单会话第一次派活就会被登记为组长;已有活组长不抢,只打开不派活不会接管(v0.3.2);
29
+ - **可拆任务**:组长可按写域拆成多个独立片,在同一轮 fan-out 多个 worker;写域不相交是硬条件,
30
+ 全部完成后组长合并/验证再收尾。切片会各自出现在看板(宿主自动卡),最终以父卡结论为准(v0.3.3);
27
31
  - 组长忙时任务留「待开始」,下一轮再试;
28
32
  - 组长不可用(被关掉 / 唤起失败)时任务留「待开始」并提示,点组长条的「创建组长」可以修复;
29
33
  - 组长会话**被归档**时不用手动处理:下次轮询会自动摘除旧映射、重建组长,并把该组长名下
@@ -60,7 +64,7 @@ v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务
60
64
  还能在浮层里直接改状态;
61
65
  - 视觉:macOS / iOS 风格皮肤——灰色画布 + 白色卡片、发丝分隔线、胶囊按钮、系统字体、柔和阴影,深色模式自动跟随宿主主题;窗口变窄时四列自动降成两列 / 一列;
62
66
  - 顶部:轮询开关、轮询间隔(5s / 15s / 30s / 60s)、**派发到**(工作区组长(默认)/ 新对话 / 回发起对话 / 空闲会话)、一键归档已完成、立即刷新;
63
- - **工作区组长(默认,v0.2.0)**:按任务工作区投给该工作区的常驻组长(见「工作区组长模式怎么用」);
67
+ - **工作区组长(默认)**:按任务工作区投给该工作区的常驻组长(见「工作区组长模式怎么用」);
64
68
  - **新对话**:在任务所属工作区新建一个派单模式对话(旧行为,兼容);
65
69
  - **回发起对话**:派回创建这条任务的那个对话(旧行为,兼容);
66
70
  - **空闲会话**:忽略来源,自动挑一个空闲会话(旧行为,兼容)。
@@ -81,8 +85,8 @@ v0.2.0 起不用再手动开「派单模式」对话,也不需要每个任务
81
85
  旧模式下优先找那个工作区里打开的会话执行,找不到就停在待开始并提示(不会跑到别的工作区干活);
82
86
  急着处理可以点「立即派发」改派。
83
87
  - **两个内置模式**:插件包自带 `taskboard-dispatch`(工作区组长)与 `taskboard-worker`(执行者)声明,
84
- 不写盘、不需要额外安装步骤。v0.2.0 起组长会话由插件按工作区自动创建,**通常不需要手动选模式**;
85
- 想手动体验时仍可在模式选择器里选「任务看板 · 工作区组长(自动)」(= 工作区组长口径,不写文件、不跑命令,一切派给子 Agent;手动选的会话不会被自动接进看板,日常交给插件自动创建即可)。
88
+ 不写盘、不需要额外安装步骤。组长会话由插件按工作区自动创建,**通常不需要手动选模式**;
89
+ 想手动体验时仍可在模式选择器里选「任务看板 · 工作区组长(自动)」(= 工作区组长口径,不写文件、不跑命令,一切派给子 Agent;工作区没有组长 / 组长已归档时,这个会话第一次派 worker 会被登记为组长,已有活组长不抢;只打开不派活不会自动接管)。
86
90
 
87
91
  ## npm 安装
88
92
 
@@ -131,7 +135,7 @@ dsh web
131
135
 
132
136
  ## 用法
133
137
 
134
- > v0.2.0 默认是「工作区组长模式」,流程见上面的「工作区组长模式怎么用」。下面是完整步骤(含旧模式差异)。
138
+ > 默认是「工作区组长模式」,流程见上面的「工作区组长模式怎么用」。下面是完整步骤(含旧模式差异)。
135
139
 
136
140
  1. **绑定主会话**:用平时的**普通会话**打开看板,在组长条点「把当前对话设为主会话」。
137
141
  换绑 = 再点一次「换绑」;一个看板对应一个主会话。
@@ -217,13 +221,13 @@ dsh web
217
221
  主会话要**在线且空闲**才会收到「【任务看板 · 汇报】」回执,忙的时候等下一轮补投。
218
222
  - **任务一直停在待开始、详情里提示「工作区组长不可用」**:组长会话被关掉或唤醒失败。点组长条的
219
223
  「创建组长」修复;也可以对任务点「立即派发」重试。
220
- - **升级后不再每个任务新开对话了**:v0.2.0 默认 `dispatchMode='workspace-lead'`,这是预期行为;
224
+ - **升级后不再每个任务新开对话了**:默认 `dispatchMode='workspace-lead'`,这是预期行为;
221
225
  要回旧行为在看板顶部「派发到」切到「新对话 / 回发起对话 / 空闲会话」。
222
226
  - **模式选择器里没有「任务看板 · 工作区组长(自动)」**:确认插件已装进当前 profile(`dsh plugin --profile <name> list`)
223
227
  并重启了 `dsh web`;看板页顶部若出现红色「任务看板 · 工作区组长(自动)加载失败:…」就是某个预设行配置有误,
224
228
  照着 `broken` 原文改 `presets/taskboard.patch.yml`(常见:删了必填 config)。
225
229
  - **主 Agent 还是自己干活**:默认(工作区组长)模式下任务由组长派 worker 执行;只有旧模式下才会派给主 Agent。
226
- 若你手动选了「任务看板 · 工作区组长(自动)」对话,它按工作区组长口径工作(不写文件、不跑命令、不直接面向用户),但不会被自动接进看板,日常交给插件自动创建即可。
230
+ 若你手动选了「任务看板 · 工作区组长(自动)」对话,它按工作区组长口径工作(不写文件、不跑命令、不直接面向用户),工作区没有组长 / 组长已归档时,它第一次派 worker 会被登记为组长,已有活组长不抢。
227
231
  - **点了「归档 / 删除 / 开始 / 完成」没反应**:0.1.0 修过一个客户端 bug(卡片按钮回调里的变量遮蔽,
228
232
  点击直接抛异常)。升级到当前版本并**重启 `dsh web` + 刷新页面**即可。删除现在是行内二次确认
229
233
  (第一次点变「确认删除」,再点才真删),不再依赖浏览器原生 confirm。