TOTP 自动填充 - Chrome 扩展

在浏览器中自动填充 TOTP 验证码到网页 OTP 输入框。

安装

1. 下载本项目 或 代码克隆 git clone https://github.com/zxyle/authenticator.git
2. 打开 Chrome 浏览器，地址栏输入 chrome://extensions/
3. 开启右上角「开发者模式」
4. 点击左上角「加载已解压的扩展程序」，选择本目录 chrome-extension
5. 勾选 「TOTP自动填充」将其固定到浏览器工具栏，点击图标即可填充。

使用

• 添加 TOTP：点击扩展图标 →「管理 TOTP 条目」，或右键扩展图标 →「选项」。输入名称与 Secret（Base32），可选填写域名匹配（如 *.github.9909958.xyz）。
• 一键导入 Google Authenticator：
  1. 在手机 Google Authenticator 中点击左上角菜单 →「转移账号」→「导出账号」；
  2. 勾选要导出的账号，显示二维码后，截图保存并发送到电脑端；
  3. 打开扩展「选项」页，在「一键导入 Google Authenticator」中上传二维码图片；
  4. 导入完成后会显示新增/跳过数量；重复导入同一批账号会自动去重。
• 填充方式一：在需要输入验证码的页面，点击扩展图标，在弹层中点击某条目的「填充」或「填充当前页面」。
• 填充方式二：页面出现 OTP 输入框时，输入框旁会显示「用 Authenticator 填充」按钮，点击即可填充（多条匹配时会弹出列表选择）。
• 右键菜单：在输入框中右键 →「用 Authenticator 填充 TOTP」。
• 复制验证码：在弹层中点击某条目的 6 位验证码可复制到剪贴板。

导入说明与限制

• 不支持无导出直接读取：Google Authenticator 不提供直接读取已存秘钥的公开接口，需先在手机端执行「导出账号」。
• 二维码识别失败处理：请确保图片清晰、无反光、二维码完整；建议重新拍照后重试。
• HOTP 条目处理：当前导入仅保留 TOTP 条目，HOTP 会在预览/导入统计中标记为跳过。
• 撤销说明：可撤销当前页面会话中的最近一次导入，用于快速回滚误导入。

安全提示

• 导出的二维码图片等同于 2FA 秘钥明文，请勿外传。
• 导入完成后建议立即删除拍摄图片或临时文件。
• 若设备可能被他人使用，建议同时启用系统级磁盘加密和浏览器账户保护。

手工验收清单

• 使用真实 otpauth-migration 二维码图片执行一次导入，确认出现“新增 N 条”提示。
• 立即重复导入同一图片，确认提示“重复跳过”，且列表无重复条目。
• 在扩展弹层查看新条目验证码是否正常刷新（30 秒窗口倒计时）。
• 打开任意 2FA 输入页面，验证「填充」与右键菜单填充可用。
• 点击「撤销上次导入」，确认本次导入条目被移除且历史手工条目不受影响。

数据与同步

• TOTP 条目保存在浏览器本地（chrome.storage.local）。
• 选项页提供「同步设置（预留）」：可保存 API 端点与 Token，后续可对接后端拉取 TOTP 列表。