图片后面带一份密文,取回时核对的是密文
现在
偶尔用
11 月 4 日核对没碰真实库
截至 11 月 4 日 · 项目源码

我可以让一个图片文件同时携带已有的加密库,之后用工具把密文原样取回。判断是否成功要比较提取后的密文,而不是只看图片仍能显示。现在不管是做载体还是取回,目标位置已有文件就直接拒绝,不会覆盖。

当前情况:在图片尾部携带和提取密文的功能在;9 月 29 日起输出一律不覆盖已有文件。平台重编码可能破坏载荷,图片能看不代表密文仍完整。

项目源码:公开仓库

图片后面带一份密文,取回时核对的是密文
现在
偶尔用
11 月 4 日核对没碰真实库
截至 11 月 4 日 · 项目源码

我可以让一个图片文件同时携带已有的加密库,之后用工具把密文原样取回。判断是否成功要比较提取后的密文,而不是只看图片仍能显示。现在不管是做载体还是取回,目标位置已有文件就直接拒绝,不会覆盖。

当前情况:在图片尾部携带和提取密文的功能在;9 月 29 日起输出一律不覆盖已有文件。平台重编码可能破坏载荷,图片能看不代表密文仍完整。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

图片查看器可能忽略尾部字节,但分享平台可能重新编码整张图,把尾部丢掉。把“封面能打开”和“保险库仍完整”混成一件事,会让损坏的载体看起来一切正常。

举个实际例子

“把这份已经加密的文件放在这张封面图片后面,再取出来确认没有改变。”工具建立载体并提取,比较密文大小与哈希;如果准备经过会压缩图片的平台,先明确这种传递方式不保证保留载荷。

最后我会得到什么

得到携带密文的图片文件,以及提取后的 vault.recovered.enc 或本人指定路径;成功取回需要字节一致。没有重新提供密码时只能证明密文保留,不能证明里面内容已恢复。

这项功能怎样使用

用途与实际影响

为什么需要它

图片查看器可能忽略尾部字节,但分享平台可能重新编码整张图,把尾部丢掉。把“封面能打开”和“保险库仍完整”混成一件事,会让损坏的载体看起来一切正常。

举个实际例子

“把这份已经加密的文件放在这张封面图片后面,再取出来确认没有改变。”工具建立载体并提取,比较密文大小与哈希;如果准备经过会压缩图片的平台,先明确这种传递方式不保证保留载荷。

最后我会得到什么

得到携带密文的图片文件,以及提取后的 vault.recovered.enc 或本人指定路径;成功取回需要字节一致。没有重新提供密码时只能证明密文保留,不能证明里面内容已恢复。

结果怎么看
正常时

密文被追加并可从完整载体中提取,取回字节与原密文一致。

发现问题时

图片重编码、转存或尾部长度异常时,外观可能仍正常,但提取失败或哈希不符。

入口不可用或证据不足时

不是带本工具标记的载体、文件不可读或目标不明确时停止,不猜图里藏了什么。

结果怎么看
正常时

密文被追加并可从完整载体中提取,取回字节与原密文一致。

发现问题时

图片重编码、转存或尾部长度异常时,外观可能仍正常,但提取失败或哈希不符。

入口不可用或证据不足时

不是带本工具标记的载体、文件不可读或目标不明确时停止,不猜图里藏了什么。

从哪里开始

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

需要准备什么
  • 已有密文和封面图片
  • 新载体及提取文件的保存位置(必须是还不存在的文件)
从开始到拿到结果
1选定已有密文和封面
这是给密文加图片载体,先确认密文本身已生成且另有恢复条件。
2写入并取回
工具把密文附在图片字节后,再从载体提取到独立文件;目标已存在就停下。
3比较密文字节
核对原密文与提取物完全相同;图片能打开不等于密文可恢复,重编码也可能破坏尾部。
从哪里开始

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

需要准备什么
  • 已有密文和封面图片
  • 新载体及提取文件的保存位置(必须是还不存在的文件)
从开始到拿到结果
1选定已有密文和封面
这是给密文加图片载体,先确认密文本身已生成且另有恢复条件。
2写入并取回
工具把密文附在图片字节后,再从载体提取到独立文件;目标已存在就停下。
3比较密文字节
核对原密文与提取物完全相同;图片能打开不等于密文可恢复,重编码也可能破坏尾部。
技术实现与依据(一)

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

图片尾部追加与密文提取已实现;2026-09-29 起 hide/unhide 不覆盖任何已有输出(提交 015fb14),当前源码 b884ab61

关键规则与设计选择
1
这里是文件尾部封装,不是像素级隐写,也不增加一道加密。
2
传递原文件与发送经过图片压缩的照片不同。
3
应保留独立密文副本和原封面,不能只靠封面显示正常判断恢复。
当前怎样实现
  • 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

关键规则与设计选择
1
这里是文件尾部封装,不是像素级隐写,也不增加一道加密。
2
传递原文件与发送经过图片压缩的照片不同。
3
应保留独立密文副本和原封面,不能只靠封面显示正常判断恢复。
当前怎样实现
  • hide_in_image 顺序写入封面原字节、密文、8 字节长度和尾标 VLTSTEG1;不解密密文、不修改像素或加入新的密码派生。
  • extract_from_image 从文件末尾检查标记和长度,再截取对应载荷;标记错误或长度范围不成立时拒绝。
  • 命令行 hide 默认用工具目录的默认库文件,--cover 选封面,--out 指定载体;unhide 默认输出为 vault.recovered.enc。两者都先检查输出目标,已有文件直接拒绝,不再询问是否覆盖;先写同目录私有候选、完整读回字节,再以不覆盖方式提交,失败清理候选。保护靠这一步,而不是靠默认文件名。
  • AI 技能的 Hide 会取回候选并与原密文逐字节比较;Unhide 会检查提取物的容器结构再不覆盖发布(10 月 1 日修了候选路径冲突)。核心命令行的提取只检查尾标、长度和写回字节,不能说它同样自动证明内容可恢复。
  • 扩展名、查看器能显示和实际图片格式有效是不同问题;实现没有对所有图片软件、社交平台或重编码器做兼容保证。
技术实现与依据(二)
1
明确已有密文、封面与输出路径(输出不能已存在)。
2
把密文和长度标记追加到封面字节之后。
3
用 unhide 提取到独立路径。
4
比较原密文与取回密文的字节或哈希。
5
如需确认内容恢复,再由本人本地提供对应凭据;不把图片外观当验收。
  • 应对提取结果检查尺寸和 SHA-256,必要时再由本人用正确凭据实际打开;两步分别证明密文保全和内容可恢复。
执行流程
技术实现与依据(二)
1
明确已有密文、封面与输出路径(输出不能已存在)。
2
把密文和长度标记追加到封面字节之后。
3
用 unhide 提取到独立路径。
4
比较原密文与取回密文的字节或哈希。
5
如需确认内容恢复,再由本人本地提供对应凭据;不把图片外观当验收。
  • 应对提取结果检查尺寸和 SHA-256,必要时再由本人用正确凭据实际打开;两步分别证明密文保全和内容可恢复。
执行流程
名词和入口
本模块用到的名词
名词意思
carrier(文件载体)携带另一段数据的完整文件;这里靠保留文件尾部字节实现。
steganography(隐写)本工具使用这个命名,但实现是图片尾部追加,不应让读者误以为修改像素或不可检测。
re-encoding(重新编码)图片平台或软件重新生成图像字节,可能保留外观却删除追加密文。
专业定义

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

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