dsh-task-status 使用指南

在对话页输入框上方显示后台任务状态条，展示当前会话运行中的任务数并支持展开查看实时输出末尾。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add @vlln/dsh-task-status

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后需要手动开启吗？

不需要。安装完重启 web profile 即在对话页生效；在设置页「插件」面板可临时停用或重新启用。

状态条在哪些页面会显示？

仅 Chat 视图显示。Trajectory 视图、任务看板等其他页面会自动隐藏，因为这些页面缺少对话流列 [data-chat-flow=""] 探针。

输出区只有 10 行，看不到更早的内容怎么办？

超过 10 行（160px）后自动出现滚动条，可向上滚动查看更早的输出；尾部始终保持最新内容，方便观察进度。

状态条会跟官方 task_output 工具抢输出吗？

不会。插件给 ctx.jobs.read 加了镜像补丁：官方工具仍按原语义消耗式读取，插件自身读取走底层 rawRead；双方看到的增量序列逐字节一致，无重复无丢失。

状态条显示的任务来自哪里？

来自宿主任务并集——遍历所有 agent 取其 owned 任务，再并上无主 unowned 任务（按 id 去重），最后过滤出当前会话（ownerSession 匹配）的活跃任务（running/stopping）。

为什么我跑后台命令没看到状态条？

检查三点：① 工具是否真的设置了 run_in_background: true；② 是否在 Chat 视图（trajectory/taskboard 不会显示）；③ 是否已重启 web profile。

多个任务同时跑会怎样？

状态条显示总任务数并提供「展开/收起」按钮；展开后逐条渲染任务行，点击单条可查看该任务的实时输出 tail；超过 5 条时任务列表自带滚动。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则