
vault-tool · 功能说明
我可以让一个图片文件同时携带已有的加密库,之后用工具把密文原样取回。判断是否成功要比较提取后的密文,而不是只看图片仍能显示。现在不管是做载体还是取回,目标位置已有文件就直接拒绝,不会覆盖。
当前情况:在图片尾部携带和提取密文的功能在;9 月 29 日起输出一律不覆盖已有文件。平台重编码可能破坏载荷,图片能看不代表密文仍完整。
项目源码:公开仓库


vault-tool · 功能说明
我可以让一个图片文件同时携带已有的加密库,之后用工具把密文原样取回。判断是否成功要比较提取后的密文,而不是只看图片仍能显示。现在不管是做载体还是取回,目标位置已有文件就直接拒绝,不会覆盖。
当前情况:在图片尾部携带和提取密文的功能在;9 月 29 日起输出一律不覆盖已有文件。平台重编码可能破坏载荷,图片能看不代表密文仍完整。
项目源码:公开仓库


用途与实际影响
图片查看器可能忽略尾部字节,但分享平台可能重新编码整张图,把尾部丢掉。把“封面能打开”和“保险库仍完整”混成一件事,会让损坏的载体看起来一切正常。
“把这份已经加密的文件放在这张封面图片后面,再取出来确认没有改变。”工具建立载体并提取,比较密文大小与哈希;如果准备经过会压缩图片的平台,先明确这种传递方式不保证保留载荷。
得到携带密文的图片文件,以及提取后的 vault.recovered.enc 或本人指定路径;成功取回需要字节一致。没有重新提供密码时只能证明密文保留,不能证明里面内容已恢复。

用途与实际影响
图片查看器可能忽略尾部字节,但分享平台可能重新编码整张图,把尾部丢掉。把“封面能打开”和“保险库仍完整”混成一件事,会让损坏的载体看起来一切正常。
“把这份已经加密的文件放在这张封面图片后面,再取出来确认没有改变。”工具建立载体并提取,比较密文大小与哈希;如果准备经过会压缩图片的平台,先明确这种传递方式不保证保留载荷。
得到携带密文的图片文件,以及提取后的 vault.recovered.enc 或本人指定路径;成功取回需要字节一致。没有重新提供密码时只能证明密文保留,不能证明里面内容已恢复。

密文被追加并可从完整载体中提取,取回字节与原密文一致。
图片重编码、转存或尾部长度异常时,外观可能仍正常,但提取失败或哈希不符。
不是带本工具标记的载体、文件不可读或目标不明确时停止,不猜图里藏了什么。

密文被追加并可从完整载体中提取,取回字节与原密文一致。
图片重编码、转存或尾部长度异常时,外观可能仍正常,但提取失败或哈希不符。
不是带本工具标记的载体、文件不可读或目标不明确时停止,不猜图里藏了什么。

在本机 vault-tool 使用 hide,把已有密文与封面图片写成新的载体;取回时用 unhide 指定独立输出路径。也可以在已接通 vault-workflow 的 AI 对话里用技能的 Hide/Unhide,精确指定密文、载体和输出位置,这一步不需要密码。原密文和原封面都会保留,做完载体不代表可以清理它们。
- 已有密文和封面图片
- 新载体及提取文件的保存位置(必须是还不存在的文件)


在本机 vault-tool 使用 hide,把已有密文与封面图片写成新的载体;取回时用 unhide 指定独立输出路径。也可以在已接通 vault-workflow 的 AI 对话里用技能的 Hide/Unhide,精确指定密文、载体和输出位置,这一步不需要密码。原密文和原封面都会保留,做完载体不代表可以清理它们。
- 已有密文和封面图片
- 新载体及提取文件的保存位置(必须是还不存在的文件)


这里保留实现、关键条件、精确入口、历史记录和验证结果。
图片尾部追加与密文提取已实现;2026-09-29 起 hide/unhide 不覆盖任何已有输出(提交 015fb14),当前源码 b884ab61


- hide_in_image 顺序写入封面原字节、密文、8 字节长度和尾标 VLTSTEG1;不解密密文、不修改像素或加入新的密码派生。
- extract_from_image 从文件末尾检查标记和长度,再截取对应载荷;标记错误或长度范围不成立时拒绝。
- 命令行 hide 默认用工具目录的默认库文件,--cover 选封面,--out 指定载体;unhide 默认输出为 vault.recovered.enc。两者都先检查输出目标,已有文件直接拒绝,不再询问是否覆盖;先写同目录私有候选、完整读回字节,再以不覆盖方式提交,失败清理候选。保护靠这一步,而不是靠默认文件名。
- AI 技能的 Hide 会取回候选并与原密文逐字节比较;Unhide 会检查提取物的容器结构再不覆盖发布(10 月 1 日修了候选路径冲突)。核心命令行的提取只检查尾标、长度和写回字节,不能说它同样自动证明内容可恢复。
- 扩展名、查看器能显示和实际图片格式有效是不同问题;实现没有对所有图片软件、社交平台或重编码器做兼容保证。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
图片尾部追加与密文提取已实现;2026-09-29 起 hide/unhide 不覆盖任何已有输出(提交 015fb14),当前源码 b884ab61


- hide_in_image 顺序写入封面原字节、密文、8 字节长度和尾标 VLTSTEG1;不解密密文、不修改像素或加入新的密码派生。
- extract_from_image 从文件末尾检查标记和长度,再截取对应载荷;标记错误或长度范围不成立时拒绝。
- 命令行 hide 默认用工具目录的默认库文件,--cover 选封面,--out 指定载体;unhide 默认输出为 vault.recovered.enc。两者都先检查输出目标,已有文件直接拒绝,不再询问是否覆盖;先写同目录私有候选、完整读回字节,再以不覆盖方式提交,失败清理候选。保护靠这一步,而不是靠默认文件名。
- AI 技能的 Hide 会取回候选并与原密文逐字节比较;Unhide 会检查提取物的容器结构再不覆盖发布(10 月 1 日修了候选路径冲突)。核心命令行的提取只检查尾标、长度和写回字节,不能说它同样自动证明内容可恢复。
- 扩展名、查看器能显示和实际图片格式有效是不同问题;实现没有对所有图片软件、社交平台或重编码器做兼容保证。

- 应对提取结果检查尺寸和 SHA-256,必要时再由本人用正确凭据实际打开;两步分别证明密文保全和内容可恢复。


- 应对提取结果检查尺寸和 SHA-256,必要时再由本人用正确凭据实际打开;两步分别证明密文保全和内容可恢复。



| 名词 | 意思 |
|---|---|
| carrier(文件载体) | 携带另一段数据的完整文件;这里靠保留文件尾部字节实现。 |
| steganography(隐写) | 本工具使用这个命名,但实现是图片尾部追加,不应让读者误以为修改像素或不可检测。 |
| re-encoding(重新编码) | 图片平台或软件重新生成图像字节,可能保留外观却删除追加密文。 |

不改照片像素来藏字;用完整图片文件携带已有密文,并验证可原样取回。



不改照片像素来藏字;用完整图片文件携带已有密文,并验证可原样取回。

- 没有证明所有 JPEG/PNG 查看器均接受载体,或所有平台传递后仍能恢复。
- 坏载体不能凭原来的图片外观补回丢失密文。
- 本功能不自动上传、分享或公开任何图片;隐写成功也不授权清理原密文或原封面。

- 没有证明所有 JPEG/PNG 查看器均接受载体,或所有平台传递后仍能恢复。
- 坏载体不能凭原来的图片外观补回丢失密文。
- 本功能不自动上传、分享或公开任何图片;隐写成功也不授权清理原密文或原封面。

- hide_in_image、extract_from_image 与命令行参数
- 载体往返、普通封面与错误输入回归
- 2026-09-03 的虚构载体为 65,619 B,取回的密文哈希与原 65,536 B 容器一致,普通封面被拒绝;这次只核对了回执文件,没有重新运行。
- 9 月 29 日新增回归 test_cli_hide_and_unhide_keep_existing_outputs_byte_for_byte,验证已有输出逐字节不变;当前源码共有 145 个测试定义,这次没有运行。
- 以上只证明原样文件的封装与提取,没有实际分享平台或图片重编码验收。
这里保存和取回的是已经加密的字节;密码、内容查看和远端备份仍由各自模块承担。

- hide_in_image、extract_from_image 与命令行参数
- 载体往返、普通封面与错误输入回归
- 2026-09-03 的虚构载体为 65,619 B,取回的密文哈希与原 65,536 B 容器一致,普通封面被拒绝;这次只核对了回执文件,没有重新运行。
- 9 月 29 日新增回归 test_cli_hide_and_unhide_keep_existing_outputs_byte_for_byte,验证已有输出逐字节不变;当前源码共有 145 个测试定义,这次没有运行。
- 以上只证明原样文件的封装与提取,没有实际分享平台或图片重编码验收。
这里保存和取回的是已经加密的字节;密码、内容查看和远端备份仍由各自模块承担。
复制 AI 续作说明
项目:图片后面带一份密文,取回时核对的是密文;仓库:wlyaaaaa/vault-tool;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








