vlln/dsh-task-status

Name: vlln/dsh-task-status
Author: vlln

插件Plugin 原生Native ⭐ 9 MIT 其他Other

DSH插件：后台任务状态条（对话页任务进度 + 实时输出tail）。官方bundle插件，通过`dsh plugin --profile web add`安装。

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

DSH 插件 task-status：在聊天输入框上方提供后台任务状态栏，显示运行中任务数、可点击展开的详情和实时输出尾部（1 秒轮询，最多 10 行）。通过官方 conversation.input.dock 槽位注册，聊天页自动隐藏。基于 mirror patch 重写 ctx.tasks.read，使官方 task_output 与本插件看到一致的增量，无冲突无重复。建议需要并行监控模型侧后台任务（如 run_in_background: true 的 bash）时使用；非 Chat 视图（如 trajectory / taskboard）不显示。

DSH plugin task-status adds a background-task status bar above the chat input box, showing the running count, click-to-expand per-task details, and a live output tail (1s polling, max 10 lines). It registers via the official conversation.input.dock slot and is hidden on non-Chat views. A mirror patch rewrites ctx.tasks.read so the official task_output and the plugin share the same increment stream without conflict. Use it when monitoring parallel model-side background tasks (e.g. bash with run_in_background: true). Caveat: it only renders on the chat page, so trajectory or taskboard views show nothing.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-task-status】【https://github.com/vlln/dsh-task-status】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

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

把 vlln/dsh-task-status 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.7 KB · 缓存于 2026-08-23 03:41:21 · 3.7 KB

中文 | English

task-status

Background task status bar: task-progress UI above the chat input area — running count + expandable details + live output tail

A background-task status bar above the chat input box: running-task count + click-to-expand per-task details + live output tail (auto-polling, 10-line scrolling area). Registered through the official conversation.input.dock slot (same family as queue/todo/goal). Ships as an official bundle plugin (dsh.bundle + dshClient channel), 0 patches.

Preview

task-status (real run screenshot: task rows + expanded output tail)

Features

UI (chat-page dock slot):

Feature	Description
Status bar	Dock card above the chat input box: `⚙ N background tasks running`
Expandable details	Click a task row to expand: status / duration / details + output tail
Live tail	Polls the output route every 1s while expanded, re-rendering the whole block (the mirror patch guarantees zero contention with the official `task_output` tool and a consistent view)
Scrolling area	Output area capped at 10 lines (160px); overflow becomes a scrollbar (tail keeps the end, scrollable to review)
Chat page only	Automatically hidden on non-Chat views (trajectory / taskboard, etc.)

Routes (Node half):

Route	Description
`/plugins/dsh-task-status/tasks`	Task list (read-only, filtered by session; owned + unowned union)
`/plugins/dsh-task-status/output`	Task output tail (`full:true` accumulates the full text; unknown id → 404)

Output tail contention semantics (official 0809 API constraint): tasks.read is a consumptive, incremental read (one shared cursor per task). This plugin applies a mirror patch to ctx.tasks.read — the official read becomes buffered mirror (increments already read by others, not re-consumed) + direct read of the latest (normal consumption); the plugin's own reads go straight to the underlying rawRead. The official tool and the plugin see the same increment sequence (no duplicates, no loss); only the proactively self-read part can no longer be replayed by the official side alone (official semantics is inherently incremental, so model perception is unaffected).

Installation

Recommended: one-line install from a git source (build artifacts are committed; a git source doesn't trigger a build):

dsh plugin --profile web add "github:vlln/dsh-task-status#main"   # one-line git source (build artifacts committed)
# or npm source: dsh plugin --profile web add @vlln/dsh-task-status@0.3.1

Or from a local directory (when you have the source): git clone, then cd dsh-task-status && dsh plugin --profile web add ..

After installing, restart web for it to take effect; you can disable/enable it in the "Plugins" panel on the settings page.

Usage

Run a background task and the status bar appears (e.g. the model-side bash tool with run_in_background: true):

⚙ 1 background task running
  ● bash-1  for i in $(seq 1 20)…   started 21:30:15   running

Click a task row to expand → the output tail scrolls live (a scrollbar appears once it exceeds 10 lines). The status bar disappears automatically when the task finishes.

Development

pnpm install
pnpm run build      # tsdown: Node half (lib/index.mjs) + client bundle (lib/client.js)

Node half: src/index.mjs (mirror patch + /tasks /output routes)
client: src/client/task-status.tsx (dock-slot status bar)

License

MIT License (example plugin in the DSH ecosystem).

渲染基于仓库 vlln/dsh-task-status 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install