2.3 KiB
Raw Permalink Blame History

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified
id title type feature scope locale aliases related_tools related_pages prerequisites negative last_verified
desktop-notify.tray.concept Dock 角标与任务栏 concept desktop-notify end-user zh
Dock 角标
macOS 红点
任务栏未读
托盘红点
任务栏闪烁
未读数字
Tray
badge
使用 DooTask 桌面端Electron
任务栏闪烁只在 Windows 平台 + 窗口失焦时生效macOS 不闪
Dock badge 只在 macOS 显示Windows 不显示数字角标
Linux 通常没有 Dock badge 与任务栏闪烁(依桌面环境而异)
v1.7.90

Dock 角标与任务栏

定义

DooTask 桌面端通过 Electron 主进程的 IPC 通道 setDockBadge 在 macOS Dock、Windows 任务栏、系统托盘上同步展示未读消息数,让用户在不切回 DooTask 窗口时也能感知到「有未读」。

平台行为

平台 表现 数据来源
macOS Dock 图标右上角红色数字 app.dock.setBadge(text)
macOS 托盘图标右侧显示未读数文字 mainTray.setTitle(text)
Windows 窗口失焦时任务栏图标闪烁(黄色) mainWindow.flashFrame(true)
Windows 系统托盘有图标,右键菜单含显示/退出 Tray + contextMenu
Linux 无 Dock badge / 闪烁;仅托盘 通常依赖桌面环境

数字含义

未读数 = 当前用户所有「未读 + 非静默」的消息条数;按下面规则计算:

  • 已读会话不计
  • 标记为免打扰silence=1的会话不计
  • 系统静默消息silence=1不计
  • 多设备共享同一个未读数(后端聚合)

清零时机

  • 打开一个会话并阅读到底 → 该会话未读清零Dock badge 减
  • 全部会话已读后 Dock badge 完全消失
  • macOS Dock 上的红点消失 = 0Windows 任务栏闪烁会在窗口被点击聚焦时自动停止

托盘点击行为

  • macOS / Windows单击托盘图标 → 显示主窗口(被最小化或隐藏时拉前)
  • Windows 托盘还可右键 → 「显示」/「退出」

跟桌面通知的区别

  • 桌面通知是一次性事件,弹出后消失;详见 desktop-notify.concept
  • Dock badge / 任务栏是持续状态,反映当前未读总数
  • 两者数据源相同但展示方式独立:通知被系统抑制不影响角标更新