一、快速上手

1. 启动监测：在 Quicker 面板点击「邮箱取验证码」图标 → 弹出置顶监测窗口

2. 取验证码：新邮件到达后约 5-10 秒，验证码出现在窗口列表（大字号蓝码 + 发件人 + 收到时间 + 过期时间 + 用途）→ 点选该行 → 自动复制到剪贴板并弹通知，窗口关闭

3. 停止监测：关闭窗口（✕ 或 Esc）即可，随时可再开

首次使用需先配置邮箱：右键图标 →「邮箱设置」。

二、右键菜单（三项设置）

1. 时间窗口

只监测最近 N 分钟内收到的邮件（默认 10 分钟，范围 1-1440）。 作用：过滤陈旧邮件，避免把几天前的旧验证码翻出来。改完即时生效。

2. 模型设置

选择用于"从邮件正文提取验证码"的 AI 模型。

• 列表实时读取 Quicker 设置→AI服务 里已配置的模型（含连接名、停用标记）

• 当前使用的模型会高亮，双击该行或点确定即生效

• 「跟随 Quicker 默认（场景自动分配）」= 不指定，由 Quicker 自动分配

未配置任何 AI 时动作依然可用：自动降级为内置数字扫描（抓 4-8 位验证码），只是列表里不显示用途和过期时间。

3. 邮箱设置（多账号）

管理要监测的邮箱账号，全部账号同时监测。

邮箱账号（全部同时监测验证码）
┌────────────────────────────────┐
│ 182xxx@163.com · imap.163.com… │ ← 账号列表，点击载入下方表单
└────────────────────────────────┘
[添加新账号] [删除选中] [保存该账号 →]
IMAP服务器 [imap.163.com]  端口 [993]
邮箱地址 [xxx@163.com]     授权码 [••••••]
         [恢复默认] [取消] [保存并同步]

操作：

规则：

• 同一邮箱地址再次保存 = 更新该账号（不会重复）

• 端口填错会标红拦截；邮箱地址和授权码必填

• 服务器/端口留空时按服务商默认：163 → imap.163.com:993，126 → imap.126.com:993，yeah.net → imap.yeah.net:993

授权码是什么？怎么获取？ 授权码不是邮箱登录密码。以 163 为例：网页登录邮箱 → 设置 → POP3/SMTP/IMAP → 开启 IMAP/SMTP 服务 → 按提示获取授权码。126 / yeah.net 同理。

三、配置云同步（换电脑迁移）

配置（含全部账号和授权码）自动同步到你的 Quicker 账号云端，键名 「邮箱配置信息」。

换电脑三步：新机装 Quicker 并登录同一账号 → 装上本动作 → 打开一次「邮箱设置」确认提示"已从云端同步" → 完成。 （云状态按 Quicker 账号隔离，别人的账号看不到你的配置。）

四、监测行为细节

• 轮询频率：每 5 秒一轮；单轮未完成时自动跳过下一轮，不会堆积连接

• 邮件范围：每账号取最新 8 封、且仅"时间窗口"内收到的未删邮件；BODY.PEEK 方式读取，不会把邮件标为已读

• 多账号：每轮顺序遍历所有账号（每账号约 1-3 秒）；单账号连不上/登录失败时静默跳过，不影响其他账号；多账号时发件人显示 [账号名] 发件人 以区分来源

• AI 提取：识别验证码 + 用途（如"GitHub登录"）+ 过期时间；失败自动回退数字扫描；邮件正文超 2500 字截断后参与识别

• 隐私：授权码只存在你本机的动作状态和你自己的 Quicker 云端；发布/分享动作包不携带任何配置；动作包内不含用户名等机器信息

五、常见问题

Q：窗口一直显示"暂未收到验证码"？ ① 确认邮件真的是刚收到的（时间窗口之外的旧邮件不显示）；② 右键「邮箱设置」核对账号授权码；③ 163 邮箱需在网页端开启 IMAP 服务；④ 换网/换机后 163 可能风控，重新生成授权码再「保存并同步」。

Q：某个账号的验证码一直不出现，其他账号正常？ 该账号连接或登录失败（被静默跳过）。多为授权码失效——重新获取授权码后，在「邮箱设置」点中该账号更新授权码 →「保存并同步」。

Q：列表里没有"用途/过期时间"？ AI 服务未配置或调用失败，已降级为纯数字提取。去 Quicker 设置→AI服务 配置模型即可恢复完整标注。

Q：验证码提取错了？ AI 偶尔会误判。列表里可看清发件人与主题上下文自行判断；也可在「模型设置」换一个模型。

Q：想同时收多个邮箱的验证码？ 正是多账号功能：右键「邮箱设置」→「添加新账号」逐个加入 →「保存并同步」。监测窗会聚合显示全部账号的验证码。

Q：监测窗会自动关闭吗？ 不会，常驻直到你手动关闭（这就是"常驻监测"设计）；关闭即停止，不占任何后台资源。