OTP 管理

概述

YuerKey 可以存储和生成多种 OTP 动态验证码，替代手机上的 Authenticator App。支持 TOTP（基于时间）、HOTP（基于计数器）、Steam Guard、mOTP 和 Yandex。

添加 OTP 令牌

通过 App 扫描二维码（推荐）

1. 打开 YuerKey App，进入「OTP 管理」页面。
2. 点击右下角的「+」按钮，选择「扫描二维码」。
3. 用手机摄像头扫描服务提供的 QR 码（标准 otpauth:// URI 格式）。
4. 确认令牌信息，包括名称、发行者和算法。
5. 点击「保存到设备」。
6. 令牌通过加密通道同步到 YuerKey 设备中。

支持的格式

标准 otpauth:// URI，例如：

otpauth://totp/GitHub:user@example.com?secret=JBSWY3DPEHPK3PXP&issuer=GitHub

查看与使用

• 在设备主菜单中选择「OTP」，进入 OTP 令牌列表。
• 上下滚动浏览已添加的令牌。
• 选择一个令牌即可查看当前验证码。
• TOTP 令牌会显示 30 秒倒计时进度条，到期自动刷新。
• HOTP 令牌需要按确认键生成下一个验证码。

自动输入 OTP

选择令牌后，可以通过 HID 自动输入功能将验证码直接输入到电脑的输入框中，无需手动抄写。

使用步骤

1. 在电脑上打开需要输入验证码的页面，将光标放在验证码输入框中。
2. 在 YuerKey 设备上进入 OTP 列表，选择对应的令牌。
3. 选择「自动输入」选项。
4. 按下确认键。
5. 设备模拟 USB 键盘，自动输入 6 位验证码。

提示：自动输入过程中，设备会模拟键盘按键，请勿移动光标或切换窗口。

管理令牌

• 编辑：修改令牌的显示名称和排列顺序，方便快速找到常用令牌。
• 删除：在 App 中长按或滑动删除不再需要的令牌。删除前请确保已在对应服务中解绑或更换验证方式。
• 收藏：标记常用令牌，收藏的令牌会出现在列表顶部，方便快速访问。

时间同步

TOTP 依赖精确的时间。如果生成的验证码不正确，可能是设备时间不准确，需要进行时间同步。

同步方式

方式	操作路径	说明
通过 App 同步	App → 设备设置 → 同步时间	将手机时间同步到设备，最简单
通过 WiFi 同步	设备联网后自动 SNTP 校时	需要设备已配置 WiFi
手动设置	设备 → 设置 → 日期时间	手动输入当前时间

排查验证码不正确

1. 首先尝试通过 App 同步时间。
2. 确认令牌的算法和位数与服务端一致（通常为 SHA-1、6 位）。
3. 确认令牌的密钥（Secret）正确——如果不确定，可以在服务端重新生成并重新扫描。
4. 部分服务允许前后 30 秒的偏差，如果只差 1-2 个码，通常是时间偏差问题。