dsh-taskflow 0.1.3 → 0.1.4

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 CHANGED
@@ -1,5 +1,13 @@
1
1
  # 更新记录
2
2
 
3
+ ## 0.1.4 — 子任务执行记录可读性修复(2026-11-18)
4
+
5
+ - 子任务记录默认展开显示正文,区分任务要求、执行状态、阶段进展、模型调用、模型输出、工具调用、工具结果和最终结果,支持 Markdown、表格与代码片段。
6
+ - 兼容旧版已保存的 Taskflow 记录,无需重跑任务或改写历史;其他插件的上下文继续使用宿主原生展示。
7
+ - 行内执行记录自动保存实际模型调用、公开输出、工具参数和返回结果;存在原始元数据时展示模型、工具、耗时与失败状态,不记录模型私有推理。
8
+ - 强化阶段汇报要求:说明步骤目标、实际操作、关键发现或验证结果及下一步;最终结果仍只通知直接父任务。
9
+ - 详细回归发现并修复真实请求头不带步骤编号的问题:从宿主步骤事件读取编号,缺失时使用无编号提示,避免出现“第 undefined 步”。新增实际打包客户端启停、延迟挂载、真实事件落盘冷恢复及旧版本迟到结果隔离测试。
10
+
3
11
  ## 0.1.3 — 自动规划、递归会话与桌面交互修复(2026-11-17)
4
12
 
5
13
  - 修复真实宿主右栏pointer-events:none导致自定义左边缘无法命中;拖动条显式恢复事件并提升到停靠内容之上。主任务繁忙时不再隐藏推荐区域,改为显示旋转等待提示,仍等待主任务结束后生成推荐。
package/README.md CHANGED
@@ -20,7 +20,7 @@
20
20
 
21
21
  ![任务导航与会话](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop.png)
22
22
 
23
- *截图来自固定响应模型的开发验收环境。*
23
+ *历史开发验收截图(0.1.0-alpha.1),使用固定响应模型,用于说明布局;不是当前版本的完整宿主截图。当前版本功能与验证范围见下方指南及[验收记录](docs/acceptance.md)。*
24
24
 
25
25
  ## 安装 / 更新
26
26
 
@@ -30,13 +30,19 @@
30
30
 
31
31
  安装后按宿主提示重载对应 profile。插件需要宿主提供模型、工具与 `spawn` 子会话能力;桌面端需提供相同的 Web 渲染层服务。
32
32
 
33
+ ### 通过 dsh-market 发现
34
+
35
+ [dsh-market](https://github.com/dsh-market/dsh-market) 从 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 目录同步插件。收录申请、维护者合并和市场刷新是三个阶段,提交 PR 不代表已经可搜索;[投稿记录](marketplace/SUBMISSION.md) 单独记录状态。
36
+
37
+ 目录收录并刷新后,在 **插件 → 插件市场** 搜索 `dsh-taskflow`,确认仓库为 `Oak-liuhj/dsh-taskflow`、npm 包名为 `dsh-taskflow`,并检查显示的 DSH 兼容要求后安装。若宿主使用 **发现 → 索引来源**,可添加市场提供的 `https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json`。搜索暂不可用时,已发布的 npm 包仍可直接安装。
38
+
33
39
  ### 使用 `dsh` CLI 安装或更新
34
40
 
35
41
  ```sh
36
42
  dsh plugin --profile web add dsh-taskflow@latest
37
43
  ```
38
44
 
39
- 桌面版将 profile 换成 `desktop`:
45
+ 官方桌面版优先使用应用内插件管理器。只有确认当前桌面宿主实际使用 `desktop` profile 时,才使用以下命令:
40
46
 
41
47
  ```sh
42
48
  dsh plugin --profile desktop add dsh-taskflow@latest
@@ -46,13 +52,13 @@ dsh plugin --profile desktop add dsh-taskflow@latest
46
52
 
47
53
  ### 安装指定版本或本地构建
48
54
 
49
- 下方使用指南对应 **0.1.3**,包含自动规划、递归子会话、工具插件预览、清单拖宽和推荐回复加载提示。需要固定版本时,执行 `dsh plugin --profile desktop add dsh-taskflow@0.1.3`。安装前可查询 registry 当前版本:
55
+ 本说明对应 **0.1.4**,包含自动规划、递归子会话、工具插件预览、清单拖宽、推荐回复加载提示,以及默认展开的分类执行记录。固定该版本时,执行 `dsh plugin --profile desktop add dsh-taskflow@0.1.4`。安装前可查询 registry 当前版本:
50
56
 
51
57
  ```sh
52
58
  npm view dsh-taskflow version dist-tags --json
53
59
  ```
54
60
 
55
- 已有 0.1.3 修复版 `.tgz` 时,在压缩包所在目录执行 `dsh plugin --profile desktop add ./dsh-taskflow-0.1.3.tgz`;安装后保存工作并重启 DSH。已经安装本地修复包的用户可直接进入下方使用指南。
61
+ 已有 0.1.4 安装包 `.tgz` 时,在压缩包所在目录执行 `dsh plugin --profile desktop add ./dsh-taskflow-0.1.4.tgz`;安装后保存工作并重启 DSH。已经安装该版本的用户可直接进入下方使用指南。
56
62
 
57
63
  需要自行打包时,在**包含上述修复的源码目录**执行:
58
64
 
@@ -61,10 +67,10 @@ npm ci
61
67
  npm run build
62
68
  npm run check
63
69
  npm run check:package
64
- dsh plugin --profile desktop add ./dist/dsh-taskflow-0.1.3.tgz
70
+ dsh plugin --profile desktop add ./dist/dsh-taskflow-0.1.4.tgz
65
71
  ```
66
72
 
67
- 这些命令需要 Node.js ≥24.9.0;`check:package` 会生成并验证 `dist/dsh-taskflow-0.1.3.tgz`。`dsh` 指你当前宿主提供的 CLI;如果终端找不到该命令,请使用宿主 CLI 的实际路径。网页版将 `desktop` 换成 `web`。本地安装不等于发布到 npm,也不会自动更新其他 profile。
73
+ 这些命令需要 Node.js ≥24.9.0;`check:package` 会生成并验证 `dist/dsh-taskflow-0.1.4.tgz`。`dsh` 指你当前宿主提供的 CLI;如果终端找不到该命令,请使用宿主 CLI 的实际路径。安装后保存工作并重启 DSH。网页版将 `desktop` 换成 `web`。本地安装不等于发布到 npm,也不会自动更新其他 profile。
68
74
 
69
75
  ## 使用指南
70
76
 
@@ -237,6 +243,8 @@ dsh plugin --profile desktop add ./dist/dsh-taskflow-0.1.3.tgz
237
243
 
238
244
  子任务的执行过程和关键发现保留在当前子任务会话。模型通过 `taskflow_progress` 保存阶段进展:委派事项直接写入执行子会话,行内事项写入对应记录子会话。实际工具过程自动保存;迟到结果按原工具调用归属记录。最终结果先保存到子任务,再由完成通知告诉直接父任务,过程不逐条通知父任务。
239
245
 
246
+ **0.1.4** 将这些记录默认展开,显示步骤目标、实际操作、关键发现或验证结果、下一步及阻塞原因。行内记录自动区分模型调用、模型公开输出、工具调用参数与返回结果;原始记录提供模型、工具、耗时或失败状态时一并展示。内容支持 Markdown、表格和代码,可手动折叠。旧版“上下文注入 · taskflow · T-xxx 执行过程”记录也能直接阅读,无需重新执行任务;历史缺失的内容不会凭空补写。
247
+
240
248
  文件来自工具的明确路径字段,不从命令或普通回复猜测。若通过终端脚本生成文档,要求模型随后调用 `taskflow_open_view`,传入 `kind: "editor"` 和真实 `filePath`(多文件用 `files`);不要只在回复里写路径。文档读取、权限检查、渲染和加载错误由宿主预览插件负责,Taskflow 不再直接读取文件。请启用宿主文档预览插件;缺失时显示原因,可在启用后点击“重试打开”。
241
249
 
242
250
  浏览器自动化、终端和编辑仍由原工具或对应插件执行。宿主浏览器打开的是相同地址;第三方自动化插件的浏览器不一定与它共享登录、页面进度或标签页,打开视图不代表完成操作。识别到的文档统一交给宿主预览;其他工具可展示插件注册的专用视图。
@@ -318,10 +326,10 @@ T-003 需要的样例文件已放在项目 fixtures/sample.json,请沿用原
318
326
 
319
327
  ## 注意事项
320
328
 
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` 及相应客户端服务。
329
+ - **兼容性** — 当前版本 **0.1.4**,要求 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
330
  - **规划与执行** — 自动规划由模型提示引导,具体拆解和工具选择取决于宿主模型。任务账本独立于 `todo_write`,后续对话通过增量操作维护原计划。
323
331
  - **数据与恢复** — 同一 `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)。
332
+ - **验证范围** — 0.1.4 通过 71 项自动化测试、12 个版本边界检查,以及 `0.2.1-rc.3`、`0.2.2-rc.2`、`0.2.2-rc.3` 的固定响应模型集成测试;执行记录另经这三个版本的原生 SlotCore 与实际打包客户端 jsdom 回归,覆盖冷读取与重复启停。推荐请求此前经真实模型验证;完整原生界面、真实模型的任务拆解质量与第三方工具仍需验收,详见[验收记录](https://github.com/Oak-liuhj/dsh-taskflow/blob/main/docs/acceptance.md)。
325
333
  - **语言** — 插件说明提供简体中文和英文;任务导航界面当前以中文显示。
326
334
 
327
335
  ## 喜欢它?
package/README_en.md CHANGED
@@ -28,6 +28,8 @@ Terminal-generated files without structured output paths require
28
28
  Previews follow tool-panel resizing, floating and scrolling. Closing the tool view
29
29
  releases its own previews and preserves documents opened by the user. The header's
30
30
  Tasks button toggles the checklist; another active sidebar page switches to Tasks.
31
+ Version **0.1.4** expands Taskflow execution records by default, including existing saved records. Inline records distinguish model calls, public model output, tool inputs and results. Available source metadata supplies the model, tool, duration and failure status. Stage reports describe the goal, actual operations, key findings or validation, and next step or blocker, with Markdown tables and code when helpful. Historical records remain intact and missing history is never fabricated.
32
+
31
33
  Execution progress and key findings stay in the current task's child session via
32
34
  `taskflow_progress`. Inline work writes to its record session; delegated work writes
33
35
  to its execution session. Final results are saved before notifying the direct parent.
@@ -36,7 +38,7 @@ The tool view keeps a compact header and fills its remaining height with documen
36
38
 
37
39
  ![Task navigation and conversation](https://raw.githubusercontent.com/Oak-liuhj/dsh-taskflow/main/docs/screenshots/desktop.png)
38
40
 
39
- *Screenshots show the development acceptance shell with a deterministic model.*
41
+ *Historical development-shell screenshots (0.1.0-alpha.1), using a deterministic model to illustrate the layout. These are not full-host screenshots of the current version. See the guide and [acceptance record](docs/acceptance.md) for the current behavior and validation scope.*
40
42
 
41
43
  ## Install / Update
42
44
 
@@ -46,6 +48,14 @@ Open **Plugins** → **Add plugin** and search for `dsh-taskflow`. If a result p
46
48
 
47
49
  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.
48
50
 
51
+ ### Discover through dsh-market
52
+
53
+ [dsh-market](https://github.com/dsh-market/dsh-market) consumes the [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) catalog. Submission, maintainer merge and market refresh are separate stages; a pull request does not establish searchability. The [submission record](marketplace/SUBMISSION.md) tracks that status.
54
+
55
+ After catalog inclusion and refresh, search for `dsh-taskflow` under **Plugins → Plugin Market**. Confirm the repository is `Oak-liuhj/dsh-taskflow`, the npm package is `dsh-taskflow`, and the host requirement is compatible. For the host's **Discover → Index sources**, the market provides `https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json`. The published npm package remains directly installable before the catalog refreshes.
56
+
57
+ On official Desktop, prefer the app's plugin manager. CLI installation must target the profile actually used by that app; installing into `web` does not install into Desktop.
58
+
49
59
  ### Using the `dsh` CLI
50
60
 
51
61
  ```sh
@@ -55,7 +65,7 @@ dsh plugin --profile web add dsh-taskflow@latest
55
65
  To pin the current version:
56
66
 
57
67
  ```sh
58
- dsh plugin --profile web add dsh-taskflow@0.1.3
68
+ dsh plugin --profile web add dsh-taskflow@0.1.4
59
69
  ```
60
70
 
61
71
  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.