dsh-taskflow 0.0.0-stage → 0.1.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/CHANGELOG.md ADDED
@@ -0,0 +1,35 @@
1
+ # 更新记录
2
+
3
+ ## 0.1.1 — 插件信息修正(2026-11-16)
4
+
5
+ - 同步已合并的本地与远端代码,保留两边提交历史。
6
+ - 按 dsh-context 的说明结构整理安装、使用入口、功能图解、设置和注意事项。
7
+ - 新增英文 README,中英文插件详情分别直接读取对应 README,并使用包含包名的展示名称。
8
+ - 同步包版本、锁文件、README、双语详情和发布说明,修正旧的未发布状态。
9
+ - 开发预览从包清单读取版本号,避免继续显示 alpha 版本。
10
+ - 保留正式版的 DSH 兼容范围、旧宿主子会话 API 修复和现有任务数据格式。
11
+
12
+ ## 0.1.0 — 正式版(2026-11-16)
13
+
14
+ - 将插件版本由 0.1.0-alpha.1 升级为 0.1.0,npm 发布标签改为 latest。
15
+ - 宿主要求调整为 `>=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 的交集展示符。
16
+ - 同步 dsh-llm / dsh-tools 的 peer 范围和锁文件,避免服务端依赖仍锁在 rc.2。
17
+ - 兼容旧宿主子会话 API 的嵌套 request 和新宿主的平铺参数,单次调用创建激活,避免兼容回退重复执行。
18
+ - 支持旧宿主的 Cordis 4.0 / Schemastery 3.18 与新宿主的 4.1 / 3.19,避免依赖树冲突。
19
+ - 发布校验覆盖宿主版本边界、正式版标签、文档与依赖一致性;保留固定的开发依赖与历史验收记录。
20
+ - 更新 README、双语插件详情、开发与发布文档,补充宿主管理器的手动检查和更新方式。
21
+
22
+ 运行验证以 `docs/acceptance.md` 及本次打包报告为准;包版本升级不代表 npm 或市场已经发布。
23
+
24
+ ## 0.1.0-alpha.1 — 发布候选
25
+
26
+ 首次预发行准备;npm、GitHub Release 与市场收录尚未执行。
27
+
28
+ - 独立持久任务账本、稳定 ID、增量调整、依赖与版本约束。
29
+ - 按复杂度递归委派,受深度与并发控制;完成后通知直接父会话。
30
+ - 层级导航、详情、筛选、折叠、按需左侧工具视图,复用 PRD 样式。
31
+ - 按领域、调度、存储、宿主适配和客户端组件拆分源码。
32
+ - 收紧 npm 包范围,补充双语详情、PNG 图标、截图声明和许可归属。
33
+ - 增加生成物一致性、发布元数据、实际安装包及 CI 校验。
34
+
35
+ 目标宿主仅为 DSH 0.2.2-rc.2。固定响应模型 AgentLoop 与客户端测试已覆盖主要流程;完整 profile、真实模型及第三方工具仍需验收。
package/LICENSE ADDED
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
package/NOTICE ADDED
@@ -0,0 +1,17 @@
1
+ dsh-taskflow
2
+ Copyright 2026 Oak-liuhj
3
+
4
+ Original project code is licensed under Apache License 2.0; see LICENSE.
5
+
6
+ The client UI styles, SVG icon paths and Fish mark are derived from the
7
+ DeepSeek UI reference preserved in docs/prototype/dsh-taskflow-prd.html.
8
+ Copyright (c) 2026 DeepSeek. These portions remain under the MIT License;
9
+ the complete notice is in licenses/DeepSeek-MIT.txt and the client bundle.
10
+
11
+ The repository-only prototype embeds Montserrat font software.
12
+ Copyright 2024 The Montserrat.Git Project Authors
13
+ https://github.com/JulietaUla/Montserrat.git
14
+ Licensed under SIL Open Font License 1.1; see licenses/Montserrat-OFL.txt.
15
+ The embedded font and prototype are excluded from the npm runtime package.
16
+
17
+ This is a community plugin. Attribution does not imply endorsement.
package/README.md CHANGED
@@ -1,3 +1,139 @@
1
- # Temporary Holding Version
1
+ # dsh-taskflow
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
+ [简体中文](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 运行包。本项目为社区插件。
package/README_en.md ADDED
@@ -0,0 +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
+ [![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
+ **A [DeepSeek Harness](https://www.deepseek.com/harness/) plugin for persistent task planning and nested session orchestration.**
9
+
10
+ [`dsh-taskflow`](https://www.npmjs.com/package/dsh-taskflow) turns a goal in the main conversation into a lasting task tree, showing what needs doing, which session owns each task, and what has finished.
11
+
12
+ - **Persistent checklist** — The model plans tasks according to request complexity. A separate ledger preserves the plan across conversation turns, page refreshes and host restarts.
13
+ - **Selective nested delegation** — Simple tasks stay in their owner session. Independent complex tasks can spawn children, which may delegate further within depth and concurrency limits.
14
+ - **Completion notifications** — Valid child results check off the task and notify its direct parent, without adding a parent review step.
15
+ - **Incremental conversation updates** — Add work beneath the current task or explicitly name a parent in the main conversation; edit requirements, cancel work and reorder siblings.
16
+ - **Hierarchical task navigation** — Inspect the task tree, progress, status and details in the right sidebar, then jump to the execution session.
17
+ - **On-demand tool views** — Actual host tool calls can show a page or output to the left of the conversation. The tool area starts closed.
18
+
19
+ ![Task navigation and conversation](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop.png)
20
+
21
+ *Screenshots show the development acceptance shell with a deterministic model.*
22
+
23
+ ## Install / Update
24
+
25
+ ### In DeepSeek Harness Web or Desktop
26
+
27
+ Open **Plugins** → **Add plugin** and search for `dsh-taskflow`. If a result points to `Oak-liuhj/dsh-taskflow`, install that entry. If it is not listed, use the CLI below to install by npm package name.
28
+
29
+ Reload the profile when the host requests it. The plugin uses the host's model, tools and `spawn` subagent provider. Desktop installations need the same Web renderer services.
30
+
31
+ ### Using the `dsh` CLI
32
+
33
+ ```sh
34
+ dsh plugin --profile web add dsh-taskflow@latest
35
+ ```
36
+
37
+ To pin the current version:
38
+
39
+ ```sh
40
+ dsh plugin --profile web add dsh-taskflow@0.1.1
41
+ ```
42
+
43
+ Replace `web` with your profile name. For an npm-based installation, you can also recheck versions in the plugin details, choose a compatible update and follow the host's reload or restart instructions.
44
+
45
+ ## Usage
46
+
47
+ Describe your goal in the main conversation. The model plans requests that need several steps, tool operations or independent execution; short questions do not need a plan.
48
+
49
+ | Entry point | What you can do |
50
+ | --- | --- |
51
+ | **Task navigation** | Inspect progress and status; switch between the global plan and current session, filter, collapse and navigate tasks. |
52
+ | **Main conversation** | Create a plan, adjust the overall requirements or identify the parent task for new work. |
53
+ | **Child conversation** | Complete assigned work, create subtasks when needed and report to the direct parent. |
54
+ | **Task details** | Read requirements, completion criteria and results; add, edit, resume, cancel and reorder tasks. |
55
+ | **Tool area to the left** | Show actual tool pages or output when needed. Close it or switch between tools and chat on narrow screens. |
56
+
57
+ ## ✅ Task navigation — one checklist across turns
58
+
59
+ Click **任务导航 / Task navigation** in the session header, or select its right-sidebar entry. Tasks appear directly in their parent-child hierarchy, without extra planning or review categories.
60
+
61
+ | Item | What it tells you |
62
+ | --- | --- |
63
+ | **Progress** | How much of the plan is complete. |
64
+ | **Global plan / Current session** | The whole tree or the part owned by the current session. |
65
+ | **Task status** | Pending, running, completed, paused, failed or cancelled work. |
66
+ | **Stable task ID** | A precise reference to the same task in later messages. |
67
+ | **Execution session** | Whether work stays in the owner session or runs in a child. |
68
+ | **Details and activity** | Requirements, completion criteria, results and change history. |
69
+
70
+ Click a task title to focus it or open its execution session. Collapse branches and filter longer plans.
71
+
72
+ ## 🧩 Child sessions — delegate according to complexity
73
+
74
+ For example, ask the main conversation:
75
+
76
+ ```text
77
+ Build a knowledge-base import module. Plan the work first and delegate independent complex parts to child sessions.
78
+ ```
79
+
80
+ The model considers complexity and independence. Simple tasks or work requiring shared context stay in the owner session; suitable complex work can spawn a child. Children may split their work again, with inline execution used at the depth limit.
81
+
82
+ A valid structured child result updates the task and notifies its direct parent. Requirement versions and execution IDs are checked so old results cannot overwrite changed requirements. The parent can then continue its remaining work.
83
+
84
+ ## ✏️ Add and edit — keep working on the same plan
85
+
86
+ Identify the task to change in your message:
87
+
88
+ ```text
89
+ Add a mobile check under the current task.
90
+ Add a PDF import check under T-005.
91
+ Update T-003 to require retries and clear error messages.
92
+ Cancel T-006 and retain its history.
93
+ Continue T-003.
94
+ ```
95
+
96
+ New work defaults to the currently running or selected task. The main conversation may name a parent ID or unique full title. If no current task is identified, work attaches to the root plan; ambiguous names need clarification.
97
+
98
+ ![Task details and actions](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/task-detail.png)
99
+
100
+ **Add child**, **Edit requirements** and **Continue in conversation** prefill the conversation input; send the message for the model to act. Cancellation and sibling reordering are direct interface actions. Adding children to completed work reopens the task and completed ancestors while preserving historical reports.
101
+
102
+ ## 🖥️ Tool views — show them when needed
103
+
104
+ ![Tool view to the left of the conversation](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop-tool.png)
105
+
106
+ The tool area starts closed. Actual browser, file, command or plugin tool calls can show their real address or output to the left of the conversation. Close the view when finished.
107
+
108
+ Execution remains with host tools or their plugins. The default page view is a restricted iframe; CSP, authentication or cross-origin rules may prevent embedding. Other client plugins can register dedicated renderers through `taskflowViews.register(kind, Component)`; see the [architecture guide](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/architecture.md).
109
+
110
+ ## ⚙️ Settings
111
+
112
+ Adjust the plugin configuration in the profile you use. Defaults are in [cordis.patch.yml](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/cordis.patch.yml).
113
+
114
+ | Setting | Default | Meaning |
115
+ | --- | --- | --- |
116
+ | `autoPlan` | `true` | Prompt the model to plan complex requests automatically; when disabled, request a plan explicitly. |
117
+ | `maxDepth` | `2` | Maximum delegation depth, with the root at 0; range 0–8. |
118
+ | `maxConcurrent` | `2` | Active delegation slots across the tree. Parents release their slot while waiting for children; range 1–16. |
119
+ | `maxTasks` | `200` | Task limit per plan; range 1–2000. |
120
+ | `provider` | `spawn` | Name of a registered host subagent provider. |
121
+ | `dataDir` | `${DSH_HOME}/taskflow` | Ledger directory; falls back to `~/.dsh/taskflow` when the environment variable is unset. |
122
+
123
+ ## Notes
124
+
125
+ - **Compatibility** — Current version **0.1.1**, Node.js **≥24.9.0**. The declared DSH range is `>=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`. Enable `tools`, `agents`, `sessions`, `systemPrompt`, `subagents` and the corresponding client services.
126
+ - **Planning and execution** — Automatic planning is model-guided. Task decomposition and tool choices depend on the host model. The ledger is independent of `todo_write`; later messages update the same plan incrementally.
127
+ - **Data and recovery** — Use one active writer per `dataDir`. Back up the whole directory while the host is stopped, together with native DSH sessions for a complete migration. Interrupted tasks recover as paused and can be resumed in their owner conversation. Uninstalling the plugin preserves the ledger.
128
+ - **Validation** — 30 automated tests, 12 version boundaries and deterministic-model integrations with exact hosts `0.2.1-rc.3`, `0.2.2-rc.2` and `0.2.2-rc.3` have passed. Full native profiles, production models and third-party tools still need acceptance; see the [acceptance record](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/acceptance.md).
129
+ - **Language** — Plugin documentation is available in Simplified Chinese and English. The task navigation interface currently uses Chinese labels.
130
+
131
+ ## Like it?
132
+
133
+ Star the project on [GitHub](https://github.com/Oak-liuhj/dsh-taskflow), or open an [Issue](https://github.com/Oak-liuhj/dsh-taskflow/issues) / PR. Include plugin and DSH versions, profile type, reproduction steps and redacted logs when reporting a problem.
134
+
135
+ See the [development guide](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/DEVELOPMENT.md) and [publishing guide](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/PUBLISHING.md) for contributions.
136
+
137
+ ## License
138
+
139
+ Original code is [Apache-2.0](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/LICENSE). Imported DeepSeek styles and icons retain their MIT license; see [NOTICE](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/NOTICE) and [DeepSeek-MIT.txt](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/licenses/DeepSeek-MIT.txt). The source PRD embeds an OFL-1.1 font; the font and complete PRD are excluded from the npm runtime package. This is a community plugin.
Binary file
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="8" fill="#4d6bfe"/><g fill="none" stroke="white" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10 8v15h6M10 14h6"/><rect x="17" y="10" width="7" height="7" rx="2"/><path d="m18 23 2 2 4-5"/></g></svg>