yimeng-dev/dsh-traffic-light 预览 preview

yimeng-dev/dsh-traffic-light

Plugin插件 Native原生 ⭐ 3 MIT Sessions & Context会话与上下文

用于DeepSeek Harness的多会话代理状态监视器。

Project Overview项目介绍

dsh-traffic-light is a native plugin built exclusively for DeepSeek Harness (DSH), designed to add a floating desktop traffic light for each active DSH user session. The plugin lets users check the current status of multiple DSH sessions at a glance without having to keep the DSH page open and visible at all times. Each session gets its own independent floating traffic light that stays pinned to the top of your desktop, can be dragged anywhere, and does not take up any space in the DSH interface. It communicates session status directly from DSH to your desktop without sending any data to external servers.

To install the plugin, you run a single command through the DSH CLI: dsh plugin add dsh-traffic-light, then restart DSH Web to complete the installation. After installation, you can enable a traffic light for any session by opening the session’s three-dot menu and selecting “Enable Traffic Light”. You can enable multiple traffic lights for sessions across different workspaces, and close any individual light either through the session menu or by right-clicking the floating light itself. This plugin is ideal for users who run multiple DSH sessions at once and want to track status without constantly checking the DSH page.

This plugin is released under the permissive MIT open source license, so it is free to use, modify, and distribute. It requires an existing installation of DeepSeek Harness that uses the web profile, and the first installation will automatically download the required Electron runtime components for the floating desktop window. The plugin is mostly tested on macOS, though it can be used on Windows and Linux with possible display differences if the desktop environment restricts transparent top-pinned windows. It never uploads any session content to external servers, so all status data stays local on your machine.

dsh-traffic-light 是一款专为 DeepSeek Harness(DSH)开发的原生插件,功能是在用户桌面为每个监控中的 DSH 会话显示一个独立的悬浮状态红绿灯。用户无需一直盯着 DSH 页面,就能一眼分辨出各个会话当前是运行中、待用户关注、已完成还是失败状态。每个悬浮灯支持独立置顶、拖动,不会占用 DSH 页面空间,也不影响 DSH 本身的原有界面布局。

安装插件后,用户只需打开需要监控的会话,点击会话右上角的三点菜单,选择「开启红绿灯」,就能在桌面看到对应会话的悬浮灯。每个会话可以单独开启或关闭悬浮灯,支持同时监控多个来自不同工作区的会话,关闭悬浮灯可以通过会话菜单或右键点击悬浮灯完成,操作会双向同步状态。这款工具适合需要同时运行多个 DSH 会话,不想频繁切换查看会话状态的用户。

该插件采用 MIT 开源许可证,完全免费使用,安装需要通过 DSH 的 CLI 工具执行命令,首次安装会自动下载所需的 Electron 运行组件。目前主要在 macOS 系统完成验证,Windows 和 Linux 系统也可尝试使用,若桌面环境限制透明置顶窗口,显示效果可能受影响。插件仅在本机传递会话状态,不会上传任何会话内容到外部服务器,保障用户隐私。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-traffic-light

把 yimeng-dev/dsh-traffic-light 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-traffic-light 桌面悬浮灯

给 DeepSeek Harness 每个 Session 一个桌面红绿灯

中文 · English

npm MIT License Public beta

dsh-traffic-light

不用一直盯着 DSH 页面。每个开启监控的 Session 都会在桌面显示一个独立的悬浮灯,运行、等待、完成和失败一眼可见。

它能做什么

  • 一个 Session 对应一个悬浮灯,多个 Session 可以同时显示。
  • 悬浮灯独立置顶、可拖动,不占用 DSH 页面空间。
  • 从 Session 的三点菜单单独开启或关闭,不会影响同一工作区的其他 Session。
  • 右键悬浮灯后选择「关闭悬浮灯」,关闭动作会同步回 DSH 页面。
  • 运行状态只在本机显示,不上传 Session 内容。

界面预览

红绿灯从空闲、运行、需要关注到完成和失败的状态变化

动图依次演示:空闲 → 运行中 → 需要关注 → 已完成 → 失败。黄色慢呼吸表示运行中,黄色快闪表示需要关注。

安装

在终端执行:

dsh plugin --profile web add dsh-traffic-light

如果当前 DSH 已经使用 web profile,也可以简写为:

dsh plugin add dsh-traffic-light

安装完成后重启 DSH Web:

dsh web

首次安装会下载桌面悬浮窗所需的运行组件,请等待安装完成。

使用方式

  1. 在 DSH 中打开要监控的 Session。
  2. 点击该 Session 的三点菜单。
  3. 选择「开启红绿灯」。
  4. 桌面会出现该 Session 对应的悬浮灯。
  5. 对其他 Session 重复以上步骤,即可同时监控多个 Session。

关闭单个悬浮灯有两种方式:

  • 在对应 Session 的三点菜单中选择「关闭红绿灯」;
  • 在悬浮灯上右键,然后选择「关闭悬浮灯」。

关闭一个 Session 不会关闭其他 Session 的悬浮灯。

灯光含义

悬浮窗只有红、黄、绿三种实体灯。黄色通过亮度和闪烁速度区分两种状态:

灯光表现 页面状态 含义
黄灯慢慢呼吸 Running(运行中) Session 正在执行任务。
黄灯快速闪烁 Attention(需要关注) 正在等待你的确认、回答,或任务暂时受阻。
绿灯常亮 Completed(已完成) 本轮任务已正常完成。
红灯常亮 Failed(失败) 本轮任务发生错误或异常中断。
三灯熄灭 Idle(空闲) 当前没有正在执行的任务。

完成后的绿灯会短暂保留,方便你注意到刚刚完成的任务;开始下一轮任务后会恢复为运行状态。

多 Session 的显示规则

悬浮灯按 Session 保存开关状态,而不是按工作区保存。也就是说:

  • 同一工作区中的多个 Session 可以只开启其中一部分;
  • 不同工作区中的 Session 也可以同时开启;
  • 每个悬浮灯只反映它对应的 Session,不会把其他 Session 的状态混在一起;
  • 关闭某个悬浮灯不会影响其他悬浮灯。

常见问题

Session 菜单里没有「开启红绿灯」

确认插件安装到了 web profile,然后完全退出并重新启动 dsh web。如果 DSH 正在运行,安装后只刷新浏览器页面可能不会加载插件菜单。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-hooks-plugin 下一个 Next dsh-WallpaperAndCost →