前言¶
DeepSeek Harness (DSH) 提供了插件化扩展能力。在使用 agent 进行开发或调试时,状态反馈(如任务完成、报错、需要授权或回答)往往分散在对话流或后台日志中。dsh-task-toast 插件将这些状态统一聚合显示在页面右上角,提供直观的视觉反馈。
插件简介¶
dsh-task-toast 是一个纯客户端插件,旨在将 agent 的运行状态可视化。它沿用了 dsh-theme-endfield 的设计语言,不依赖任何构建步骤,直接通过命令安装即可使用。
核心功能¶
- 右上角状态提示板:在页面右上角显示 agent 状态。
- 支持的状态类型:
- 完成 (COMPLETE)
- 出错 (ERROR)
- 会话打不开 (UNOPENED)
- 有子 agent 在跑 (SUBAGENT)
- 待授权 (APPROVAL)
- 待回答 (QUESTION)
- 交互与视觉:
- 持有状态时显示完整提示板,超时或处理后收起为细边。
- 鼠标悬停在细边上可重新展开提示板。
- 视觉风格沿用 Endfield 设计语言。
- 多通道通知:
- 页内提示板:始终显示。
- 系统通知:当用户未直接查看 DSH 时触发。
- 标题栏前缀:在任务栏/标签页显示状态标记。
安装与启用¶
插件无需构建,直接通过 DSH 命令行安装。
安装¶
dsh plugin --profile web add github:jgao9906-droid/dsh-task-toast
安装后需要重启或重新加载 web profile 才能生效。
开发调试¶
如需修改源码并立即生效,可使用 link: 方式:
dsh plugin --profile web add link:<你 clone 下来的路径>
卸载¶
dsh plugin --profile web rm dsh-task-toast
注意事项¶
- 浏览器权限:首次使用时,需要在浏览器中授权通知权限。授权后记在
localStorage中,除非权限被拒绝,否则不会重复询问。 - 版本兼容:插件依赖 DSH 版本 0.1.5-rc.x。
- 平台兼容:
- 支持普通浏览器环境。
- 支持 DSH Desktop (Tauri 壳) 环境。在 Tauri 上,宿主会修正可见性状态。
- 系统行为:
- 在 Windows 上,系统通知的显示时长由系统设置决定(设置 > 系统 > 通知),插件无法控制。
- 在 DSH Desktop (Tauri) 上,授权通知的询问界面不会出现,由宿主直接接管。
总结¶
dsh-task-toast 提供了一个零依赖、无构建步骤的状态反馈方案。它通过右上角的状态板和系统通知,确保开发者或用户能及时掌握 agent 的运行情况,包括瞬时的完成/错误以及需要人工介入的授权与提问。对于需要高度关注 agent 状态的开发者而言,这是一个实用的辅助工具。
- GitHub: https://github.com/jgao9906-droid/dsh-task-toast
- 目录页: https://www.skillhub.cn/plugins/jgao9906-droid/dsh-task-toast