改密、升级和清理都要说清旧库还剩在哪里
现在
偶尔用
11 月 4 日核对没碰真实库
截至 11 月 4 日 · 项目源码

改密码时保留原来没改的内容,容量不够或要换密钥文件时先做另一份经过验证的库。新副本未成功前旧库不动;中途失败会说明原路径和恢复副本各是什么状态,而不是只留一句失败。

当前情况:已有只改已打开内容层、生成新副本及失败回退的维护功能;真实私人资料恢复仍需独立验证。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码

公开仓库

改密、升级和清理都要说清旧库还剩在哪里
现在
偶尔用
11 月 4 日核对没碰真实库
截至 11 月 4 日 · 项目源码

改密码时保留原来没改的内容,容量不够或要换密钥文件时先做另一份经过验证的库。新副本未成功前旧库不动;中途失败会说明原路径和恢复副本各是什么状态,而不是只留一句失败。

当前情况:已有只改已打开内容层、生成新副本及失败回退的维护功能;真实私人资料恢复仍需独立验证。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码

公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

改密码和升级都会生成新密文。操作中的临时副本、明确保留的旧库和远端备份各有不同去向;把它们都叫“自动备份”,出问题时反而可能找不到能恢复的那一份。

举个实际例子

“给这份库换密码,先确认原来能打开的文件仍然在;失败时不要损坏旧库。”流程要先验证旧凭据,再核对重建范围与自检,并明确旧库副本是否会在成功后删除。

最后我会得到什么

得到经验证的新密码槽位、升级后的库或独立重建副本,并说明保留了哪些层、原库和恢复副本在哪里。冲突、取消和回滚失败单列;未知层的字节保留不等于已经验证其密码。

这项功能怎样使用

用途与实际影响

为什么需要它

改密码和升级都会生成新密文。操作中的临时副本、明确保留的旧库和远端备份各有不同去向;把它们都叫“自动备份”,出问题时反而可能找不到能恢复的那一份。

举个实际例子

“给这份库换密码,先确认原来能打开的文件仍然在;失败时不要损坏旧库。”流程要先验证旧凭据,再核对重建范围与自检,并明确旧库副本是否会在成功后删除。

最后我会得到什么

得到经验证的新密码槽位、升级后的库或独立重建副本,并说明保留了哪些层、原库和恢复副本在哪里。冲突、取消和回滚失败单列;未知层的字节保留不等于已经验证其密码。

结果怎么看
正常时

新凭据或新格式下能取回本次明确维护的内容,并说明实际留下的旧库位置和寿命。

发现问题时

自检、写入、恢复或层次保留不成立时返回失败;已经发生的变化与仍可用原件分开说明。

入口不可用或证据不足时

旧凭据无法打开、必要密钥文件缺失或当前格式不支持该维护时停止,不把它当成新建空库。

结果怎么看
正常时

新凭据或新格式下能取回本次明确维护的内容,并说明实际留下的旧库位置和寿命。

发现问题时

自检、写入、恢复或层次保留不成立时返回失败;已经发生的变化与仍可用原件分开说明。

入口不可用或证据不足时

旧凭据无法打开、必要密钥文件缺失或当前格式不支持该维护时停止,不把它当成新建空库。

从哪里开始

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

需要准备什么
  • 要维护的库
  • 本次是改密、迁移、重建还是清理
  • 新库或旧备份的保留选择
  • 本人在本地提供旧凭据
从开始到拿到结果
1分清维护目标
确认当前格式、层次和旧库位置,说明本次会生成哪份新库以及保留哪些旧文件。
2生成并验证
本人提供旧凭据;工具只处理可打开的范围,写出新结果并回读,失败时保留原库或恢复原状。
3确认后处理旧件
逐项交代新库、临时备份和恢复位置;旧备份清理另由本人明确决定。
从哪里开始

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

需要准备什么
  • 要维护的库
  • 本次是改密、迁移、重建还是清理
  • 新库或旧备份的保留选择
  • 本人在本地提供旧凭据
从开始到拿到结果
1分清维护目标
确认当前格式、层次和旧库位置,说明本次会生成哪份新库以及保留哪些旧文件。
2生成并验证
本人提供旧凭据;工具只处理可打开的范围,写出新结果并回读,失败时保留原库或恢复原状。
3确认后处理旧件
逐项交代新库、临时备份和恢复位置;旧备份清理另由本人明确决定。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

槽位改密、可验证新副本与事务回退已实现;2026-10-11 重读源码,行为未变,真实私人恢复另验(源码 b884ab61,版本 2.3.1)

关键规则与设计选择
1
旧版升级与当前库改密是独立操作,不需要为了普通查看先升级。
2
事务里的临时回退副本成功后会清掉;独立恢复副本另有寿命。不能把“执行时有备份”当成永久恢复点。
3
VAULT03 原槽改密保留另一槽;改变共享密钥文件标志或容量必须走 rebuild 新副本。两密码重建需要两个已知密码分别打开不同槽位,不猜隐藏层是否存在;未解开的字节还在,不等于另一密码已验证。
当前怎样实现
  • 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)

关键规则与设计选择
1
旧版升级与当前库改密是独立操作,不需要为了普通查看先升级。
2
事务里的临时回退副本成功后会清掉;独立恢复副本另有寿命。不能把“执行时有备份”当成永久恢复点。
3
VAULT03 原槽改密保留另一槽;改变共享密钥文件标志或容量必须走 rebuild 新副本。两密码重建需要两个已知密码分别打开不同槽位,不猜隐藏层是否存在;未解开的字节还在,不等于另一密码已验证。
当前怎样实现
  • 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。结构损坏或原算法不可用在密码、备份和写入前停止。
技术实现与依据(二)
1
确认是改密、升级、重建还是明确清理,不把几件事连成自动流程。
2
核对当前库、原凭据、格式和可能的其他层。
3
说明会保留的旧库及临时备份的实际寿命。
4
生成并验证本次维护结果,失败保留或恢复原件。
5
检查实际新内容与恢复位置,再由本人决定是否清理旧备份。
  • clean_backups_mode 枚举实际备份并要求本人明确确认;删除只针对精确备份,不等于清理全部原文、系统历史或云端版本。
  • 恢复条件包括原库字节、对应密码、精确密钥文件及运行依赖;本机备份、私人仓库提交与另一磁盘副本分别证明各自保存状态。
执行流程
技术实现与依据(二)
1
确认是改密、升级、重建还是明确清理,不把几件事连成自动流程。
2
核对当前库、原凭据、格式和可能的其他层。
3
说明会保留的旧库及临时备份的实际寿命。
4
生成并验证本次维护结果,失败保留或恢复原件。
5
检查实际新内容与恢复位置,再由本人决定是否清理旧备份。
  • clean_backups_mode 枚举实际备份并要求本人明确确认;删除只针对精确备份,不等于清理全部原文、系统历史或云端版本。
  • 恢复条件包括原库字节、对应密码、精确密钥文件及运行依赖;本机备份、私人仓库提交与另一磁盘副本分别证明各自保存状态。
执行流程
名词和入口
本模块用到的名词
名词意思
migration(格式迁移)先解读旧格式,再重新生成当前格式的密文;不是直接给旧文件换一个扩展名。
rollback copy(回退副本)操作失败时用于恢复旧状态的具体文件;必须说明它何时产生、何时仍在、何时会被删除。
unlocked layer(本次打开的内容层)当前凭据实际解出的那份内容,不自动等同双密码容器的全部内容。
专业定义

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

名词和入口
本模块用到的名词
名词意思
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。