> ## 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.

# 通知：システム通知とアプリ内通知

> システム通知のスイッチ、権限、3 種類の通知、バナーが表示される場合と、アプリ内通知一覧での絞り込み、既読化、移動について説明します。

AIHubMix Cloud には、独立した 2 種類の通知があります。**システム通知**は、Cloud を見ていないときにお知らせするために、オペレーティングシステム（またはブラウザ）が表示するバナーです。**アプリ内通知**は **Settings › Notifications** にある通知一覧で、通知の記録が残ります。システム通知をオフにしてもアプリ内の記録には影響しません。

## 利用できる環境

| プラットフォーム | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | ネイティブのシステム通知。サインイン時のオンボーディングを完了またはスキップした後に、通知の許可を 1 回確認します。未読数は Dock アイコンに表示されます |
| Web アプリ | 対応 | ブラウザの通知を使用します。許可は自動では確認されないため、Settings でオンにします。未読数はブラウザのタブタイトルの前に表示されます |
| モバイル Web | 一部対応 | アプリ内通知は利用できます。一部のモバイルブラウザは Web 通知に対応しておらず、その場合 **System permission** には **Not supported** と表示されます |

## 場所

* **システム通知の設定**：**Settings › General** の **System notifications** グループ。アプリ内通知一覧の右上にある歯車 **Notification settings** からも開きます。
* **アプリ内通知一覧**：アカウントメニュー › **Notifications**（未読の通知がある場合は未読数が表示され、アバターに小さな点が表示されます）、**Settings › Personal › Notifications**、**System notifications** 見出しの右側にある **View notifications**、ショートカット `⌥⌘U`（Windows：`Ctrl+Alt+U`）。

## システム通知

### 設定

| 設定 | 説明 |
| - | - |
| System notifications | メインスイッチ。デフォルトでオン |
| System permission | オペレーティングシステム（またはブラウザ）が Cloud による通知の送信を許可しているかどうか：**Not requested**、**Allowed**、**Not allowed**、**Not supported**。ボタンは、状態が **Not requested** の場合は **Allow notifications**、それ以外の場合は **System Settings** です |
| Task completed | セッションまたはスケジュールタスクが完了した |
| Needs your attention | 承認、追加情報、または手動での引き継ぎ |
| Task issues | 実行が失敗した、中断された、またはスケジュールタスクが自動的に一時停止された |

* 3 種類の通知はすべてデフォルトでオンです。メインスイッチをオフにしても、3 種類の通知の選択内容は保持され、再びオンにすると復元されます。
* **System Settings** は、デスクトップアプリではオペレーティングシステムの通知設定を直接開きます。Web アプリでは、ブラウザの設定で変更します。
* 通知のサウンドやおやすみモードなどの動作は、オペレーティングシステムで制御されます。

### 初回の権限確認

* **デスクトップアプリ**：サインイン時のオンボーディングを初めて完了またはスキップしたときに、オペレーティングシステムが許可の確認を 1 回表示します。その後は、**Allow notifications** をクリックして再度要求するか、**System Settings** をクリックして変更できます。
* **Web アプリ**：自動では確認されません。**System notifications** をオンにするか **Allow notifications** をクリックしたときにのみ、ブラウザが許可の確認を表示します。

通知を許可するかどうかにかかわらず、Cloud は通常どおり使用できます。

### ルールと状態

| 状況 | 表示内容 | できること |
| - | - | - |
| メインスイッチがオン + Allowed | 3 種類の通知のスイッチ。条件を満たすイベントでバナーが表示されます | 個別の種類をオフにする |
| メインスイッチがオン + Not requested | 3 種類の通知は非表示 | **Allow notifications** をクリック |
| メインスイッチがオン + Not allowed | 3 種類の通知は非表示 | **System Settings** をクリックし、システムで通知を許可する |
| メインスイッチがオフ | 3 種類の通知は非表示で、バナーは表示されません | メインスイッチを再びオンにする。まだ権限を要求していない場合は、オンにすると権限も要求されます |
| Not supported | メインスイッチは使用できません | アプリ内通知一覧を使用する |

## システム通知が表示されるイベント

| 種類 | イベント |
| - | - |
| Task completed | Task completed、Scheduled task completed |
| Needs your attention | Approval needed、Input needed、Action needed |
| Task issues | Task failed、Task interrupted、Scheduled task failed、Schedule paused |

その他の通知（プロジェクトの環境変数の不足、クラウドサーバーのデスクトップ通信量のアラート、サブスクリプション関連のアラートなど）は、アプリ内通知一覧にのみ記録され、バナーは表示されません。

### バナーが表示される条件

新しい通知が届いたとき、以下の条件をすべて満たす場合にのみバナーが表示されます。それ以外の場合は、アプリ内通知にのみ記録されます：

1. メインスイッチがオンで、システムが通知を許可していること。
2. 通知の種類のスイッチがオンであること。
3. その通知のページをフォアグラウンドで表示していないこと。

Cloud を開いたときにすでにある通知については、後からバナーは表示されません。スケジュールタスクが実行結果を通知するかどうかは、そのスケジュールタスク自体の **Notifications** 設定にもよります。[スケジュールタスク](https://docs.aihubmix.com/jp/cloud/automation/scheduled-tasks.md) を参照してください。

### バナーの動作

* **バナーをクリックする**：対応するセッションまたはスケジュールタスクが開き、ウィンドウがフォアグラウンドに表示されます。
* 複数のセッションがほぼ同時に完了した場合は、1 つのバナー **N tasks completed** にまとめられます。クリックするとアプリ内通知一覧が開きます。アプリ内の一覧には、各通知が個別に残ります。
* **Needs your attention** の通知を既読にしても、確認したことを示すだけです。承認や対応が代わりに行われることはありません。

### ウィンドウを閉じる場合とアプリを終了する場合

* デスクトップアプリで **Keep in the menu bar** がオン（デフォルトでオン）の場合、メインウィンドウを閉じても通知は表示されます。
* アプリを完全に終了すると、システム通知は表示されなくなります。その間の通知はアプリ内の一覧で確認します。

## アプリ内通知

**Settings › Personal › Notifications** はアプリ内通知の一覧です。最新の通知が上に表示され、未読の項目には印が付きます。

### 一覧と絞り込み

* 上部には **All / Unread** の絞り込み、**Mark all read** ボタン、歯車 **Notification settings** があります。
* 各行には、タイトル、説明（またはプロジェクト名）、時刻が表示されます。未読の項目には **Mark as read** ボタンがあります。
* 一覧の最下部にある **Load more** をクリックすると、古い通知を表示できます。

### クリックして開く

| 通知に関連付けられた対象 | クリックした後 |
| - | - |
| セッション / スケジュールタスク / プロジェクト | 対応するページを開きます |
| プロジェクトの環境変数の不足 | プロジェクトの環境設定ページを開きます |
| クラウドサーバーのデスクトップ通信量のアラート | クラウドサーバーのページを開きます |
| サブスクリプション関連のアラート | **Settings › Account** の請求部分を開きます |
| 削除されたセッション / プロジェクト | 何も開かず、**This chat was deleted** または **This project was deleted** と表示されます |

* クリックすると、まず通知が既読になり、その後対象が開きます。
* デスクトップアプリでのみ対応できる通知には、Web アプリで **Resolve in the desktop app** または **View in the desktop app** と表示されます。

### ルールと状態

| 状況 | 表示内容 | できること |
| - | - | - |
| 通知が 1 件もない | **No notifications yet** | 操作は不要 |
| **Unread** の絞り込みで未読の通知がない | **No unread notifications** | **All** に戻す |
| 読み込んだ通知はすべて既読だが、古い未読の通知が残っている | **Everything loaded is read. Load more to check older ones.** | **Load more** をクリック |
| 読み込みまたは既読化に失敗 | **Couldn’t load notifications** または **Couldn’t mark as read: reason** | **Retry** をクリックするか、もう一度試す |

* **Mark all read** をクリックすると、アカウントメニューの未読数、アバターの点、Dock / タブの未読数が消えます。
* 既読の状態はアカウントと同期され、他のデバイスにも反映されます。

## よくある質問

### セッションが完了したのに通知が表示されなかったのはなぜですか？

次の順に確認してください：**System notifications** がオンか、**System permission** が **Allowed** か、**Task completed** の種類がオンか。スケジュールタスクの場合は、その **Notifications** 設定が **All updates** になっているか確認してください（デフォルトの **Important updates** では失敗のみが通知されます）。また、その時点でそのセッションをフォアグラウンドで表示していなかったかも確認してください。

### システム通知をオフにした後も、通知の記録は確認できますか？

はい。アプリ内通知一覧は、システム通知のスイッチとは独立しています。

### システム設定ですでに通知を許可したのに、"Not allowed" と表示されるのはなぜですか？

状態は Cloud のウィンドウに戻ったときに更新されます。macOS では、次の通知が配信された時点で **Allowed** に戻る場合があります。

### "Approval needed" の通知を既読にすると、セッションは続行されますか？

いいえ。既読は確認したことを示すだけです。承認を完了するには、セッションを開く必要があります。

## 関連ページ

* [一般と外観](https://docs.aihubmix.com/jp/cloud/settings/general.md)
* [スケジュールタスク](https://docs.aihubmix.com/jp/cloud/automation/scheduled-tasks.md)
* [対応が必要](https://docs.aihubmix.com/jp/cloud/sessions/user-intervention.md)
* [アーカイブ](https://docs.aihubmix.com/jp/cloud/settings/archived.md)


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