常见问题

浮窗不显示 / 一闪而过？

请确认已为 ReadBrief 开启「辅助功能」权限（系统设置 → 隐私与安全性 → 辅助功能）。同时检查是否开启了「点击窗口外关闭」导致失焦即隐藏——浮窗显示后有 400ms 宽限期防止误隐藏，正常点击外部仍会关闭。

划词读不到选中文本？

部分应用（如 Safari）AX 属性不完整，会回退到 AppleScript 模拟 ⌘C 复制兜底；若仍失败，可用托盘「粘贴并总结」走剪贴板路径——这条路径不需要任何系统权限。

我的密钥安全吗？

密钥仅存于本地 config.json，且 AI 请求全部由 Rust 后端发起，前端渲染进程拿不到密钥。但 MVP 阶段本地为明文存储，请妥善保管本机；系统钥匙串加密在路线图中。

支持 Windows 吗？

当前版本聚焦 macOS（NSPanel 浮层为 macOS 专属能力）。非 macOS 平台走 show + set_focus 降级路径，完整的 Windows / Linux 适配在路线图中（划词、剪贴板、快捷键已做平台无关封装）。

免费吗？

免费。 使用自己的 API Key（BYOK），全功能永久免费，请求直连服务商、不经任何中转。免费版仅限制自定义数量：自定义提示词 3 个、自定义快捷键 2 个。

需要联网吗？

划词本身完全离线；只有在执行 AI 总结时才会请求你配置的 AI 服务（OpenAI / Claude / Gemini 或你的中转网关）。

总结会存到云端吗？

不会。所有历史记录只存于本机 SQLite（~/Library/Application Support/ReadBrief/readbrief.db），无账号、无云同步。

支持哪些 AI 模型？

只要你的服务商兼容 OpenAI / Claude / Gemini 任一协议即可，例如 gpt-4o-mini、claude-3-5-sonnet、gemini-1.5-flash，以及各类 OpenAI 格式的中转网关。

全屏看视频时浮窗会挡视线吗？

浮窗默认出现在光标附近，看完自动可关；也可以 ⌘P 固定后拖动到屏幕边缘。它是非激活面板，不会抢焦点、不会打断你的视频。

如何反馈问题或建议？

欢迎提交 Issue 与 PR。提交前请确保通过检查：

npm run lint && npm test      # 前端检查与测试
cd src-tauri && cargo test    # Rust 测试