dsh-taskflow 0.1.1 → 0.1.3

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
@@ -1,139 +1,335 @@
1
- # dsh-taskflow
2
-
3
- [简体中文](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/README.md) · [English](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/README_en.md)
4
-
5
- [![npm version](https://img.shields.io/npm/v/dsh-taskflow)](https://www.npmjs.com/package/dsh-taskflow)
6
- [![GitHub stars](https://img.shields.io/github/stars/Oak-liuhj/dsh-taskflow?style=social)](https://github.com/Oak-liuhj/dsh-taskflow)
7
-
8
- **面向持久任务计划与多层子会话协作的 [DeepSeek Harness](https://www.deepseek.com/harness/) 智能任务编排插件。**
9
-
10
- [`dsh-taskflow`](https://www.npmjs.com/package/dsh-taskflow) 将主会话的目标组织为持续保留的任务树,让你看到要做什么、由哪个会话执行,以及哪些事项已经完成。
11
-
12
- - **持久任务清单** — 模型根据请求复杂度规划事项,使用独立任务账本保存;对话换轮、页面刷新和宿主重启不会自动清空计划。
13
- - **按需递归委派** — 简单事项在负责会话完成,复杂且独立的事项创建子会话;子会话可在深度与并发限制内继续拆分。
14
- - **完成自动通知** — 子会话返回有效完成结果后,自动勾选对应事项并通知直接父会话,无需主会话再次核对。
15
- - **对话增量维护** — 在当前执行或选中的任务下增补事项,也可在主会话明确指定目标父任务;支持修改要求、取消和调整顺序。
16
- - **层级任务导航** — 在右侧按层级查看清单、进度、执行状态和任务详情,跳转到对应执行会话。
17
- - **按需工具视图** — 浏览器、文件、命令或插件工具实际调用后,可在会话左侧展示对应页面或输出;工具区默认关闭。
18
-
19
- ![任务导航与会话](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop.png)
20
-
21
- *截图来自固定响应模型的开发验收环境。*
22
-
23
- ## 安装 / 更新
24
-
25
- ### 在 DeepSeek Harness 网页版或桌面版中安装
26
-
27
- 打开 **Plugins / 插件** → **Add plugin / 添加插件**,搜索 `dsh-taskflow`。如果结果中出现仓库 `Oak-liuhj/dsh-taskflow`,选择对应条目安装;尚未检索到时,可使用下方 CLI 按 npm 包名安装。
28
-
29
- 安装后按宿主提示重载对应 profile。插件需要宿主提供模型、工具与 `spawn` 子会话能力;桌面端需提供相同的 Web 渲染层服务。
30
-
31
- ### 使用 `dsh` CLI 安装或更新
32
-
33
- ```sh
34
- dsh plugin --profile web add dsh-taskflow@latest
35
- ```
36
-
37
- 需要固定当前版本时:
38
-
39
- ```sh
40
- dsh plugin --profile web add dsh-taskflow@0.1.1
41
- ```
42
-
43
- 将 `web` 替换为实际 profile 名称。已通过 npm 包名安装的用户,也可在插件详情点击 **重新检查**,选择兼容版本后点击 **更新**,按宿主提示重启或重载。
44
-
45
- ## 使用方法
46
-
47
- 在主会话描述目标,模型会为需要多个步骤、工具或独立执行的请求规划任务;短问答无需建立计划。
48
-
49
- | 入口 | 可以做什么 |
50
- | --- | --- |
51
- | **任务导航** | 查看持久任务树、完成进度与执行状态;在全局计划和当前会话之间切换,筛选、折叠及跳转任务。 |
52
- | **主会话** | 创建计划、调整整体要求,或明确指定在哪个子任务下增补事项。 |
53
- | **子任务会话** | 执行负责的事项;必要时拆分下级任务,完成后向直接父会话报告。 |
54
- | **任务详情** | 查看要求、完成标准和结果;增补、修改、继续执行、取消及调整同级顺序。 |
55
- | **会话左侧工具区** | 按需展示实际工具页面或输出,支持关闭;窄屏可切换对话与工具。 |
56
-
57
- ## ✅ 任务导航 — 一份跨轮保留的清单
58
-
59
- 在会话顶部点击 **任务导航**,或在右侧栏选择对应入口。已有计划时,面板按父子层级展示事项,不额外划分规划、决策或核对分类。
60
-
61
- | 内容 | 解答的问题 |
62
- | --- | --- |
63
- | **完成进度** | 整份计划完成了多少事项。 |
64
- | **全局计划 / 当前会话** | 查看完整任务树,或聚焦当前会话负责的部分。 |
65
- | **事项状态** | 哪些事项待执行、执行中、已完成、暂停、失败或已取消。 |
66
- | **稳定任务 ID** | 在对话中准确引用同一事项,避免同名任务混淆。 |
67
- | **执行会话** | 当前事项在本会话完成,还是交由独立子会话处理。 |
68
- | **任务详情与动态** | 查看要求、完成标准、执行结果及历史变更。 |
69
-
70
- 点击任务标题可聚焦事项或打开对应执行会话;通过折叠和筛选查看较长的计划。
71
-
72
- ## 🧩 子会话协作 — 按任务复杂度拆分
73
-
74
- 例如,在主会话输入:
75
-
76
- ```text
77
- 开发知识库导入模块,先规划任务,复杂且独立的部分分配子会话。
78
- ```
79
-
80
- 模型结合复杂度与独立性选择执行方式:简单或需要共享上下文的事项留在负责会话;适合独立处理的复杂事项创建子会话。子会话可以继续拆分下级,达到深度上限后在负责会话内完成。
81
-
82
- 子会话返回有效的结构化完成结果后,插件更新对应事项,并通知它的直接父会话。任务要求和本次执行 ID 会参与校验,旧结果不能覆盖修改后的要求;父会话可据此继续剩余工作。
83
-
84
- ## ✏️ 增补与修改 — 在原计划上继续推进
85
-
86
- 通过对话明确要调整的任务:
87
-
88
- ```text
89
- 在当前任务下新增一个移动端检查。
90
- 在 T-005 下新增一个 PDF 导入检查。
91
- 修改 T-003 的要求,增加失败重试和错误提示。
92
- 取消 T-006,保留历史。
93
- 继续执行 T-003。
94
- ```
95
-
96
- 默认增补到当前执行或选中的事项;主会话也可指定父任务 ID 或唯一完整名称。未定位当前事项时,新增到根计划;名称存在歧义时需要进一步定位。
97
-
98
- ![任务详情与操作](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/task-detail.png)
99
-
100
- 详情中的 **增补下级事项**、**修改要求** 和 **在会话中继续** 会预填当前会话输入框,发送后由模型执行。**取消任务** 和 **上移 / 下移** 可直接操作。向已完成任务增补下级时,会重新打开该任务及已完成祖先,并保留历史报告。
101
-
102
- ## 🖥️ 工具视图 — 需要操作时再展示
103
-
104
- ![会话左侧工具视图](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop-tool.png)
105
-
106
- 工具区默认关闭。模型实际调用宿主的浏览器、文件、命令或其他插件工具时,可在会话左侧显示本次实际地址或输出;不再需要时可关闭。
107
-
108
- 浏览器自动化、终端和编辑能力由宿主或相应插件提供。默认网页视图使用受限 iframe,部分网站会因 CSP、登录或跨域策略无法嵌入。其他客户端插件可通过 `taskflowViews.register(kind, Component)` 注册专用渲染器,见[架构说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/architecture.md)。
109
-
110
- ## ⚙️ 设置
111
-
112
- 在所用 profile 的插件配置中调整,默认配置见 [cordis.patch.yml](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/cordis.patch.yml)。
113
-
114
- | 配置项 | 默认值 | 说明 |
115
- | --- | --- | --- |
116
- | `autoPlan` | `true` | 引导模型为复杂请求自动规划;关闭后需明确要求创建计划。 |
117
- | `maxDepth` | `2` | 最大委派深度,根会话为 0;可设 0–8。 |
118
- | `maxConcurrent` | `2` | 全树同时执行的委派名额;父任务等待下级时释放名额;可设 1–16。 |
119
- | `maxTasks` | `200` | 每份计划的事项上限;可设 1–2000。 |
120
- | `provider` | `spawn` | 宿主已注册的子会话提供者。 |
121
- | `dataDir` | `${DSH_HOME}/taskflow` | 任务账本目录;未设置环境变量时为 `~/.dsh/taskflow`。 |
122
-
123
- ## 注意事项
124
-
125
- - **兼容性** — 当前版本 **0.1.1**,要求 Node.js **≥24.9.0**;DSH 兼容声明为 `>=0.2.1-rc.3 <1.0.0-0 || >=0.2.2-0 <1.0.0-0 || >=0.2.3-0 <1.0.0-0 || >=0.3.0-0 <1.0.0-0`。宿主需启用 `tools`、`agents`、`sessions`、`systemPrompt`、`subagents` 及相应客户端服务。
126
- - **规划与执行** — 自动规划由模型提示引导,具体拆解和工具选择取决于宿主模型。任务账本独立于 `todo_write`,后续对话通过增量操作维护原计划。
127
- - **数据与恢复** — 同一 `dataDir` 只允许一个活跃写入者。停止宿主后备份整个目录;完整迁移还需备份原生 DSH 会话。中断时仍在执行的任务恢复为暂停,从负责会话继续;卸载插件保留账本数据。
128
- - **验证范围** — 已通过 30 项自动化测试、12 个版本边界检查,以及 `0.2.1-rc.3`、`0.2.2-rc.2`、`0.2.2-rc.3` 的固定响应模型集成测试。完整原生 profile、真实模型与第三方工具仍需验收,详见[验收记录](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/acceptance.md)。
129
- - **语言** — 插件说明提供简体中文和英文;任务导航界面当前以中文显示。
130
-
131
- ## 喜欢它?
132
-
133
- 欢迎在 [GitHub](https://github.com/Oak-liuhj/dsh-taskflow) 点亮 ⭐,或提交 [Issue](https://github.com/Oak-liuhj/dsh-taskflow/issues) / PR。反馈时请附插件与 DSH 版本、profile 类型、复现步骤及脱敏日志。
134
-
135
- 开发与贡献请参阅[开发说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/DEVELOPMENT.md)和[发布说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/PUBLISHING.md)。
136
-
137
- ## 许可证
138
-
139
- 原创代码采用 [Apache-2.0](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/LICENSE),复用的 DeepSeek 界面样式和图标保留 MIT 许可,详见 [NOTICE](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/NOTICE) 与 [DeepSeek-MIT.txt](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/licenses/DeepSeek-MIT.txt)。仓库 PRD 内嵌字体按 OFL-1.1 分发,字体与完整 PRD 不进入 npm 运行包。本项目为社区插件。
1
+ # dsh-taskflow
2
+
3
+ [简体中文](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/README.md) · [English](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/README_en.md)
4
+
5
+ [![npm version](https://img.shields.io/npm/v/dsh-taskflow)](https://www.npmjs.com/package/dsh-taskflow)
6
+ [![GitHub stars](https://img.shields.io/github/stars/Oak-liuhj/dsh-taskflow?style=social)](https://github.com/Oak-liuhj/dsh-taskflow)
7
+
8
+ **面向持久任务计划与多层子会话协作的 [DeepSeek Harness](https://www.deepseek.com/harness/) 智能任务编排插件。**
9
+
10
+ [`dsh-taskflow`](https://www.npmjs.com/package/dsh-taskflow) 将主会话的目标组织为持续保留的任务树,让你看到要做什么、由哪个会话执行,以及哪些事项已经完成。
11
+
12
+ 详细操作见[使用指南](#使用指南),包括任务规划、子会话协作、清单调整、工具视图和中断恢复。
13
+
14
+ - **持久任务清单** — 模型根据请求复杂度规划事项,使用独立任务账本保存;对话换轮、页面刷新和宿主重启不会自动清空计划。
15
+ - **按需递归委派** — 简单事项在负责会话完成,复杂且独立的事项创建子会话;子会话可在深度与并发限制内继续拆分。
16
+ - **完成自动通知** — 子会话返回有效完成结果后,自动勾选对应事项并通知直接父会话,无需主会话再次核对。
17
+ - **对话增量维护** — 在当前执行或选中的任务下增补事项,也可在主会话明确指定目标父任务;支持修改要求、取消和调整顺序。
18
+ - **层级任务导航** — 在右侧按层级查看清单、进度、执行状态和任务详情,跳转到对应执行会话。
19
+ - **按需工具视图** — 浏览器、文件、命令或插件工具实际调用后,可在会话左侧展示对应页面或输出;工具区默认关闭。
20
+
21
+ ![任务导航与会话](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop.png)
22
+
23
+ *截图来自固定响应模型的开发验收环境。*
24
+
25
+ ## 安装 / 更新
26
+
27
+ ### 在 DeepSeek Harness 网页版或桌面版中安装
28
+
29
+ 打开 **Plugins / 插件** → **Add plugin / 添加插件**,搜索 `dsh-taskflow`。如果结果中出现仓库 `Oak-liuhj/dsh-taskflow`,选择对应条目安装;尚未检索到时,可使用下方 CLI 按 npm 包名安装。
30
+
31
+ 安装后按宿主提示重载对应 profile。插件需要宿主提供模型、工具与 `spawn` 子会话能力;桌面端需提供相同的 Web 渲染层服务。
32
+
33
+ ### 使用 `dsh` CLI 安装或更新
34
+
35
+ ```sh
36
+ dsh plugin --profile web add dsh-taskflow@latest
37
+ ```
38
+
39
+ 桌面版将 profile 换成 `desktop`:
40
+
41
+ ```sh
42
+ dsh plugin --profile desktop add dsh-taskflow@latest
43
+ ```
44
+
45
+ 将 `web` 替换为实际 profile 名称。已通过 npm 包名安装的用户,也可在插件详情点击 **重新检查**,选择兼容版本后点击 **更新**,按宿主提示重启或重载。
46
+
47
+ ### 安装指定版本或本地构建
48
+
49
+ 下方使用指南对应 **0.1.3**,包含自动规划、递归子会话、工具插件预览、清单拖宽和推荐回复加载提示。需要固定版本时,执行 `dsh plugin --profile desktop add dsh-taskflow@0.1.3`。安装前可查询 registry 当前版本:
50
+
51
+ ```sh
52
+ npm view dsh-taskflow version dist-tags --json
53
+ ```
54
+
55
+ 已有 0.1.3 修复版 `.tgz` 时,在压缩包所在目录执行 `dsh plugin --profile desktop add ./dsh-taskflow-0.1.3.tgz`;安装后保存工作并重启 DSH。已经安装本地修复包的用户可直接进入下方使用指南。
56
+
57
+ 需要自行打包时,在**包含上述修复的源码目录**执行:
58
+
59
+ ```sh
60
+ npm ci
61
+ npm run build
62
+ npm run check
63
+ npm run check:package
64
+ dsh plugin --profile desktop add ./dist/dsh-taskflow-0.1.3.tgz
65
+ ```
66
+
67
+ 这些命令需要 Node.js ≥24.9.0;`check:package` 会生成并验证 `dist/dsh-taskflow-0.1.3.tgz`。`dsh` 指你当前宿主提供的 CLI;如果终端找不到该命令,请使用宿主 CLI 的实际路径。网页版将 `desktop` 换成 `web`。本地安装不等于发布到 npm,也不会自动更新其他 profile。
68
+
69
+ ## 使用指南
70
+
71
+ 日常使用从主会话开始:描述目标,模型规划并执行持久任务;你通过右侧清单查看进度,通过对话调整要求,通过左侧子会话查看独立事项的执行过程。无需手动创建每个子会话,也无需手写工具调用参数。
72
+
73
+ ### 1. 打开插件入口
74
+
75
+ 确认插件安装并启用于当前 profile,安装或更新后按宿主提示重启、重载。DSH 需要配置可正常对话和调用工具的模型,并具备 `spawn` 子会话能力;文件、终端、浏览器等业务能力由宿主或对应插件提供。
76
+
77
+ 进入主会话,在右上角点击 **清单图标 + 任务**,打开右侧的 **待办任务清单**。安装了任务进度插件时,入口位于其右侧;极窄窗口下可能仅显示图标。
78
+
79
+ 首次打开时清单为空是正常情况。提交需要多步骤处理的目标后,模型才会建立具体事项;短问答通常无需清单。
80
+
81
+ ### 2. 在主会话描述目标
82
+
83
+ 直接说明要完成的事情、范围和完成标准。例如:
84
+
85
+ ```text
86
+ 请为当前项目开发知识库文档导入功能。
87
+ 支持 Markdown 和 TXT,能够校验文件、保存导入结果,并提示失败原因。
88
+ 请先规划持久待办,再按依赖执行;复杂且独立的模块分配子会话,
89
+ 必要时由子会话继续拆分下级。完成后提供实际修改和验证结果。
90
+ ```
91
+
92
+ 模型会根据实际复杂度生成任务树,而不是要求你先列出每一项。条数、层级、标题和执行方式由任务内容决定,不是固定模板。
93
+
94
+ - **需要执行**:正常描述目标即可;信息和工具齐备时,模型应在规划后继续推进。
95
+ - **只需要规划**:在目标后明确补充“本轮只规划,暂不执行”。之后可以通过对话或 **开始** 按钮启动。
96
+ - **已有计划**:继续在原主会话提出新要求,模型增量维护原清单,不因新一轮对话重建。
97
+
98
+ 任务计划以右侧面板保存成功为准。聊天中的普通 Markdown 清单和 `todo_write` 不会代替 Taskflow 的持久账本。
99
+
100
+ ### 3. 查看任务进度并启动执行
101
+
102
+ 计划建立后,右侧展示计划标题、稳定任务 ID、父子层级、状态和完成进度。已有计划时面板会尝试自动打开,也可以随时点击右上角入口打开。
103
+
104
+ ![任务导航与会话](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop.png)
105
+
106
+ | 操作 | 用途 |
107
+ | --- | --- |
108
+ | **全局计划 / 当前会话** | 查看完整任务树,或聚焦当前会话负责的事项。 |
109
+ | **全部事项 / 未完成 / 已完成 / 已取消** | 按状态筛选;为保留层级,匹配事项的祖先也可能显示。 |
110
+ | 事项旁的折叠按钮 | 折叠或展开下级待办。 |
111
+ | 点击事项标题 | 打开对应执行会话,或在负责会话聚焦该事项。 |
112
+ | 事项右侧的详情菜单 | 查看要求、完成标准、父事项、执行说明和实际结果。 |
113
+ | **开始** | 将该事项的执行请求提交给主会话,按依赖和归属启动。 |
114
+ | **继续** | 请求恢复暂停、受阻或失败的事项。 |
115
+ | 面板标题右侧的动态菜单 | 查看任务增补、执行、修改和结果等历史变更。 |
116
+
117
+ 也可以在主会话直接发送:
118
+
119
+ ```text
120
+ 按依赖执行现有计划,沿用原任务 ID,保留已完成结果。
121
+ ```
122
+
123
+ **开始 / 继续** 会直接提交执行请求并显示反馈,不覆盖输入框中已有的草稿。模型需要先读取当前状态;有未运行的委派父任务时,先恢复父任务。提交成功表示请求已接收,不代表事项已经完成。
124
+
125
+ 顶部完成进度按**未取消的根事项**统计。下级事项完成时,如果父事项还有剩余工作,顶部进度不一定立即增加。
126
+
127
+ ### 4. 查看子会话与多层协作
128
+
129
+ 插件根据复杂度和独立性选择执行方式:
130
+
131
+ | 任务情况 | 执行方式 |
132
+ | --- | --- |
133
+ | 简单事项,或必须共享当前上下文 | 在父会话内完成,同时创建只读事项子会话,保存实际过程和结果。 |
134
+ | 适合独立处理的复杂事项 | 委派真实子会话。高复杂度且独立的事项自动使用委派。 |
135
+ | 子会话内还有可独立处理的复杂部分 | 继续拆分下级,并在深度允许时创建孙会话。 |
136
+ | 达到最大委派深度 | 在负责会话内执行,在详情中说明原因。 |
137
+
138
+ 左侧沿用原型的气泡图标、展开箭头、状态圆点、36px 行高、12px 圆角和层级连线;进行中的事项显示旋转图标。点击子会话可查看执行过程,右侧清单仍可切换到全局计划。会话记录创建后,左侧约每 1.2 秒同步。
139
+
140
+ **仅规划时只生成右侧清单,执行到哪项才创建哪项的子会话。** 行内事项在 `taskflow_start` 后创建记录子会话;委派事项获得执行名额后创建实际执行会话,不提前创建所有待办的会话。行内子项挂在对应父事项的记录下;实际操作仍由负责会话完成,记录不额外调用模型、不占用委派名额。旧版提前建立但尚未执行的记录会保留数据,并从插件侧栏隐藏,真正开始后再展示。
141
+
142
+ 每层中高复杂度事项在执行前都由模型判断是否继续拆解;需要则保存下级事项,无需则保存直接执行的依据。已有主清单不会跳过子任务判断,子任务也能继续拆解孙任务。判断按任务版本保存;要求变化后重新判断。低复杂度动作可直接执行,深度与并发限制仍然生效。
143
+
144
+ 左侧会话列表默认收起下级。点击主会话或某条子会话时,打开该会话;如果它有下级,则同时展开,已展开时再次点击会收起。没有下级时只打开会话。箭头可单独切换展开状态,层级连线表示直接父子关系。在子会话任务面板中,可通过路径或“返回父会话”回到上级。点击行内事项会打开其记录子会话;从记录面板增补要求时,自动回到负责会话预填,仍需你确认发送。
145
+
146
+ **执行先后不等于父子关系。** “勘察、设计、实现、接入、整体验证”通常是主目标下的同级阶段,通过前置依赖排序;只有某阶段的组成事项才挂在该阶段下面。中高复杂度、具有独立产物的设计、入口开发或验证事项应优先委派;共享项目文件、读取前序结果不意味着必须使用同一会话。简短操作或必须共享当前对话的事项仍可行内完成。
147
+
148
+ 希望独立执行时,可在主会话明确说明:
149
+
150
+ ```text
151
+ 将设计、入口开发和整体验证规划为主目标下的同级事项,按前置依赖执行。
152
+ 每项使用独立子会话,读取前序任务保存的产物;任务内部再按实际复杂度拆分。
153
+ 已完成的事项保留原记录,不要为了补建会话重复执行。
154
+ ```
155
+
156
+ 历史行内事项会补建真实的记录子会话,显示原任务要求和已保存的执行结果;历史过程仍在原父会话中,补建不会重跑任务或伪造缺失的过程。新执行的行内事项会持续保存实际工具过程。保存失败会在面板显示原因并自动重试,重启或重试不会重复创建同一记录。任务 ID、执行版本和完成结果保持不变。
157
+
158
+ 默认 `maxDepth: 2`,主会话为深度 0,允许子会话和孙会话两层委派;默认 `maxConcurrent: 2`,全树最多两个委派名额同时执行。父任务等待下级时会释放名额,供下级继续执行。
159
+
160
+ 子会话返回有效完成结果后,对应事项自动勾选,并通知**直接父会话**;父会话继续自己的剩余工作,无需主会话再次核对或批准。某个子项完成不代表整个父任务已完成。
161
+
162
+ #### 模型推荐的快捷回复
163
+
164
+ 输入框上方会根据当前会话的最新对话、任务进度和阻塞原因,生成 **3–5 条推荐回复**。点击后将内容填入输入框;已有草稿和引用会保留,确认后由你发送。不会仅因点击推荐就执行任务。
165
+
166
+ 推荐使用当前会话所选模型,属于额外的短请求,预留 4096 tokens(含模型推理),最多等待 60 秒。相同上下文共享缓存,轮询不会重复调用模型;对话或任务状态变化后更新。执行中暂不生成;失败显示连接、模型认证/额度、超时或输出格式等原因及重试入口,不循环重试,也不以固定文案冒充模型推荐。刚安装后若提示后端未加载,请重启 DSH;尚无对话或未选择模型时,需要先正常交流。可通过 `quickReplies: false` 关闭。
167
+
168
+ ### 5. 在对话中增补、修改和取消事项
169
+
170
+ 在主会话说明要调整哪个事项。下面的 ID 仅为示例,请替换成清单里的实际 ID;需要多项调整时,分条说明目标和要求。
171
+
172
+ | 需要做什么 | 对话示例 |
173
+ | --- | --- |
174
+ | 在当前事项下增补 | `在当前任务下新增一个移动端检查。` |
175
+ | 在指定事项下增补 | `在 T-003 下新增一个“导入失败时保留原数据”的验证事项。` |
176
+ | 修改任务要求 | `修改 T-003 的要求:增加重复文件检测,并明确错误提示。` |
177
+ | 调整执行顺序 | `将 T-005 移到同级事项的前面,保留原 ID。` |
178
+ | 取消任务 | `取消 T-006 及其下级,保留历史,不改变其他事项。` |
179
+
180
+ 新增事项默认挂到当前正在执行或选中的事项下;主会话可用任务 ID 或唯一完整名称明确指定父任务。没有定位到当前事项时新增到根计划;名称重复或找不到目标时,需要进一步澄清。子会话只能维护自己负责的子树,跨事项调整请在主会话提出。
181
+
182
+ ![任务详情与操作](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/task-detail.png)
183
+
184
+ 也可以通过界面操作:
185
+
186
+ - 面板底部的 **在当前任务下增补 / 在主任务下增补**,或详情中的 **增补下级事项**:预填输入框,补充内容后发送。
187
+ - **修改要求**:预填输入框,写明新要求后发送。
188
+ - **取消任务**:直接取消该事项及其下级,保留记录,取消不计为完成。
189
+ - **上移 / 下移**:直接调整同级顺序,保留任务 ID 和执行历史;依赖约束仍然生效。
190
+
191
+ 修改要求后版本递增,旧执行结果不能完成新要求;受影响的未完成下级会暂停,之后按新要求继续。向已完成事项增补下级时,该事项及已完成祖先会重新打开,历史报告仍保留。
192
+
193
+ ### 6. 使用工具视图、拖宽和悬浮
194
+
195
+ 工具区默认关闭。模型实际调用浏览器、文件、命令或其他插件工具时,可在**调用工具的会话左侧**展示本次地址或输出;纯文字回复不会触发展开。工具展示需要该会话已经关联 Taskflow 计划。
196
+
197
+ 例如在负责的会话中提出:
198
+
199
+ ```text
200
+ 读取当前模块已经修改的文件,在工具视图展示实际结果,并继续处理剩余工作。
201
+ ```
202
+
203
+ 或者在宿主具备浏览器能力时提出:
204
+
205
+ ```text
206
+ 使用浏览器打开项目的本地页面,检查导入交互,并展示实际页面地址。
207
+ ```
208
+
209
+ 工具由子会话调用时,切换到该子会话查看。视图按会话保存,不会将所有子会话的工具集中显示在主会话。
210
+
211
+ ![会话左侧工具视图](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop-tool.png)
212
+
213
+ | 操作 | 效果 |
214
+ | --- | --- |
215
+ | 拖动工具区右边缘 | 左右调整工具区宽度;分隔条获得焦点后也可用左右方向键。 |
216
+ | 点击 **悬浮工具视图** | 将工具窗口悬浮在 DSH 界面上,对话恢复可用空间。 |
217
+ | 拖动悬浮标题栏 | 移动工具窗口。 |
218
+ | 拖动悬浮窗口右下角 | 调整悬浮窗口大小。 |
219
+ | 点击 **停靠工具视图** | 回到对话左侧。 |
220
+ | 点击 **收起工具视图** | 关闭当前视图;后续工具调用仍可再次展开。 |
221
+ | 窄屏点击 **看对话 / 看工具** | 切换显示区域。 |
222
+
223
+ 布局偏好按会话保存在当前浏览器。工具视图会识别成功调用返回的实际文件路径,并按格式展示:
224
+
225
+ | 产物或操作 | 展示方式 |
226
+ | --- | --- |
227
+ | Markdown(`.md` / `.markdown`) | 自动使用宿主 Markdown 插件,在工具视图内预览,无需选择。 |
228
+ | Excel(`.xls` / `.xlsx` / `.csv` / `.tsv`) | 自动调用宿主文档预览插件,在工具视图内展示表格。 |
229
+ | Word、PPT(`.doc` / `.docx` / `.ppt` / `.pptx`) | 在工具视图内使用宿主对应文档插件预览;渲染服务由宿主提供。 |
230
+ | PDF | 在工具视图内使用宿主 PDF 插件预览。 |
231
+ | 浏览器操作 | 展示真实返回的地址,并自动调用宿主浏览器插件打开该地址。 |
232
+ | 多个文件 | 在工具视图内逐项展示插件预览,无需选择文件;滚动查看其他产物。 |
233
+
234
+ 自动打开仅针对正在查看的任务会话,后台子会话不会抢占当前页面;切换到该子会话后可查看产物。轮询不会重复打开,同地址连续浏览器操作也不会反复新建页面。缺少预览或浏览器插件时显示具体原因,启用后点击对应的打开按钮重试。
235
+
236
+ 文档预览随工具区调宽、悬浮、拖动和滚动;关闭工具区或切换会话时释放本次预览,不关闭用户自行打开的文档。右上角 **图标 + 任务** 点击展开清单,再次点击收起;正在显示其他右侧页面时会切换到任务清单。
237
+
238
+ 子任务的执行过程和关键发现保留在当前子任务会话。模型通过 `taskflow_progress` 保存阶段进展:委派事项直接写入执行子会话,行内事项写入对应记录子会话。实际工具过程自动保存;迟到结果按原工具调用归属记录。最终结果先保存到子任务,再由完成通知告诉直接父任务,过程不逐条通知父任务。
239
+
240
+ 文件来自工具的明确路径字段,不从命令或普通回复猜测。若通过终端脚本生成文档,要求模型随后调用 `taskflow_open_view`,传入 `kind: "editor"` 和真实 `filePath`(多文件用 `files`);不要只在回复里写路径。文档读取、权限检查、渲染和加载错误由宿主预览插件负责,Taskflow 不再直接读取文件。请启用宿主文档预览插件;缺失时显示原因,可在启用后点击“重试打开”。
241
+
242
+ 浏览器自动化、终端和编辑仍由原工具或对应插件执行。宿主浏览器打开的是相同地址;第三方自动化插件的浏览器不一定与它共享登录、页面进度或标签页,打开视图不代表完成操作。识别到的文档统一交给宿主预览;其他工具可展示插件注册的专用视图。
243
+
244
+ 其他客户端插件可通过 `taskflowViews.register(kind, Component)` 注册专用渲染器,见[架构说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/architecture.md)。
245
+
246
+ 右侧清单及左侧子会话中,实际 `running` 的事项显示 **进行中** 和旋转图标;完成后停止旋转并勾选。排队、等待下级、受阻、暂停分别显示自身状态,不会因点击会话就变成执行中。状态约每 1.2 秒同步,系统启用减少动画时保留静态进度图标。
247
+
248
+ 工具视图仅保留紧凑标题栏,隐藏文件路径、重复打开和成功提示,文档预览填满剩余高度;多个文档纵向滚动查看。加载失败仍可重试。右侧待办清单在普通停靠模式默认300px,可拖动左边缘调整宽度并自动记住;窗口变窄时会自适应收窄,恢复后还原偏好。全屏、悬浮和其他插件页面继续使用宿主布局。推荐回复等待当前主任务结束或生成中时显示小型旋转图标和“正在推荐中...”,与推荐内容左边缘对齐;等待期间不会额外并发调用模型,完成或失败后停止。
249
+
250
+ ### 7. 处理受阻、失败和继续执行
251
+
252
+ 任务状态表示当前实际执行情况:
253
+
254
+ | 状态 | 含义与操作 |
255
+ | --- | --- |
256
+ | **待执行** | 尚未启动;可让模型继续计划,或点击开始。 |
257
+ | **排队中** | 等待调度或并发名额,无需重复提交。 |
258
+ | **执行中** | 负责会话正在处理事项。 |
259
+ | **等待下级** | 父任务等待下级结果,之后继续本层工作。 |
260
+ | **已暂停** | 例如宿主重启或要求变更后中断,需要明确继续。 |
261
+ | **受阻** | 缺少文件、访问方式、权限或必要确认;先补齐条件。 |
262
+ | **失败** | 本次执行出错;查看原因,解决后再继续。 |
263
+ | **已完成** | 已保存有效完成结果,通常无需再次执行。 |
264
+ | **已取消** | 已停止该事项及其下级,历史保留。 |
265
+
266
+ 受阻或失败原因直接显示在事项下方,详情中可查看完整结果。排队中和等待下级是正常过程,不应直接当作故障。
267
+
268
+ 处理受阻时,先在主会话补充信息并指定任务 ID,例如:
269
+
270
+ ```text
271
+ T-003 需要的样例文件已放在项目 fixtures/sample.json,请沿用原任务继续验证,
272
+ 保留已完成下级和现有结果,不要重新创建清单。
273
+ ```
274
+
275
+ 提供的路径应实际存在。如果事项尚未恢复,可以点击 **继续**,或发送 `继续执行 T-003。` 查看提交反馈及后续工具调用。外部条件仍未满足时,事项可能再次受阻,不会仅因点击继续就自动完成。
276
+
277
+ 若委派父任务已结束,恢复时会创建新的负责会话;左侧保留历史执行会话及其父子关系。原子项的完成记录不会因重试而清空。
278
+
279
+ ### 8. 跨轮、刷新和重启后继续工作
280
+
281
+ 任务清单保存在独立账本中。后续对话、页面刷新以及切换会话不会清空原计划。需要查看进度时,在原主会话发送:
282
+
283
+ ```text
284
+ 汇报当前计划的进度、阻塞原因和下一步,不重建任务,不重复执行已完成事项。
285
+ ```
286
+
287
+ 重启 DSH 后,重新打开**原主会话**,即可查看已有任务、稳定 ID、层级、完成记录和历史。重启时仍在运行的事项恢复为 **已暂停**,需要明确继续,不会自动重跑。
288
+
289
+ 同一目标的后续调整继续在原主会话处理;完全独立的新目标可以新建主会话。新主会话不会自动继承另一个主会话的计划。完整迁移还需要保留原生 DSH 会话数据,不能只复制任务账本。
290
+
291
+ ### 常见使用问题
292
+
293
+ | 现象 | 检查与处理 |
294
+ | --- | --- |
295
+ | 看不到“任务”入口 | 检查安装和启用的是否为当前 profile,重启加载对应版本;极窄窗口下可能仅显示图标。 |
296
+ | 回答里有清单,右侧却为空 | 检查持久计划是否保存成功。可在主会话要求“将刚才的事项通过 taskflow_plan 保存为持久计划”;普通文本和 `todo_write` 不会写入账本。短问答也可能正常跳过规划。 |
297
+ | 自动规划提示停止重试 | 查看工具错误并补充必要信息,在新一轮要求修正参数后重新规划;模型最多收到两次补建提醒,最多四个规划步骤,不会无限重试。 |
298
+ | 有待办却没有子会话 | 行内事项保存计划后自动建记录,需等待宿主持久化及侧栏刷新;委派父会话未创建时先等待父级。失败原因显示为“子会话记录待同步”。独立委派仍需启动并满足依赖、深度、并发和宿主提供者限制。 |
299
+ | 看不到孙会话 | 确认下级确实被委派并已启动;默认最多两层委派,待办层级不等于会话深度。 |
300
+ | 点击继续后未立即变成执行中 | 先看提交反馈及主会话状态。请求需由模型处理,繁忙时可能排在后续轮次;按错误提示补齐条件。旧版按钮行为需要更新修复版本并重启。 |
301
+ | 工具区没有打开 | 确认正在查看实际调用工具的会话,且该会话已关联 Taskflow 计划;纯文字回复不会触发工具区。 |
302
+ | 面板报 HTTP 404 / 405 | 检查前后端是否加载同一修复版本及当前 profile,重启后重试;仍存在时记录具体接口路径、宿主版本和脱敏日志。 |
303
+ | 重启后任务变成暂停 | 这是中断恢复行为。确认原结果和剩余工作,再点继续,不需要删除重建计划。 |
304
+
305
+ ## ⚙️ 设置
306
+
307
+ 在所用 profile 的插件配置中调整,默认配置见 [cordis.patch.yml](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/cordis.patch.yml)。
308
+
309
+ | 配置项 | 默认值 | 说明 |
310
+ | --- | --- | --- |
311
+ | `autoPlan` | `true` | 检查模型复杂度判断及计划落账;关闭后需明确要求创建计划。 |
312
+ | `quickReplies` | `true` | 在输入框上方展示模型生成的 3–5 条推荐;使用当前模型的额外短请求,并按上下文缓存。 |
313
+ | `maxDepth` | `2` | 最大委派深度,根会话为 0;可设 0–8。 |
314
+ | `maxConcurrent` | `2` | 全树同时执行的委派名额;父任务等待下级时释放名额;可设 1–16。 |
315
+ | `maxTasks` | `200` | 每份计划的事项上限;可设 1–2000。 |
316
+ | `provider` | `spawn` | 宿主已注册的子会话提供者。 |
317
+ | `dataDir` | `${DSH_HOME}/taskflow` | 任务账本目录;未设置环境变量时为 `~/.dsh/taskflow`。 |
318
+
319
+ ## 注意事项
320
+
321
+ - **兼容性** — 当前版本 **0.1.3**,要求 Node.js **≥24.9.0**;DSH 兼容声明为 `>=0.2.1-rc.3 <1.0.0-0 || >=0.2.2-0 <1.0.0-0 || >=0.2.3-0 <1.0.0-0 || >=0.3.0-0 <1.0.0-0`。宿主需启用 `tools`、`agents`、`sessions`、`systemPrompt`、`subagents` 及相应客户端服务。
322
+ - **规划与执行** — 自动规划由模型提示引导,具体拆解和工具选择取决于宿主模型。任务账本独立于 `todo_write`,后续对话通过增量操作维护原计划。
323
+ - **数据与恢复** — 同一 `dataDir` 只允许一个活跃写入者。停止宿主后备份整个目录;完整迁移还需备份原生 DSH 会话。中断时仍在执行的任务恢复为暂停,从负责会话继续;卸载插件保留账本数据。
324
+ - **验证范围** — 当前 0.1.3 修复版已通过 65 项自动化测试、12 个版本边界检查,以及 `0.2.1-rc.3`、`0.2.2-rc.2`、`0.2.2-rc.3` 的固定响应模型集成测试。推荐请求另经当前真实模型验证;完整原生界面、真实模型的任务拆解质量与第三方工具仍需验收,详见[验收记录](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/acceptance.md)。
325
+ - **语言** — 插件说明提供简体中文和英文;任务导航界面当前以中文显示。
326
+
327
+ ## 喜欢它?
328
+
329
+ 欢迎在 [GitHub](https://github.com/Oak-liuhj/dsh-taskflow) 点亮 ⭐,或提交 [Issue](https://github.com/Oak-liuhj/dsh-taskflow/issues) / PR。反馈时请附插件与 DSH 版本、profile 类型、复现步骤及脱敏日志。
330
+
331
+ 开发与贡献请参阅[开发说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/DEVELOPMENT.md)和[发布说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/PUBLISHING.md)。
332
+
333
+ ## 许可证
334
+
335
+ 原创代码采用 [Apache-2.0](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/LICENSE),复用的 DeepSeek 界面样式和图标保留 MIT 许可,详见 [NOTICE](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/NOTICE) 与 [DeepSeek-MIT.txt](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/licenses/DeepSeek-MIT.txt)。仓库 PRD 内嵌字体按 OFL-1.1 分发,字体与完整 PRD 不进入 npm 运行包。本项目为社区插件。