把明确文件装进库,先分清追加与替换
现在
偶尔用
截至 11 月 4 日 · 项目源码

我把一组明确文件交给工具,它把相对目录与内容放进同一个加密库。已有库时用终端菜单“添加文件”追加,新文件和本次打开的旧内容在内存里合并;直接 encrypt 和 AI 技能的加密都是新建或整体替换,不是追加。

当前情况:文件打包、追加及同名新版保留的机制没变,原件默认保留;这次只重读了源码,没有处理任何真实库。

项目源码:公开仓库

把明确文件装进库,先分清追加与替换
现在
偶尔用
截至 11 月 4 日 · 项目源码

我把一组明确文件交给工具,它把相对目录与内容放进同一个加密库。已有库时用终端菜单“添加文件”追加,新文件和本次打开的旧内容在内存里合并;直接 encrypt 和 AI 技能的加密都是新建或整体替换,不是追加。

当前情况:文件打包、追加及同名新版保留的机制没变,原件默认保留;这次只重读了源码,没有处理任何真实库。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

“把文件放进去”不等于“原来的都还在”。直接重建 source/ 可能遗漏旧文件,错误的同名合并次序又会把刚准备的新版本换回旧版。产品需要先说明这两个不同问题,再执行加密。

举个实际例子

“给原来的库加一份新清单,保留里面的附件;若暂存区已有新版同名清单,不要用旧库的版本把它盖回去。”入口先解开本次有权打开的旧内容,再按明确规则合并。

最后我会得到什么

得到一个 vault.enc 与实际处理结果;来源副本、source/ 暂存、合并后的内容和本次能保留的层次分别说明。不能仅凭新库存在就声称整份旧库都保留了。

这项功能怎样使用

用途与实际影响

为什么需要它

“把文件放进去”不等于“原来的都还在”。直接重建 source/ 可能遗漏旧文件,错误的同名合并次序又会把刚准备的新版本换回旧版。产品需要先说明这两个不同问题,再执行加密。

举个实际例子

“给原来的库加一份新清单,保留里面的附件;若暂存区已有新版同名清单,不要用旧库的版本把它盖回去。”入口先解开本次有权打开的旧内容,再按明确规则合并。

最后我会得到什么

得到一个 vault.enc 与实际处理结果;来源副本、source/ 暂存、合并后的内容和本次能保留的层次分别说明。不能仅凭新库存在就声称整份旧库都保留了。

结果怎么看
正常时

范围明确,合并次序与内容核对正确,密文经过写入和读回验证;原件默认保留,明确选择的清理另报结果。

发现问题时

同名、新旧版本、另一层或写入结果无法保持时先说明,不悄悄丢文件。

入口不可用或证据不足时

没有文件、路径不可读或本人取消密码输入时停止本次操作,不把空库或取消当成完成。

结果怎么看
正常时

范围明确,合并次序与内容核对正确,密文经过写入和读回验证;原件默认保留,明确选择的清理另报结果。

发现问题时

同名、新旧版本、另一层或写入结果无法保持时先说明,不悄悄丢文件。

入口不可用或证据不足时

没有文件、路径不可读或本人取消密码输入时停止本次操作,不把空库或取消当成完成。

从哪里开始

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

需要准备什么
  • 要加入的文件或目录
  • 现有库或新库目标
  • 追加、替换及同名文件的选择
  • 需要解锁时本人在本地掌握的凭据
从开始到拿到结果
1先核对输入和库结构
工具检查选定原件、目标库格式和追加或替换的影响;旧成员的同名关系要在本地解锁后才能确认。
2本地解锁并装入
本人只在本机提供凭据,工具在内存中打开相应层,按“旧成员在前、新成员在后,同名以新版为准”合并后加密;其他打不开的层保持原密文。
3核对再交付
读回新容器中的预期文件并报告成功或失败;原件默认仍在原处,清理要另行明确。
从哪里开始

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

需要准备什么
  • 要加入的文件或目录
  • 现有库或新库目标
  • 追加、替换及同名文件的选择
  • 需要解锁时本人在本地掌握的凭据
从开始到拿到结果
1先核对输入和库结构
工具检查选定原件、目标库格式和追加或替换的影响;旧成员的同名关系要在本地解锁后才能确认。
2本地解锁并装入
本人只在本机提供凭据,工具在内存中打开相应层,按“旧成员在前、新成员在后,同名以新版为准”合并后加密;其他打不开的层保持原密文。
3核对再交付
读回新容器中的预期文件并报告成功或失败;原件默认仍在原处,清理要另行明确。
技术实现与依据(一)

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

打包、合并与同名新版优先已实现;9 月 3 日的虚构样例验证保留原日期,本次未重新运行(源码 b884ab61,版本 2.3.1)

关键规则与设计选择
1
已有库要追加时用菜单添加;encrypt、启动脚本和 AI 技能的 Encrypt 都不会自动合并。
2
source/ 和复制前的原路径都默认保留;--cleanup-source 只处理本次已归档且仍完全相符的文件,不清理新增、变化、占用、硬链接或无法确认的对象。
3
菜单追加只修改当前解锁层,未解锁槽位保留密文字节;直接 encrypt 是另一种重建意图,已有目标要本人确认整体替换,不把一个密码可打开误认为整库所有层都已验证。
当前怎样实现
  • 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)

关键规则与设计选择
1
已有库要追加时用菜单添加;encrypt、启动脚本和 AI 技能的 Encrypt 都不会自动合并。
2
source/ 和复制前的原路径都默认保留;--cleanup-source 只处理本次已归档且仍完全相符的文件,不清理新增、变化、占用、硬链接或无法确认的对象。
3
菜单追加只修改当前解锁层,未解锁槽位保留密文字节;直接 encrypt 是另一种重建意图,已有目标要本人确认整体替换,不把一个密码可打开误认为整库所有层都已验证。
当前怎样实现
  • 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)可以作为输入。登记只在门开且指向相符时提供,关门或失败不登记占位目标。这不是自动加密全部私人目录。
技术实现与依据(二)
1
固定文件与目录范围,区分保留原库、追加与整库替换。
2
已有库追加时先由本人提供对应凭据,并说明只能打开相应层。
3
在内存中按“旧成员在前、新成员在后”合并,同名以新版为准;本次明确的新路径直接归档。
4
打包、压缩、加密并核对新容器可解回预期内容。
5
核对密文写入和读回;默认保留原件,若明确选择清理,另报实际删除、保留与未确认项。
  • 候选密文先在内存中验证,再写同目录临时密文并刷新落盘,读回重新验证;提交前核对原目标未变,提交后再校验。失败与回滚分别报告。
  • 默认保留 source/ 和原路径文件。只有 --cleanup-source 才清理本次快照;Windows 在同一个独占句柄里比较文件身份与 SHA-256 并执行逻辑删除,变化、链接、硬链接或无法核对的保留。无法取得这一保护的平台保留原件,不退回存在竞态的覆写删除。
执行流程
技术实现与依据(二)
1
固定文件与目录范围,区分保留原库、追加与整库替换。
2
已有库追加时先由本人提供对应凭据,并说明只能打开相应层。
3
在内存中按“旧成员在前、新成员在后”合并,同名以新版为准;本次明确的新路径直接归档。
4
打包、压缩、加密并核对新容器可解回预期内容。
5
核对密文写入和读回;默认保留原件,若明确选择清理,另报实际删除、保留与未确认项。
  • 候选密文先在内存中验证,再写同目录临时密文并刷新落盘,读回重新验证;提交前核对原目标未变,提交后再校验。失败与回滚分别报告。
  • 默认保留 source/ 和原路径文件。只有 --cleanup-source 才清理本次快照;Windows 在同一个独占句柄里比较文件身份与 SHA-256 并执行逻辑删除,变化、链接、硬链接或无法核对的保留。无法取得这一保护的平台保留原件,不退回存在竞态的覆写删除。
执行流程
名词和入口
本模块用到的名词
名词意思
source(明文暂存目录)入库前打包的工作目录,不能因为名字像来源就默认它是永不删除的原件库。
merge(合并)把旧库本次打开的成员与新文件放在一起;不是恢复另一未打开层,也不是自动版本管理。
round trip(加密再解密往返)对同一份明确输入比较取回内容,用于证明这一次容器处理与预期一致。
专业定义

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

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

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

出问题时
边界
  • 任意文件类型可以作为字节入库,不代表任意文件都能在内存文本界面直接阅读。
  • 没有后台目录监听、全盘扫描或自动上传;目录门牌兼容只是允许登记过的入口作为输入。
  • 合并的旧库内容只在内存处理;内存合并不等于整个程序或操作系统没有其他内存副本。菜单追加不写终端日志,所以日志里没有记录不能说明没追加过。
失败与恢复
情况
怎么处理
准备区已有同名新版
按明确的新旧优先顺序保留预期版本,并用实际内容回归;不能只验证成员数量。
取消、没有输入或新库自检失败
返回未完成或失败,保留尚未成功提交时需要的原文与原库,不输出完成证据。
旧库可能含另一密码对应的层
菜单追加和 VAULT03 槽位改密保留未解锁槽位的密文字节,不声称已经打开它。共享密钥文件、容量或格式需要变化时生成新副本,不能静默覆盖未知层。
出问题时
边界
  • 任意文件类型可以作为字节入库,不代表任意文件都能在内存文本界面直接阅读。
  • 没有后台目录监听、全盘扫描或自动上传;目录门牌兼容只是允许登记过的入口作为输入。
  • 合并的旧库内容只在内存处理;内存合并不等于整个程序或操作系统没有其他内存副本。菜单追加不写终端日志,所以日志里没有记录不能说明没追加过。
失败与恢复
情况
怎么处理
准备区已有同名新版
按明确的新旧优先顺序保留预期版本,并用实际内容回归;不能只验证成员数量。
取消、没有输入或新库自检失败
返回未完成或失败,保留尚未成功提交时需要的原文与原库,不输出完成证据。
旧库可能含另一密码对应的层
菜单追加和 VAULT03 槽位改密保留未解锁槽位的密文字节,不声称已经打开它。共享密钥文件、容量或格式需要变化时生成新副本,不能静默覆盖未知层。
依据与来源
真实入口
  • 文件枚举、相对路径打包、加密与引导式添加
  • 本地终端与 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。