> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 通知：系统通知与站内通知

> 系统通知的开关、授权与三类提醒，什么时候会弹横幅；站内通知列表的筛选、已读与跳转。

AIHubMix Cloud 有两套互相独立的通知：**系统通知**是操作系统（或浏览器）弹出的横幅，在你没看着 Cloud 时提醒你；**站内通知**是「设置 › 通知」里的通知列表，保存通知记录。关闭系统通知不影响站内记录。

## 适用范围

| 形态 | 支持情况 | 说明 |
| - | - | - |
| 桌面客户端 | 支持 | 系统原生通知；完成或跳过登录引导后询问一次通知权限；未读数显示在 Dock 图标上 |
| 网页版 | 支持 | 浏览器通知，不自动询问权限，需在设置里主动开启；未读数显示在标签页标题前 |
| 手机网页 | 部分 | 站内通知可用；部分手机浏览器不支持网页通知，「系统权限」显示「不支持」 |

## 入口

* **系统通知设置**：「设置 › 通用」里的「系统通知」一组；站内通知列表右上角的齿轮「通知设置」也会打开这里。
* **站内通知列表**：账户菜单 ›「通知」（有未读时显示未读数，头像上有小圆点）；「设置 › 个人 › 通知」；「系统通知」标题右侧的「查看通知」；快捷键 `⌥⌘U`（Windows：`Ctrl+Alt+U`）。

## 系统通知

### 设置项

| 设置 | 说明 |
| - | - |
| 允许系统通知 | 总开关，默认开启 |
| 系统权限 | 操作系统（或浏览器）是否允许 Cloud 发通知：「未授权」「已允许」「未允许」「不支持」。「未授权」时按钮为「允许通知」，其他情况为「打开系统设置」 |
| 任务完成 | 会话或定时任务完成 |
| 待你处理 | 批准、补充信息或手动接管 |
| 任务异常 | 执行失败、中断或定时任务自动暂停 |

* 三类提醒默认都开启。关闭总开关时，三类提醒各自的选择会保留，重新打开后恢复。
* 「打开系统设置」在桌面客户端直接打开系统的通知设置；网页版需要你到浏览器设置里修改。
* 通知的声音、勿扰等由操作系统决定。

### 首次授权

* **桌面客户端**：第一次完成或跳过登录引导后，由操作系统弹出一次授权询问。之后可以点「允许通知」再次申请，或点「打开系统设置」修改。
* **网页版**：不会自动询问。打开「允许系统通知」或点「允许通知」时，浏览器才弹出授权询问。

无论是否允许，都可以正常使用 Cloud。

### 规则与状态

| 情况 | 你会看到 | 你可以 |
| - | - | - |
| 总开关开 + 已允许 | 三类提醒开关；符合条件的事件弹出横幅 | 单独关闭某一类 |
| 总开关开 + 未授权 | 三类提醒隐藏 | 点「允许通知」 |
| 总开关开 + 未允许 | 三类提醒隐藏 | 点「打开系统设置」到系统里允许 |
| 总开关关 | 三类提醒隐藏，不弹横幅 | 重新打开总开关；尚未授权时会同时申请权限 |
| 不支持 | 总开关不可用 | 使用站内通知列表 |

## 哪些事件会弹出系统通知

| 类别 | 事件 |
| - | - |
| 任务完成 | 任务完成、定时任务完成 |
| 待你处理 | 等待批准、需要补充信息、需要手动处理 |
| 任务异常 | 任务失败、任务中断、定时任务失败、定时任务已暂停 |

其他通知（如项目缺少环境变量、云主机桌面流量提醒、订阅相关提醒）只记入站内通知列表，不弹横幅。

### 弹出横幅的条件

新通知同时满足以下条件才弹出横幅，否则只记入站内通知：

1. 总开关已开启，且系统已允许。
2. 该通知所属类别已开启。
3. 你此刻没有在前台看着这条通知对应的页面。

打开 Cloud 时已有的通知不会补弹。定时任务是否通知运行结果，还取决于该定时任务自己的「通知」设置，见 [定时任务](https://docs.aihubmix.com/cn/cloud/automation/scheduled-tasks.md)。

### 横幅的行为

* **点击横幅**：打开对应的会话或定时任务，并把窗口切到前台。
* 多个会话几乎同时完成时，合并为一条横幅「N 个任务已完成」，点击打开站内通知列表；站内列表仍逐条保存。
* 「待你处理」类通知被标为已读只表示你看过，不会替你批准或处理。

### 关闭窗口与退出客户端

* 桌面客户端开启「关闭窗口后保留在菜单栏」（默认开）时，关掉主窗口后仍会弹出通知。
* 完全退出客户端后不会弹出系统通知；期间的通知在站内列表里查看。

## 站内通知

「设置 › 个人 › 通知」列出站内通知，最新的在最前，未读的带标记。

### 列表与筛选

* 顶部有「全部 / 未读」筛选、「全部已读」按钮和齿轮「通知设置」。
* 每行显示标题、说明（或所属项目名）和时间；未读条目有「标为已读」按钮。
* 列表底部点「加载更多」查看更早的通知。

### 点击跳转

| 通知关联的对象 | 点击后 |
| - | - |
| 会话 / 定时任务 / 项目 | 打开对应页面 |
| 项目缺少环境变量 | 打开该项目的环境配置页 |
| 云主机桌面流量提醒 | 打开云主机页 |
| 订阅相关提醒 | 打开「设置 › 账户」的账单部分 |
| 已删除的会话 / 项目 | 不跳转，提示「这个对话已删除」或「这个项目已删除」 |

* 点击会把这一条标为已读，再跳转。
* 只能在桌面客户端处理的通知，在网页版上标注「在桌面客户端处理」或「在桌面客户端查看」。

### 规则与状态

| 情况 | 你会看到 | 你可以 |
| - | - | - |
| 没有任何通知 | 「暂无通知」 | 无需操作 |
| 「未读」筛选下没有未读 | 「没有未读通知」 | 切回「全部」 |
| 已加载的都已读，但还有更早的未读 | 「已加载的通知都已读，可以加载更多」 | 点「加载更多」 |
| 加载或标记已读失败 | 「通知加载失败」或「标记已读失败：原因」 | 点「重试」或再试一次 |

* 点「全部已读」后，账户菜单、头像和 Dock / 标签页上的未读数随之消失。
* 已读状态跟随账号同步到你的其他设备。

## 常见问题

### 为什么会话完成了却没有弹通知？

依次检查：「允许系统通知」是否开启、「系统权限」是否为「已允许」、「任务完成」类别是否开启；如果是定时任务，它的「通知」设置是否为「全部更新」（默认「仅重要更新」只通知失败）；以及你当时是否正在前台看着这个会话。

### 关掉系统通知后，还能看到通知记录吗？

能。站内通知列表与系统通知开关无关。

### 系统设置里已经允许了，为什么还显示「未允许」？

切回 Cloud 窗口后状态会更新。macOS 上可能要等下一条通知送达后，才恢复为「已允许」。

### 把「等待批准」的通知标为已读，会话会继续吗？

不会。已读只表示你看过，需要打开会话完成批准。

## 相关

* [通用与外观](https://docs.aihubmix.com/cn/cloud/settings/general.md)
* [定时任务](https://docs.aihubmix.com/cn/cloud/automation/scheduled-tasks.md)
* [需要你处理](https://docs.aihubmix.com/cn/cloud/sessions/user-intervention.md)
* [归档](https://docs.aihubmix.com/cn/cloud/settings/archived.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.