
vault-tool · 功能说明
我不需要为了找一句话先解压整库。终端里能按文件名或内容搜索、显示支持的文本,并只把明确选中的文件提取出来交给外部程序;本地窗口 LocalView 则是从成员列表里选一项来看或复制。每一步都说明原文是在内存、剪贴板还是磁盘。
当前情况:本地文本查看、终端搜索和选择性提取都在;冲突不覆盖,部分导出与明文实际落盘分别报告。这次没有打开任何真实库。
项目源码:公开仓库


vault-tool · 功能说明
我不需要为了找一句话先解压整库。终端里能按文件名或内容搜索、显示支持的文本,并只把明确选中的文件提取出来交给外部程序;本地窗口 LocalView 则是从成员列表里选一项来看或复制。每一步都说明原文是在内存、剪贴板还是磁盘。
当前情况:本地文本查看、终端搜索和选择性提取都在;冲突不覆盖,部分导出与明文实际落盘分别报告。这次没有打开任何真实库。
项目源码:公开仓库


用途与实际影响
“解密了”没有说明内容去了哪里。临时提取文件可能在强杀后留下,复制到剪贴板的内容也不是原文缓冲区的一部分。把这些位置分清,才能决定本次查看需要哪条路线、结束后还剩什么。
“找出清单里写到打印机的那一段;然后只取出对应 PDF 给我打开。”先做文本内容搜索,PDF 则通过明确提取交给阅读器,而不是把 PDF 二进制硬显示成乱码。
在本机看到真实文本或明确的文件列表;选择提取后得到 decrypted/ 内本次文件及清理说明。无法作为文本读取的成员会保留类型边界,不用替换字符假装读懂。

用途与实际影响
“解密了”没有说明内容去了哪里。临时提取文件可能在强杀后留下,复制到剪贴板的内容也不是原文缓冲区的一部分。把这些位置分清,才能决定本次查看需要哪条路线、结束后还剩什么。
“找出清单里写到打印机的那一段;然后只取出对应 PDF 给我打开。”先做文本内容搜索,PDF 则通过明确提取交给阅读器,而不是把 PDF 二进制硬显示成乱码。
在本机看到真实文本或明确的文件列表;选择提取后得到 decrypted/ 内本次文件及清理说明。无法作为文本读取的成员会保留类型边界,不用替换字符假装读懂。

支持的文本可显示和搜索,筛选提取只交付匹配文件;结束时说明相应缓冲区和目录处理结果。
冲突、部分导出、格式不支持、清理失败或进程中断时,分别列出已存在、已写入、冲突与保留范围;不覆盖同名文件,不用退出码代替内容完整性。
密码或密钥文件不匹配时不显示内容;来源不存在或格式损坏时不生成空白成功页。

支持的文本可显示和搜索,筛选提取只交付匹配文件;结束时说明相应缓冲区和目录处理结果。
冲突、部分导出、格式不支持、清理失败或进程中断时,分别列出已存在、已写入、冲突与保留范围;不覆盖同名文件,不用退出码代替内容完整性。
密码或密钥文件不匹配时不显示内容;来源不存在或格式损坏时不生成空白成功页。

要搜索、按名称提取:在本机终端运行 vault-tool 打开库,普通关键字按文件名搜、/按内容搜,:copy 名字复制第一个匹配的文本,选 [2] 后输入关键字只提取匹配的文件。只想看某一项:在已接通 vault-workflow 的 AI 对话中用 LocalView,本人仅在本地窗口解锁,从成员列表里选择显示或复制。AI 技能的 DecryptExport 会把本次打开的内容全部导出到指定目录,目前不能只导出某个成员。
- 要查看的库和文字线索
- 若需提取文件,想要的文件名关键字和落盘位置
- 本人在本地窗口输入的解锁凭据


要搜索、按名称提取:在本机终端运行 vault-tool 打开库,普通关键字按文件名搜、/按内容搜,:copy 名字复制第一个匹配的文本,选 [2] 后输入关键字只提取匹配的文件。只想看某一项:在已接通 vault-workflow 的 AI 对话中用 LocalView,本人仅在本地窗口解锁,从成员列表里选择显示或复制。AI 技能的 DecryptExport 会把本次打开的内容全部导出到指定目录,目前不能只导出某个成员。
- 要查看的库和文字线索
- 若需提取文件,想要的文件名关键字和落盘位置
- 本人在本地窗口输入的解锁凭据


这里保留实现、关键条件、精确入口、历史记录和验证结果。
终端查看、搜索与选择性提取,以及 LocalView 列表查看已实现;9 月 3 日虚构样例保留原日期,本次未重新运行(源码 b884ab61,版本 2.3.1)


- decrypt_mode 的普通交互可选内存查看或磁盘提取;选择 [2] 后才有名称筛选。--no-disk 强制内存查看,--extract 则跳过筛选,把本次打开层的全部内容提取到工具的 decrypted/。_view_in_memory 按支持的文本扩展名和 64 KiB 限制显示。终端把明文打印到标准输出,只供本人不被模型捕获的本地终端阅读。
- 普通关键字筛文件名,/ 前缀进入文本内容搜索;:copy 使用首个名称匹配的可读文本,复制对象与多个匹配的边界要明确。
- 终端剪贴板清除由进程内守护线程等待 20 秒(CLIPBOARD_CLEAR_SECONDS)后执行,进程提前退出就不能保证该安排完成。
- LocalView 是成员下拉选择加显示/复制,没有终端那种名称/内容搜索框;AI 只拿到状态,不拿到原文。
- AI 技能的 DecryptExport 只接受明确的输出目录,当前参数里没有成员或筛选参数,会导出本次打开层的全部内容。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
终端查看、搜索与选择性提取,以及 LocalView 列表查看已实现;9 月 3 日虚构样例保留原日期,本次未重新运行(源码 b884ab61,版本 2.3.1)


- decrypt_mode 的普通交互可选内存查看或磁盘提取;选择 [2] 后才有名称筛选。--no-disk 强制内存查看,--extract 则跳过筛选,把本次打开层的全部内容提取到工具的 decrypted/。_view_in_memory 按支持的文本扩展名和 64 KiB 限制显示。终端把明文打印到标准输出,只供本人不被模型捕获的本地终端阅读。
- 普通关键字筛文件名,/ 前缀进入文本内容搜索;:copy 使用首个名称匹配的可读文本,复制对象与多个匹配的边界要明确。
- 终端剪贴板清除由进程内守护线程等待 20 秒(CLIPBOARD_CLEAR_SECONDS)后执行,进程提前退出就不能保证该安排完成。
- LocalView 是成员下拉选择加显示/复制,没有终端那种名称/内容搜索框;AI 只拿到状态,不拿到原文。
- AI 技能的 DecryptExport 只接受明确的输出目录,当前参数里没有成员或筛选参数,会导出本次打开层的全部内容。

- 提取按逐文件临时写入、长度和 SHA 核对、不覆盖提交。相同现有内容计 already_count,不同或并发新建同名目标计 conflict_count,不支持的成员单列;有冲突或不支持成员返回 partial,partial 仍可能已写出明文,完成数为 0 也不能推断没写过字节。归档成员数与声明解压总量受独立预算约束。
- 主明文缓冲区尽力 VirtualLock/mlock,结束时清零可变缓冲区并清屏;Python、tar 和界面仍可能产生其他副本。Ctrl+X 只在指定等待界面起作用。
- 终端里真正选择提取时,会先清掉已有的 decrypted/,结束时清理本次输出;强杀或断电可能留下明文。普通启动以及 info/doctor/assess/plan 这些诊断不清旧 decrypted/,旧残留需独立 clean-plaintext --confirm。清理前检查精确目标树,硬链接、符号链接、重解析点等不按普通暂存文件递归删除。


- 提取按逐文件临时写入、长度和 SHA 核对、不覆盖提交。相同现有内容计 already_count,不同或并发新建同名目标计 conflict_count,不支持的成员单列;有冲突或不支持成员返回 partial,partial 仍可能已写出明文,完成数为 0 也不能推断没写过字节。归档成员数与声明解压总量受独立预算约束。
- 主明文缓冲区尽力 VirtualLock/mlock,结束时清零可变缓冲区并清屏;Python、tar 和界面仍可能产生其他副本。Ctrl+X 只在指定等待界面起作用。
- 终端里真正选择提取时,会先清掉已有的 decrypted/,结束时清理本次输出;强杀或断电可能留下明文。普通启动以及 info/doctor/assess/plan 这些诊断不清旧 decrypted/,旧残留需独立 clean-plaintext --confirm。清理前检查精确目标树,硬链接、符号链接、重解析点等不按普通暂存文件递归删除。



| 名词 | 意思 |
|---|---|
| no-disk(不主动落盘查看) | 程序不主动把内容提取成原文文件;不保证解释器、系统或其他进程绝无副本。 |
| selective extraction(选择性提取) | 只把名称筛选命中的成员写到明确的提取目录,随后由外部程序使用。 |
| best effort(尽力处理) | 锁页、清零和某些退出清理只能在程序仍能执行相应步骤时完成,不是断电保证。 |

文字先在本地内存里查看;图片、PDF 和附件按需取出,并说明清理条件。



文字先在本地内存里查看;图片、PDF 和附件按需取出,并说明清理条件。

- 终端查看会输出明文,不应由 AI 捕获;LocalView/LocalEdit 的本地窗口才只给 AI 返回状态。不落盘与不进入模型是两条不同边界。
- SSD 的覆写删除不保证物理介质上每个旧副本都被抹除。
- 没有实测强杀、断电或全部桌面程序的清理效果,就不能写成已经通过。本地窗口的查看操作不写终端日志,AI 技能账本也只记入口名、不记结果,所以最近有没有真正查看过,现有记录说明不了。

- 终端查看会输出明文,不应由 AI 捕获;LocalView/LocalEdit 的本地窗口才只给 AI 返回状态。不落盘与不进入模型是两条不同边界。
- SSD 的覆写删除不保证物理介质上每个旧副本都被抹除。
- 没有实测强杀、断电或全部桌面程序的清理效果,就不能写成已经通过。本地窗口的查看操作不写终端日志,AI 技能账本也只记入口名、不记结果,所以最近有没有真正查看过,现有记录说明不了。

- _view_in_memory、_extract_to_folder、锁页、剪贴板与清理
- 选择性提取、大小提示、清理与隔离剪贴板验证
- 与 CLI(命令行工具)区分的本地 GUI 剪贴板和内存说明
- 2026-09-03 的虚构样例验证过:内存查看不创建 decrypted/,只筛选 ledger(追加式账本)时只提取对应的 47 字节 CSV,随后清理完成;这次只重读回执,没有重新运行。当前源码共有 145 个测试定义,这次没有运行。
- 测试替身只证明调用合同,不证明真实系统剪贴板计时已经完成。
- AI 技能账本里 vault-workflow 共 7 条记录,最近一条是 2026-09-29 01:11;账本只统计到 10 月 10 日零点,而且只记技能名,不记做了什么、成没成功,不能当作查看或提取的使用证明。
- 这次不对真实原文、系统剪贴板内容、断电或强杀做验收。
日常内容使用由本模块负责;本地窗口的文本编辑和它的结果状态在 AI 与本地入口模块,密码与依赖问题在密码与格式模块。

- _view_in_memory、_extract_to_folder、锁页、剪贴板与清理
- 选择性提取、大小提示、清理与隔离剪贴板验证
- 与 CLI(命令行工具)区分的本地 GUI 剪贴板和内存说明
- 2026-09-03 的虚构样例验证过:内存查看不创建 decrypted/,只筛选 ledger(追加式账本)时只提取对应的 47 字节 CSV,随后清理完成;这次只重读回执,没有重新运行。当前源码共有 145 个测试定义,这次没有运行。
- 测试替身只证明调用合同,不证明真实系统剪贴板计时已经完成。
- AI 技能账本里 vault-workflow 共 7 条记录,最近一条是 2026-09-29 01:11;账本只统计到 10 月 10 日零点,而且只记技能名,不记做了什么、成没成功,不能当作查看或提取的使用证明。
- 这次不对真实原文、系统剪贴板内容、断电或强杀做验收。
日常内容使用由本模块负责;本地窗口的文本编辑和它的结果状态在 AI 与本地入口模块,密码与依赖问题在密码与格式模块。
复制 AI 续作说明
项目:只看要用的文字,必须取文件时再明确落盘;仓库:wlyaaaaa/vault-tool;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








