平台與整合
本章節幫助你了解 opencode-notify 在不同作業系統上的功能差異，掌握平台特定設定，以及如何讓你的終端機發揮最佳效能。
學習路徑
1. macOS 平台特性
全面了解 macOS 上的進階功能，包括智慧焦點偵測、點擊通知聚焦和自訂音效。
- 焦點偵測：自動判斷終端機是否為當前活動視窗
- 點擊聚焦：點擊通知後自動切換到終端機
- 自訂音效：為不同事件設定專屬音效
- 37+ 終端機支援：包括 Ghostty、iTerm2、VS Code 整合終端機等
2. Windows 平台特性
掌握 Windows 平台的通知基礎和設定方法。
- 原生通知：使用 Windows 10/11 通知中心
- 通知權限：確保 OpenCode 有發送通知的權限
- 基礎設定：Windows 環境下的設定檔位置
- 限制說明：Windows 暫不支援焦點偵測功能
3. Linux 平台特性
了解 Linux 平台的通知機制和依賴安裝。
- libnotify 整合：使用 notify-send 發送通知
- 桌面環境支援：GNOME、KDE Plasma、XFCE 等主流環境
- 依賴安裝：不同發行版的安裝指令
- 限制說明：Linux 暫不支援焦點偵測功能
4. 支援的終端機
查看所有 37+ 支援的終端機模擬器，了解自動偵測機制。
- 終端機偵測：如何自動辨識你的終端機類型
- 終端機清單：完整的支援終端機清單
- 手動設定：當自動偵測失敗時如何手動指定
- 特殊終端機：VS Code 整合終端機、遠端 SSH 會話的處理
前置條件
平台選擇建議
根據你的作業系統選擇對應的章節：
| 作業系統 | 推薦學習順序 | 核心功能 |
|---|---|---|
| macOS | 1. macOS 平台特性 → 4. 支援的終端機 | 焦點偵測、點擊聚焦、自訂音效 |
| Windows | 2. Windows 平台特性 → 4. 支援的終端機 | 原生通知、基礎設定 |
| Linux | 3. Linux 平台特性 → 4. 支援的終端機 | libnotify 整合、依賴安裝 |
通用建議
無論你使用哪個平台，第 4 課「支援的終端機」都值得學習，它能幫助你理解終端機偵測機制，解決設定問題。
功能對比表
| 功能 | macOS | Windows | Linux |
|---|---|---|---|
| 原生通知 | ✅ | ✅ | ✅ |
| 終端機焦點偵測 | ✅ | ❌ | ❌ |
| 點擊通知聚焦 | ✅ | ❌ | ❌ |
| 自訂音效 | ✅ | ✅ | ✅ (部分) |
| 靜音時段 | ✅ | ✅ | ✅ |
| 父會話檢查 | ✅ | ✅ | ✅ |
| 37+ 終端機支援 | ✅ | ✅ | ✅ |
| 自動終端機偵測 | ✅ | ✅ | ✅ |
下一步
完成本章節後，你將了解不同平台的功能差異和設定方法。
建議繼續學習：
進階設定
深入學習設定檔的所有選項，掌握進階設定技巧。
- 完整設定參考：所有設定項的詳細說明
- 靜音時段詳解：如何設定和工作原理
- 終端機偵測原理：自動偵測的內部機制
- 進階用法：設定技巧和最佳實踐
故障排除
遇到問題時，查看常見故障的解決方案。
- 通知不顯示：權限和系統設定問題
- 焦點偵測失效：終端機設定和偵測機制
- 設定錯誤：設定檔格式和欄位說明
- 音效問題：音效設定和系統相容性
學習路徑建議
如果你剛開始使用，建議按照 平台章節 → 進階設定 → 故障排除 的順序學習。如果你遇到具體問題，可以直接跳轉到故障排除章節。