プラットフォームと統合
本章节は、異なるオペレーティングシステムでの 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+ ターミナルサポート | ✅ | ✅ | ✅ |
| 自動ターミナル検出 | ✅ | ✅ | ✅ |
次のステップ
本章节を完了すると、異なるプラットフォームでの機能の違いと設定方法を理解できます。
引き続き以下を学習することをお勧めします：
高度な設定
設定ファイルのすべてのオプションについて深く学び、高度な設定のスキルを習得します。
- 完全な設定リファレンス：すべての設定項目の詳細な説明
- ミュート時間帯の詳細：設定方法と動作原理
- ターミナル検出の原理：自動検出の内部メカニズム
- 高度な使用法：設定のヒントとベストプラクティス
トラブルシューティング
問題が発生した場合は、一般的な故障の解決策を確認してください。
- 通知が表示されない：権限とシステム設定の問題
- フォーカス検出が動作しない：ターミナル設定と検出メカニズム
- 設定エラー：設定ファイルの形式とフィールドの説明
- サウンドの問題：サウンド設定とシステム互換性
学習パスの推奨事項
初めて使用する場合は、プラットフォーム章 → 高度な設定 → トラブルシューティング の順序で学習することをお勧めします。特定の問題に遭遇した場合は、トラブルシューティングの章に直接ジャンプできます。