
vault-tool · 功能说明
我把一组明确文件交给工具,它把相对目录与内容放进同一个加密库。已有库时用终端菜单“添加文件”追加,新文件和本次打开的旧内容在内存里合并;直接 encrypt 和 AI 技能的加密都是新建或整体替换,不是追加。
当前情况:文件打包、追加及同名新版保留的机制没变,原件默认保留;这次只重读了源码,没有处理任何真实库。
项目源码:公开仓库


vault-tool · 功能说明
我把一组明确文件交给工具,它把相对目录与内容放进同一个加密库。已有库时用终端菜单“添加文件”追加,新文件和本次打开的旧内容在内存里合并;直接 encrypt 和 AI 技能的加密都是新建或整体替换,不是追加。
当前情况:文件打包、追加及同名新版保留的机制没变,原件默认保留;这次只重读了源码,没有处理任何真实库。
项目源码:公开仓库


用途与实际影响
“把文件放进去”不等于“原来的都还在”。直接重建 source/ 可能遗漏旧文件,错误的同名合并次序又会把刚准备的新版本换回旧版。产品需要先说明这两个不同问题,再执行加密。
“给原来的库加一份新清单,保留里面的附件;若暂存区已有新版同名清单,不要用旧库的版本把它盖回去。”入口先解开本次有权打开的旧内容,再按明确规则合并。
得到一个 vault.enc 与实际处理结果;来源副本、source/ 暂存、合并后的内容和本次能保留的层次分别说明。不能仅凭新库存在就声称整份旧库都保留了。

用途与实际影响
“把文件放进去”不等于“原来的都还在”。直接重建 source/ 可能遗漏旧文件,错误的同名合并次序又会把刚准备的新版本换回旧版。产品需要先说明这两个不同问题,再执行加密。
“给原来的库加一份新清单,保留里面的附件;若暂存区已有新版同名清单,不要用旧库的版本把它盖回去。”入口先解开本次有权打开的旧内容,再按明确规则合并。
得到一个 vault.enc 与实际处理结果;来源副本、source/ 暂存、合并后的内容和本次能保留的层次分别说明。不能仅凭新库存在就声称整份旧库都保留了。

范围明确,合并次序与内容核对正确,密文经过写入和读回验证;原件默认保留,明确选择的清理另报结果。
同名、新旧版本、另一层或写入结果无法保持时先说明,不悄悄丢文件。
没有文件、路径不可读或本人取消密码输入时停止本次操作,不把空库或取消当成完成。

范围明确,合并次序与内容核对正确,密文经过写入和读回验证;原件默认保留,明确选择的清理另报结果。
同名、新旧版本、另一层或写入结果无法保持时先说明,不悄悄丢文件。
没有文件、路径不可读或本人取消密码输入时停止本次操作,不把空库或取消当成完成。

已有库要追加,在本机终端运行 vault-tool,选菜单“加密 / 添加文件”,本人在本地输入凭据。AI 技能里的 Encrypt 只会把指定输入新建成一个独立的加密输出(本地确认两次密码、原件保留),没有“追加”模式;AI 可以帮我准备菜单步骤,但不会凭空开一个追加窗口。
- 要加入的文件或目录
- 现有库或新库目标
- 追加、替换及同名文件的选择
- 需要解锁时本人在本地掌握的凭据


已有库要追加,在本机终端运行 vault-tool,选菜单“加密 / 添加文件”,本人在本地输入凭据。AI 技能里的 Encrypt 只会把指定输入新建成一个独立的加密输出(本地确认两次密码、原件保留),没有“追加”模式;AI 可以帮我准备菜单步骤,但不会凭空开一个追加窗口。
- 要加入的文件或目录
- 现有库或新库目标
- 追加、替换及同名文件的选择
- 需要解锁时本人在本地掌握的凭据


这里保留实现、关键条件、精确入口、历史记录和验证结果。
打包、合并与同名新版优先已实现;9 月 3 日的虚构样例验证保留原日期,本次未重新运行(源码 b884ab61,版本 2.3.1)


- BASE 取 vault_tool.py 所在目录;普通入口使用其 source/、默认库文件与日志路径,不随当前终端工作目录任意变化。
- 直接 encrypt 和菜单添加都用
archive_explicit_inputs对明确输入做稳定快照:检查原路径、链接/重解析点、对象身份、大小、修改时间和 SHA-256,确认读取中没有变化,再按相对路径构造 gzip/tar(gzip 头时间固定为 0)。菜单新增的路径直接归档,没有先复制到 source/ 的步骤;_make_tar只用于设置双密码等其他路径。
- add_files_mode 在内存中展开当前密码对应层,按原成员→新增成员次序合并,同名(忽略大小写比较)以新版为准,不把旧库内容先写进 source/;未解锁槽位保持原密文字节。
- encrypt_mode 只打包当前 source/;已有目标需本人确认整体替换,并留下独立的
.replaced.<随机>.enc恢复副本。仓库附带的启动加密脚本先把 AddPath 复制进 source/,再调用直接 encrypt,不走菜单的合并步骤。
- 普通符号链接仍然拒绝;电脑配置项目(PCConfig)登记过、且实际指向相符的目录门牌(mount point/junction)可以作为输入。登记只在门开且指向相符时提供,关门或失败不登记占位目标。这不是自动加密全部私人目录。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
打包、合并与同名新版优先已实现;9 月 3 日的虚构样例验证保留原日期,本次未重新运行(源码 b884ab61,版本 2.3.1)


- BASE 取 vault_tool.py 所在目录;普通入口使用其 source/、默认库文件与日志路径,不随当前终端工作目录任意变化。
- 直接 encrypt 和菜单添加都用
archive_explicit_inputs对明确输入做稳定快照:检查原路径、链接/重解析点、对象身份、大小、修改时间和 SHA-256,确认读取中没有变化,再按相对路径构造 gzip/tar(gzip 头时间固定为 0)。菜单新增的路径直接归档,没有先复制到 source/ 的步骤;_make_tar只用于设置双密码等其他路径。
- add_files_mode 在内存中展开当前密码对应层,按原成员→新增成员次序合并,同名(忽略大小写比较)以新版为准,不把旧库内容先写进 source/;未解锁槽位保持原密文字节。
- encrypt_mode 只打包当前 source/;已有目标需本人确认整体替换,并留下独立的
.replaced.<随机>.enc恢复副本。仓库附带的启动加密脚本先把 AddPath 复制进 source/,再调用直接 encrypt,不走菜单的合并步骤。
- 普通符号链接仍然拒绝;电脑配置项目(PCConfig)登记过、且实际指向相符的目录门牌(mount point/junction)可以作为输入。登记只在门开且指向相符时提供,关门或失败不登记占位目标。这不是自动加密全部私人目录。

- 候选密文先在内存中验证,再写同目录临时密文并刷新落盘,读回重新验证;提交前核对原目标未变,提交后再校验。失败与回滚分别报告。
- 默认保留 source/ 和原路径文件。只有 --cleanup-source 才清理本次快照;Windows 在同一个独占句柄里比较文件身份与 SHA-256 并执行逻辑删除,变化、链接、硬链接或无法核对的保留。无法取得这一保护的平台保留原件,不退回存在竞态的覆写删除。


- 候选密文先在内存中验证,再写同目录临时密文并刷新落盘,读回重新验证;提交前核对原目标未变,提交后再校验。失败与回滚分别报告。
- 默认保留 source/ 和原路径文件。只有 --cleanup-source 才清理本次快照;Windows 在同一个独占句柄里比较文件身份与 SHA-256 并执行逻辑删除,变化、链接、硬链接或无法核对的保留。无法取得这一保护的平台保留原件,不退回存在竞态的覆写删除。



| 名词 | 意思 |
|---|---|
| source(明文暂存目录) | 入库前打包的工作目录,不能因为名字像来源就默认它是永不删除的原件库。 |
| merge(合并) | 把旧库本次打开的成员与新文件放在一起;不是恢复另一未打开层,也不是自动版本管理。 |
| round trip(加密再解密往返) | 对同一份明确输入比较取回内容,用于证明这一次容器处理与预期一致。 |

保存哪几个文件、旧库是否合并、同名以谁为准,都在加密前说明。



保存哪几个文件、旧库是否合并、同名以谁为准,都在加密前说明。

- 任意文件类型可以作为字节入库,不代表任意文件都能在内存文本界面直接阅读。
- 没有后台目录监听、全盘扫描或自动上传;目录门牌兼容只是允许登记过的入口作为输入。
- 合并的旧库内容只在内存处理;内存合并不等于整个程序或操作系统没有其他内存副本。菜单追加不写终端日志,所以日志里没有记录不能说明没追加过。

- 任意文件类型可以作为字节入库,不代表任意文件都能在内存文本界面直接阅读。
- 没有后台目录监听、全盘扫描或自动上传;目录门牌兼容只是允许登记过的入口作为输入。
- 合并的旧库内容只在内存处理;内存合并不等于整个程序或操作系统没有其他内存副本。菜单追加不写终端日志,所以日志里没有记录不能说明没追加过。

- 文件枚举、相对路径打包、加密与引导式添加
- 本地终端与 AddPath 到直接 encrypt 的真实路线
- 虚构文件往返、追加与同名内容回归
- 2026-09-03 虚构文件实际算法验证原始 JSON;含很小的测试参数,不能作为真实资料配置建议
- 来源独立审查分别读取了加密、合并和启动脚本,没有把这些入口混成一条。
- 2026-09-03 的虚构样例:3 个文件(61 + 47 + 2057 = 2165 字节)装进 65,536 字节的容器后实际取回,同名内容以新版为准;这次只重读了这份回执并核对指纹一致,没有重新运行。当前源码共有 145 个测试定义,这次没有运行。
- 没有对本人真实的暂存目录、库文件或私人文件执行这些操作,原件清理的真实验收也没有做。
这里决定什么进入库;密码与格式模块解释怎样打开,查看与提取模块解释怎样使用,库维护模块解释后续重建及旧库。

- 文件枚举、相对路径打包、加密与引导式添加
- 本地终端与 AddPath 到直接 encrypt 的真实路线
- 虚构文件往返、追加与同名内容回归
- 2026-09-03 虚构文件实际算法验证原始 JSON;含很小的测试参数,不能作为真实资料配置建议
- 来源独立审查分别读取了加密、合并和启动脚本,没有把这些入口混成一条。
- 2026-09-03 的虚构样例:3 个文件(61 + 47 + 2057 = 2165 字节)装进 65,536 字节的容器后实际取回,同名内容以新版为准;这次只重读了这份回执并核对指纹一致,没有重新运行。当前源码共有 145 个测试定义,这次没有运行。
- 没有对本人真实的暂存目录、库文件或私人文件执行这些操作,原件清理的真实验收也没有做。
这里决定什么进入库;密码与格式模块解释怎样打开,查看与提取模块解释怎样使用,库维护模块解释后续重建及旧库。
复制 AI 续作说明
项目:把明确文件装进库,先分清追加与替换;仓库:wlyaaaaa/vault-tool;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








