

vault-tool · 功能说明
我可以把一份明确密文保存在自己的私人仓库,并让工具确认远端保存的正是那份字节。真正恢复时再用原密码、密钥文件和兼容环境打开;这两层分别给出结论,不用一次上传提示包办所有证明。
当前情况:密文上传与远端字节核对接口有历史隔离验证;11 月 4 日只读确认私人目标仍是私有仓库、默认分支不变,远端最后一次推送是 7 月 27 日。10 月 20 日起内容没变就不再多传,只读回核对;AI 技能入口原来会把这种情况报成失败,11 月 5 日已修,相同密文且远端读回通过就算成功(回归用例写好了,这次没有跑,也还没有拿真实备份验过)。11 月 4 日没有写入或读回密文,真正解密恢复仍要另验。
项目源码:公开仓库

vault-tool · 功能说明
我可以把一份明确密文保存在自己的私人仓库,并让工具确认远端保存的正是那份字节。真正恢复时再用原密码、密钥文件和兼容环境打开;这两层分别给出结论,不用一次上传提示包办所有证明。
当前情况:密文上传与远端字节核对接口有历史隔离验证;11 月 4 日只读确认私人目标仍是私有仓库、默认分支不变,远端最后一次推送是 7 月 27 日。10 月 20 日起内容没变就不再多传,只读回核对;AI 技能入口原来会把这种情况报成失败,11 月 5 日已修,相同密文且远端读回通过就算成功(回归用例写好了,这次没有跑,也还没有拿真实备份验过)。11 月 4 日没有写入或读回密文,真正解密恢复仍要另验。
项目源码:公开仓库


用途与实际影响
发布命令失败却仍打印成功,或只确认某个路径存在,都可能留下假的备份安心感。另一个“把远端 README 正文移进密文”的动作又会改变远端当前内容,需要与普通密文上传分开解释和确认。
普通备份:“把这份明确的 vault.enc 备份到我指定的私人路径,再读回来确认大小和哈希。”独立的正文保护:“我明确要把当前远端 README 的内容转成密文,先预演,密码我在本机确认。”后一句不是前一句默认附带的动作。
普通上传与README保护都分别报告实际写入和远端回读。普通备份遇到远端已是同一份密文时不再上传,报告“已是最新、没有新提交”,仍然读回核对。README保护还核对当前说明及密文字节,响应丢失时只回读原操作;仍不能确定就保留效果未知。字节一致不证明密码可恢复,也不表示旧历史已清除或既有保险库已合并。

用途与实际影响
发布命令失败却仍打印成功,或只确认某个路径存在,都可能留下假的备份安心感。另一个“把远端 README 正文移进密文”的动作又会改变远端当前内容,需要与普通密文上传分开解释和确认。
普通备份:“把这份明确的 vault.enc 备份到我指定的私人路径,再读回来确认大小和哈希。”独立的正文保护:“我明确要把当前远端 README 的内容转成密文,先预演,密码我在本机确认。”后一句不是前一句默认附带的动作。
普通上传与README保护都分别报告实际写入和远端回读。普通备份遇到远端已是同一份密文时不再上传,报告“已是最新、没有新提交”,仍然读回核对。README保护还核对当前说明及密文字节,响应丢失时只回读原操作;仍不能确定就保留效果未知。字节一致不证明密码可恢复,也不表示旧历史已清除或既有保险库已合并。

普通备份必须从私人目标读回同一份密文,内容没变、没有上传时也一样;单独保护远端说明时,也要核对当前说明与新密文。两者都不代表已经凭密码恢复原文。
目标或远端内容在操作中改变、写入结果不明或读回不符时,分别说清是否已经写入,不给笼统成功提示。经 AI 技能入口备份时,内容没变且读回通过算成功,回执写明这次没有上传;读回失败或说不清时不算备份好了(11 月 5 日修好的,还没有拿真实备份验过)。
私人目标、权限或本人本地确认不成立时停止写入;预演和只读检查仍不算发布。

普通备份必须从私人目标读回同一份密文,内容没变、没有上传时也一样;单独保护远端说明时,也要核对当前说明与新密文。两者都不代表已经凭密码恢复原文。
目标或远端内容在操作中改变、写入结果不明或读回不符时,分别说清是否已经写入,不给笼统成功提示。经 AI 技能入口备份时,内容没变且读回通过算成功,回执写明这次没有上传;读回失败或说不清时不算备份好了(11 月 5 日修好的,还没有拿真实备份验过)。
私人目标、权限或本人本地确认不成立时停止写入;预演和只读检查仍不算发布。

在已接通本机 vault-workflow 的 AI 对话中明确要求“把这份密文备份到已核准的私人密文仓库”,或单独要求保护远端 README;两件事分别确认。内容没变时不再上传,读回通过也算成功,见“结果怎么看”。
- 要备份的密文或要保护的 README
- 已核准的私人目标和路径
- 本次只做哪一种动作


在已接通本机 vault-workflow 的 AI 对话中明确要求“把这份密文备份到已核准的私人密文仓库”,或单独要求保护远端 README;两件事分别确认。内容没变时不再上传,读回通过也算成功,见“结果怎么看”。
- 要备份的密文或要保护的 README
- 已核准的私人目标和路径
- 本次只做哪一种动作


这里保留实现、关键条件、精确入口、历史记录和验证结果。
上传与回读接口有历史隔离验证;2026-11-04 只读确认私人目标为私有、默认分支 main,未写入、未读密文


- 仓库附带的发布脚本通过现有 gh(GitHub 命令行工具)使用 Contents API;先解析实际仓库私有状态与默认分支,检查明确输入、非空字节和许可扩展名(.enc/.age/.gpg,或明确允许的图片载体)。扩展名许可不是加密真实性证明。WhatIf 不写入,但会读取本地密文字节来计算待传指纹,不是“完全不读文件”。
- 更新已有路径需带当前文件 SHA;只有真实不存在(404)才按创建处理,权限或网络错误不能静默当成没有文件。PUT 的退出码和返回结构必须被核对,失败不能继续输出 Uploaded。
- 2026-10-20 起(提交 059508a),本地算出的 Git blob SHA 与远端当前 SHA 相同时不发 PUT,仍从默认分支读目标 blob 核对长度和 SHA-256;结果为 upload_performed=false、already_current=true、readback_verified=true、commit_sha=null。跳过上传不等于跳过核对。这条分支已实现,没有对真实远端运行过。
- 现行技能的 Invoke-PublishVault 成功条件是 readback_verified=true,且 upload_performed=true 和 already_current=true 恰有一个成立,并透传 already_current(.agents 277dd615,北京时间 11 月 5 日 02:43);上面的合法结果算成功,不再进入失败分支。预演仍要求这两个值和 readback_verified 都为 false,读回不通过仍报失败。11 月 6 日只读了代码和 references/json-contract.md;Test-VaultWorkflowSmoke.ps1 有同密文、实际上传、旧发布器和矛盾字段的回归用例,这次没有跑,也没有真实备份的回执。
- 实际成功还需从默认分支读取目标 blob(Git 文件内容对象)身份,再读取 base64 编码字节,与本次上传同一缓冲区的长度和 SHA-256 比较;提交存在与当前分支路径一致分别核对。
- 远端响应和临时请求文件包含的是密文;对调用方只返回目标、提交和指纹等元数据,不打印密文大正文,也不建立计划任务。上传程序本身不克隆私人仓库;但现行技能允许一份只含密文和安全说明的受管本地副本,并不是全系统都没有本地副本。
- VerifyRemote(远端核验)的树路径检查仍只证明路径存在,safe_readme_present 不是正文安全证明。ProtectRemoteReadme 另按完整字节核验受管占位说明,不接受仅含标记;existing_stub_verified 不表示检验过已有密文或密码。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
上传与回读接口有历史隔离验证;2026-11-04 只读确认私人目标为私有、默认分支 main,未写入、未读密文


- 仓库附带的发布脚本通过现有 gh(GitHub 命令行工具)使用 Contents API;先解析实际仓库私有状态与默认分支,检查明确输入、非空字节和许可扩展名(.enc/.age/.gpg,或明确允许的图片载体)。扩展名许可不是加密真实性证明。WhatIf 不写入,但会读取本地密文字节来计算待传指纹,不是“完全不读文件”。
- 更新已有路径需带当前文件 SHA;只有真实不存在(404)才按创建处理,权限或网络错误不能静默当成没有文件。PUT 的退出码和返回结构必须被核对,失败不能继续输出 Uploaded。
- 2026-10-20 起(提交 059508a),本地算出的 Git blob SHA 与远端当前 SHA 相同时不发 PUT,仍从默认分支读目标 blob 核对长度和 SHA-256;结果为 upload_performed=false、already_current=true、readback_verified=true、commit_sha=null。跳过上传不等于跳过核对。这条分支已实现,没有对真实远端运行过。
- 现行技能的 Invoke-PublishVault 成功条件是 readback_verified=true,且 upload_performed=true 和 already_current=true 恰有一个成立,并透传 already_current(.agents 277dd615,北京时间 11 月 5 日 02:43);上面的合法结果算成功,不再进入失败分支。预演仍要求这两个值和 readback_verified 都为 false,读回不通过仍报失败。11 月 6 日只读了代码和 references/json-contract.md;Test-VaultWorkflowSmoke.ps1 有同密文、实际上传、旧发布器和矛盾字段的回归用例,这次没有跑,也没有真实备份的回执。
- 实际成功还需从默认分支读取目标 blob(Git 文件内容对象)身份,再读取 base64 编码字节,与本次上传同一缓冲区的长度和 SHA-256 比较;提交存在与当前分支路径一致分别核对。
- 远端响应和临时请求文件包含的是密文;对调用方只返回目标、提交和指纹等元数据,不打印密文大正文,也不建立计划任务。上传程序本身不克隆私人仓库;但现行技能允许一份只含密文和安全说明的受管本地副本,并不是全系统都没有本地副本。
- VerifyRemote(远端核验)的树路径检查仍只证明路径存在,safe_readme_present 不是正文安全证明。ProtectRemoteReadme 另按完整字节核验受管占位说明,不接受仅含标记;existing_stub_verified 不表示检验过已有密文或密码。

- ProtectRemoteReadme 是独立精确动作:WhatIf(只读预演)不读正文、不取密码、不写远端;真实执行由本地辅助进程读取固定 source_head_sha 的 README,要求两次本地密码一致,打包单个 README 并自检。
- 正文保护写入前重新核对私有状态、固定 source_head_sha 的完整树和目标。截断树不能证明文件不存在;远端已有密文而 README 仍为普通正文时拒绝覆盖密文。非强制提交后回读分支头、README 与密文并比较 SHA-256;响应丢失只核对原结果,不盲重放,无法确定时 effect(外部现实动作)为 null。正常换行 Base64 及固定 blob 读取均受支持。
- 恢复还需要对应密码、密钥文件、容器版本与依赖。本地备份、远端密文、程序测试和真正打开原文是不同恢复证据。


- ProtectRemoteReadme 是独立精确动作:WhatIf(只读预演)不读正文、不取密码、不写远端;真实执行由本地辅助进程读取固定 source_head_sha 的 README,要求两次本地密码一致,打包单个 README 并自检。
- 正文保护写入前重新核对私有状态、固定 source_head_sha 的完整树和目标。截断树不能证明文件不存在;远端已有密文而 README 仍为普通正文时拒绝覆盖密文。非强制提交后回读分支头、README 与密文并比较 SHA-256;响应丢失只核对原结果,不盲重放,无法确定时 effect(外部现实动作)为 null。正常换行 Base64 及固定 blob 读取均受支持。
- 恢复还需要对应密码、密钥文件、容器版本与依赖。本地备份、远端密文、程序测试和真正打开原文是不同恢复证据。



| 名词 | 意思 |
|---|---|
| PRIVATE(私有仓库) | 本次远端访问范围,必须由真实目标元数据确认;它不是来自文件名或 README 的自称。 |
| WhatIf(只预演) | 检查并说明计划动作,不上传、不替换远端正文,也不能作为已有备份证据。 |
| read-back(从目标重新读取) | 写入后重新取实际保存的内容并核对,区别于只相信发送请求前的本地字节。 |
| safe_readme_present(README 路径存在字段) | 现有名字容易误解;它只检查树路径,不证明正文安全或已经被替换。 |

先确认私人目标,再上传和逐字节回读;密文还在,不代表解锁条件一定齐全。



先确认私人目标,再上传和逐字节回读;密文还在,不代表解锁条件一定齐全。

- 网站建设不授权向私人密文仓库写入虚构样例,所有发布接口测试均与真实远端隔离。
- 密文读回可证明字节一致,不能确认遗失的密码或密钥文件,也不能替代真实恢复演练。
- 不创建定时备份服务、公开分享链接、第二个远端或全历史改写流程。
- 不能用一个 README 保护结果推断整个仓库及全部历史都没有原文;这次没有读 README,不据路径存在或历史提交判断现在的历史都安全。

- 网站建设不授权向私人密文仓库写入虚构样例,所有发布接口测试均与真实远端隔离。
- 密文读回可证明字节一致,不能确认遗失的密码或密钥文件,也不能替代真实恢复演练。
- 不创建定时备份服务、公开分享链接、第二个远端或全历史改写流程。
- 不能用一个 README 保护结果推断整个仓库及全部历史都没有原文;这次没有读 README,不据路径存在或历史提交判断现在的历史都安全。

- 私人密文上传与目标字节核对
- 人工准备、密文与恢复条件
- VerifyRemote(远端核验)、PublishVault、预演与结果适配
- 固定远端版本、两次本地确认与单提交正文保护
- 发布、读取与真实效果字段
- GitHub 官方文件对象读取合同;base64 字节与接口容量边界
- 发布脚本已通过九类隔离 mock gh(模拟 GitHub 命令)验证:PUT 失败、非 404 错误、404 创建、正常回读、回读失败、字节不符、预演、非私人目标和扩展名拒绝(历史,这次没有重新运行;当前源码共有 145 个测试定义)。
- 工具源仓库自身曾 normal-push 并从真实 main 读回,但这不是向私人密文仓库上传的结果。

- 私人密文上传与目标字节核对
- 人工准备、密文与恢复条件
- VerifyRemote(远端核验)、PublishVault、预演与结果适配
- 固定远端版本、两次本地确认与单提交正文保护
- 发布、读取与真实效果字段
- GitHub 官方文件对象读取合同;base64 字节与接口容量边界
- 发布脚本已通过九类隔离 mock gh(模拟 GitHub 命令)验证:PUT 失败、非 404 错误、404 创建、正常回读、回读失败、字节不符、预演、非私人目标和扩展名拒绝(历史,这次没有重新运行;当前源码共有 145 个测试定义)。
- 工具源仓库自身曾 normal-push 并从真实 main 读回,但这不是向私人密文仓库上传的结果。

- 私人密文仓库的 Git 记录里,密文文件有 4 次内容变更:北京时间 7 月 7 日、7 月 8 日、7 月 23 日和 7 月 27 日 04:06;最后一次推送是 7 月 27 日 23:16,之后同日两次提交没有改动密文文件,不能算成 6 个版本。Git 记录不自动证明当时做过远端字节回读、密码验证或恢复。
- 2026-10-11 16:31—16:33 只读查询:目标仍是私有仓库、默认分支 main,远端分支头与本地一致;只验证目标身份,没有读取密文或 README,也没有上传。
- 2026-11-04 09:10 再次只读查询:仍是私有仓库、默认分支 main,密文最近一次内容变更是 7 月 27 日 04:06,最近一次推送是 7 月 27 日 23:16;同样没有读取密文或 README,也没有上传。
- 当前远端密文与本地字节是否一致、真实密码能否恢复、换机恢复都没有核对。
本模块保存密文与解释远端材料保护;具体加密、密码和本机取回仍由前面的模块负责。实际使用例子:本人明确采用 VAULT03 与独立密码,把恢复材料分两处保管,分别解锁、互不替代,单边不能代表完整材料。这次没有读取真实密文、密码或恢复码,也没有试解密,现在两处材料是否仍齐全、能否恢复没有核对。它与 AI 工作区中的配置和记忆备份分别使用。

- 私人密文仓库的 Git 记录里,密文文件有 4 次内容变更:北京时间 7 月 7 日、7 月 8 日、7 月 23 日和 7 月 27 日 04:06;最后一次推送是 7 月 27 日 23:16,之后同日两次提交没有改动密文文件,不能算成 6 个版本。Git 记录不自动证明当时做过远端字节回读、密码验证或恢复。
- 2026-10-11 16:31—16:33 只读查询:目标仍是私有仓库、默认分支 main,远端分支头与本地一致;只验证目标身份,没有读取密文或 README,也没有上传。
- 2026-11-04 09:10 再次只读查询:仍是私有仓库、默认分支 main,密文最近一次内容变更是 7 月 27 日 04:06,最近一次推送是 7 月 27 日 23:16;同样没有读取密文或 README,也没有上传。
- 当前远端密文与本地字节是否一致、真实密码能否恢复、换机恢复都没有核对。
本模块保存密文与解释远端材料保护;具体加密、密码和本机取回仍由前面的模块负责。实际使用例子:本人明确采用 VAULT03 与独立密码,把恢复材料分两处保管,分别解锁、互不替代,单边不能代表完整材料。这次没有读取真实密文、密码或恢复码,也没有试解密,现在两处材料是否仍齐全、能否恢复没有核对。它与 AI 工作区中的配置和记忆备份分别使用。
复制 AI 续作说明
项目:远端保存同一份密文,和真正能恢复分开验;仓库:wlyaaaaa/vault-tool;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








