蛙记浏览器扩展使用指南：从保存账号到网页自动填充

这是一篇面向浏览器扩展新用户的指南。完成首次设置后，你可以直接在网页登录框中调用已保存的账号和密码，也可以在注册、改密和使用 Passkey 时把新信息保存到蛙记。

浏览器扩展当前以登录项目为主。银行卡、身份资料等其他项目类型请在蛙记客户端中管理。

1. 安装、固定与登录

先从蛙记下载页或对应浏览器的扩展商店安装扩展。固定到工具栏后，可以随时打开密码库、同步内容或手动锁定扩展。

1. 安装蛙记浏览器扩展。
2. 在浏览器工具栏的扩展菜单中找到蛙记，点击 固定，让图标始终显示在地址栏旁边。
3. 点击蛙记图标。已有账号时，输入邮箱和主密码登录；没有账号时，选择注册并按页面提示完成邮箱验证和主密码设置。
4. 登录后输入主密码解锁密码库。解锁成功后，扩展会加载并同步登录项目。

提示： 主密码只应输入到蛙记扩展自己的登录或解锁窗口。不要因为网页弹窗、聊天消息或邮件的提示而在陌生页面输入主密码。

2. 认识扩展密码库

点击工具栏中的蛙记图标可打开密码库。顶部可以搜索项目名称、用户名或网址；也可以在 收藏、建议、所有 项目之间切换，并按分组、密码项目、OTP 项目、通行密钥或二次验证项目筛选。

1. 在网页登录前打开扩展，查看 建议 中是否出现当前网站的匹配项目。
2. 输入名称、用户名或网址搜索项目，然后打开项目详情。
3. 在详情中可以查看网址和备注、复制密码或当前 OTP 验证码、打开网站、编辑项目、添加收藏或删除项目。
4. 需要获取其他设备的最新修改时，点击顶部的 同步 图标。
5. 使用完成后，点击锁定图标；锁定后再次查看或填充敏感内容时需要重新解锁。

离线模式： 已缓存的内容仍可查看，但新建、编辑、保存、删除和收藏等会写入密码库的操作不可用。恢复网络后同步，再继续操作。

3. 新建、编辑与整理登录项目

手动新建适合网页没有触发保存提示，或需要提前录入账号的情况。为每个服务保留独立项目，并填写真实登录网址，自动填充才能更准确地匹配。

1. 打开扩展，点击右上角的 新建凭据。
2. 填写 项目名、用户名 和 密码。用户名可以是邮箱、手机号或服务要求的账号名。
3. 填写一个或多个 网址，例如 https://github.com。只填写服务名称而不填写网址，会降低网页匹配准确性。
4. 按需选择 分组、添加 备注，然后点击 保存凭据。
5. 修改密码、用户名或网址时，打开原项目选择 编辑凭据，更新后保存；不要为同一个账号反复新建相似项目。
6. 对高敏感项目，可在详情页开启 二次验证。之后显示、复制或自动填充敏感内容时，扩展会再次要求输入主密码。

如果你需要把 TOTP 加入项目，在编辑页的 验证码（TOTP） 字段粘贴网站提供的 otpauth:// 链接或 Base32 密钥。该功能需要会员资格；扩展不提供扫描网页二维码的功能。

4. 在网页中自动填充

完成登录项目保存后，蛙记会在网页的用户名、密码或验证码输入框旁提供入口。项目网址与当前网页匹配时，扩展会优先显示相应建议。

1. 打开目标网站的登录页，确认蛙记密码库已解锁。
2. 点击用户名、密码或验证码输入框旁的蛙记入口。
3. 从菜单中选择正确的登录项目，确认用户名、密码或 OTP 应填入的字段。
4. 填充后核对网页地址和账号，再提交登录表单。
5. 没有出现正确项目时，打开扩展搜索项目，并检查该项目中保存的网址是否为实际登录地址。

在 HTTP 页面或跨来源 iframe 等风险更高的场景中，扩展可能先要求确认。确认前请核对域名；不要为了省事而在不可信页面填充账号或密码。

5. 保存新账号或更新后的密码

当你在网页中注册账号、手动登录，或修改密码并成功提交表单后，扩展会在识别到用户名和密码时显示保存提示。并非所有网站都会以标准方式暴露登录表单，因此保存提示不会在每个网页中出现。

1. 在网站中完成注册、登录或修改密码，并正常提交表单。
2. 出现蛙记保存提示后，核对项目名称、用户名和网址。
3. 新账号选择 保存；已有账号改密时，选择 更新 对应项目。
4. 不确定是否属于同一个账号时，选择 保存为新凭据，避免覆盖原有密码。
5. 需要补充分组、备注或网址时，打开编辑窗口后再保存。

无法出现保存提示： 请先确认密码库已解锁、网页确实包含用户名和密码字段，并在提交后停留片刻。仍未出现时，按第 3 节手动新建项目。

6. 使用密码生成器与 OTP

生成强密码

扩展内置随机密码生成器，可设置长度以及是否包含大写字母和特殊字符。新注册账号或修改泄露、重复的密码时，优先生成新的独立密码。

1. 打开扩展，点击 密码生成器。
2. 设置长度；普通网站密码建议至少 15 个字符，并按网站要求保留大写字母和特殊字符。
3. 点击 重新生成 直到获得合适的密码，再点击 复制。
4. 返回网页或项目编辑页粘贴密码，并保存登录项目。

查看和复制 OTP

已保存 TOTP 密钥的项目会显示定时刷新的验证码。打开项目详情后，点击 复制验证码，再粘贴到网站的二次验证输入框。TOTP 密钥与密码同样敏感，不要发送给他人。

7. 保存并使用 Passkey（通行密钥）

Passkey 必须由支持该功能的网站发起创建或登录请求，不能在密码库中手动凭空创建。保存新的 Passkey 时需要联网。

保存新的 Passkey

1. 在支持 Passkey 的网站中进入账户安全设置，选择添加、创建或注册 Passkey。
2. 蛙记打开 Passkey 窗口后，核对显示的网站和账号。
3. 选择 新建项目，或选择已有的匹配登录项目并更新它。
4. 网站要求用户验证时，按蛙记窗口提示输入主密码；确认网站地址正确后再继续。
5. 确认保存，返回网站等待它显示创建成功。

使用已有 Passkey 登录

1. 在网站登录页选择 使用 Passkey 或类似选项。
2. 在蛙记窗口中选择与当前网站匹配的 Passkey。
3. 按提示解锁或完成主密码验证。
4. 浏览器会把认证结果交回网站，完成登录。

注意： 当前版本不能编辑仅包含 Passkey 的项目。需要更新用户名、网址或其他登录信息时，请在关联的登录项目中操作。

8. 设置锁定、隐私与快捷键

在扩展的 设置 中，可以调整显示语言、安全策略、自动填充确认和浏览器快捷键。

1. 在 安全 中设置自动锁定时间，以及超时后选择 锁定 或 注销。
2. 需要更严格的会话控制时，开启 锁定时清除登录令牌。开启后，下次同步可能需要重新登录。
3. 仅在已配置本地解锁条件时，才会显示 启用本地解锁。没有该条件时，继续使用主密码解锁即可。
4. 在 隐私 中，建议关闭 跳过自动填充安全确认，以便在 HTTP 页面或跨来源 iframe 填充时保留确认步骤。
5. 在 通用 > 快捷键 中查看或修改打开扩展、锁定扩展的浏览器快捷键。

9. 常见问题与排查

网页输入框旁没有蛙记入口

• 确认扩展已启用，并且蛙记图标不是锁定状态。
• 刷新网页后再次点击用户名或密码输入框；部分页面会在加载完成后才出现入口。
• 确认页面不是浏览器内部页面、扩展管理页或其他不允许内容脚本运行的页面。

没有出现正确的自动填充项目

• 打开扩展的 建议 或搜索项目，确认密码库已同步。
• 编辑项目中的网址，填写实际登录页的域名或地址。
• 不要把多个无关网站放进同一个登录项目。

保存提示没有出现

• 确认密码库已解锁，并在网页提交登录表单后等待提示。
• 某些网站使用非标准登录流程，扩展可能无法识别用户名或密码字段；此时手动新建或编辑项目。
• 离线模式下不能保存或更新项目，恢复网络并同步后重试。

OTP 或 Passkey 无法使用

• OTP：确认保存的是验证器密钥或 otpauth:// 链接，不是短信验证码；同时检查设备时间是否自动同步。
• Passkey：确认网站本身支持 Passkey，当前网页地址正确，且保存新 Passkey 时网络可用。
• 仍无法完成时，先锁定再重新解锁扩展，并执行一次同步后重试。

完成设置后，建议先用风险较低的测试账号验证“新建项目 → 网页填充 → 保存或更新密码 → Passkey”的完整流程，再迁入邮箱、支付和工作账号等重要凭据。