
vault-tool · 功能说明
改密码时保留原来没改的内容,容量不够或要换密钥文件时先做另一份经过验证的库。新副本未成功前旧库不动;中途失败会说明原路径和恢复副本各是什么状态,而不是只留一句失败。
当前情况:已有只改已打开内容层、生成新副本及失败回退的维护功能;真实私人资料恢复仍需独立验证。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库


vault-tool · 功能说明
改密码时保留原来没改的内容,容量不够或要换密钥文件时先做另一份经过验证的库。新副本未成功前旧库不动;中途失败会说明原路径和恢复副本各是什么状态,而不是只留一句失败。
当前情况:已有只改已打开内容层、生成新副本及失败回退的维护功能;真实私人资料恢复仍需独立验证。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库


用途与实际影响
改密码和升级都会生成新密文。操作中的临时副本、明确保留的旧库和远端备份各有不同去向;把它们都叫“自动备份”,出问题时反而可能找不到能恢复的那一份。
“给这份库换密码,先确认原来能打开的文件仍然在;失败时不要损坏旧库。”流程要先验证旧凭据,再核对重建范围与自检,并明确旧库副本是否会在成功后删除。
得到经验证的新密码槽位、升级后的库或独立重建副本,并说明保留了哪些层、原库和恢复副本在哪里。冲突、取消和回滚失败单列;未知层的字节保留不等于已经验证其密码。

用途与实际影响
改密码和升级都会生成新密文。操作中的临时副本、明确保留的旧库和远端备份各有不同去向;把它们都叫“自动备份”,出问题时反而可能找不到能恢复的那一份。
“给这份库换密码,先确认原来能打开的文件仍然在;失败时不要损坏旧库。”流程要先验证旧凭据,再核对重建范围与自检,并明确旧库副本是否会在成功后删除。
得到经验证的新密码槽位、升级后的库或独立重建副本,并说明保留了哪些层、原库和恢复副本在哪里。冲突、取消和回滚失败单列;未知层的字节保留不等于已经验证其密码。

新凭据或新格式下能取回本次明确维护的内容,并说明实际留下的旧库位置和寿命。
自检、写入、恢复或层次保留不成立时返回失败;已经发生的变化与仍可用原件分开说明。
旧凭据无法打开、必要密钥文件缺失或当前格式不支持该维护时停止,不把它当成新建空库。

新凭据或新格式下能取回本次明确维护的内容,并说明实际留下的旧库位置和寿命。
自检、写入、恢复或层次保留不成立时返回失败;已经发生的变化与仍可用原件分开说明。
旧凭据无法打开、必要密钥文件缺失或当前格式不支持该维护时停止,不把它当成新建空库。

改密:在已接通本机 vault-workflow 的 AI 对话中指定库,用技能的 ChangePassword,本人在本地提供旧凭据。迁移格式用核心命令 migrate,扩容或换密钥文件用 rebuild --out 生成新副本,清理旧备份用本机终端菜单;AI 技能没有这几项的模式,AI 可以帮我准备对应的本地步骤,但不会虚构一个通用维护窗口。
- 要维护的库
- 本次是改密、迁移、重建还是清理
- 新库或旧备份的保留选择
- 本人在本地提供旧凭据


改密:在已接通本机 vault-workflow 的 AI 对话中指定库,用技能的 ChangePassword,本人在本地提供旧凭据。迁移格式用核心命令 migrate,扩容或换密钥文件用 rebuild --out 生成新副本,清理旧备份用本机终端菜单;AI 技能没有这几项的模式,AI 可以帮我准备对应的本地步骤,但不会虚构一个通用维护窗口。
- 要维护的库
- 本次是改密、迁移、重建还是清理
- 新库或旧备份的保留选择
- 本人在本地提供旧凭据


这里保留实现、关键条件、精确入口、历史记录和验证结果。
槽位改密、可验证新副本与事务回退已实现;2026-10-11 重读源码,行为未变,真实私人恢复另验(源码 b884ab61,版本 2.3.1)


- migrate_mode 识别当前格式;已有 VAULT03 则无需升级,VAULT01/02 需要原凭据解开再以当前格式重新封装。
- migrate、decoy、passwd 与本地编辑复用密文事务:候选验证、临时密文 fsync 与读回、原目标变化检查、提交、最终验证和必要回滚。失败恢复不覆盖第三方的并发变化;回滚也失败时保留
.rollback.enc,不报“已恢复”。迁移与双层设置保留不会覆盖已有文件的独立密文恢复副本:.enc.bak已存在就另起.recovery.<随机>.enc。
- passwd 对 VAULT03 只重加密当前解锁槽,原 KDF 及未解锁槽位密文字节保留。共享密钥文件标志不能在不知道另一层凭据时原地变更;credential-plan 明确引导到 rebuild --out 的新副本。
- rebuild 创建独立、读回验证的新容器,用于扩容、共享密钥文件变化或层次重建;可只复制当前已验证层而保留原库,也可显式输入第二个已知密码,在确认打开不同槽位并分别验证后保全两层。新库为后续编辑预留有界空间,旧槽不会静默扩大。
- VAULT03 改密和设置诱饵保留原 KDF 及全部编码参数,VAULT02 升级保留其 scrypt 参数;只有 VAULT01 迁移因原 PBKDF2 不在现有 V3 格式中,明确转为当前 scrypt。结构损坏或原算法不可用在密码、备份和写入前停止。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
槽位改密、可验证新副本与事务回退已实现;2026-10-11 重读源码,行为未变,真实私人恢复另验(源码 b884ab61,版本 2.3.1)


- migrate_mode 识别当前格式;已有 VAULT03 则无需升级,VAULT01/02 需要原凭据解开再以当前格式重新封装。
- migrate、decoy、passwd 与本地编辑复用密文事务:候选验证、临时密文 fsync 与读回、原目标变化检查、提交、最终验证和必要回滚。失败恢复不覆盖第三方的并发变化;回滚也失败时保留
.rollback.enc,不报“已恢复”。迁移与双层设置保留不会覆盖已有文件的独立密文恢复副本:.enc.bak已存在就另起.recovery.<随机>.enc。
- passwd 对 VAULT03 只重加密当前解锁槽,原 KDF 及未解锁槽位密文字节保留。共享密钥文件标志不能在不知道另一层凭据时原地变更;credential-plan 明确引导到 rebuild --out 的新副本。
- rebuild 创建独立、读回验证的新容器,用于扩容、共享密钥文件变化或层次重建;可只复制当前已验证层而保留原库,也可显式输入第二个已知密码,在确认打开不同槽位并分别验证后保全两层。新库为后续编辑预留有界空间,旧槽不会静默扩大。
- VAULT03 改密和设置诱饵保留原 KDF 及全部编码参数,VAULT02 升级保留其 scrypt 参数;只有 VAULT01 迁移因原 PBKDF2 不在现有 V3 格式中,明确转为当前 scrypt。结构损坏或原算法不可用在密码、备份和写入前停止。

- clean_backups_mode 枚举实际备份并要求本人明确确认;删除只针对精确备份,不等于清理全部原文、系统历史或云端版本。
- 恢复条件包括原库字节、对应密码、精确密钥文件及运行依赖;本机备份、私人仓库提交与另一磁盘副本分别证明各自保存状态。


- clean_backups_mode 枚举实际备份并要求本人明确确认;删除只针对精确备份,不等于清理全部原文、系统历史或云端版本。
- 恢复条件包括原库字节、对应密码、精确密钥文件及运行依赖;本机备份、私人仓库提交与另一磁盘副本分别证明各自保存状态。



| 名词 | 意思 |
|---|---|
| migration(格式迁移) | 先解读旧格式,再重新生成当前格式的密文;不是直接给旧文件换一个扩展名。 |
| rollback copy(回退副本) | 操作失败时用于恢复旧状态的具体文件;必须说明它何时产生、何时仍在、何时会被删除。 |
| unlocked layer(本次打开的内容层) | 当前凭据实际解出的那份内容,不自动等同双密码容器的全部内容。 |

新密码能用还不够;原内容、另一层、旧库备份和失败回退必须分别核对。



新密码能用还不够;原内容、另一层、旧库备份和失败回退必须分别核对。

解决什么
防止维护过程假成功、丢失未核对内容,以及对旧库备份产生错误预期。

- 恢复不是找回遗失密码,也不是把损坏的唯一密文自动修成原文。
- 不能为方便改密而静默改变原本声明的凭据、格式或层次范围。
- 没有实际私人备份或换机演练时,源码与样例只证明实现和所测试流程。
- 旧密码或密钥文件不匹配: 停止维护,不生成替代空库,也不把旧库删掉后让本人再试。
- 新库自检或提交失败: 保留或恢复原库,明确是否产生临时文件,失败不能被命令行退出 0 隐藏。
- 无法保留其他内容层: 明确本操作的维护范围并保持可恢复原件;本地编辑入口无法保真时直接拒绝,不伪称双层完整。

解决什么
防止维护过程假成功、丢失未核对内容,以及对旧库备份产生错误预期。

- 恢复不是找回遗失密码,也不是把损坏的唯一密文自动修成原文。
- 不能为方便改密而静默改变原本声明的凭据、格式或层次范围。
- 没有实际私人备份或换机演练时,源码与样例只证明实现和所测试流程。
- 旧密码或密钥文件不匹配: 停止维护,不生成替代空库,也不把旧库删掉后让本人再试。
- 新库自检或提交失败: 保留或恢复原库,明确是否产生临时文件,失败不能被命令行退出 0 隐藏。
- 无法保留其他内容层: 明确本操作的维护范围并保持可恢复原件;本地编辑入口无法保真时直接拒绝,不伪称双层完整。

- migrate_mode、change_password_mode、clean_backups_mode 与备份寿命
- 改密、旧库迁移、备份与错误分支回归
- 与私人远端密文备份区分的人工恢复流程
- 2026-09-03 的虚构探针验证过旧密码拒绝、新密码往返,以及 V2→V3 内容相同并留下 .bak;这次只重读回执,没有重新运行。
- 9 月 3 日 pwbak 样例里“改密后删除旧备份”只说明当时的改密路线,不代表现在所有维护都删旧库;2.3.1 新增的槽位保全、新副本重建和不覆盖旧备份有隔离回归。9 月 28 日另有一次 144 项的历史实跑;当前源码共有 145 个测试定义,这次没有运行。
- 这次没有清理任何真实备份、维护另一密码层或做换机恢复。
日常内容追加在文件入库模块;双密码容器独立说明两层;远端密文保存与逐字节读回在密文备份模块。

- migrate_mode、change_password_mode、clean_backups_mode 与备份寿命
- 改密、旧库迁移、备份与错误分支回归
- 与私人远端密文备份区分的人工恢复流程
- 2026-09-03 的虚构探针验证过旧密码拒绝、新密码往返,以及 V2→V3 内容相同并留下 .bak;这次只重读回执,没有重新运行。
- 9 月 3 日 pwbak 样例里“改密后删除旧备份”只说明当时的改密路线,不代表现在所有维护都删旧库;2.3.1 新增的槽位保全、新副本重建和不覆盖旧备份有隔离回归。9 月 28 日另有一次 144 项的历史实跑;当前源码共有 145 个测试定义,这次没有运行。
- 这次没有清理任何真实备份、维护另一密码层或做换机恢复。
日常内容追加在文件入库模块;双密码容器独立说明两层;远端密文保存与逐字节读回在密文备份模块。
复制 AI 续作说明
项目:改密、升级和清理都要说清旧库还剩在哪里;仓库:wlyaaaaa/vault-tool;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








