dsh-dispatch-board 0.0.0-stage → 0.1.2

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 duan
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,165 @@
1
- # Temporary Holding Version
1
+ # dsh-dispatch-board —— 派单看板 + 派单模式
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(dsh)用的插件,解决一个具体问题:
4
+
5
+ > 包名:`dsh-dispatch-board`(npm / GitHub 同名)。内部运行时标识仍是 `taskboard`(存储目录 `~/.dsh/storages/dsh-taskboard/`、RPC 路由 `/taskboard`、预设 id `taskboard-*`、工具 `taskboard_*`),这样老安装和已有看板数据不会失效。
6
+
7
+ > **让主 Agent 别自己干活。** 主 Agent 只拆解、派单、审核、汇报;具体工作全部交给子 Agent。
8
+ > 你在看板上往「待开始」丢任务,插件轮询到就送给主 Agent 派发,子 Agent 干完自动回报,
9
+ > 主 Agent 审核通过后把看板状态改成「已完成」,你只负责看结论和归档。
10
+
11
+ ## 界面
12
+
13
+ 两个看板,同一份数据:
14
+
15
+ ### 1) 本工作区看板(右侧栏)
16
+
17
+ - 会话 header 右侧的「任务看板」图标按钮(带本工作区待开始角标)→ 右侧栏打开「任务看板」tab;
18
+ 右栏引导页里也有入口卡片。
19
+ - **只显示当前对话所属工作区的任务**;副标题带工作区名。
20
+ - 布局随右栏宽度自适应:窄栏 → 四个状态纵向 lane;≥560px → 两列网格;全屏/≥900px → 四列看板。
21
+ - 「待开始」列可以自己加任务(标题 + 备注/验收标准);**从哪个对话加的,任务就绑定那个对话与工作区**,
22
+ 不需要你选会话;卡片上会标出工作区;
23
+ - 卡片按钮:详情 / 开始 / 立即派发 / 完成 / 打回 / 归档 / 重新打开 / 编辑 / 删除,
24
+ 有关联会话时还有「对话」——**一键跳到发起/执行这条任务的那个对话**(详情里也有「发起对话 / 执行对话」;
25
+ 旧任务没记录执行会话时,进行中的那条会用「最近派发」兜底显示「执行对话」);
26
+ **点卡片标题(或「详情」)看完整详情**:完整结论、备注、创建/开始/完成时间、执行者、提醒次数,
27
+ 还能在浮层里直接改状态;
28
+ - 视觉:macOS / iOS 风格皮肤——灰色画布 + 白色卡片、发丝分隔线、胶囊按钮、系统字体、柔和阴影,深色模式自动跟随宿主主题;窗口变窄时四列自动降成两列 / 一列;
29
+ - 顶部:轮询开关、轮询间隔(5s / 15s / 30s / 60s)、**派发到**(新对话 / 回发起对话 / 空闲会话)、一键归档已完成、立即刷新;
30
+ - **新对话(默认)**:在任务所属工作区**新建一个派单模式对话**(落在那条工作区的分组里,不进「未分组」),任务投给它;
31
+ - **回发起对话**:派回创建这条任务的那个对话;
32
+ - **空闲会话**:忽略来源,自动挑一个空闲会话(同工作区优先)。
33
+ - 宽栏底部显示数据文件路径(本机持久化,不随会话结束丢失)。
34
+
35
+ ### 2) 任务看板(左侧栏,全部工作区)
36
+
37
+ - 左侧栏多一个「任务看板」面板图标(带 全部待开始+进行中 的数量角标)。
38
+ - 整页显示**全平台所有工作区**的任务,每张卡带「工作区 xxx」标签;顶部有工作区过滤(全部 / 单个)。
39
+ - 新建任务**必须选工作区**(下拉来自 DSH 的工作区列表):选好后任务就绑定该工作区,
40
+ 派发时优先找那个工作区里打开的会话执行,找不到就停在待开始并提示(不会跑到别的工作区干活);
41
+ 急着处理可以点「立即派发」改派。
42
+ - **新「模式」:派单看板模式**。插件包自带两个模式声明(不写盘、不需要额外安装步骤),
43
+ 在模式选择器里选「派单看板模式」,主 Agent 就按派单口径工作(不写文件、不跑命令,一切派给子 Agent)。
44
+
45
+ ## 安装
46
+
47
+ ```powershell
48
+ # 1) 装进你的 profile(web 是 `dsh web` 默认用的那个)
49
+ dsh plugin --profile web add C:\Users\duan\Code\dsh-taskboard
50
+
51
+ # 2) 重启 web 服务(Host 半需要重新加载)
52
+ dsh web
53
+
54
+ # 3) 浏览器刷新 http://127.0.0.1:3080 —— 左侧栏出现「任务看板」、会话 header 右侧出现「任务看板」按钮
55
+ ```
56
+
57
+ > 也可以用 GUI 的插件管理器安装本地包(等价于把包 link 进 profile)。
58
+ > 卸载:`dsh plugin --profile web remove dsh-dispatch-board`。
59
+
60
+ 「派单看板模式」由插件包自带的 `presets/taskboard.patch.yml` **声明**(dsh 0.2.2 起 preset 是
61
+ bundle patch 里的 `@deepseek-ai/dsh-agent-preset` 行,不是 `~/.dsh/.agent-presets` 目录)。
62
+ 装好插件、重启 `dsh web`、刷新页面后,模式选择器里就会出现:
63
+
64
+ - **派单看板模式**(主 Agent:只拆解 / 派单 / 审核 / 汇报)
65
+ - **派单看板模式 · 执行者**(子 Agent 专用:完整执行工具集)
66
+
67
+ 不需要任何额外安装步骤,也不写盘。
68
+
69
+ ## 用法
70
+
71
+ 1. **选模式**:新建会话时把模式切成「派单看板模式」。
72
+ 2. **加任务**:点会话 header 的「任务看板」按钮打开右侧栏 → 在「待开始」区输入任务标题(可加备注写验收标准),回车。
73
+ - 不需要选会话:任务默认**回当前这个对话**执行(面板会提示「任务会回到本对话执行(工作区:xxx)」),
74
+ 子 Agent 就在这个对话的工作区里干活;
75
+ - 如果这个对话正在跑,任务会等它空下来再派(不会插话、也不会改派给别的会话);
76
+ - 如果你打开的是**历史会话**(还没产生新对话轮),插件会先尝试唤醒它再回派;唤醒不了(历史会话被界面持有)
77
+ 任务会**留在待开始**并提示你去那边发一条消息,绝不偷偷跑到别的工作区执行;
78
+ - 急着处理的话点「立即派发」,它才会退化给其它空闲会话。
79
+ 2b. **跨工作区派活**:左侧栏「任务看板」(全部工作区)→ 新建时选工作区 → 任务绑定该工作区,派发优先落在那边的会话。
80
+ 3. **等派发**:宿主每 15s 轮询一次「待开始」。命中且目标会话空闲时,会给主 Agent 推一条
81
+ `【任务看板 · 待开始】t-3 …` 的消息;主 Agent 把任务改成「进行中」,然后派子 Agent 去做,
82
+ 自己结束本轮(不占对话,你可以继续和它聊别的)。
83
+ 4. **审核闭环**:子 Agent 完成后,运行时把完成通知送回主 Agent,它开新一轮审核:
84
+ - 通过 → 看板任务变「已完成」,`result` 里是结论,同时向你汇报一句话;
85
+ - 不通过 → 带着修改意见打回同一个子 Agent 重做,任务保持「进行中」。
86
+ 5. **归档**:你点「归档」,或顶部「全部归档」,任务进「已归档」列,不再参与轮询。
87
+
88
+ ### 轮询规则(为什么它不会烦到你)
89
+
90
+ - 任务优先派回**创建它的对话**(工作区绑定);平台看板的任务优先派给**同工作区**的空闲会话;
91
+ - 目标会话忙/该工作区没有打开的会话时会等(不跨工作区偷偷执行),只有「立即派发」才允许改派;
92
+ - 创建它的对话是历史会话且唤醒不了 → 停在待开始并提示去那边发条消息;
93
+ - 一次轮询逐条试任务,某个任务的目标会话正忙不会挡住其它任务;
94
+ - 只在目标会话 **空闲**(idle)时投递,运行中不打扰;
95
+ - 每轮最多投递 1 条任务;
96
+ - 同一个任务两次提醒之间至少等 `2 × 轮询间隔`(最长 120s),最多提醒 5 次,
97
+ 超过后卡片上标「派发超时」,等你手动处理;
98
+ - 顶部可以随时暂停轮询。
99
+
100
+ ## 数据与文件
101
+
102
+ | 内容 | 路径 |
103
+ | --- | --- |
104
+ | 看板数据 | `$DSH_HOME/storages/dsh-taskboard/board.json`(原子写,坏文件自动备份) |
105
+ | 模式声明 | 插件包内 `presets/taskboard.patch.yml`(随 bundle 加载,不写 `$DSH_HOME`) |
106
+
107
+ `$DSH_HOME` 默认 `~/.dsh`(Windows:`C:\Users\<你>\.dsh`)。
108
+
109
+ 想改模式行为(persona、工具集)就直接改 `presets/taskboard.patch.yml` 再重启;看板页会在模式
110
+ 挂载失败时显示红色诊断条(`agentPresets.list()` 的 `broken` 原文)。
111
+
112
+ ## 给模型用的工具
113
+
114
+ 插件在宿主级注册了三个工具,所有模式都能用:
115
+
116
+ | 工具 | 用途 |
117
+ | --- | --- |
118
+ | `taskboard_list` | 列出看板任务(可只看某个状态),派单前确认、审核时对照 |
119
+ | `taskboard_add` | 往「待开始」加任务(用户口述需求、主 Agent 拆出的后续任务) |
120
+ | `taskboard_update` | 改状态(doing / done / todo / archived)、写 result / assignee / note |
121
+
122
+ ## 排障
123
+
124
+ - **会话 header 没有「任务看板」按钮**:确认部署里有右侧栏(`@deepseek-ai/dsh-client-ui-sidebar-right`,
125
+ web-app 自带);再确认 `dsh plugin --profile web list` 里有 `dsh-dispatch-board`,重启 `dsh web` 后刷新页面。
126
+ 浏览器控制台若有 `dsh.client` 相关报错,说明 `lib/client.js` 没被识别(检查 `exports["./client"]`)。
127
+ - **点了按钮右栏没出现看板**:看 console 的 `[dsh-dispatch-board]` 警告——通常是右栏服务不可用;
128
+ 也可以直接点右栏 tab 条上的 + 从引导页里选「任务看板」。
129
+ - **加了任务但没派发**:看页面顶部的跳过原因——
130
+ 「没有在线的会话」表示当前没有打开的会话;「目标会话正在运行」表示主 Agent 正忙;
131
+ 「轮询已暂停」就点恢复。也可以对任务点「立即派发」跳过等待。
132
+ - **模式选择器里没有「派单看板模式」**:确认插件已装进当前 profile(`dsh plugin --profile <name> list`)
133
+ 并重启了 `dsh web`;看板页顶部若出现红色「派单看板模式加载失败:…」就是某个预设行配置有误,
134
+ 照着 `broken` 原文改 `presets/taskboard.patch.yml`(常见:删了必填 config)。
135
+ - **主 Agent 还是自己干活**:确认会话用的确实是「派单看板模式」,而不是 standard。
136
+ - **点了「归档 / 删除 / 开始 / 完成」没反应**:0.1.0 修过一个客户端 bug(卡片按钮回调里的变量遮蔽,
137
+ 点击直接抛异常)。升级到当前版本并**重启 `dsh web` + 刷新页面**即可。删除现在是行内二次确认
138
+ (第一次点变「确认删除」,再点才真删),不再依赖浏览器原生 confirm。
139
+ - **点了「归档」过一会儿又变回「已完成」**:常见原因是**同时开了两个 dsh 进程共用同一个
140
+ `board.json`**(比如正式实例 + 一个测试实例),后写的整份内存状态会把先写的覆盖掉。
141
+ 0.1.0 起读/写前都会比对 `revision`、盘上更新就采用盘上状态;测试实例请用
142
+ `$env:DSH_TASKBOARD_PATH='C:\Users\<你>\.dsh-taskboard-test\board.json'` 单独隔离。
143
+ 升级后需要**重启一次 `dsh web`**(Host 半改动)再刷新页面。
144
+
145
+ ## 开发
146
+
147
+ ```powershell
148
+ node --check lib\index.js
149
+ node --check lib\client.js
150
+ node --test
151
+ ```
152
+
153
+ - 契约(RPC 端点 / 任务状态机 / 快照字段 / 模式声明):[`docs/architecture.md`](docs/architecture.md)
154
+ - RPC 探针:`node .dev/verify-rpc.mjs http://127.0.0.1:3099`(33 项断言,含错误分支)
155
+ - 验证记录(自动化 + 端到端闭环证据):[`docs/verification.md`](docs/verification.md)
156
+ - 浏览器端调查(slot / RPC / 主题变量):[`docs/client-notes.md`](docs/client-notes.md)
157
+ - Host 端调查:[`docs/host-notes.md`](docs/host-notes.md)
158
+ - 预设调查:[`docs/preset-notes.md`](docs/preset-notes.md)
159
+
160
+ 改 `lib/client.js` 后刷新浏览器即可(client bundle 走 HMR / 页面重载);
161
+ 改 `lib/index.js` 需要重启 `dsh web`(Host 模块不热更)。
162
+
163
+ ## License
164
+
165
+ MIT
@@ -0,0 +1,10 @@
1
+ # dsh-dispatch-board bundle patch.
2
+ #
3
+ # 只插入一行 Host loader entry;包名由 profile 的 node_modules 解析
4
+ # (dsh plugin --profile <name> add <本目录/包名> 安装的就是这个包)。
5
+ #
6
+ # Client 半由 package.json 的 dsh.client 声明,不需要单独的 loader row。
7
+ # Preact/React 之外的 @deepseek-ai/* 一律不 import(见 docs/architecture.md)。
8
+ - insert:
9
+ - id: taskboard
10
+ name: dsh-dispatch-board
package/icon.svg ADDED
@@ -0,0 +1,7 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="dsh-taskboard">
2
+ <rect x="6" y="10" width="52" height="44" rx="9" fill="#f2f6ff" stroke="#3b6fe0" stroke-width="3"/>
3
+ <rect x="13" y="20" width="9" height="25" rx="3" fill="#3b6fe0"/>
4
+ <rect x="27.5" y="20" width="9" height="15" rx="3" fill="#7aa2f7"/>
5
+ <rect x="42" y="20" width="9" height="21" rx="3" fill="#4f8ff7"/>
6
+ <rect x="13" y="14" width="9" height="3" rx="1.5" fill="#3b6fe0"/>
7
+ </svg>