mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
62 lines
2.3 KiB
Markdown
62 lines
2.3 KiB
Markdown
---
|
||
id: desktop-notify.tray.concept
|
||
title: Dock 角标与任务栏
|
||
type: concept
|
||
feature: desktop-notify
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- Dock 角标
|
||
- macOS 红点
|
||
- 任务栏未读
|
||
- 托盘红点
|
||
- 任务栏闪烁
|
||
- 未读数字
|
||
- Tray
|
||
- badge
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 使用 DooTask 桌面端（Electron）
|
||
negative:
|
||
- 任务栏闪烁只在 Windows 平台 + 窗口失焦时生效；macOS 不闪
|
||
- Dock badge 只在 macOS 显示；Windows 不显示数字角标
|
||
- Linux 通常没有 Dock badge 与任务栏闪烁（依桌面环境而异）
|
||
last_verified: 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 上的红点消失 = 0；Windows 任务栏闪烁会在窗口被点击聚焦时自动停止
|
||
|
||
## 托盘点击行为
|
||
- macOS / Windows：单击托盘图标 → 显示主窗口（被最小化或隐藏时拉前）
|
||
- Windows 托盘还可右键 → 「显示」/「退出」
|
||
|
||
## 跟桌面通知的区别
|
||
- 桌面通知是**一次性**事件，弹出后消失；详见 [[desktop-notify.concept]]
|
||
- Dock badge / 任务栏是**持续状态**，反映当前未读总数
|
||
- 两者数据源相同但展示方式独立：通知被系统抑制不影响角标更新
|