OTPFill 使用文档

OTPFill 是一款常驻 macOS 菜单栏的验证码助手。它可以监听本机的信息、Apple Mail 和系统通知，在内容中找到验证码，再按你选择的方式复制、粘贴、模拟输入或显示在悬浮窗中。

先从这里开始

你现在要做什么	推荐页面
还没有安装应用	下载与安装
第一次打开，不确定该授予哪些权限	首次启动与权限
想确认整条流程是否正常	接收第一个验证码
想切换复制、粘贴或输入方式	验证码处理方式
某类验证码没有被识别	识别规则
需要排查监听、权限或更新问题	常见问题

OTPFill 的工作方式

信息 / 邮件 / 系统通知
        ↓
匹配触发关键词
        ↓
按正则表达式提取候选验证码
        ↓
选择离关键词最近的候选项
        ↓
复制 / 自动粘贴 / 模拟输入 / 悬浮窗

OTPFill 只处理包含触发关键词的内容。默认关键词包含“验证码”“动态密码”“verification code”“code”等中英文词语；候选码还必须通过格式和距离检查，减少把订单号、手机号或日期当成验证码的情况。

文档结构

分组	内容
快速开始	下载、首次打开、权限配置和第一次验证
基础使用	设置界面、菜单栏、监听来源和四种处理方式
功能说明	关键词与正则、日志、更新、隐私与本地数据
帮助与排错	未识别、未粘贴、权限异常和通知内容缺失

当前版本

官网与应用现已统一使用 OTPFill 品牌，当前版本为 v1.4.0。源码仓库暂时保留原地址，安装包与后续更新以 OTPFill Releases 为准。

使用前要知道

• 目前面向 macOS。
• 信息、邮件和系统通知监听依赖“完全磁盘访问”。
• 自动粘贴和模拟输入依赖“辅助功能”权限。
• 系统通知里必须真的显示验证码正文；只显示“收到一条新消息”的通知无法提取内容。
• 日志可能记录邮件正文、验证码和本机路径，发送日志给他人前请先检查并脱敏。

第一次使用建议按这个顺序阅读：

下载与安装 → 首次启动与权限 → 接收第一个验证码 → 验证码处理方式