# 收到第一則通知

這篇教學從已經開啟的哨站管理頁面開始，以“監聽工作信箱的 Clients
資料夾，透過 Bark 提醒”為例。完成後，你能用一封新郵件驗證整條鏈路。

## 1. 建立管理員

首次開啟時，從
`docker compose logs --tail=50 core`
找到設定碼，輸入頁面並建立至少 12
個字元的管理員密碼。已經完成初始化時，直接使用管理員密碼登入。

**成功標誌**：進入設定嚮導或概覽頁。信箱與通知可以分步設定。

## 2. 新增信箱

開啟「信箱」，點選「新增信箱」，填寫顯示名稱、IMAP
主機、埠、信箱使用者名稱和密碼或應用專用密碼：

- **顯示名稱**：例如“工作信箱”，用於頁面和通知標題。
- **IMAP 主機**：從信箱服務商的 IMAP 設定頁面獲取。
- **埠**：通常是 `993`，使用 TLS。
- **使用者名稱**：通常是完整信箱地址。
- **密碼**：優先使用服務商提供的應用專用密碼或授權碼；163
  等信箱使用授權碼。

測試連線並儲存。Gmail 使用 `imap.gmail.com` 和
`993`，應用密碼是否可用由帳號及組織策略決定，見
[Google 說明](https://support.google.com/accounts/answer/185833?hl=zh-Hans)。其他信箱以服務商提供的 IMAP 引數為準。

**成功標誌**：信箱出現在側欄，能夠進入信箱詳情並掃描資料夾。認證失敗時，先確認服務商已開啟
IMAP、使用者名稱完整且授權碼有效。

## 3. 選擇真正需要提醒的資料夾

在信箱詳情點選「掃描資料夾」→「開始掃描」，勾選需要監聽的資料夾。郵件規則將客戶郵件移動到
Clients 時，就選擇 Clients。

- **實時**：用於需要及時提醒的資料夾。
- **每 5 分鐘 / 每 15 分鐘**：用於收據、訂閱郵件等可以稍後檢視的資料夾。

點選「下一步」，確認後儲存。連線額度條會展示當前佔用；額度不足時，可以將部分資料夾改為定時檢查。

**成功標誌**：「監聽狀態」顯示選定資料夾正在監聽，並有上次檢查時間。首次訂閱從當前郵件位置建立起點，已有郵件不會一次性補發通知。

## 4. 設定 Bark 通知

在手機 Bark App 中啟用系統通知權限，並找到推播地址。假設地址是
`https://api.day.app/你的设备Key`，在哨站
的「通知設定」中選擇 Bark：

- 「服務地址」填寫 `https://api.day.app`；自建 Bark
  使用自己的 HTTPS 服務地址。
- 「Bark 裝置 Key」只填寫裝置 Key 部分。
- 選擇是否顯示郵件主旨。關閉預覽時使用通用的新郵件提示。

儲存後點選「傳送測試通知」，然後檢查手機。

**成功標誌**：哨站
顯示通知服務已接受測試，手機出現測試通知。哨站
的“已接受”代表服務端接收，手機展示還受系統通知權限、專注模式和通道狀態影響。

使用 Pushover 時填寫應用 Token 與 User Key；使用 Webhook 時填寫
HTTPS 接收地址與簽章金鑰。欄位和簽章規則見[通知通道參考](notifications.md)。

## 5. 用一封新郵件驗收

1. 保持哨站執行，確認 Clients 正在監聽。
2. 從另一個信箱傳送一封新的測試郵件，讓信箱服務端規則將它送進
   Clients。
3. 在信箱網頁或原來的郵件客戶端確認這封郵件確實位於 Clients。
4. 在哨站「投遞記錄」找到這封郵件對應的記錄，再檢查手機通知。

**成功標誌**：手機通知顯示對應信箱和資料夾；開啟主旨預覽時，還能看到測試郵件主旨。閱讀和回覆繼續使用原來的郵件客戶端。

測試請使用新郵件。把接收時間早於 24
小時的舊郵件拖進資料夾會推進進度，但不會生成通知。同一封郵件進入兩個已訂閱資料夾時，可能收到兩條資料夾通知。

## 6. 按鏈路定位問題

- **測試通知也收不到**：先檢查通道憑據、哨站
  到通知服務的網路，以及手機通知權限。
- **測試通知正常，新郵件沒有記錄**：確認訂閱的是規則的目標資料夾，再看監聽狀態與上次檢查時間；定時資料夾等待所選檢查週期。
- **出現失敗投遞**：檢視失敗原因，修正通道設定後手動重試。預設自動重試次數為
  0，可在通知設定調整。
- **信箱需要重新認證**：在「信箱設定」更新應用密碼或授權碼。

設定完成後，按[備份與恢復教學](backup.md)儲存第一次備份。管理頁面的歷史記錄是通知記錄，郵件原文仍由信箱儲存。