dsh-taskflow 0.0.0-stage → 0.1.0
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 +26 -0
- package/LICENSE +201 -0
- package/NOTICE +17 -0
- package/README.md +169 -3
- package/assets/icon.png +0 -0
- package/assets/icon.svg +1 -0
- package/client.js +312 -0
- package/cordis.patch.yml +8 -0
- package/docs/DETAIL.md +51 -0
- package/docs/DETAIL.zh-CN.md +36 -0
- package/index.js +1 -0
- package/licenses/DeepSeek-MIT.txt +20 -0
- package/licenses/Montserrat-OFL.txt +94 -0
- package/locale/en.json +7 -0
- package/locale/zh.json +7 -0
- package/package.json +133 -6
- package/src/application/task-runtime.mjs +114 -0
- package/src/domain/task-service.mjs +178 -0
- package/src/server/config.mjs +8 -0
- package/src/server/index.mjs +38 -0
- package/src/server/notifications.mjs +19 -0
- package/src/server/prompts.mjs +8 -0
- package/src/server/rpc.mjs +22 -0
- package/src/server/session-context.mjs +17 -0
- package/src/server/tool-views.mjs +14 -0
- package/src/server/tools.mjs +28 -0
- package/src/storage/task-store.mjs +59 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# 更新记录
|
|
2
|
+
|
|
3
|
+
## 0.1.0 — 正式版发布准备(2026-11-16,未发布)
|
|
4
|
+
|
|
5
|
+
- 将插件版本由 0.1.0-alpha.1 升级为 0.1.0,npm 发布标签改为 latest。
|
|
6
|
+
- 宿主要求调整为 `>=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 的交集展示符。
|
|
7
|
+
- 同步 dsh-llm / dsh-tools 的 peer 范围和锁文件,避免服务端依赖仍锁在 rc.2。
|
|
8
|
+
- 兼容旧宿主子会话 API 的嵌套 request 和新宿主的平铺参数,单次调用创建激活,避免兼容回退重复执行。
|
|
9
|
+
- 支持旧宿主的 Cordis 4.0 / Schemastery 3.18 与新宿主的 4.1 / 3.19,避免依赖树冲突。
|
|
10
|
+
- 发布校验覆盖宿主版本边界、正式版标签、文档与依赖一致性;保留固定的开发依赖与历史验收记录。
|
|
11
|
+
- 更新 README、双语插件详情、开发与发布文档,补充宿主管理器的手动检查和更新方式。
|
|
12
|
+
|
|
13
|
+
运行验证以 `docs/acceptance.md` 及本次打包报告为准;包版本升级不代表 npm 或市场已经发布。
|
|
14
|
+
|
|
15
|
+
## 0.1.0-alpha.1 — 发布候选
|
|
16
|
+
|
|
17
|
+
首次预发行准备;npm、GitHub Release 与市场收录尚未执行。
|
|
18
|
+
|
|
19
|
+
- 独立持久任务账本、稳定 ID、增量调整、依赖与版本约束。
|
|
20
|
+
- 按复杂度递归委派,受深度与并发控制;完成后通知直接父会话。
|
|
21
|
+
- 层级导航、详情、筛选、折叠、按需左侧工具视图,复用 PRD 样式。
|
|
22
|
+
- 按领域、调度、存储、宿主适配和客户端组件拆分源码。
|
|
23
|
+
- 收紧 npm 包范围,补充双语详情、PNG 图标、截图声明和许可归属。
|
|
24
|
+
- 增加生成物一致性、发布元数据、实际安装包及 CI 校验。
|
|
25
|
+
|
|
26
|
+
目标宿主仅为 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,169 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
# dsh-taskflow · 智能任务编排
|
|
2
|
+
|
|
3
|
+
为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供持久任务树、按需子会话与自动完成通知。在主会话描述目标,由模型根据任务复杂度规划清单;执行进度与会话保持关联,跨轮对话继续沿用同一份计划。
|
|
4
|
+
|
|
5
|
+
[安装](#安装) · [使用](#使用) · [配置](#配置) · [数据与恢复](#数据与恢复) · [开发](#开发) · [问题反馈](https://github.com/Oak-liuhj/dsh-taskflow/issues)
|
|
6
|
+
|
|
7
|
+
## 功能
|
|
8
|
+
|
|
9
|
+
- **持久任务清单**:独立于 `todo_write` 保存计划、稳定任务 ID、层级、状态与执行历史,对话换轮、页面刷新和宿主重启不会自动清空。
|
|
10
|
+
- **按需递归委派**:简单事项在负责会话执行;复杂且独立的事项通过宿主 `spawn` 创建子会话,可在深度和并发限制内继续拆分为孙子会话。
|
|
11
|
+
- **完成自动通知**:子会话提交有效完成结果后,自动勾选对应事项并通知直接父会话,无需主会话再做结果核对。
|
|
12
|
+
- **增量维护计划**:通过父任务会话增补、修改、取消或调整事项;默认增补到当前执行或选中任务,也可在主会话明确指定目标父任务。
|
|
13
|
+
- **层级任务导航**:右侧直接展示任务树,支持进度、折叠、筛选、详情与执行会话跳转。
|
|
14
|
+
- **按需工具视图**:工具实际调用后,在会话左侧展示网页或输出;支持关闭,窄屏可切换工具与对话。
|
|
15
|
+
|
|
16
|
+

|
|
17
|
+
|
|
18
|
+
截图来自标注“固定响应模型”的开发验收环境,复用 [PRD 原型](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/prototype/dsh-taskflow-prd.html) 样式。原生宿主安装与真实模型验证范围见[版本与验证](#版本与验证)。
|
|
19
|
+
|
|
20
|
+
## 环境与宿主要求
|
|
21
|
+
|
|
22
|
+
| 项目 | 要求 |
|
|
23
|
+
| --- | --- |
|
|
24
|
+
| DSH | 下方完整 SemVer 范围,最低 `0.2.1-rc.3`,排除 `1.0.0` 及其预发行版本 |
|
|
25
|
+
| Node.js | `>=24.9.0` |
|
|
26
|
+
| 服务端服务 | `tools`、`agents`、`sessions`、`systemPrompt`、`subagents` |
|
|
27
|
+
| 子会话提供者 | 已注册的 `spawn`;可通过 `provider` 配置调整 |
|
|
28
|
+
| 客户端 | DSH Web 渲染层的会话、工作区、右侧栏、布局和连接模块 |
|
|
29
|
+
|
|
30
|
+
`package.json` 声明的宿主范围:
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"engines": {
|
|
35
|
+
"node": ">=24.9.0",
|
|
36
|
+
"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"
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
兼容性提示中的 `∩` 表示范围交集,不是 npm SemVer 语法;上面保留各个 `||` 分支,使用可写入包清单的表达式。DSH 的宿主检查启用 `includePrerelease: true`,在该规则下,这些分支的并集等价于 `>=0.2.1-rc.3 <1.0.0-0`。安装判定以实际发布包的 `engines.dsh` 为准,README 不会改变宿主检查结果。
|
|
42
|
+
|
|
43
|
+
DSH 桌面端如使用上述 Web 渲染层,也需要同样的客户端服务。完整桌面安装尚未完成验收。版本范围为安装兼容声明,已运行测试的具体宿主见[版本与验证](#版本与验证)。
|
|
44
|
+
|
|
45
|
+
## 安装
|
|
46
|
+
|
|
47
|
+
### 插件市场
|
|
48
|
+
|
|
49
|
+
市场收录后,搜索 `dsh-taskflow`,核对仓库为 `Oak-liuhj/dsh-taskflow`,选择与当前宿主兼容的正式版本,安装至使用中的 profile。
|
|
50
|
+
|
|
51
|
+
### DSH CLI
|
|
52
|
+
|
|
53
|
+
正式版发布到 npm 后,安装 `latest` 标签对应的版本:
|
|
54
|
+
|
|
55
|
+
```sh
|
|
56
|
+
dsh plugin --profile web add dsh-taskflow@latest
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
需要固定版本时,将 `latest` 替换为已经发布的版本号。也可以安装经过验证的本地发布包,例如将以下路径替换为实际 `.tgz` 文件路径:
|
|
60
|
+
|
|
61
|
+
```sh
|
|
62
|
+
dsh plugin --profile web add /absolute/path/to/dsh-taskflow.tgz
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
将 `web` 替换为实际 profile 名称,按宿主提示重载该 profile。插件使用 `dsh.bundle.patch` 注册服务端入口,并通过 `dsh.client` 加载编译后的界面;安装用户无需在插件目录编译源码。
|
|
66
|
+
|
|
67
|
+
插件依赖 DSH 提供模型、会话和执行工具。浏览器、终端、编辑器等操作能力需要由宿主或相应插件提供。
|
|
68
|
+
|
|
69
|
+
## 检查与更新
|
|
70
|
+
|
|
71
|
+
通过 npm 包名安装后,DSH 插件管理器可查询注册表的新版本。打开插件详情,点击“重新检查”,选择兼容版本并点击“更新”;宿主会再次校验版本要求,并在需要时提示重启。正式版更新默认优先推荐兼容、未弃用的稳定版本,预发行版需展开相应选项。
|
|
72
|
+
|
|
73
|
+
也可使用 DSH CLI 更新:
|
|
74
|
+
|
|
75
|
+
```sh
|
|
76
|
+
dsh plugin --profile web add dsh-taskflow@latest
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
将 `latest` 替换为已发布的确切版本号可固定版本。Git、本地目录和 `.tgz` 安装不走宿主的 npm 注册表版本检测,应手动安装新的来源。Taskflow 使用宿主更新机制,无需额外更新服务。
|
|
80
|
+
|
|
81
|
+
## 使用
|
|
82
|
+
|
|
83
|
+
在主会话说明目标,模型根据复杂度创建计划:
|
|
84
|
+
|
|
85
|
+
```text
|
|
86
|
+
开发知识库导入模块,先规划任务,复杂且独立的部分分配子会话。
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
后续通过自然语言维护同一份任务树:
|
|
90
|
+
|
|
91
|
+
```text
|
|
92
|
+
在当前任务下新增一个移动端检查。
|
|
93
|
+
在 T-005 下新增一个 PDF 导入检查。
|
|
94
|
+
修改 T-003 的要求,增加失败重试和错误提示。
|
|
95
|
+
取消 T-006,保留历史。
|
|
96
|
+
继续执行 T-003。
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
首次规划通过 `taskflow_plan` 创建计划,后续对话只做增量变更。默认在当前执行或选中事项下增补;未定位到当前事项时,新增到根计划。主会话可指定父任务 ID 或唯一完整名称,名称存在歧义时需要进一步定位。
|
|
100
|
+
|
|
101
|
+
复杂事项创建执行子会话,简单事项可在负责会话内完成。子会话结束时,插件校验完成结果、任务版本和本次执行 ID;有效结果立即更新状态并通知直接父会话。修改要求后,旧执行结果不能覆盖新要求。
|
|
102
|
+
|
|
103
|
+
在右侧任务导航中可查看层级和进度、打开详情、跳转执行会话。增补、修改和继续操作会预填会话输入框,发送后由模型执行;取消与同级排序可直接在界面操作。向已完成事项增补下级会重新打开该事项及已完成祖先,同时保留历史报告。
|
|
104
|
+
|
|
105
|
+
## 配置
|
|
106
|
+
|
|
107
|
+
在 DSH 对应 profile 的插件配置中调整。安装默认值见 [cordis.patch.yml](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/cordis.patch.yml)。
|
|
108
|
+
|
|
109
|
+
| 配置项 | 默认值 | 说明 |
|
|
110
|
+
| --- | --- | --- |
|
|
111
|
+
| `dataDir` | `${DSH_HOME}/taskflow`;未设环境变量时为 `~/.dsh/taskflow` | 持久任务账本目录 |
|
|
112
|
+
| `maxDepth` | `2` | 最大委派深度;根会话为 0,达到上限后转为负责会话内执行;可设 0–8 |
|
|
113
|
+
| `maxConcurrent` | `2` | 调度器同时执行的委派名额;父任务等待下级时释放名额;可设 1–16 |
|
|
114
|
+
| `maxTasks` | `200` | 每份计划的事项上限;可设 1–2000 |
|
|
115
|
+
| `autoPlan` | `true` | 引导模型为复杂任务自动规划;设为 `false` 后需明确要求创建计划 |
|
|
116
|
+
| `provider` | `spawn` | 宿主已注册的子会话提供者名称 |
|
|
117
|
+
|
|
118
|
+
`autoPlan` 通过模型提示引导规划,实际拆解与工具选择受模型能力和用户指令影响。
|
|
119
|
+
|
|
120
|
+
## 数据与恢复
|
|
121
|
+
|
|
122
|
+
任务账本独立存储,原生对话记录由 DSH 管理。同一个 `dataDir` 只允许一个活跃宿主写入。
|
|
123
|
+
|
|
124
|
+
- **备份**:停止宿主后备份整个 `dataDir`,保留计划、完成报告与待送通知。
|
|
125
|
+
- **迁移**:除任务账本外,同时备份和恢复对应的 DSH 原生会话数据,以保留会话跳转关系。
|
|
126
|
+
- **中断恢复**:恢复已有计划;中断时仍在执行的事项转为暂停,需要从负责会话继续。
|
|
127
|
+
- **卸载**:保留任务数据;需要清理时,先停止宿主并完成备份,再手动删除对应账本目录。
|
|
128
|
+
|
|
129
|
+
## 工具视图与限制
|
|
130
|
+
|
|
131
|
+
工具由宿主执行,Taskflow 根据实际工具调用在会话左侧展示地址或输出。默认网页视图采用受限 iframe;网站的 CSP、登录和跨域策略可能阻止嵌入。需要交互控制时,应使用宿主浏览器工具提供的能力。
|
|
132
|
+
|
|
133
|
+
右侧任务面板通过宿主槽位注册;左侧工具区通过隔离 DOM portal 挂载,会话切换和卸载时清理。该区域依赖宿主页面结构,升级宿主后需要复核。其他客户端插件可通过 `taskflowViews.register(kind, Component)` 注册专用渲染器,见[架构说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/architecture.md)。
|
|
134
|
+
|
|
135
|
+
## 版本与验证
|
|
136
|
+
|
|
137
|
+
当前版本为 **0.1.0**,npm 正式版发布标签为 `latest`。源码、锁文件、运行依赖范围与发布校验使用同一宿主兼容声明。npm 发布和插件市场收录状态以各渠道实际结果为准;本地构建成功不代表已经对外发布。
|
|
138
|
+
|
|
139
|
+
本版验证包括 **30 项自动化测试**,覆盖领域规则、持久化、调度、客户端、正式版元数据与真实 AgentLoop 的固定响应模型集成。最终 `.tgz` 在独立目录生产安装;宿主矩阵覆盖 **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),包哈希与矩阵结果由发布产物中的报告绑定。
|
|
140
|
+
|
|
141
|
+
上述结果不代表完整目标版本范围均已运行验证。正式版发布前,仍需完成目标宿主的独立 profile 安装、原生界面、真实模型规划与第三方工具验收;截图中的开发环境不能替代这些检查。
|
|
142
|
+
|
|
143
|
+
## 开发
|
|
144
|
+
|
|
145
|
+
```sh
|
|
146
|
+
git clone https://github.com/Oak-liuhj/dsh-taskflow.git
|
|
147
|
+
cd dsh-taskflow
|
|
148
|
+
npm ci --ignore-scripts
|
|
149
|
+
npm run build
|
|
150
|
+
npm run check
|
|
151
|
+
npm run check:package
|
|
152
|
+
npm run dev
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
开发预览地址为 `http://127.0.0.1:4173`,`/prototype` 可查看原型对照。设置 `TASKFLOW_DEV_PORT` 可修改端口。预览使用真实 DSH AgentLoop 与固定响应模型,数据存于 `.local/dev`。
|
|
156
|
+
|
|
157
|
+
服务端按 `domain`、`application`、`storage`、`server` 分层,界面位于 `src/client`。npm 包仅包含生产入口、运行模块、必要资源和用户文档;完整源码、原型与测试保留在 GitHub。
|
|
158
|
+
|
|
159
|
+
[开发说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/DEVELOPMENT.md) · [发布说明](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/PUBLISHING.md) · [更新记录](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/CHANGELOG.md)
|
|
160
|
+
|
|
161
|
+
## 问题反馈
|
|
162
|
+
|
|
163
|
+
请通过 [GitHub Issues](https://github.com/Oak-liuhj/dsh-taskflow/issues) 提供插件版本、DSH 版本、profile 类型、复现步骤及脱敏后的日志。涉及工具显示时,请同时说明工具提供者与页面表现。请勿提交 API 密钥、认证令牌或完整私密会话。
|
|
164
|
+
|
|
165
|
+
## 许可
|
|
166
|
+
|
|
167
|
+
原创代码采用 [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)。仓库原型内嵌的 Montserrat 字体按 OFL-1.1 分发,完整原型与字体不进入 npm 运行包。
|
|
168
|
+
|
|
169
|
+
本项目为社区插件。
|
package/assets/icon.png
ADDED
|
Binary file
|
package/assets/icon.svg
ADDED
|
@@ -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>
|