适用版本：苹果版 1.0 测试版（iPhone；Mac 需 Apple 芯片）。最后更新：2026-11-02。 本软件尚未经过独立安全审查，测试期间请不要只把真实密码存在这里。
界面语言跟随系统：系统语言是中文（简体或繁体）时显示中文，其他语言显示英文。只想让 IvyKey 换一种语言：iPhone 上在"设置 › App › 常春钥 › 语言"，Mac 上在"系统设置 › 通用 › 语言与地区 › 应用程序"。
1. 先读这三条
- 没有找回密码服务。 忘记主密码、又丢了恢复密钥，数据永远无法找回，开发者也帮不了你。
- 删除应用 = 数据没了。 在 iPhone 上删除 IvyKey（包括系统的"卸载未使用的 App"），保险库会一起被删除。Mac 上用清理软件删除 IvyKey 的数据也一样。请经常导出备份，拷到电脑或 U 盘上。
- IvyKey 不联网。 它没有账号、没有云端，不进 iCloud，也不进电脑上的 iPhone 备份或 Mac 的时间机器；同步和备份都由你自己拷文件完成。
2. 第一次使用
全新开始：点"创建新保险库"→ 设置主密码（推荐"生成口令短语"，抄在纸上）→ 保存恢复包（抄写或打印，然后回填其中两组）→ 导出第一份备份。
电脑或另一台设备上已经有保险库：
- 在那台设备的 IvyKey 里"导出同步副本"；
- 把副本拷到这台设备上：iPhone 可以用"隔空投送"、数据线（Mac 的"访达"或 Windows 的"Apple 设备"应用里，把文件拖到 IvyKey 或"文件"应用）、U 盘（"文件"应用支持 U 盘）；
- 在欢迎页点"从电脑的同步副本开始"，选择这个文件，输入那个保险库的主密码。
3. 恢复包
恢复包是一张纸：上面只有恢复密钥（7 组字符）和使用说明，不包含任何密码。忘记主密码时，用它打开保险库并设置新主密码。
- 恢复密钥只显示一次。可以抄写，也可以点"打印恢复包…"用打印机打印。
- 打印时请用直接连接的打印机（iPhone 用"隔空打印"打印机；Mac 用 USB 或局域网打印机）。不要选"存储为 PDF"、不要分享到其他 App、不要用云打印——那样恢复密钥会以文件形式留在设备上。打印队列也可能临时保存内容。
- 抄好或打印好之后，按提示回填其中两组，确认无误才能进入保险库。
- 恢复包放在只有你（或你信任的家人）能拿到的地方，与备份 U 盘分开，不要拍照。
4. 日常使用
- 新建：条目列表上方的"＋"（Mac 上按 ⌘N），先选类型（登录、银行卡、证件、API 密钥、服务器、Wi-Fi、软件许可、安全笔记），每种类型都预填了常用字段。
- 分类：侧边栏按全部、收藏、文件夹、标签、回收站浏览。iPhone 上点左上角返回到侧边栏。
- 查看密码：详情页点"眼睛"。距上次验证超过 5 分钟时会先要求输入主密码。默认 30 秒后自动隐藏。"大字显示密码"把每个字符放大并编号，方便对照输入到电视等设备。
- 复制：复制的密码默认 30 秒后自动从剪贴板清除。iPhone 上复制的内容只留在本机，不会经"通用剪贴板"传到你的 Mac 或 iPad；Mac 上复制的密码同样只留在本机（不经"通用剪贴板"传到 iPhone），并标记为"机密"，剪贴板管理工具通常不会记录。复制用户名、网址等普通内容不受这些限制。
- 锁定：工具栏上的锁；Mac 上也可以用菜单栏"保险库 › 锁定"或按 ⌘L。
- Mac 菜单栏：设置在"常春钥 › 设置…"（⌘,）；同步与备份、密码健康检查在"保险库"菜单；使用帮助在"帮助"菜单。窗口较窄时工具栏右侧会出现 »，锁定和工具按钮在里面。
- 生成密码：编辑条目时点"生成"，可以选随机字符或口令短语。
5. 自动锁定
- iPhone 锁屏：立即锁定。Mac 锁屏、睡眠、屏幕关闭、切换用户：立即锁定。
- 切到其他应用：默认 30 秒后锁定（设置里可改为立即）；
- 在 IvyKey 里一直不操作：默认 5 分钟后锁定。
锁定后，内存里的钥匙会被清除，屏幕上的明文也会清空。在设置里把任何一项改得更宽松，都要先输入主密码。
5a. 面容 ID / 触控 ID / PIN 码快速解锁
在"工具 › 设置 › 快速解锁"开启（需要先输入一次主密码）。默认关闭。
- 面容 ID / 触控 ID：开启时会马上验证一次。钥匙锁在设备的安全芯片（安全隔区）里，IvyKey 拿不到你的面容或指纹。
- PIN 码：设一个 6～12 位数字，只用于 IvyKey。不要和锁屏密码、银行卡密码相同，也不要用生日、123456、123123 这类容易猜的数字（IvyKey 会拒绝）。连续输错 5 次，PIN 码解锁自动关闭，必须输入主密码。
- 两种只能开一个；开启一个会自动关闭另一个。
- 设备重启后、或距上次输入主密码超过 24 小时（可改为 1～72 小时），必须输入主密码。这是为了防止有人趁你睡着或强迫你解锁。
- 在系统里新增或删除了面容 / 指纹，面容 ID / 触控 ID 解锁会自动关闭，需要输入主密码后重新开启。
- 修改主密码、轮换保险库密钥、替换导入、用恢复密钥解锁之后，快速解锁会自动关闭，需要重新开启。
- 设备必须设置了锁屏密码才能开启；关掉锁屏密码后，系统会删除快速解锁的钥匙。
- 查看密码等需要验证身份时，也可以用面容 ID / PIN 码；但开启快速解锁和导出明文 CSV 必须输入主密码。
5b. 自动填充（iPhone、Mac）
开启：iPhone 的"设置 › 通用 › 自动填充与密码"，在"自动填充自"里打开"常春钥"（系统语言不是中文时显示为"IvyKey"）。Mac 上是"系统设置 › 通用 › 自动填充与密码"（较旧的系统在"密码 › 密码选项"）。
使用：在 Safari 或其他 App 的登录框里点一下，键盘上方出现"自动填充密码"→ 选"常春钥"→ 用面容 ID / PIN 码 / 主密码解锁 → 点要用的条目，用户名和密码就填进去了。IvyKey 从不在你没点的时候自动填。
Mac 上：在 Safari 的登录框里点一下，再点输入框右侧的钥匙图标 → 选"常春钥…"→ 输入主密码（或用触控 ID）解锁 → 点条目。不想填了点"取消"或按 Esc。Mac 上的自动填充面板由系统画在 Safari 窗口里，录屏或屏幕共享时看得到面板上的条目名称和用户名（密码从不显示在面板上）；录屏、共享屏幕时请不要打开它。
- 网址怎么匹配：按主域名匹配。条目里写
www.google.com，在accounts.google.com上也会列出；google.com.evil.cn这种仿冒网址不会列出。 - 网址不一致的提醒：在"其他条目"里选了一个网址不匹配的条目时，IvyKey 会提醒你"钓鱼网站常常仿冒知名网站"。只有确认是同一个网站时才继续。
- 其他 App：系统只告诉 IvyKey 该 App 关联的网站；没有关联网站的 App，请在"其他条目"里手动选择。
- IvyKey 不会把你的账号列表交给系统（所以键盘上方不会直接显示账号名），这样手机锁着或 IvyKey 锁着时，系统也不知道你有哪些网站的账号。
- 苹果系统不允许第三方密码管理器在你登录后"保存新密码"，新账号请在 IvyKey 里手动添加。
6. 与其他设备同步、备份
工具（列表顶部的"…"按钮）› 同步与备份：
- 导出同步副本：在系统的文件面板里选位置（例如"文件"应用的"我的 iPhone"或 U 盘）。导出后会自动读回验证。然后把它拷到另一台设备上，在那里的 IvyKey 中"合并导入"。
- 合并导入：选择另一台设备导出的副本 → 看预览（新增、更新、删除、冲突）→ 确认。合并前自动保存历史版本，可以在"历史版本"里撤销。两边都改过同一条目时，会让你选择保留哪一个，或者两个都留。
- 替换导入：用另一个保险库文件整体替换这台设备上的保险库（例如另一台设备"轮换保险库密钥"之后）。替换前会自动在应用内备份旧数据。
- 验证备份：检查一份备份能否完整打开，不做任何更改。
超过 30 天没有备份，条目列表顶部会一直提醒。
7. 从其他密码管理器搬过来 / 搬出去
工具 › 同步与备份 › "其他密码管理器"：
- 导入：支持 KeePass / KeePassXC 的
.kdbx（输入那个文件的密码）、Bitwarden 的.json（未加密）或.csv、Chrome / Firefox / 苹果"密码"等导出的.csv。先看预览（可能重复的默认跳过），确认后才导入，导入前自动保存历史版本。导入后请删除源文件，它里面的密码通常是明文。 - 导出为 KeePass 文件（加密）：设置一个单独的导出密码，其他密码管理器都能导入。
- 导出为明文 CSV：不加密，每次都要输入主密码；用完立即删除。
8. 密码健康检查
工具 › 密码健康检查：列出弱密码、多个条目共用的密码、很久没换的密码、已过期和快到期的密码。点一项直接打开那个条目。
9. 忘记主密码
解锁页点"忘记主密码？用恢复密钥解锁"，输入恢复包上的恢复密钥（大小写、空格、短横线都可以），并设置新主密码。完成后会生成新的恢复密钥，请重新抄写或打印保存，旧的那张作废。
10. 设置
工具 › 设置：
- 自动锁定时间、剪贴板清除时间、密码显示多久后自动隐藏；
- "登录条目的备注也默认遮盖"（默认关闭；关闭需要验证）；
- 修改主密码、重新生成恢复包、轮换保险库密钥（怀疑主密码或旧备份泄露时使用；轮换前自动备份）；
- 安全状态：设备是否设置了锁屏密码、内存中的钥匙是否已锁定（不会被换出到磁盘）；Mac 上还会提醒开启"文件保险箱"（全盘加密），并有打开系统设置的按钮。
11. 安全提醒
- iPhone：录屏、屏幕镜像（投屏）时 IvyKey 的内容会被遮挡，多任务界面里只显示 IvyKey 图标。iPhone 系统不允许应用阻止单张截屏，请不要在显示密码时截屏；万一截了，IvyKey 会提醒你去"照片"里删除（开启了 iCloud 照片的话，截图可能已经上传）。
- Mac：截屏、录屏、屏幕共享都看不到 IvyKey 窗口的内容。
- 请给 iPhone 设置锁屏密码，并保持系统更新。系统本身有漏洞时，任何应用的保护都可能被绕过。
- 自动填充见第 5b 节。
12. 删除 IvyKey 前
- 导出一份同步副本或备份，拷到另一台设备或 U 盘；
- 在另一台设备的 IvyKey 中"验证备份"成功；
- 再删除。重装后选择"从电脑的同步副本开始"即可恢复。