平台与集成
本章节帮助你了解 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+ 终端支持 | ✅ | ✅ | ✅ |
| 自动终端检测 | ✅ | ✅ | ✅ |
下一步
完成本章节后，你将了解不同平台的功能差异和配置方法。
建议继续学习：
进阶配置
深入学习配置文件的所有选项，掌握高级配置技巧。
- 完整配置参考：所有配置项的详细说明
- 静音时段详解：如何设置和工作原理
- 终端检测原理：自动检测的内部机制
- 高级用法：配置技巧和最佳实践
故障排除
遇到问题时，查看常见故障的解决方案。
- 通知不显示：权限和系统设置问题
- 焦点检测失效：终端配置和检测机制
- 配置错误：配置文件格式和字段说明
- 音效问题：音效配置和系统兼容性
学习路径建议
如果你刚开始使用，建议按照 平台章节 → 进阶配置 → 故障排除 的顺序学习。如果你遇到具体问题，可以直接跳转到故障排除章节。