
Bing-Bryan/dsh-unread-dot
30最近提交 2026年8月15日
dsh-unread-dot DSH 插件
本插件利用 Chrome 的 Badging API,在最小化或切走 DSH Web 时,在 macOS Dock 图标上显示红点或数字角标。回到应用自动清除,并播放水泡提示音。需要将 DSH Web 通过 Chrome 安装为 PWA。
如何安装 dsh-unread-dot DSH 插件
dsh plugin --profile web add github:Bing-Bryan/dsh-unread-dot复制不会执行命令。安装 dsh-unread-dot DSH 插件前请核对仓库和版本。
dsh-unread-dot DSH 插件数据来源
dsh-unread-dot DSH 插件快照日期:2026年8月16日
discovered
dsh-unread-dot DSH 插件能做什么
- 当会话正在运行且你离开 DSH Web 窗口时,显示红色圆点(无数字)。
- 当会话完成或需要用户输入时,显示红色数字角标,计数递增。
- 每段离开期间,会话完成或需要处理时播放一次内置水泡声(0.4秒)。
- 回到应用时自动清除角标,并防止重复计数。
- 提供 Dock 角标、活动点、提示音的独立开关,以及测试提示音按钮。
dsh-unread-dot DSH 插件适合哪些场景
- 在其他应用工作时,了解 DSH 会话是否仍在运行。
- 会话完成时立刻获得通知,无需频繁查看浏览器。
- 当 DSH 需要你输入(如等待提示)时,通过声音和角标获得提醒。
- 回到应用后角标自动清除,避免干扰。
- 通过设置中的测试按钮快速验证声音是否正常。
dsh-unread-dot DSH 插件适合谁
- 在 macOS 上使用 DSH Web 并经常切换应用的用户。
- 需要非侵入式、实时状态更新的开发者或高级用户。
- 偏好 Dock 角标而非通知横幅或弹窗的用户。
dsh-unread-dot DSH 插件的限制
- 仅支持 macOS 平台,因为依赖 Dock 图标角标。
- 需要将 DSH Web 通过 Chrome 安装为渐进式 Web 应用(PWA)。
- 依赖 Chrome 的 Badging API,仅在 Chrome 81+ 且位于已安装的 Web App 上下文中生效。
- 角标不会在普通浏览器标签页中显示,必须是独立的 PWA 窗口。
dsh-unread-dot DSH 插件的仓库 README 摘录
以下文字摘自 dsh-unread-dot DSH 插件的上游仓库 Bing-Bryan/dsh-unread-dot 的 README,版权归原作者,仅作引用。
> 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() // 清除:回到应用,已读 ``` - **无权限、无横幅、无系统设置**:角标是系统级常驻标记
阅读完整 README仓库许可: MIT
dsh-unread-dot DSH 插件常见问题
如何安装 dsh-unread-dot?
在终端中运行 `dsh plugin --profile web add github:Bing-Bryan/dsh-unread-dot`。然后在 profile 的 `package.json` 的 `dsh.profile.bundles` 数组中添加 `"dsh-unread-dot"`。重启 `dsh web`,你会在设置中看到新的「Dock 角标与通知」配置项。
为什么 Dock 上没有显示角标?
角标仅在 DSH Web 被安装为渐进式 Web 应用(PWA)时生效。请通过 Chrome 菜单 →「更多工具」→「创建快捷方式...」,并勾选「作为窗口打开」。同时确保 Chrome 版本为 81 或以上。
这个插件支持 Windows 或 Linux 吗?
不支持。该插件专为 macOS Dock 角标设计,利用 macOS 的 Dock 图标,没有 Windows 任务栏或 Linux 的等效实现。README 明确说明仅在 macOS 上工作。
可以关闭声音但保留角标吗?
可以。在插件设置中,有一个独立的「提示音(水泡)」开关。你可以关闭它,同时保持 Dock 角标和活动点开关开启。
如何测试声音是否正常?
进入插件设置,点击「测试提示音」按钮,会立即播放内置水泡声。请确保系统音量未静音,并且浏览器拥有音频播放权限。