DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Yven /

Yven/dsh-run-monitor

Verified

简单的dsh任务监控插件以及可以进行完成后消息通知

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@ff8caa69

运行监控(dsh-run-monitor)

DSH Web 界面插件。在左侧栏底部加一个「运行监控」入口,点开是一个贴着侧栏的浮窗,把当前工作区里的会话任务按状态分三组列出来:待回复 / 已完成 / 执行中。点任意一条直接跳到那个对话。

它解决什么

同时开几个会话时,哪些在跑、哪些在等你回答、哪些刚跑完还没看,原本只能靠翻侧栏历史判断。这个插件把这三类集中到一个浮窗里,并在状态发生变化时通知你——不用盯着某个会话也能知道它需要你了。

功能

状态分组

分组 判定
待回复 轮次未结束,且最后一个事件是提问类工具调用(如 ask_user_question)
执行中 轮次已开始、尚未结束
已完成 轮次已结束;只列完成但未读的(读过即从列表消失)
  • 每条任务以 目录徽标 + 标题 呈现,徽标是任务所属工作区(优先取工作区标题,其次取路径末段),按工作区分组一目了然。
  • 子代理(subagent)会话不纳入监控——它们是主任务的内部步骤,混进来只会淹没真正的任务。
  • 「已完成」的清空依据是 shell 的 completionUnread 状态投影,不是本地的“点过没点过”,所以换个标签页、重开页面结果一致。

侧栏气泡

入口按钮右侧按状态显示数量:待回复(黄)、执行中(绿)、已完成(蓝)。窄栏(56px 图标栏)只显示最紧急的一个。气泡与浮窗共用同一份判据,两边数字不会打架。

通知

  • 只在状态发生变化时触发,首次看到不响。
  • 页面在前台且有输入时:用贴在入口上方的内部气泡提醒,3 秒自动消失,点一下跳转。
  • 窗口失焦、被切走,或闲置超过 30 秒:发系统通知,点击会聚焦窗口并跳转。
  • 浮窗顶部两个开关可分别关掉内部 / 外部通知;每个开关旁边有「测试」按钮,用来验证该通道是否可用。

安装

# 用 DSH 的插件管理器安装(推荐)
plugin_manager: install_bundle  target: <本目录绝对路径>

插件以 bundle 形式被 profile 引用(cordis.patch.yml 里插入一条 dsh-run-monitor 条目),源码留在这个目录里,不需要编译、没有第三方依赖。

改了代码怎么生效:先把已安装的 bundle 移除,再重新安装同一目录——版本号不同时客户端才会重新拉取 bundle,所以改动后记得 bump package.json 的 version。

plugin_manager: remove_bundle  target: dsh-run-monitor
plugin_manager: install_bundle target: <本目录绝对路径>

装完刷新页面即可。

结构

dsh-run-monitor/
├── index.js            Host 半:注册 /run-monitor/api/list,推导任务状态
├── client.js           客户端半:侧栏入口、浮窗、通知、样式
├── cordis.patch.yml    插入 bundle 的 patch
├── icon.svg            侧栏图标
├── package.json        dsh.bundle / dsh.client 清单
├── .gitattributes      固定 LF
└── .gitignore

Host 半(index.js)导出 inject = ['webServer', 'sessions'],用 ctx.webServer.register 注册只读路由 GET /run-monitor/api/list,返回:

{ "ok": true, "now": 1700000000000,
  "tasks": [ { "id": "session-…", "title": "…", "state": "running",
               "group": { "label": "项目名", "path": "D:\\work\\项目名" },
               "lastActivity": "…", "createdAt": 0, "updatedAt": 0 } ] }

状态从会话事件流尾部推导:向后找最近的 turn/start 或 turn/end 确定轮次开合(窗口不够就成倍放大,上限 8000 条),再看最后几个事件里是否有未结算的提问类工具调用。工作区归属来自 workspaceRegistry。列表最多返回 200 条,按最近活动排序。

客户端半(client.js)通过模块加载器注册三个挂载点:

  • sidebar.footer.action —— 侧栏底部入口按钮;
  • shell.overlay —— 浮窗本体(点击外部或按 Esc 关闭,窗口缩放时重新吸附);
  • shell.overlay(另一个 id)—— 内部通知气泡。

浮窗打开时每 4 秒刷新一次,关闭时每 20 秒刷新一次用于更新气泡数字。

兼容性与样式

  • 样式只使用宿主主题令牌(--dsw-alias-*、--dsw-specific-*),明暗主题切换自动跟随;不写死颜色。
  • 文案按宿主 locale 服务注册中英文,未取到字典时回退中文。
  • 系统通知的 tag 用 FNV-1a 把会话 id 压到 32 位并拼接事件时间戳,控制在 32 字符内——Windows 会静默丢弃超过 64 字符的 tag,通知根本不弹。

已知限制

  • 只统计活着的会话(Host 侧 sessions.list()),已归档或进程重启前的会话不在列表里。
  • 状态是轮询推导的,不是事件订阅,因此存在最多 4 秒(浮窗打开)/ 20 秒(关闭时)的延迟。
  • 系统通知需要浏览器授权;未授权时该通道自动退回内部气泡。
—/ 5

No ratings yet

Verified DSH bundle

Commit ff8caa6983ae

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout