Mac

#安装

MimiKey Mac App 目前是内测版，需要 macOS 14 或更高版本。

1. 在 下载 页面下载 .dmg 安装包。
2. 打开 .dmg，把 MimiKey 拖到「应用程序」文件夹。
3. 内测版尚未经过 Apple 公证，第一次打开时请在「访达」中 右键点击 MimiKey → 打开，再在弹出的对话框中点击「打开」。之后可以正常双击启动。

Mac App 同时承担两项本机职责：

• 为 浏览器扩展 提供条目，扩展必须配合 Mac App 使用。
• 提供 macOS 系统自动填充，见 自动填充。

#登录或注册

1. 打开 MimiKey。首次使用时显示登录页。
2. 已有账号：输入邮箱、主密码和 Secret Key，点击「登录」。这台 Mac 之后会记住 Secret Key，下次只需主密码。
3. 还没有账号：点击「注册」，依次填写邮箱、邮箱验证码、设备名称和主密码，然后保存应急包。流程与 快速开始 相同。
4. 忘记主密码：点击「忘记主密码？」，见 设备与账号找回。

#主窗口

#新建和编辑条目

1. 点击「新建条目」，选择类型。
2. 填写字段。带「（必填）」的字段不能为空。网站账号可以展开「+ 添加备注」「+ 添加验证码密钥」等可选字段。
3. 需要新密码时点击「生成」，会填入一条 24 位、含符号的随机密码。
4. 点击「保存」。保存后会同步到你的其他设备。

切换条目或关闭编辑时如果有未保存的修改，MimiKey 会询问「保存并继续 / 放弃修改 / 继续编辑」。删除条目需要再次确认，删除会同步到全部设备。

通行密钥条目由自动填充在网站注册时自动创建，只能查看网站、显示名、凭据 ID 和创建时间，私钥不会显示。

#复制

点击字段旁的「复制」把内容放到剪贴板。30 秒后或锁定时，如果剪贴板里仍是 MimiKey 复制的内容，会被自动清除；你之后复制的其他内容不受影响。

#锁定与解锁

• 5 分钟没有操作，MimiKey 自动锁定。
• 手动锁定：按 ⌘L，或使用菜单「保险库 → 锁定保险库」，或侧栏「锁定账号」。
• 解锁：输入主密码，或使用 Touch ID。解锁时 MimiKey 会连接服务器登录并同步，因此需要网络。

锁定或退出时，未保存的编辑内容会被丢弃。

#开启 Touch ID 解锁

1. 先用主密码解锁 MimiKey。
2. 按 ⌘, 打开「偏好设置」。
3. 在「解锁」中勾选「用 Touch ID 解锁」，按提示验证一次指纹。

开启后，锁定页会自动弹出 Touch ID 验证；取消或失败时改用主密码。解锁材料由 Mac 的 Secure Enclave 保护，取消勾选即从本机删除。需要这台 Mac 已在系统设置中录入指纹。

#同步与冲突

条目在保存时自动同步。点击工具栏的同步按钮可以立即同步，结果会显示推送、拉取和冲突的数量。

同一条目在两台设备上同时被修改时会产生冲突，列表上方显示「有同步冲突待裁决」。点击「查看并裁决」，对每个冲突选择「保留本机」或「保留服务器」，另一侧的修改会被丢弃。冲突未处理前，该条目不能再编辑。

#浏览器填充设置

在「偏好设置 → 浏览器填充」中：

• 填充确认：严格、均衡（默认）或便捷，决定浏览器和系统自动填充在 MimiKey 中弹出确认的频率，见 自动填充。
• 手动开启查询：勾选后，MimiKey 不再在解锁期间持续接收浏览器请求，需要你每次手动开启一次查询。

按 ⌘. 可以取消正在进行的浏览器查询。

#账号安全与设备

• 「账号安全」：更换主密码、设备管理、清空保险库。
• 「设备」：查看已登记的设备并吊销。

详见 设备与账号找回。

#退出账号

在侧栏点击「退出账号」。退出后，这台 Mac 保存的 Secret Key 和本机同步记录会被删除，服务器和其他设备上的数据不受影响。下次登录需要重新输入 Secret Key。

#已知限制

• 内测版本未经 Apple 公证，首次打开需右键 → 打开。
• 内测期间，macOS 系统自动填充扩展只能在已登记的开发设备上运行；从下载页安装的版本以主程序和浏览器扩展为准。
• 解锁需要网络连接，暂不支持离线使用。
• 侧栏中折叠的「旧模式（本机文件）」是早期的单机保险库模式，仅为兼容保留，新用户无需使用。