跳到正文
  • 首页
  • 插件说明
  • dsh-task-status

vlln/dsh-task-status

100最近提交 2026年8月15日

dsh-task-status DSH 插件

task-status 插件在对话页输入框上方添加一个 dock 卡片，显示运行中后台任务的数量。点击任务行可展开查看状态、耗时、详情以及每秒轮询的实时输出 tail。插件以官方 bundle 插件形式安装，无需打补丁。

ui-productivity

如何安装 dsh-task-status DSH 插件

dsh plugin --profile web add "github:vlln/dsh-task-status#main

复制不会执行命令。安装 dsh-task-status DSH 插件前请核对仓库和版本。

dsh-task-status DSH 插件数据来源

dsh-task-status DSH 插件快照日期：2026年8月16日

discovered

dsh-task-status DSH 插件能做什么

  • 显示运行中后台任务计数的状态条。
  • 点击展开任务详情，包含状态、耗时和实时输出 tail（每秒轮询，最多 10 行滚动区）。
  • 提供只读路由 `/tasks`（任务列表）和 `/output`（任务输出 tail）供程序访问。
  • 使用镜像补丁避免与官方 `task_output` 工具竞争，保证视图一致。

dsh-task-status DSH 插件适合哪些场景

  • 在对话页聊天时监控后台任务进度。
  • 调试长时间运行的脚本，实时查看输出 tail。
  • 跟踪多个并行后台任务，展开查看各自详情。
  • 无需离开对话视图即可快速检查任务状态。

dsh-task-status DSH 插件适合谁

  • 需要实时了解后台任务进度的 DSH 用户。
  • 在对话界面中调试或监控脚本执行的开发者。

dsh-task-status DSH 插件的限制

  • 仅在对话页可见；在 trajectory、taskboard 等非 Chat 视图自动隐藏。
  • 输出 tail 限制为 10 行（160px），超出部分滚动显示，旧行将被顶出。
  • 需要后台任务支持（如使用 bash 工具时设置 `run_in_background: true`）。

dsh-task-status DSH 插件的仓库 README 摘录

以下文字摘自 dsh-task-status DSH 插件的上游仓库 vlln/dsh-task-status 的 README，版权归原作者，仅作引用。

对话页输入框上方的后台任务状态条：运行中任务计数 + 点击展开逐条详情 + **实时输出 tail**（自动轮询，10 行滚动区）。经官方 `conversation.input.dock` 槽注册（与 queue/todo/goal 同族）。形态：官方 **bundle 插件**（`dsh.bundle` + dshClient 通道），0 patch。 ## 效果 ![task-status（真实运行截图：任务行 + 展开输出 tail）](docs/preview/task-status.png) ## 能力 **UI**（对话页 dock 槽）： | 功能 | 说明 | |---|---| | 状态条 | 对话页输入框上方 dock 卡片：`⚙ N 个后台任务运行中` | | 展开详情 | 点击任务行展开：状态/耗时/详情 + 输出 tail | | 实时 tail | 展开时每 1s 轮询输出路由，整段替换渲染（镜像补丁保证与官方 `task_output` 工具零竞争、视图一致） | | 滚动区 | 输出区 max 10 行（160px），超出变滚动条（tail 保尾可回看） | | 仅对话页 | 非 Chat 视图（trajectory/taskboard 等）自动隐藏 | **路由**（Node half）： | 路由 | 说明 | |---|---| | `/plugins/dsh-task-status/tasks` | 任务列表（只读，按 session 过滤；owned + unowned 并集） | | `/plugins/dsh-task-status/output` | 任务输出 tail（`full:true` 累积全文；未知 id 404） | **输出 tail 的竞争语义**（0809 官方 API 约束）：`tasks.read` 是消耗式增量（每任务唯一共享游标）。本插件给 `ctx.tasks.read` 打**镜像补丁**——官方 read = 缓冲镜像（他人已读增量，不重复消耗）+ 直读补最新（正常消耗）；插件自读直接走底层 rawRead。官方工具与插件看到同一增量序列（无重复无丢失），仅主动自读部分官方不再能单独重放（官方语义本就是增量读取，模型感知无影响）。 ## 安装 **推荐：git 源一行安装**（构建产物已入库，git 源不触发构建）： ```sh dsh plugin --profile web add "github:vlln/dsh-task-status#main" ``` 或本地目录（有源码时）：`git clone` 后 `cd dsh-task-status && dsh plugin --profile web add .`。 装完 **重启 web**

阅读完整 README仓库许可: MIT

dsh-task-status DSH 插件常见问题

如何安装 task-status 插件？

在终端中运行 `dsh plugin --profile web add "github:vlln/dsh-task-status#main"`。安装完成后重启 Web 界面即可生效，也可在设置页的插件面板中启用或禁用。

在非对话视图中能看到任务状态吗？

不能，该插件仅在对话页可见。切换到 trajectory、taskboard 等其他非 Chat 视图时会自动隐藏。

如何触发后台任务以显示状态条？

需要使用 `run_in_background: true` 运行任务，例如通过 bash 工具。状态条会显示运行中的任务数量，点击任务行可展开查看详情和实时输出。

插件会与官方的 task_output 工具冲突吗？

不会，它使用镜像补丁避免了竞争，官方工具和插件看到相同的增量输出序列，不会重复或丢失。

能否修改输出行数的限制？

输出 tail 固定为最多 10 行（160px 高度），超出部分会显示滚动条。如需修改，需要改动插件源码，目前不支持设置项。