dootask/resources/ai-kb/zh/concept/electron-client/notify.md

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
electron-client.notify.concept	桌面端原生通知	concept	electron-client	end-user	zh	桌面通知 桌面端推送 收不到通知 弹出通知 通知中心 桌面端消息提醒				桌面端通知不依赖浏览器权限,但需要系统级允许 DooTask 发通知 系统勿扰模式 / 专注模式开启时,不会弹出但会进通知中心 桌面端通知与移动端 UMENG 推送是两套独立通道,见 mobile-client.notify.concept	v1.7.90

桌面端原生通知

定义

桌面端的「原生通知」是通过操作系统通知中心弹出的提示(macOS 通知中心 / Windows 操作中心),区别于网页端的浏览器通知。新消息、任务变更、AI 响应等事件会触发,即使 App 处于后台 / 最小化也能收到。

触发场景

• 新消息(私聊 / 群聊)
• 任务被分配 / @ 提醒
• 项目变更(状态、负责人)
• 截止提醒
• 系统通知(管理员推送)

系统授权

首次启动会向操作系统申请通知权限:

• macOS:系统设置 → 「通知」→ 找到「DooTask」→ 允许「允许通知」、选择「横幅」或「提醒」样式
• Windows:设置 → 「系统」→「通知」→ 找到「DooTask」→ 打开

未授权时 App 仍能收到消息,但不会弹系统通知,只会在 App 内显示红点 / 角标。

应用内开关

DooTask 内部还有一层免打扰开关:

• 个人设置 → 「通知」→ 开关「桌面通知」/「声音」
• 单个会话 / 项目 → 「免打扰」可单独静音

通知触发顺序:系统权限 → 应用免打扰 → 单会话免打扰,任一环节关闭都收不到。

通知样式

• 标题:消息来源(如群名、发送人)
• 正文:消息预览(开启「消息预览」时显示;关闭则只显示「您有一条新消息」)
• 点击通知:激活窗口并跳到对应会话 / 任务

不支持

• 不支持自定义通知音效(用系统默认)
• 不支持通知中折叠 / 分组(每条独立)
• 系统勿扰模式开启时不弹横幅,但仍写入通知中心
• 与浏览器 Notifications API 不通用,网页端单独管理