IvyKey 常春钥 使用帮助

适用版本：桌面版 1.0（Fedora 与 Windows，测试版）。最后更新：2026-11-02。 本软件尚未经过独立安全审查，请勿用它保存真实密码。

1. 先读这三条

1. 没有找回密码服务。 主密码只存在于你的脑子里。忘记主密码、又丢了恢复密钥，保险库里的数据永远无法找回，任何人（包括开发者）都帮不了你。
2. 数据只在你自己的设备上。 常春钥从不联网，没有账号、没有云端。电脑坏了或丢了，只有你自己导出的备份能救回数据。
3. 卸载应用或清除应用数据会删除本机保险库。 操作前请先导出一份加密备份。

2. 第一次使用

1. 打开应用，在"创建保险库"页设置主密码。推荐点"生成口令短语"：它会生成 6 个随机英文单词组成的口令，请抄在纸上。自己想的密码必须足够强（应用会拒绝"zhangwei19900101""woaini1314"这类常见组合）。
2. 点"创建"。应用会按本机性能调整加密强度，需要一两秒。
3. 保存恢复包：页面显示一串 27 位的恢复密钥（7 组）。把它抄写下来，或点"打印恢复包…"打印出来（只印恢复密钥和使用说明，不含任何密码；请用直接连接的打印机，不要选"打印到文件"），离线保存（例如放进抽屉或保险柜），和备份文件分开放。然后按提示回填其中两组。没有完成回填就关闭窗口或锁屏，下次解锁时会生成一份新的恢复密钥并再次要求确认——以最后确认的那份为准。
4. 进入主界面后，应用会提示导出第一份备份，见第 5 节。

已经在另一台设备上使用？在创建页点"已有其他设备导出的同步副本？从副本开始…"，选择从那台设备导出的副本文件，输入那台设备的主密码即可。

3. 日常使用

• 新增条目：左上角"＋"（Ctrl+N），先选类型：登录、银行卡、证件、API 密钥、服务器 / SSH、Wi-Fi、软件许可、安全笔记。每种类型预先准备好了常用字段（例如银行卡有卡号、有效期、安全码），敏感字段默认"隐藏"；没填的字段不会保存，字段都可以改名、增删。
• 自定义字段：每行右侧依次是"隐藏"开关、多行（适合证书、私钥、配置）、上移、下移、删除。隐藏字段在详情页只显示圆点。
• 到期日：编辑条目时可填"到期日"（或点"3 个月后""1 年后"）。详情页显示还剩几天；到期前 14 天起，"密码健康检查"会列出它。
• 复制为新条目：详情页"复制为新条目"，以当前条目为底稿新建（例如同一公司的多个系统账号），标题自动加"（副本）"。
• 安全笔记：只有正文的笔记，正文默认遮盖。
• 生成密码：编辑条目时点"生成"。在"生成器选项"中可选随机字符（长度、字符种类、排除易混淆字符）或口令短语（词数、分隔符等）。生成后会显示熵值（比特数越高越难猜）。
• 浏览：左侧边栏可按"全部条目""收藏"、文件夹、标签、"回收站"浏览，右侧数字是条目数。文件夹可以分层：在"文件夹"里写"工作/服务器"，侧边栏会显示"工作"下面的"服务器"，点"工作"会同时列出子文件夹里的条目。列表上方可选按名称、最近修改或最近创建排序。
• 搜索：列表上方的搜索框，匹配标题、用户名、网址、标签和文件夹，并与左侧所选分类叠加。不会搜索密码和备注内容。
• 复制密码：详情页"复制密码"按钮。默认 30 秒后自动清除剪贴板；在 KDE 下复制的密码不会进入剪贴板历史。
• 复制隐藏字段、安全笔记正文：详情页每个自定义字段旁有复制按钮（复制银行卡号时会自动去掉空格和短横线，方便粘贴到网页），安全笔记旁有"复制笔记"按钮。隐藏字段和笔记正文与密码一样，到时自动清除、不进剪贴板历史。安全笔记正文不能手动选中复制，请用这个按钮。适合保存 API 密钥、令牌等。
• 查看密码：点"显示密码"会先要求输入主密码，验证后 5 分钟内查看其他条目不再询问；明文 30 秒后自动隐藏。编辑已有条目、复制为新条目、查看安全笔记正文或隐藏字段（字段旁的"显示"）同样需要验证。
• 大字显示密码：密码旁的"Aa"按钮把密码每个字符放大、编号，数字蓝色、符号橙色，方便对照着在电视、路由器等设备上输入；同样先验证，到时自动关闭。
• 删除：先"移入回收站"，30 天后自动永久删除；也可以在回收站里立即"永久删除"或"恢复"。

4. 自动锁定

以下情况会立即锁定，界面上的所有明文会被清空：

• 一段时间没有操作（默认 5 分钟，可在"设置"中改为 1–60 分钟，没有"永不锁定"）；
• 锁屏、屏保启动或电脑休眠；
• 关闭窗口；
• 点右上角锁形按钮（Ctrl+L）。

连续输错主密码 5 次后，需要等待 30 秒；之后每次再错，等待时间递增。这个等待在重启应用后依然有效。

5. 备份

主菜单 →"导出同步副本 / 备份…"。导出的文件和保险库同样加密，没有主密码打不开。

• 请存到电脑以外的地方，比如 U 盘、移动硬盘；
• 不要通过网盘、邮件、聊天软件传递——那样会把密文交给第三方，对方可以离线反复猜你的主密码；
• 备份文件和恢复密钥要分开放；
• 定期导出。超过 30 天没有备份，主界面会出现提醒横幅。

验证备份：主菜单 →"验证备份…"，选择备份文件。应用会完整检查它能否被当前保险库认出、内容是否完好，不会写入任何东西。

6. 在多台设备之间同步（手工）

常春钥不联网，同步靠你自己搬文件：

1. 在设备 A 上"导出同步副本"，用 U 盘拷到设备 B；
2. 在设备 B 上"合并导入…"，选择这个文件；
3. 应用先完整检查文件，然后显示变更预览：新增、更新、删除、冲突各有多少；
4. 确认后写入，并显示结果。合并前会自动保存一个历史版本，可以撤销；
5. 要让两边完全一致，再从 B 导出一份，到 A 上合并一次。

合并规则：只有一边改过的，自动采用新版本；两边都改过的是"冲突"，默认"两个都保留"；一边删除、一边修改的，默认"保留条目"。任何情况下都不会悄悄丢数据。 如果副本比本机还旧，应用会提示"这是一个较旧的副本"，不做任何更改。

不要合并很旧的副本：永久删除的条目在所有设备都同步过、并过了保留期之后，删除记录会被清理。此后再合并一份那之前导出的旧副本或旧备份，被删除的条目可能重新出现（不会泄露数据，再删一次即可）。同步请使用最近导出的副本。

同步历史：主菜单 →"同步历史…"，查看本机每次合并的时间、来源设备和变更数量。

两台设备的主密码不同：合并照常进行。合并后应用会询问是否让本机改用另一台设备的主密码；改用前需要输入两边的主密码。

7. 历史版本与撤销

主菜单 →"历史版本…"。本机保留最近 10 个历史版本（合并前、恢复前会自动保存，也可以手动"保存当前版本"）。恢复某个版本后，恢复结果会被当作一次新的修改，下次同步时传到其他设备。

8. 主密码、恢复密钥与"轮换"——三者的区别

怀疑主密码泄露时：只修改主密码是不够的（旧备份还能用旧密码打开）。请执行"轮换保险库密钥"：

1. 先把其他设备上的变更合并进来；
2. 轮换（需要输入当前主密码、设置新主密码）；
3. 抄写新的恢复密钥并回填确认；
4. 其他设备用"替换导入"接入新保险库（见第 9 节）；
5. 轮换前应用会自动在数据目录的 backups 文件夹保存一份旧保险库的备份，它仍能用旧主密码打开。请把需要的另存到离线介质，然后在"设置 → 自动备份"中删除。

9. 替换导入

另一台设备轮换了保险库密钥后，本机的旧保险库无法再和它合并。这时在本机使用主菜单 →"替换导入…"：

• 选择对方导出的新文件，输入本机当前主密码和新文件的主密码；
• 本机现有数据会先自动备份到 backups 文件夹，然后被整体替换（不合并）；
• 之后用新文件的主密码解锁。

9a. 从其他密码管理器搬过来 / 搬出去

导入：主菜单 →"从其他密码管理器导入…"，选择文件：

• KeePass / KeePassXC：直接选 .kdbx 文件，再输入那个文件的主密码。只支持仅用密码保护的 KDBX 4（KeePassXC 默认就是）；用了密钥文件或硬件钥匙的，请先在 KeePassXC 里去掉，或导出为 CSV。
• Bitwarden：在 Bitwarden 里导出为 .json（不要选"加密的 JSON"）或 .csv。银行卡、身份信息会变成 IvyKey 的银行卡、证件类条目。
• 浏览器（Chrome、Edge、Firefox）、苹果"密码"、1Password 等导出的 .csv。

导入前会显示预览：共多少条、哪些可能和现有条目重复（默认跳过）、哪些内容不会导入（附件、两步验证码等）。确认后才写入，并自动保存一个历史版本，有问题可以在"历史版本"中撤销。

导入完成后请立即删除源文件：CSV 和未加密的 JSON 里密码都是明文。

导出：主菜单 →"导出到其他密码管理器…"（先输入主密码）：

• KeePass 文件（推荐）：用你另外设置的导出密码加密，KeePassXC、KeePass、Strongbox、Bitwarden 等都能导入。
• 明文 CSV：所有密码不加密，只在目标软件不支持 KeePass 格式时使用，用完立即删除。

平时的备份请用"导出同步副本 / 备份"，不要用这两种。

10. 忘记主密码

在解锁页点"忘记主密码？用恢复密钥解锁"，输入恢复密钥（大小写、空格、短横线都可以），并设置一个新主密码。完成后会显示一份新的恢复密钥，需要重新抄写并确认；刚才用过的那份对本机保险库作废。之前导出的备份和其他设备上的副本，仍然用旧主密码或旧恢复密钥打开。

主密码和恢复密钥都丢了：数据无法找回。

11. 设置

主菜单 →"设置…"（Ctrl+,）：

• 自动锁定时间、剪贴板清除时间（延长需要输入主密码）；
• "登录条目的备注也默认遮盖"（默认关闭；打开后登录条目的备注像安全笔记一样遮盖，点"显示笔记"才出现；关闭需要输入主密码）；
• 设备名称（出现在副本文件名和合并记录里）；
• 系统安全检查：保险库所在磁盘是否启用全盘加密（LUKS）、交换空间是否加密、是否运行在 X11（X11 下其他程序可以截屏和记录键盘）、密钥内存是否已锁定；
• 自动备份：查看数量、全部删除；
• 高级：提高密钥派生强度（会生成新的恢复密钥，所有要打开该保险库的设备都必须有足够内存）。

12. 残余风险（我们做不到的事）

如实列出，便于你判断：

• 设备已被入侵（被植入木马、键盘记录器，或别人拿到了 root 权限）：任何密码管理器都无法防护。
• 界面显示过的内容：显示过的密码、备注会短暂留在图形界面库的内存里，无法保证清零。
• 打开文件对话框的几秒内：为了让系统文件选择器工作，应用会临时放开"禁止其他程序读取本进程内存"的保护，对话框关闭后立即恢复。
• 打印恢复包：打印时恢复密钥会经过本机打印系统，可能在打印队列中临时保存；网络打印机或"打印到文件"会把它留在别处。
• 剪贴板：复制的密码会交给读取剪贴板的程序；到时清除只在 KDE（KWin）下验证过。
• 交换空间：加密密钥已锁定在内存中不会被换出；但解密后显示过的条目内容仍可能被写入未加密的交换分区。建议启用全盘加密或加密交换分区（"设置 → 系统安全检查"会提示）。
• 离线暴力破解：拿到你的保险库或备份文件的人，可以离线反复猜主密码。主密码越强越安全；这也是不要用网盘传副本的原因。
• 修改主密码不会让旧备份失效，见第 8 节。

13. 文件在哪里

（以 Flatpak 安装时，位于 ~/.var/app/nz.xlab.ivykey.IvyKey/ 下的对应目录。）

Linux 的两种安装方式（官网下载）：

• RPM（适合 Fedora）：装好后随系统更新自动更新。和普通软件一样运行，没有额外的隔离。IvyKey 本身没有任何联网功能。
• Flatpak：装好后自动更新。运行在系统的隔离环境里：系统保证它不能联网、看不到你的其他文件。
• 两种方式的数据各存一处、互不相通。不要两个都装；要换用另一种，先用"导出同步副本 / 备份"导出，装好后再"从同步副本开始"或"替换导入"。

13a. Windows 版

Windows 版与 Fedora 版界面、功能相同，区别如下（支持 Windows 10 2004 及以上与 Windows 11；Windows 10 已停止常规安全更新，建议升级到 Windows 11 或开启延长安全更新）：

• 保护：截屏、录屏、远程桌面看不到 IvyKey 的窗口；复制的密码不进入剪贴板历史（Win+V）、不同步到其他电脑，到时自动清除；锁屏（Win+L）、睡眠时立即锁定；输入主密码时暂时关闭输入法；程序崩溃时不留下内存转储；保险库文件只有你本人能访问（启动时发现被放宽会自动收紧）。
• 输入法：标题、备注等普通输入框仍经过输入法。带"云输入"的中文输入法可能把输入内容传到网上，备注里不要写密码。
• 同一账户下的其他程序：Windows 没有办法阻止同一个 Windows 账户下运行的其他程序读取 IvyKey 的内存。不要安装来路不明的软件；用完及时锁定（锁定后内存中的密钥会被清零）。
• 全盘加密：IvyKey 无法自动检测 BitLocker。请在 Windows 设置 › 隐私和安全性 › 设备加密（或 控制面板 › BitLocker 驱动器加密）中确认系统盘已加密。
• 卸载会删除数据：以安装包（MSIX）安装时，卸载 IvyKey 会连同保险库一起删除。卸载前请先导出备份或同步副本。
• 文件位置：保险库与自动备份在 %LOCALAPPDATA%\IvyKey\，设置与状态在 %LOCALAPPDATA%\IvyKey\config\（以安装包安装时由 Windows 重定向到该应用的私有目录）。
• 读屏软件：Windows 版的界面不能被"讲述人"等读屏软件读取（1.0 不支持）。需要读屏的用户请使用手机版或 Linux 版。

14. 反馈

常春钥不收集任何使用数据，也没有崩溃上报。发现问题请通过项目公布的渠道反馈；安全问题请勿公开披露，见 SECURITY.md。