连接扩展与桌面端 — 自动发现与手动配对
为什么需要"连接"
Enpass 的浏览器扩展本身不存储任何密码数据。它只是一个前端界面——真正的加密保险库（Vault）在 Enpass 桌面应用 / 移动应用里。扩展的职责是：
- 识别当前访问的网站
- 向 Enpass 应用请求对应的条目数据
- 自动填充网站表单
所以扩展必须和 Enpass 应用建立通信。这个过程叫做"连接 / Connect"。
自动发现（最常见）
安装完扩展后，第一次点击浏览器工具栏的 Enpass 图标：
场景一：Enpass 桌面应用正在运行且已解锁
扩展会在后台自动尝试发现本机运行的 Enpass 进程，通常几秒钟内就能自动连接成功。成功标志：
- 扩展弹出界面里显示的是 "已连接 / Connected" 状态
- 可以看到 Vault 里的条目列表（或输入主密码解锁扩展）
场景二：Enpass 桌面应用正在运行但未解锁
扩展会提示你 "请先解锁 Enpass 应用 / Please unlock Enpass app"。解锁 Enpass 应用后，扩展会自动连接。
场景三：Enpass 桌面应用没有运行
扩展会提示你 "找不到 Enpass / Can't find Enpass"。解决方案：启动 Enpass 应用 → 等待 2~3 秒 → 扩展会自动重试。
手动配对（自动发现失败时）
如果自动发现不工作（比如某些系统权限阻止了进程间通信），可以手动配对。
步骤
- 确保 Enpass 桌面应用正在运行并已解锁
- 打开 Enpass 应用 → 设置 → 浏览器扩展 / Browser
- 找到"连接扩展 / Connect Extension"或类似入口 → 显示一个连接码 / 配对码
- 在浏览器扩展弹出界面里 → 找"手动连接 / Manual Connect"选项 → 输入连接码
- 确认连接成功
某些浏览器的特殊情况
- Firefox：首次安装扩展时会弹出"是否允许 Enpass 与本地应用通信"的权限确认 → 必须点允许，否则扩展无法连接
- Safari：Safari 扩展和 Enpass App 的连接由系统级桥接完成，通常不需要手动配对
连接成功后的状态
连接成功的标志：
| 状态 | 扩展显示 |
|---|---|
| 已连接 + Enpass 已解锁 | 条目列表可见，或可以用生物识别快速解锁 |
| 已连接 + Enpass 未解锁 | "请解锁 Enpass 应用"提示 |
| 未连接 | "找不到 Enpass / Not connected"提示 |
扩展里会显示当前连接的 Enpass 应用信息（版本号、运行状态）。
扩展能做什么、不能做什么
扩展可以做
- ✅ 列出当前 Vault 的条目（需解锁）
- ✅ 根据当前网站 URL 匹配对应条目
- ✅ 自动填充密码 / 用户名 / 信用卡 / 身份信息 / 2FA 码
- ✅ 在新网站注册时捕获并保存密码
- ✅ 用生成器生成新密码
- ✅ 切换当前使用的 Vault
扩展不能做
- ❌ 独立解锁 Vault（必须通过 Enpass 应用解锁）
- ❌ 修改 Vault 设置（创建新 Vault、改存储位置等要在 Enpass 应用里做）
- ❌ 访问附件（附件只在 Enpass 应用里打开）
- ❌ 导出 Vault 数据（导出在 Enpass 应用里做）
这个设计是有意的安全分层——扩展能做的都是"填充类"的轻量操作，核心管理功能都在 Enpass 应用里。
Vault 切换
扩展可以切换当前使用的 Vault（如果你有多个 Vault）：
- 点击扩展图标 → 找到 Vault 选择器 → 从下拉列表选目标 Vault
- 切换后扩展会重新加载该 Vault 的条目列表
连接断开怎么办
如果扩展突然显示"Not Connected"：
- Enpass 应用还在运行吗？ 可能被关闭或崩溃了——重新启动
- Enpass 应用还是解锁状态吗？ 应用可能自动锁定了——重新解锁
- 重启浏览器 —— 有时浏览器更新或扩展冲突导致通信中断
- Enpass 版本更新了吗？ 如果扩展提示版本不匹配，同时更新扩展和 Enpass 应用
Safari 上的连接（iOS / macOS）
Safari 扩展和 Enpass App 的连接由系统级 App Extension 机制处理：
- 不需要手动配对
- 只要 Enpass App 在运行并已解锁，Safari 扩展就能自动工作
- 如果 Safari 扩展没反应，确认系统设置里已经给 Enpass 开启了 Safari 扩展权限
下一步：让扩展帮你自动填充——参见 表单自动填充。