常见问题

菜单栏里没有图标

1. 从“应用程序”文件夹重新启动应用。
2. 检查菜单栏图标是否被其他图标挤到折叠区域。
3. 打开“活动监视器”，搜索 OTPFill，确认进程是否运行。
4. 若进程反复退出，从终端启动或查看本地日志获取错误信息。

信息里的验证码没有被识别

• 确认“启用监听”和“监听信息”都已开启。
• 确认完全磁盘访问已授权；修改权限后重启应用。
• 保持 Mac 上的“信息”App 运行，等待 iPhone 同步完成。
• 检查内容里是否有“验证码”“code”等关键词。
• 在日志中确认是否发现新的 Messages 记录。

邮件验证码没有被识别

• 确认邮件已经同步到 Apple Mail 的收件箱，而不只是网页邮箱。
• 确认“监听邮件”和完全磁盘访问已开启。
• 只有 HTML、没有纯文本部分的邮件可能无法解析。
• 尝试开启“系统通知”监听，前提是邮件通知预览会显示验证码正文。

QQ、Gmail 或其他 App 的通知没有反应

• 开启“系统通知”监听。
• 在 系统设置 > 通知 中允许目标 App 显示预览。
• 展开通知确认正文里真的包含验证码。只显示“收到新消息”时无法提取。
• 确认目标通知到达发生在 OTPFill 启动之后。

已识别但没有自动粘贴

1. 确认当前模式不是“仅复制”或“悬浮窗”。
2. 确认辅助功能权限已授权。
3. 验证码到达前把焦点放进正确输入框。
4. 先切到“仅复制”，确认识别本身正常。
5. 某些安全输入框会禁止粘贴，可改用“模拟输入”。

模拟输入覆盖了错误窗口

OTPFill 会把内容发送给当前获得焦点的 App。关闭“自动按下回车”，切换到“仅复制”或“悬浮窗”，确认环境稳定后再恢复自动模式。

正常消息被误识别

• 删除过于宽泛的关键词，例如单独的 code。
• 收紧正则表达式允许的长度或格式。
• 保留与实际验证码提示词更接近的关键词。
• 用识别规则中的筛选逻辑检查误命中来源。

macOS 显示“无法验证开发者”

在访达中按住 Control 点击应用并选择“打开”，或到 系统设置 > 隐私与安全性 使用单次“仍要打开”。不要为了一个应用全局关闭系统安全检查。

检查更新失败

确认 GitHub 可访问，检查系统代理，然后在日志中搜索 updater。仍失败时从最新发行页手动下载。

反馈问题时提供什么

请提供 macOS 版本、CPU 架构、应用版本、监听源、处理方式、复现步骤和脱敏后的相关日志。不要发送仍有效的验证码、完整邮件正文、手机号、邮箱地址或本机用户名。