dsh-plugin-taskflow · DSH 任务流
给 DeepSeek Harness 的任务清单 + 分段小结插件:输入框上方一条液态玻璃清单,进行中的行带流动彩虹描边;每项任务完成时由模型写一句自己的小结;每个回合结束自动压成「一行标题 + 要点」。
A task list and per-turn digest plugin for DeepSeek Harness: a liquid-glass task panel above the composer, a one-line model-written summary per task, and a condensed digest for every finished turn.
安装
# 从 npm 安装
dsh plugin --profile web add dsh-plugin-taskflow
# 若包管理器因「新版本发布冷却期」装到了旧版,显式指定:
dsh plugin --profile web add dsh-plugin-taskflow@0.1.1
# 或直接从 GitHub 源码安装
dsh plugin --profile web add github:wk-xjd/dsh-plugin-taskflow
dsh plugin add 会把本包装成一个 profile bundle(自动写入 dsh.profile.bundles 并加载
cordis.patch.yml),无需手工编辑 patch 文件。
安装后刷新页面(桌面客户端:开发者工具里执行 location.reload(),或重启 App);
宿主半部更新需重启一次 App。
git clone https://github.com/wk-xjd/dsh-plugin-taskflow.git
cd dsh-plugin-taskflow
node install.mjs # 同步到 ~/.dsh/plugins 并写入 profile 行
node install.mjs --rotate # 宿主代码热更(换路径,免重启)
node install.mjs --profile web # 装到别的 profile
它做了什么
给 DeepSeek Harness(Web GUI)补两块能力:
- 对话内的任务清单:替换内置的一行式 todo 行,把 agent 的
todo_write渲染成 Claude 风格的清单卡片(7 个任务 · 完成 6 · 待办 1+✔/◐/■/□逐项),位置就在那次工具调用处。 - 常驻任务列表:替换 composer 上方自带的 todo 面板(遮蔽同一个
todo槽位)。有任务时,清单一直显示在输入框上方,宽度与输入框对齐(在 composer 包裹层里找到"最深的宽元素"= 输入卡片,复制它的width与左边缘,并用ResizeObserver跟随侧栏/窗口变化),液态玻璃背景(backdrop-filter: blur(34px) saturate(1.7)+ 顶部渐变高光 + 内外描边);执行中的任务行带 Apple Intelligence 风格的彩虹描边与呼吸圆点;进度环是 SVG,按完成比例填充,最多 190px 高,超出滚动。- 每个任务完成时,宿主用当前模型给它写一句自己的小结(≤60 字,基于该任务期间的工具调用与文件);
- 点有小结的某一项:弹出详情浮窗 —— 先是小结正文,再是开始/完成/用时、期间动作、涉及文件;
- 没有小结的项不可点击,行尾显示「小结生成中…」或「无小结」;
- 点进度环:打开右侧栏,看全部分段小结;
- 折叠按钮:收成一行,默认展开;
- 回合结束时仍处
in_progress的任务一律落到终态,不再假装在跑:正常结束的补记为完成;用户点「停止」、或回合被中断/失败时,宿主把任务标成status: stopped并记stoppedAt,界面变灰色■、停掉彩虹灯带、计时冻结在停止时刻,标题显示「已停止:<该任务>」; - 恢复会话时(插件重载、窗口重开)宿主会读回最后一轮回合边界:正常结束就补关未收尾项,异常结束就把遗留的
in_progress收成stopped,所以刷新页面不会重新出现一个永远在跑的任务; - 仍在运行的子 agent(宿主从子会话 header 的
origin=subagent/parentSession认出来)不会抢走主任务的标题:回合进行中时,标题仍是主任务正文,右侧另加「N 个子 agent」;列表里以∥ 子 agent:开头的并行项会显示靛蓝色的「子 agent 执行中」提示; - 每个正在运行的子 agent 都会以「子 agent · <descriptor 名字>」的靛蓝色行出现在清单下方,带自己的计时;插件重载后从子会话日志里补回名字与开始时间;
- 只有当主回合已经结束、子 agent 还在跑时,标题才切回靛蓝色「子 agent 执行中」,计时继续走;
- 没有任务时回退成单行胶囊,显示最新一段小结标题。
- 分段小结:每个 assistant 回合结束时,宿主用当前会话的路由发一次很短的独立请求,把这一回合压缩成「一行标题 + 1–3 条要点」,然后
- 作为胶囊的一行标题展示,点开浮层看全部段落与要点;
- 通过插件自己的 HTTP 路由提供给浏览器。
宿主同时记录每个 todo 的 startedAt / completedAt / stoppedAt,所以任务条能显示「这一项已经跑了 42s」,停止后冻结在停止时刻。
目录
安装细节
本包同时是一个 DSH bundle:package.json 里声明 dsh.bundle.patch = ./cordis.patch.yml,
dsh plugin --profile <p> add dsh-plugin-taskflow 会把它写进该 profile 的 dsh.profile.bundles:
{"profile": {"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-plugin-taskflow"]}}
bundle 里的 patch 只有一行 insert:
- insert:
- id: dsh-plugin-taskflow
name: 'dsh-plugin-taskflow'
从源码手动安装(不想走 npm 时)也可以用 install.mjs 直接改 profile 的 cordis.patch.yml。
生效方式
| 改了什么 | 怎么生效 |
|---|---|
浏览器半部(client/client.js) |
刷新页面(桌面客户端可用开发者工具执行 location.reload()) |
宿主半部(lib/index.js) |
重启 App;本地开发可用 node install.mjs --rotate 换新路径立即生效 |
| patch 行本身 | patchReload: live 会监听;改同一行的 name 要先删后加,避免新旧实例抢同一张 HTTP 路由表 |
使用
| 位置 | 看到什么 |
|---|---|
对话里每次 todo_write |
清单卡片:5 个任务 · 完成 2 · 待办 3,逐项 ✔ / ◐ / □ |
| composer 上方 | 常驻清单:◔ 4/6 当前任务 + 逐项 ✔/◐/□(最多 190px,超出滚动) |
| 点有小结的项 | 详情浮窗:任务小结正文 + 开始/完成/用时 + 期间动作 + 涉及文件 |
| 无小结的项 | 不可点击,行尾提示「小结生成中…」或「无小结」 |
| 点进度环 | 右侧栏「任务流」:全部 N 段小结 + 「整理最近一段」 |
| 无任务时 | 单行胶囊:▤ 最新小结标题(≤20 字),点击同样开侧栏 |
斜杠命令 /taskflow:立即整理最近一个还没有小结的回合。
配置
写在 patch 行的 config: 上(全部可选):
- insert:
- id: dsh-plugin-taskflow
name: '.../lib/index.js'
config:
enabled: true
minToolCalls: 1
minAssistantChars: 240
maxOutputTokens: 320
provider: '' # 留空 = 跟随会话最近一次请求的路由
model: ''
includeSubagents: false
| 字段 | 默认 | 含义 |
|---|---|---|
enabled |
true |
false 时不调用模型,只出规则摘要 |
minToolCalls |
1 |
工具调用数达到它才值得总结 |
minAssistantChars |
240 |
或助手文本达到它 |
maxDigestChars |
14000 |
递给模型的原文字符上限 |
maxOutputTokens |
600 |
摘要输出上限;撞上限但有正文时照用并标 truncated |
timeoutMs |
45000 |
单次调用看门狗 |
maxConcurrent |
2 |
全局并发摘要数 |
provider / model |
空 | 显式指定摘要路由;空则跟随会话 |
maxSegments |
60 |
每会话保留的段数 |
includeSubagents |
false |
默认不给子 agent 会话生成小结(它们自带 turn 流,容易刷屏与烧钱) |
taskListPolicy |
true |
往系统提示注册「任务清单规范」段:无论任务大小先拆解、每条中文≤35 词、只留一个进行中、完成即勾 |
parallelPolicy |
true |
往系统提示注册「复杂任务:并行拆解」段(吸收 SDK workflows/parallel-agents SOP 的可执行部分) |
实现
lib/index.js 宿主半部:事件折叠、摘要、HTTP、斜杠命令(零 npm 依赖)
client/client.js 浏览器半部:预构建 classic script,注册三处 UI
install.mjs 同步到 ~/.dsh/plugins + 维护 patch 行 + 轮换热更
test/ 两半各自的离线测试(假 cordis 上下文 + React shim)
任务清单规范(模型侧约束)
插件向 ctx.systemPrompt 注册一段 taskflow:task-list-policy(order 9000),所有对话、所有 agent 都读得到:
## 任务清单规范
- 无论任务大小(哪怕只改一行、只跑一条命令),都先用 todo_write 拆成可执行条目再动手;单步任务也给一条。
- 每条用中文书写,动词开头,最多 35 个词(中文约 60 字);一条只做一件事,但要把对象和判据写全。
- 写清对象(文件、命令、结论),不要用「处理一下」「继续优化」这类空话。
- 同一时间只保留一个 in_progress;做完一项立刻勾掉,不要攒到最后批量改。
关掉它:配置 taskListPolicy: false。
复杂任务:并行拆解(parallelPolicy,order 9010)
- 触发:出现 2 个以上可独立回答的未知,或 2 个以上可隔离的产物/模块。单文件单步不硬拆。
- 粒度:按「可独立消费的产物」切,每条写清产物、消费者与停止条件;不按文件数量机械切分。
- 执行:独立项用 subagent / workflow 并发派出(数量按宿主槽位减一),主代理同时推进
不依赖它们的关键路径;有依赖的串行交同一 agent 续作。
- 清单:并行项同时标 in_progress 并在文本前加「∥」;被依赖项保持 pending,解除后再置。
- 诚实:以真实工具调用作为派发证据;派发失败要保留该条并记录原因。
列表行按两行截断显示(-webkit-line-clamp: 2),35 词的条目也能读全;再长就以省略号收尾,完整文本在 tooltip 和详情浮窗里。
UI 配合:同时有 ≥2 项 in_progress 时,这些行的文本前会显示 ∥,提示这是并行轨道。
宿主
ctx.on('session/event')跟踪turn/start、turn/end、todo/write;子 agent 会话(meta.origin === 'subagent')与被中断/失败的回合(reason.kind为aborted/error)默认跳过;- 插件中途挂载也能找准回合起点:内存标记缺失时回扫日志里的
turn/start,不靠固定事件窗口; - 回合结束时
session.snapshotEvents(start, end + 1)取原文,折成「用户请求 / 工具调用 / 任务清单 / 助手收尾」; ctx.llm.stream({ provider, model, system, messages, maxTokens, sessionId, signal }),只累积text-delta;stop与max-tokens(有正文时)都算成功,其余 finish 视为失败;- 解析成
{title, bullets},写入$DSH_HOME/taskflow/<session>.json(400ms 防抖 + 原子 rename); ctx.inject(['webServer'])注册/taskflow/state、/taskflow/summarize、/taskflow/health、/taskflow/diagnostics;- 没有
llm服务、没有可用路由或调用失败时,退回规则摘要(工具数、文件、命令),UI 标记「规则摘要」。
浏览器
conversation.input.dock(list,id: 'todo',priority: -1)→ 任务条;lower priority 遮蔽自带面板(同 id 同 priority 会抛错);- 胶囊只显示一行(≤20 字,超长省略);浮层用
react-dom的createPortal挂到document.body,定位锚在胶囊右上方,随滚动/缩放重算,点外部或 Esc 关闭; - 说明:
conversation.chat.turnTail在 0.1.5-rc.2 的运行时实际是 list 槽(ctx.slots.spec()返回{"kind":"list"}),链式select注册会被拒(list slot "..." requires options.id),所以没有"回合末尾行内卡片"这种形态; tool.call.toolview以key: 'todo_write'、priority: -1遮蔽内置的一行式 todo 行,换成清单卡片(同 key 同 priority 会抛错,低 priority 才生效);conversation.input.dock承载常驻清单;宿主在每次tool/call时把它归到当前in_progress任务上(保留最近 12 条动作、10 个文件),详情浮窗才有"干了什么"可显示;- 详情浮窗用 portal 挂在
body,锚在被点的行下方(空间不够翻到上方);右侧栏只注册一个taskflow标签页,由进度环触发,不占导航入口; - 2.5s 轮询
/taskflow/state(页面隐藏时暂停),fetch失败即静默降级。
数据结构(~/.dsh/taskflow/<session>.json):segments[](turn、标题、要点、步数、文件、耗时、路由、usage)、
tasks.items(按任务文本记首次出现/开始/完成)、tasks.history、lastTurn、skipped[]。
自查与排错
curl -s http://127.0.0.1:<port>/taskflow/health # 在线状态 + 客户端握手 + 各面渲染尺寸
curl -s http://127.0.0.1:<port>/taskflow/diagnostics # 浏览器半部是否进图(clientPath / bundle URL)
curl -s "http://127.0.0.1:<port>/taskflow/diagnostics?llm=1" # 真发一次极小请求,验证摘要链路
curl -s -X POST http://127.0.0.1:<port>/taskflow/open-panel # 展开常驻清单(若被折叠)
curl -s -X POST http://127.0.0.1:<port>/taskflow/open-detail # 打开第一项的任务详情浮窗
curl -s -X POST http://127.0.0.1:<port>/taskflow/open-sidebar # 打开侧栏(全部小结)
curl -s -X POST -H 'content-type: application/json' \
-d '{"session":"<id>","turn":3,"force":true}' \
http://127.0.0.1:<port>/taskflow/summarize # 强制重做某段并返回成败原因
/taskflow/health 里的关键字段:
| 字段 | 含义 |
|---|---|
client |
浏览器半部的握手(build、href、UA);为空说明页面还没加载插件 |
stateHits / lastStateAgoMs |
客户端轮询次数与最近一次时间;不再增长说明界面没在跑 |
renders.<part> |
各面实测几何(visible、width/height):taskcard(对话内卡片)/dock(常驻清单)/detail(任务详情浮窗)/sidebar(全部小结)/apply |
lastSummary |
最近一次摘要的路由、失败原因与是否规则摘要 |
/taskflow/summarize 的返回里 failure 会直接给出原因(例如 ... finished with max-tokens、no provider/model route),排查不用翻日志。
?llm=1返回{"ok":true,"route":{...},"text":"…"}说明路由、消息形状与流式解析都通。- 小结是「规则摘要」而不是模型输出,说明
llm服务缺失、没有路由或调用失败——用?llm=1看具体错误。 - 浏览器里没有 UI:先确认
diagnostics里entry非空,再刷新页面;仍无则看 console 的slot entry crashed in '<slot>'。
兼容与权限
- DSH 版本:面向
dsh 0.1.5-rc.1(客户端包0.1.5-rc.2)实测,桌面客户端 0.2.2-rc.1;更低版本未验证。 - 平台:Web profile 与桌面客户端(Electron)都验证过;纯 CLI/headless profile 没有 UI,只会有宿主半部。
- 依赖:宿主半部零 npm 依赖(只用
node:fs/node:path/node:os/node:crypto);客户端半部只require('react')与require('react-dom')(DSH 内置种子模块)。 - 数据落地:
$DSH_HOME/taskflow/<session>.json,只存任务、耗时与小结文本;删除它不损失会话正确性。 - 外部调用:除"当前会话模型"外不访问任何网络服务;摘要调用走宿主已配置的 provider 路由(默认每次回合 1 次、每个完成的任务 1 次)。
- HTTP 路由:仅注册在宿主本机 web server(
/taskflow/state、/taskflow/summarize、/taskflow/health等),只读本机会话数据。 - 系统提示:注册两段约束(
taskflow:task-list-policy、taskflow:parallel-policy)与一条运行时提醒,可用配置关闭。
已知限制
- 没有行内(回合末尾)卡片:
conversation.chat.turnTail在本版本运行时是 list 槽,链式注册被拒;小结出现在胶囊标题与浮层列表里。 - 手动整理需要会话仍活着:
ctx.get('sessions').get(id)拿不到时只能看已有结果。 - 摘要是一次额外模型调用:默认每回合最多一次,受
minToolCalls/minAssistantChars节流;不想要就enabled: false。 - HTTP 取数依赖 web server:非 web 表面下任务条仍可用,但耗时与小结不可用。
- 宿主半部改动必须重启(或用
--rotate):这是 Loader 的 ESM 缓存行为,不是插件缺陷。
测试
node test/host.test.mjs # 事件 → 摘要 → HTTP 全链路(假 LLM、假 ctx)
node test/client.test.mjs # 注册、selector、三个组件渲染(React shim)
两个测试都不需要 DSH 进程,也不联网。
No comments yet. Be the first to write one.