只看要用的文字,必须取文件时再明确落盘
现在
偶尔用 · 最近 AI 技能记录 10 月 20 日 13:59
使用记录记到 11 月 5 日,只记技能名,不能证明用成了
截至 11 月 4 日 · 项目仓库和 AI 使用记录

我不需要为了找一句话先解压整库。终端里能按文件名或内容搜索、显示支持的文本,并只把明确选中的文件提取出来交给外部程序;本地窗口 LocalView 则是从成员列表里选一项来看或复制。每一步都说明原文是在内存、剪贴板还是磁盘。

当前情况:本地文本查看、终端搜索和选择性提取都在;冲突不覆盖,部分导出与明文实际落盘分别报告。这次没有打开任何真实库。

项目源码:公开仓库

只看要用的文字,必须取文件时再明确落盘
现在
偶尔用 · 最近 AI 技能记录 10 月 20 日 13:59
使用记录记到 11 月 5 日,只记技能名,不能证明用成了
截至 11 月 4 日 · 项目仓库和 AI 使用记录

我不需要为了找一句话先解压整库。终端里能按文件名或内容搜索、显示支持的文本,并只把明确选中的文件提取出来交给外部程序;本地窗口 LocalView 则是从成员列表里选一项来看或复制。每一步都说明原文是在内存、剪贴板还是磁盘。

当前情况:本地文本查看、终端搜索和选择性提取都在;冲突不覆盖,部分导出与明文实际落盘分别报告。这次没有打开任何真实库。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

“解密了”没有说明内容去了哪里。临时提取文件可能在强杀后留下,复制到剪贴板的内容也不是原文缓冲区的一部分。把这些位置分清,才能决定本次查看需要哪条路线、结束后还剩什么。

举个实际例子

“找出清单里写到打印机的那一段;然后只取出对应 PDF 给我打开。”先做文本内容搜索,PDF 则通过明确提取交给阅读器,而不是把 PDF 二进制硬显示成乱码。

最后我会得到什么

在本机看到真实文本或明确的文件列表;选择提取后得到 decrypted/ 内本次文件及清理说明。无法作为文本读取的成员会保留类型边界,不用替换字符假装读懂。

这项功能怎样使用

用途与实际影响

为什么需要它

“解密了”没有说明内容去了哪里。临时提取文件可能在强杀后留下,复制到剪贴板的内容也不是原文缓冲区的一部分。把这些位置分清,才能决定本次查看需要哪条路线、结束后还剩什么。

举个实际例子

“找出清单里写到打印机的那一段;然后只取出对应 PDF 给我打开。”先做文本内容搜索,PDF 则通过明确提取交给阅读器,而不是把 PDF 二进制硬显示成乱码。

最后我会得到什么

在本机看到真实文本或明确的文件列表;选择提取后得到 decrypted/ 内本次文件及清理说明。无法作为文本读取的成员会保留类型边界,不用替换字符假装读懂。

结果怎么看
正常时

支持的文本可显示和搜索,筛选提取只交付匹配文件;结束时说明相应缓冲区和目录处理结果。

发现问题时

冲突、部分导出、格式不支持、清理失败或进程中断时,分别列出已存在、已写入、冲突与保留范围;不覆盖同名文件,不用退出码代替内容完整性。

入口不可用或证据不足时

密码或密钥文件不匹配时不显示内容;来源不存在或格式损坏时不生成空白成功页。

结果怎么看
正常时

支持的文本可显示和搜索,筛选提取只交付匹配文件;结束时说明相应缓冲区和目录处理结果。

发现问题时

冲突、部分导出、格式不支持、清理失败或进程中断时,分别列出已存在、已写入、冲突与保留范围;不覆盖同名文件,不用退出码代替内容完整性。

入口不可用或证据不足时

密码或密钥文件不匹配时不显示内容;来源不存在或格式损坏时不生成空白成功页。

从哪里开始

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

需要准备什么
  • 要查看的库和文字线索
  • 若需提取文件,想要的文件名关键字和落盘位置
  • 本人在本地窗口输入的解锁凭据
从开始到拿到结果
1只打开所需范围
本人本地解锁后,在终端按名称或内容找目标,或在 LocalView 列表里选,不一次性导出整库。
2选择查看或提取
支持的文本在本地界面阅读;外部程序必需的文件才在终端按名称筛选后提取。
3结束时核对残留
区分内存、剪贴板与已提取文件;中断时报告实际残留,不能称自动清完。
从哪里开始

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

需要准备什么
  • 要查看的库和文字线索
  • 若需提取文件,想要的文件名关键字和落盘位置
  • 本人在本地窗口输入的解锁凭据
从开始到拿到结果
1只打开所需范围
本人本地解锁后,在终端按名称或内容找目标,或在 LocalView 列表里选,不一次性导出整库。
2选择查看或提取
支持的文本在本地界面阅读;外部程序必需的文件才在终端按名称筛选后提取。
3结束时核对残留
区分内存、剪贴板与已提取文件;中断时报告实际残留,不能称自动清完。
技术实现与依据(一)

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

终端查看、搜索与选择性提取,以及 LocalView 列表查看已实现;9 月 3 日虚构样例保留原日期,本次未重新运行(源码 b884ab61,版本 2.3.1)

关键规则与设计选择
1
内存查看不等于所有系统副本都无法恢复。
2
终端文本显示受类型与 64 KiB 限制;LocalView 支持的文本总预算是 64 MiB,两者不是同一个上限。外部附件应明确提取。
3
终端复制后的 20 秒清理需要当前进程存活;本地窗口的 15 秒规则是另一条实现,从最近一次复制算起,只清自己复制且仍在剪贴板里的内容,关窗时也清。
当前怎样实现
  • 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)

关键规则与设计选择
1
内存查看不等于所有系统副本都无法恢复。
2
终端文本显示受类型与 64 KiB 限制;LocalView 支持的文本总预算是 64 MiB,两者不是同一个上限。外部附件应明确提取。
3
终端复制后的 20 秒清理需要当前进程存活;本地窗口的 15 秒规则是另一条实现,从最近一次复制算起,只清自己复制且仍在剪贴板里的内容,关窗时也清。
当前怎样实现
  • decrypt_mode 的普通交互可选内存查看或磁盘提取;选择 [2] 后才有名称筛选。--no-disk 强制内存查看,--extract 则跳过筛选,把本次打开层的全部内容提取到工具的 decrypted/。_view_in_memory 按支持的文本扩展名和 64 KiB 限制显示。终端把明文打印到标准输出,只供本人不被模型捕获的本地终端阅读。
  • 普通关键字筛文件名,/ 前缀进入文本内容搜索;:copy 使用首个名称匹配的可读文本,复制对象与多个匹配的边界要明确。
  • 终端剪贴板清除由进程内守护线程等待 20 秒(CLIPBOARD_CLEAR_SECONDS)后执行,进程提前退出就不能保证该安排完成。
  • LocalView 是成员下拉选择加显示/复制,没有终端那种名称/内容搜索框;AI 只拿到状态,不拿到原文。
  • AI 技能的 DecryptExport 只接受明确的输出目录,当前参数里没有成员或筛选参数,会导出本次打开层的全部内容。
技术实现与依据(二)
1
本人在本地提供所需凭据,实际打开相应内容。
2
终端里用名称或内容搜索缩小要看的文本;LocalView 里从列表选择。
3
只阅读、明确复制,或在终端按名称提取需要外部软件的文件。
4
按内存、剪贴板和磁盘三种位置分别处理结束。
5
意外中断时确认具体残留,不把下次清理能力冒充这次已经清理。
  • 提取按逐文件临时写入、长度和 SHA 核对、不覆盖提交。相同现有内容计 already_count,不同或并发新建同名目标计 conflict_count,不支持的成员单列;有冲突或不支持成员返回 partial,partial 仍可能已写出明文,完成数为 0 也不能推断没写过字节。归档成员数与声明解压总量受独立预算约束。
  • 主明文缓冲区尽力 VirtualLock/mlock,结束时清零可变缓冲区并清屏;Python、tar 和界面仍可能产生其他副本。Ctrl+X 只在指定等待界面起作用。
  • 终端里真正选择提取时,会先清掉已有的 decrypted/,结束时清理本次输出;强杀或断电可能留下明文。普通启动以及 info/doctor/assess/plan 这些诊断不清旧 decrypted/,旧残留需独立 clean-plaintext --confirm。清理前检查精确目标树,硬链接、符号链接、重解析点等不按普通暂存文件递归删除。
执行流程
技术实现与依据(二)
1
本人在本地提供所需凭据,实际打开相应内容。
2
终端里用名称或内容搜索缩小要看的文本;LocalView 里从列表选择。
3
只阅读、明确复制,或在终端按名称提取需要外部软件的文件。
4
按内存、剪贴板和磁盘三种位置分别处理结束。
5
意外中断时确认具体残留,不把下次清理能力冒充这次已经清理。
  • 提取按逐文件临时写入、长度和 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 和附件按需取出,并说明清理条件。

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

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

出问题时
边界
  • 终端查看会输出明文,不应由 AI 捕获;LocalView/LocalEdit 的本地窗口才只给 AI 返回状态。不落盘与不进入模型是两条不同边界。
  • SSD 的覆写删除不保证物理介质上每个旧副本都被抹除。
  • 没有实测强杀、断电或全部桌面程序的清理效果,就不能写成已经通过。本地窗口的查看操作不写终端日志,AI 技能账本也只记入口名、不记结果,所以最近有没有真正查看过,现有记录说明不了。
失败与恢复
情况
怎么处理
图片、PDF、二进制或超出显示限制的文本
说明不能在该文本入口完整显示,改由本人明确选择是否提取,不把部分文本当完整附件。
进程提前结束或断电
剪贴板计时和退出回调可能来不及执行;明文残留先定位,再用明确的清理入口处理。诊断不会自动删除,不能声称断电当场已清除。
暂存清理发现链接或删除失败
停止不适合的删除并报告具体范围,不顺着链接清别处文件。
出问题时
边界
  • 终端查看会输出明文,不应由 AI 捕获;LocalView/LocalEdit 的本地窗口才只给 AI 返回状态。不落盘与不进入模型是两条不同边界。
  • SSD 的覆写删除不保证物理介质上每个旧副本都被抹除。
  • 没有实测强杀、断电或全部桌面程序的清理效果,就不能写成已经通过。本地窗口的查看操作不写终端日志,AI 技能账本也只记入口名、不记结果,所以最近有没有真正查看过,现有记录说明不了。
失败与恢复
情况
怎么处理
图片、PDF、二进制或超出显示限制的文本
说明不能在该文本入口完整显示,改由本人明确选择是否提取,不把部分文本当完整附件。
进程提前结束或断电
剪贴板计时和退出回调可能来不及执行;明文残留先定位,再用明确的清理入口处理。诊断不会自动删除,不能声称断电当场已清除。
暂存清理发现链接或删除失败
停止不适合的删除并报告具体范围,不顺着链接清别处文件。
依据与来源
真实入口
  • _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。