dsh-taskflow 0.1.1 → 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/CHANGELOG.md +43 -35
- package/README.md +139 -139
- package/README_en.md +139 -139
- package/client.js +24 -24
- package/docs/DETAIL.md +1 -1
- package/docs/DETAIL.zh-CN.md +1 -1
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +134 -134
- package/src/server/rpc.mjs +24 -22
package/CHANGELOG.md
CHANGED
|
@@ -1,35 +1,43 @@
|
|
|
1
|
-
# 更新记录
|
|
2
|
-
|
|
3
|
-
## 0.1.
|
|
4
|
-
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
1
|
+
# 更新记录
|
|
2
|
+
|
|
3
|
+
## 0.1.2 — 任务入口与 RPC 修复(2026-11-16)
|
|
4
|
+
|
|
5
|
+
- 会话右上角入口改为图标 +「任务」,面板名称统一为「待办任务清单」。
|
|
6
|
+
- 使用独立 `/taskflow` RPC 通道,避免抢占宿主 Gateway 的共享 `/api` interceptor 导致 HTTP 404。
|
|
7
|
+
- 保留宿主认证和所有者校验,拒绝未知 RPC 方法,保持任务数据格式不变。
|
|
8
|
+
- 新增真实宿主 HTTP 回归,覆盖旧冲突、读写、鉴权、Gateway 共存和卸载重载。
|
|
9
|
+
- 客户端构建显式解析本地源码,支持受限目录中的可重复构建。
|
|
10
|
+
|
|
11
|
+
## 0.1.1 — 插件信息修正(2026-11-16)
|
|
12
|
+
|
|
13
|
+
- 同步已合并的本地与远端代码,保留两边提交历史。
|
|
14
|
+
- 按 dsh-context 的说明结构整理安装、使用入口、功能图解、设置和注意事项。
|
|
15
|
+
- 新增英文 README,中英文插件详情分别直接读取对应 README,并使用包含包名的展示名称。
|
|
16
|
+
- 同步包版本、锁文件、README、双语详情和发布说明,修正旧的未发布状态。
|
|
17
|
+
- 开发预览从包清单读取版本号,避免继续显示 alpha 版本。
|
|
18
|
+
- 保留正式版的 DSH 兼容范围、旧宿主子会话 API 修复和现有任务数据格式。
|
|
19
|
+
|
|
20
|
+
## 0.1.0 — 正式版(2026-11-16)
|
|
21
|
+
|
|
22
|
+
- 将插件版本由 0.1.0-alpha.1 升级为 0.1.0,npm 发布标签改为 latest。
|
|
23
|
+
- 宿主要求调整为 `>=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`,移除非 SemVer 的交集展示符。
|
|
24
|
+
- 同步 dsh-llm / dsh-tools 的 peer 范围和锁文件,避免服务端依赖仍锁在 rc.2。
|
|
25
|
+
- 兼容旧宿主子会话 API 的嵌套 request 和新宿主的平铺参数,单次调用创建激活,避免兼容回退重复执行。
|
|
26
|
+
- 支持旧宿主的 Cordis 4.0 / Schemastery 3.18 与新宿主的 4.1 / 3.19,避免依赖树冲突。
|
|
27
|
+
- 发布校验覆盖宿主版本边界、正式版标签、文档与依赖一致性;保留固定的开发依赖与历史验收记录。
|
|
28
|
+
- 更新 README、双语插件详情、开发与发布文档,补充宿主管理器的手动检查和更新方式。
|
|
29
|
+
|
|
30
|
+
运行验证以 `docs/acceptance.md` 及本次打包报告为准;包版本升级不代表 npm 或市场已经发布。
|
|
31
|
+
|
|
32
|
+
## 0.1.0-alpha.1 — 发布候选
|
|
33
|
+
|
|
34
|
+
首次预发行准备;npm、GitHub Release 与市场收录尚未执行。
|
|
35
|
+
|
|
36
|
+
- 独立持久任务账本、稳定 ID、增量调整、依赖与版本约束。
|
|
37
|
+
- 按复杂度递归委派,受深度与并发控制;完成后通知直接父会话。
|
|
38
|
+
- 层级导航、详情、筛选、折叠、按需左侧工具视图,复用 PRD 样式。
|
|
39
|
+
- 按领域、调度、存储、宿主适配和客户端组件拆分源码。
|
|
40
|
+
- 收紧 npm 包范围,补充双语详情、PNG 图标、截图声明和许可归属。
|
|
41
|
+
- 增加生成物一致性、发布元数据、实际安装包及 CI 校验。
|
|
42
|
+
|
|
43
|
+
目标宿主仅为 DSH 0.2.2-rc.2。固定响应模型 AgentLoop 与客户端测试已覆盖主要流程;完整 profile、真实模型及第三方工具仍需验收。
|
package/README.md
CHANGED
|
@@ -1,139 +1,139 @@
|
|
|
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
|
-
[](https://www.npmjs.com/package/dsh-taskflow)
|
|
6
|
-
[](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
|
-
*截图来自固定响应模型的开发验收环境。*
|
|
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.
|
|
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
|
-

|
|
99
|
-
|
|
100
|
-
详情中的 **增补下级事项**、**修改要求** 和 **在会话中继续** 会预填当前会话输入框,发送后由模型执行。**取消任务** 和 **上移 / 下移** 可直接操作。向已完成任务增补下级时,会重新打开该任务及已完成祖先,并保留历史报告。
|
|
101
|
-
|
|
102
|
-
## 🖥️ 工具视图 — 需要操作时再展示
|
|
103
|
-
|
|
104
|
-

|
|
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.
|
|
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
|
+
[](https://www.npmjs.com/package/dsh-taskflow)
|
|
6
|
+
[](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
|
+
*截图来自固定响应模型的开发验收环境。*
|
|
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.2
|
|
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
|
+

|
|
99
|
+
|
|
100
|
+
详情中的 **增补下级事项**、**修改要求** 和 **在会话中继续** 会预填当前会话输入框,发送后由模型执行。**取消任务** 和 **上移 / 下移** 可直接操作。向已完成任务增补下级时,会重新打开该任务及已完成祖先,并保留历史报告。
|
|
101
|
+
|
|
102
|
+
## 🖥️ 工具视图 — 需要操作时再展示
|
|
103
|
+
|
|
104
|
+

|
|
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.2**,要求 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 运行包。本项目为社区插件。
|