Bing-Bryan/dsh-unread-dot
30Last commit Aug 15, 2026
dsh-unread-dot DSH plugin
This plugin leverages Chrome's Badging API to display a red dot or numbered badge on the macOS Dock icon when you minimize or switch away from DSH Web. It automatically clears the badge when you return, and plays a bubble sound for new events. Requires DSH Web to be installed as a PWA via Chrome.
How to install the dsh-unread-dot DSH plugin
dsh plugin --profile web add github:Bing-Bryan/dsh-unread-dotCopying does not run this command. Review the repository and version before installing the dsh-unread-dot DSH plugin.
dsh-unread-dot DSH plugin data source
dsh-unread-dot DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-unread-dot DSH plugin can do
- Shows a red dot (no number) when a session is running while you are away from the DSH Web window.
- Displays a numbered red badge when a session completes or requires user input, incrementing the count.
- Plays a built-in bubble sound (0.4s) once per leave period when a session finishes or needs attention.
- Automatically clears the badge and ensures no double-counting when you return to the application.
- Provides configurable toggles for Dock badge, activity dot, and sound, plus a test sound button.
Where the dsh-unread-dot DSH plugin fits
- Monitor whether your DSH session is still running while you work in other apps.
- Get notified immediately when a session finishes without constantly checking the browser.
- Receive a subtle audio cue when DSH needs your input, like waiting for a prompt.
- Avoid distraction after returning to the app since the badge clears automatically.
- Quickly verify sound is working via the built-in test sound button in settings.
Who the dsh-unread-dot DSH plugin is for
- macOS users who run DSH Web and frequently switch between applications.
- Developers or power users who need non-intrusive, real-time status updates from DSH.
- Users who prefer visual dock badges over notification banners or pop-ups.
dsh-unread-dot DSH plugin limitations
- Only works on macOS because it relies on the Dock icon badge.
- Requires DSH Web to be installed as a Progressive Web App (PWA) via Chrome ('Install page as app').
- Depends on Chrome's Badging API, which is only available in Chrome 81+ and only works within an installed Web App context.
- The badge does not appear in a regular browser tab; it must be a standalone PWA window.
dsh-unread-dot DSH plugin: from the repository README
Quoted from the Bing-Bryan/dsh-unread-dot README, the upstream source of the dsh-unread-dot DSH plugin. Copyright remains with the original authors.
> DeepSeek Harness（DSH）插件：最小化/切走时，在 macOS Dock 图标上显示**未读红点**，并在会话完成/需要你处理时播放**水泡提示音**。回到应用自动清除。    <p align="center"><img src="assets/dock-badge.png" width="280" alt="Dock 未读红点效果：运行中=红点，跑完=数字"></p> 基于 Chrome **Badging API**（`navigator.setAppBadge` / `navigator.clearAppBadge`）实现——不依赖任何 macOS 系统设置，不需要通知权限，没有横幅打扰。 > ⚠️ **使用前提**：请先在 Chrome 中打开 DSH Web，通过浏览器菜单 **「更多 → Cast, save and share → 安装应用 / Install…」** 把它封装成一个独立的 macOS 应用（PWA）——`setAppBadge` 只对已安装的 Web App 生效。 ## 效果 | 场景 | Dock 图标 | 声音 | | --- | --- | --- | | 会话正在运行（你不在时） | 🔴 红点（无数字）= 还在干活 | 静音 | | 会话跑完（你不在时） | 🔴 红色数字 +1 = 结果在等你 | 🔊 水泡音 | | 会话需要你处理 | 🔴 红色数字 +1 | 🔊 水泡音（每段离开期一次） | | 回到应用 | 自动清除 | — | ## 为什么用 Badging API 本插件完全构建在 [Badging API](https://developer.chrome.com/docs/capabilities/web-apis/badging-api) 之上，用它的三种状态编码「是否/何种新信息」： ```js navigator.setAppBadge(3) // 红色数字角标：3 个未读结果 navigator.setAppBadge() // 无数字红点：有会话正在运行 navigator.clearAppBadge() // 清除：回到应用，已读 ``` - **无权限、无横幅、无系统设置**：角标是系统级常驻标记
Read the full READMERepository license: MIT
dsh-unread-dot DSH plugin questions
How do I install dsh-unread-dot?
Run `dsh plugin --profile web add github:Bing-Bryan/dsh-unread-dot` in your terminal. Then add `"dsh-unread-dot"` to the `dsh.profile.bundles` array in your profile's `package.json`. Restart `dsh web` and you'll find a new 'Dock Badge & Notifications' section in settings.
Why doesn't the badge appear on my Dock?
The badge only works when DSH Web is installed as a Progressive Web App (PWA) via Chrome. Go to Chrome's menu → 'More Tools' → 'Create Shortcut...' and check 'Open as window'. Also ensure you're using Chrome 81 or later.
Does this plugin support Windows or Linux?
No. The plugin is designed specifically for macOS Dock badges. It uses the macOS Dock icon and does not have a Windows taskbar or Linux equivalent. The README explicitly states it is a macOS-only plugin.
Can I turn off the sound but keep the badge?
Yes. In the plugin settings, there is a separate toggle for 'Sound (bubble)'. You can disable it while keeping the Dock badge and activity dot enabled.
How do I test if the sound is working?
Go to the plugin settings and click the 'Test Sound' button. It will play the built-in bubble sound immediately. Ensure your system volume is not muted and that your browser has audio permissions.