Windows 剪贴板历史、再次复制与增量出口
现在
常用 · 近线备份 11 月 5 日 18:25
截至 11 月 4 日 · 项目仓库和备份回执

当段落、网址或文件路径被下一次复制覆盖,我可以在本机按关键词、日期和类型找回;完全相同的内容合在一组并显示真正复制次数,再看完整内容或再次复制。私人历史不进浏览器或主遥测数据库。日常入口现在是开始菜单里的“TimeAudit 剪贴板历史”,它打开的是密码中心桌面版的剪贴板页。

当前情况:11 月 06 日 14:26 本机库里共有 13,680 条复制事件;每天 18:25 的近线备份最近一次(11 月 3 日 18:25)完整通过,下一次排在 11 月 4 日 18:25。这次没有打开界面、试再次复制或试恢复。

项目源码:公开仓库

Windows 剪贴板历史、再次复制与增量出口
现在
常用 · 近线备份 11 月 5 日 18:25
截至 11 月 4 日 · 项目仓库和备份回执

当段落、网址或文件路径被下一次复制覆盖,我可以在本机按关键词、日期和类型找回;完全相同的内容合在一组并显示真正复制次数,再看完整内容或再次复制。私人历史不进浏览器或主遥测数据库。日常入口现在是开始菜单里的“TimeAudit 剪贴板历史”,它打开的是密码中心桌面版的剪贴板页。

当前情况:11 月 06 日 14:26 本机库里共有 13,680 条复制事件;每天 18:25 的近线备份最近一次(11 月 3 日 18:25)完整通过,下一次排在 11 月 4 日 18:25。这次没有打开界面、试再次复制或试恢复。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

Windows 当前剪贴板只保留最新内容,临时资料很容易被覆盖;只存去重文本又会丢掉“复制了几次、何时复制、是否来自历史恢复”的真实事件。

举个实际例子

我复制过同一个链接好几次,现在又被别的内容盖掉了。在本机剪贴板页筛选日期或链接,查看这一组的复制次数和最近时间,确认完整内容后点“再次复制”。新复制等原采集器记录后才会更新次数,不由界面先加一。

最后我会得到什么

本机筛选后按完全相同内容显示分组、准确总数和复制次数;预览正确内容后可再次复制,也能暂停或继续记录。允许的消费者仍按独立游标取得原始新事件。

这项功能怎样使用

用途与实际影响

为什么需要它

Windows 当前剪贴板只保留最新内容,临时资料很容易被覆盖;只存去重文本又会丢掉“复制了几次、何时复制、是否来自历史恢复”的真实事件。

举个实际例子

我复制过同一个链接好几次,现在又被别的内容盖掉了。在本机剪贴板页筛选日期或链接,查看这一组的复制次数和最近时间,确认完整内容后点“再次复制”。新复制等原采集器记录后才会更新次数,不由界面先加一。

最后我会得到什么

本机筛选后按完全相同内容显示分组、准确总数和复制次数;预览正确内容后可再次复制,也能暂停或继续记录。允许的消费者仍按独立游标取得原始新事件。

结果怎么看
正常时

查看器按筛选条件找到本机已保存内容,重复复制次数来自真实事件,再次复制后由采集器记录新时间。

发现问题时

来源不允许记录、内容过大或剪贴板暂时被占用时留下不含正文的缺口,不编造丢失内容。

入口不可用或证据不足时

记录停止、数据库损坏或搜索不可用时明确报告,保留已有历史,不用低效的全库翻找冒充恢复。

结果怎么看
正常时

查看器按筛选条件找到本机已保存内容,重复复制次数来自真实事件,再次复制后由采集器记录新时间。

发现问题时

来源不允许记录、内容过大或剪贴板暂时被占用时留下不含正文的缺口,不编造丢失内容。

入口不可用或证据不足时

记录停止、数据库损坏或搜索不可用时明确报告,保留已有历史,不用低效的全库翻找冒充恢复。

从哪里开始

从开始菜单打开“TimeAudit 剪贴板历史”(实际进入本机密码中心桌面版的剪贴板页),按记得的词、日期或类型查找;旧的独立查看器 viewer.pyw 还在源码里,但安装程序已不再打开或依赖它,不推荐当日常起点。确认正确内容后再选“再次复制”。

需要准备什么
  • 记得的文字片段、日期或内容类型
  • 要看相同内容被复制几次,还是要把它重新放入剪贴板
从开始到拿到结果
1找回被覆盖的内容
按关键词、日期或类型筛选本机已记录的复制,再把完全相同的内容放在一组;同一次复制的重复观察不增加次数。
2确认后再次复制
选择正确记录并点击“再次复制”,内容回到 Windows 剪贴板,找回动作也另记一条事件。
3核对范围
只说明本机实际观察到的复制;空白、跳过或采集间隙单独显示,复制事实不代表执行或同意。
从哪里开始

从开始菜单打开“TimeAudit 剪贴板历史”(实际进入本机密码中心桌面版的剪贴板页),按记得的词、日期或类型查找;旧的独立查看器 viewer.pyw 还在源码里,但安装程序已不再打开或依赖它,不推荐当日常起点。确认正确内容后再选“再次复制”。

需要准备什么
  • 记得的文字片段、日期或内容类型
  • 要看相同内容被复制几次,还是要把它重新放入剪贴板
从开始到拿到结果
1找回被覆盖的内容
按关键词、日期或类型筛选本机已记录的复制,再把完全相同的内容放在一组;同一次复制的重复观察不增加次数。
2确认后再次复制
选择正确记录并点击“再次复制”,内容回到 Windows 剪贴板,找回动作也另记一条事件。
3核对范围
只说明本机实际观察到的复制;空白、跳过或采集间隙单独显示,复制事实不代表执行或同意。
技术实现与依据(一)

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

正式入口归密码中心剪贴板页;2026-11-06 14:26 本机库 13,680 条事件、5,564 个正文对象、8,215 条索引;11 月 3 日 18:25 近线备份完整通过(回执记完整性检查 ok,备份里 13,300 条事件、5,312 个正文对象、7,887 条索引;11 月 4 日 09:09 回读,没有重跑完整性检查);这次未试恢复

关键规则与设计选择
1
每次复制都是独立事件;相同内容只复用 blobs 正文对象,绝不合并 events 事实。
2
展示时才按完全相同正文分组,空格不同仍是不同内容;复制次数排除同一来源实例、开机、会话、剪贴板序列里的重复观察。筛选先于分组与分页;疑似密钥只按特征提示,不能保证识别全部秘密。
3
启动、解锁、恢复和暂停结束只建立新的 clipboard sequence baseline(剪贴板序列基线),不导入此前当前内容。
4
只接收 Unicode 文本、HTTP(S) URL 和普通文件路径列表;图片、二进制、虚拟文件、私有格式与超限内容不保存正文。
5
查看界面、增量出口和备份各有只读/恢复边界;下游 checkpoint(续作检查点)只有在下游 writer(写入方)成功后才能推进。
6
公开页只展示 schema(数据结构)、组件、任务、路径类别、状态和计数;原始正文、内容 hash(内容指纹)、私密窗口与凭据始终不公开。
当前怎样实现
  • collector.pyw 创建隐藏 Win32 消息窗口,以 AddClipboardFormatListener / WM_CLIPBOARDUPDATE 事件驱动采集,不轮询、不装键盘 hook(钩子)、DLL、驱动或 Session 0 服务。
  • 读取时遵守 Windows 来源格式:ExcludeClipboardContentFromMonitorProcessing 或 CanIncludeInClipboardHistory=0 会阻止本地保存;CanUploadToCloudClipboard=0 只禁止云剪贴板,不阻止本机历史。
技术实现与依据(一)

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

正式入口归密码中心剪贴板页;2026-11-06 14:26 本机库 13,680 条事件、5,564 个正文对象、8,215 条索引;11 月 3 日 18:25 近线备份完整通过(回执记完整性检查 ok,备份里 13,300 条事件、5,312 个正文对象、7,887 条索引;11 月 4 日 09:09 回读,没有重跑完整性检查);这次未试恢复

关键规则与设计选择
1
每次复制都是独立事件;相同内容只复用 blobs 正文对象,绝不合并 events 事实。
2
展示时才按完全相同正文分组,空格不同仍是不同内容;复制次数排除同一来源实例、开机、会话、剪贴板序列里的重复观察。筛选先于分组与分页;疑似密钥只按特征提示,不能保证识别全部秘密。
3
启动、解锁、恢复和暂停结束只建立新的 clipboard sequence baseline(剪贴板序列基线),不导入此前当前内容。
4
只接收 Unicode 文本、HTTP(S) URL 和普通文件路径列表;图片、二进制、虚拟文件、私有格式与超限内容不保存正文。
5
查看界面、增量出口和备份各有只读/恢复边界;下游 checkpoint(续作检查点)只有在下游 writer(写入方)成功后才能推进。
6
公开页只展示 schema(数据结构)、组件、任务、路径类别、状态和计数;原始正文、内容 hash(内容指纹)、私密窗口与凭据始终不公开。
当前怎样实现
  • collector.pyw 创建隐藏 Win32 消息窗口,以 AddClipboardFormatListener / WM_CLIPBOARDUPDATE 事件驱动采集,不轮询、不装键盘 hook(钩子)、DLL、驱动或 Session 0 服务。
  • 读取时遵守 Windows 来源格式:ExcludeClipboardContentFromMonitorProcessing 或 CanIncludeInClipboardHistory=0 会阻止本地保存;CanUploadToCloudClipboard=0 只禁止云剪贴板,不阻止本机历史。
技术实现与依据(二)
1
启动 collector 后先记录 baseline,不读取启动前已在剪贴板中的内容。
2
新复制触发 WM_CLIPBOARDUPDATE;读取 source policy(来源策略)与受支持格式,失败则写无正文 skip/gap。
  • SQLite schema(数据结构)v1 包含 meta、blobs、events、content_fts 与 adapter_events_v1;WAL + synchronous=FULL,events/blobs 由 trigger(触发器)保持 append-only(只追加)。
  • 同一内容 SHA-256 映射到一个 blob;每次复制仍生成独立 event_id。再次复制写 versioned restore marker(版本化恢复标记),只有 marker 与原事件正文一致才记录 lineage。
  • 日常查看由密码中心桌面版的剪贴板页承担(开始菜单快捷方式带 --clipboard 参数打开),读取密码中心正式的资料状态,到期清屏,后台记录不受影响;PCConfig 截止前的安装器已不再打开或要求旧 viewer.pyw。viewer.pyw 仍可用 mode=ro 与 query_only=ON 在 Tkinter 窗口查询,FTS5 缺失时明确失败。
  • ReadOnlyClipboardStore.search_grouped 先在全历史按词、日期、payload 类型和内容类型筛选,再按 blob_id 分组分页;同 sequence 的重复观察只算一次,真正再次复制另计。model.py 的 link/secret_like 是格式线索,独立采集器和 append-only events 不改变。
  • adapter_stdio.py 提供 timeaudit.clipboard-export.request.v1 / response.v1 的 JSON/stdio 只读接口;checkpoint(续作检查点)是 (observed_at_utc,event_id),没有 HTTP API、浏览器依赖或固定端口。密码中心的只读界面不是这个增量出口的消费者。
  • backup.py 使用 SQLite Online Backup(在线一致备份),保存大小、计数、integrity 与 SHA-256 清单;恢复前验证副本,只写入空目标目录。10 月 1 日起加了窄范围文件告警:杀毒软件隔离或移除了本次精确路径、或已枚举的控制文件消失时,可带告警保留此前的备份,但会标明这次新数据没有拷入;源目录或目标目录不见仍算失败。
执行流程
技术实现与依据(二)
1
启动 collector 后先记录 baseline,不读取启动前已在剪贴板中的内容。
2
新复制触发 WM_CLIPBOARDUPDATE;读取 source policy(来源策略)与受支持格式,失败则写无正文 skip/gap。
  • SQLite schema(数据结构)v1 包含 meta、blobs、events、content_fts 与 adapter_events_v1;WAL + synchronous=FULL,events/blobs 由 trigger(触发器)保持 append-only(只追加)。
  • 同一内容 SHA-256 映射到一个 blob;每次复制仍生成独立 event_id。再次复制写 versioned restore marker(版本化恢复标记),只有 marker 与原事件正文一致才记录 lineage。
  • 日常查看由密码中心桌面版的剪贴板页承担(开始菜单快捷方式带 --clipboard 参数打开),读取密码中心正式的资料状态,到期清屏,后台记录不受影响;PCConfig 截止前的安装器已不再打开或要求旧 viewer.pyw。viewer.pyw 仍可用 mode=ro 与 query_only=ON 在 Tkinter 窗口查询,FTS5 缺失时明确失败。
  • ReadOnlyClipboardStore.search_grouped 先在全历史按词、日期、payload 类型和内容类型筛选,再按 blob_id 分组分页;同 sequence 的重复观察只算一次,真正再次复制另计。model.py 的 link/secret_like 是格式线索,独立采集器和 append-only events 不改变。
  • adapter_stdio.py 提供 timeaudit.clipboard-export.request.v1 / response.v1 的 JSON/stdio 只读接口;checkpoint(续作检查点)是 (observed_at_utc,event_id),没有 HTTP API、浏览器依赖或固定端口。密码中心的只读界面不是这个增量出口的消费者。
  • backup.py 使用 SQLite Online Backup(在线一致备份),保存大小、计数、integrity 与 SHA-256 清单;恢复前验证副本,只写入空目标目录。10 月 1 日起加了窄范围文件告警:杀毒软件隔离或移除了本次精确路径、或已枚举的控制文件消失时,可带告警保留此前的备份,但会标明这次新数据没有拷入;源目录或目标目录不见仍算失败。
执行流程
技术实现与依据(三)
3
为每次观察写 events,并按内容 SHA-256 复用 blobs;content_fts 同步保存可搜索索引。
4
用户在密码中心剪贴板页搜索、筛选和预览;点击再次复制时写原事件 id 与本次 request id marker。
5
获准消费者用版本化 JSON/stdio 读取有序事件,成功提交后在自己的 owner 边界保存下一 checkpoint(续作检查点);sidecar(侧车文件)不接受消费确认或删除。
6
每天北京时间 18:25 的 nearline backup(近线备份)用 SQLite Online Backup 写 G 盘;恢复先校验清单与数据库,再读回空目录,正式替换需单独停止 collector/watchdog 并保留 pre-image(替换前副本)。
技术实现与依据(三)
3
为每次观察写 events,并按内容 SHA-256 复用 blobs;content_fts 同步保存可搜索索引。
4
用户在密码中心剪贴板页搜索、筛选和预览;点击再次复制时写原事件 id 与本次 request id marker。
5
获准消费者用版本化 JSON/stdio 读取有序事件,成功提交后在自己的 owner 边界保存下一 checkpoint(续作检查点);sidecar(侧车文件)不接受消费确认或删除。
6
每天北京时间 18:25 的 nearline backup(近线备份)用 SQLite Online Backup 写 G 盘;恢复先校验清单与数据库,再读回空目录,正式替换需单独停止 collector/watchdog 并保留 pre-image(替换前副本)。
名词和入口
本模块用到的名词
名词意思
WM_CLIPBOARDUPDATEWindows 在剪贴板发生变化时发出的消息;事件驱动,不是轮询或键盘监听。
WAL(预写日志)SQLite 让持续写入与只读查询并行的日志模式;恢复不能靠在线手工复制 WAL/SHM。
FTS5(全文搜索索引)为关键词检索建立的 SQLite 虚拟表;缺失就停止查看,不长期扫描正文表。
lineage(恢复来源链)restored_from_event_id 与 restore_request_id 把再次复制连接回原事件。
checkpoint(增量游标)最后成功提交的观察时间与事件 id;重复读取同一 event_id 必须由下游幂等处理。
专业定义

在当前 Windows 会话记录新复制;本机按词、日期与类型找回,相同内容分组显示实际复制次数,确认后可再次复制。增量出口和近线恢复仍独立。

名词和入口
本模块用到的名词
名词意思
WM_CLIPBOARDUPDATE
意思:
Windows 在剪贴板发生变化时发出的消息;事件驱动,不是轮询或键盘监听。
WAL(预写日志)
意思:
SQLite 让持续写入与只读查询并行的日志模式;恢复不能靠在线手工复制 WAL/SHM。
FTS5(全文搜索索引)
意思:
为关键词检索建立的 SQLite 虚拟表;缺失就停止查看,不长期扫描正文表。
lineage(恢复来源链)
意思:
restored_from_event_id 与 restore_request_id 把再次复制连接回原事件。
checkpoint(增量游标)
意思:
最后成功提交的观察时间与事件 id;重复读取同一 event_id 必须由下游幂等处理。
专业定义

在当前 Windows 会话记录新复制;本机按词、日期与类型找回,相同内容分组显示实际复制次数,确认后可再次复制。增量出口和近线恢复仍独立。

出问题时(一)
边界
  • sidecar(侧车文件)与 PostgreSQL/Grafana 主链完全独立;主链健康不能证明剪贴板健康,反之亦然。
  • 复制事实只证明本机观察到一次复制,不证明阅读、收件、同意、执行、归属或用户意图。
  • 活动私密库在 E 盘持久数据层,G 盘只是近线恢复副本且不是查询依赖;网页、Git、日志和浏览器不接触原始正文、hash(内容指纹)、FTS 或凭据。
  • 当前合同只覆盖 Windows 电脑;手机来源是另一 source instance(来源实例),不能在 collector 内猜测合并。
  • clipboard_sequence 只在同一 Windows clipboard station(剪贴板站)相邻事实中解释,不能当作跨启动、会话或设备的全局顺序。
  • 增量合同存在不等于下游消费者已上线;现在实际有没有程序在用这个增量出口、用了多少次,没有核对。
  • 版本化恢复标记只连接再次复制与原事件,不表示另一个中央系统是当前产品或消费者。
失败与恢复
情况
怎么处理
来源明确禁止、格式不支持、内容超限或剪贴板暂时锁定
保存无 payload 的 skip/gap 原因;不把缺失内容猜回数据库。
出问题时(一)
边界
  • sidecar(侧车文件)与 PostgreSQL/Grafana 主链完全独立;主链健康不能证明剪贴板健康,反之亦然。
  • 复制事实只证明本机观察到一次复制,不证明阅读、收件、同意、执行、归属或用户意图。
  • 活动私密库在 E 盘持久数据层,G 盘只是近线恢复副本且不是查询依赖;网页、Git、日志和浏览器不接触原始正文、hash(内容指纹)、FTS 或凭据。
  • 当前合同只覆盖 Windows 电脑;手机来源是另一 source instance(来源实例),不能在 collector 内猜测合并。
  • clipboard_sequence 只在同一 Windows clipboard station(剪贴板站)相邻事实中解释,不能当作跨启动、会话或设备的全局顺序。
  • 增量合同存在不等于下游消费者已上线;现在实际有没有程序在用这个增量出口、用了多少次,没有核对。
  • 版本化恢复标记只连接再次复制与原事件,不表示另一个中央系统是当前产品或消费者。
失败与恢复
情况
怎么处理
来源明确禁止、格式不支持、内容超限或剪贴板暂时锁定
保存无 payload 的 skip/gap 原因;不把缺失内容猜回数据库。
出问题时(二)
情况 怎么处理
heartbeat 超过 30 秒或 collector 退出 TimeAudit_ClipboardWatchdog 每分钟通过隐藏启动器检查并恢复;不启动第二个长期 collector。
schema(数据结构)版本不支持或 FTS5 缺失 查看界面/adapter(执行适配器)失败关闭,不回退为长期全表扫描。
备份 hash(内容指纹)、大小、计数或 integrity 不一致 拒绝恢复;非空目标也拒绝覆盖,活动库原样保留。普通 I/O 错误仍算备份失败,只有杀毒隔离等窄情况可带告警保留旧备份。
marker 缺失、无效或正文不匹配 新观察按普通 copy 保存,不靠时间窗口或 hash(内容指纹)猜 lineage。
出问题时(二)
情况 怎么处理
heartbeat 超过 30 秒或 collector 退出 TimeAudit_ClipboardWatchdog 每分钟通过隐藏启动器检查并恢复;不启动第二个长期 collector。
schema(数据结构)版本不支持或 FTS5 缺失 查看界面/adapter(执行适配器)失败关闭,不回退为长期全表扫描。
备份 hash(内容指纹)、大小、计数或 integrity 不一致 拒绝恢复;非空目标也拒绝覆盖,活动库原样保留。普通 I/O 错误仍算备份失败,只有杀毒隔离等窄情况可带告警保留旧备份。
marker 缺失、无效或正文不匹配 新观察按普通 copy 保存,不靠时间窗口或 hash(内容指纹)猜 lineage。
依据与来源(一)
真实入口
  • Win32 消息采集、baseline、边界与 heartbeat
  • SQLite schema(数据结构)、WAL、FTS5、只读查询与增量投影
  • 链接与疑似密钥内容类型提示,不保证识别全部凭据
  • 本机搜索、预览、暂停与再次复制
  • 版本化 JSON/stdio 只读增量出口
  • 在线一致备份、校验与空目录恢复
  • 任务、ACL、心跳、schema(数据结构)、计数与无正文 adapter(执行适配器)验收
  • 机器路径类别、三任务、近线备份与恢复顺序
依据与来源(一)
真实入口
  • Win32 消息采集、baseline、边界与 heartbeat
  • SQLite schema(数据结构)、WAL、FTS5、只读查询与增量投影
  • 链接与疑似密钥内容类型提示,不保证识别全部凭据
  • 本机搜索、预览、暂停与再次复制
  • 版本化 JSON/stdio 只读增量出口
  • 在线一致备份、校验与空目录恢复
  • 任务、ACL、心跳、schema(数据结构)、计数与无正文 adapter(执行适配器)验收
  • 机器路径类别、三任务、近线备份与恢复顺序
依据与来源(二)
  • 模型、存储、查看、lineage、adapter(执行适配器)与备份回归
如何验证
  • Source(源码):已发布 001cee0 包含完整 clipboard_history 实现与合同;当前源码 12491e2(10 月 20 日)里 test_clipboard_history.py 仍是 19 个测试函数、clipboard_history/test_personal_access.py 有 11 个,这次没有运行;c5ca4eeb 之后的 17 次提交没有改剪贴板记录。
  • Tests(测试):8 月 31 日使用 Python 3.11 -B -m unittest -v test_clipboard_history.py,11 项全部通过,用时 0.806 秒;单元测试包含 SQLite Online Backup 到空目录的合成读回。
  • Runtime(运行,历史):8 月 31 日 PCConfig 无正文验证 status=passed;当时 5234 events / 2312 blobs / 3406 FTS rows。
  • Runtime(运行,2026-10-12 05:37 只读计数):schema v1,11,382 条 events、4,277 个 blobs、6,397 条 FTS 索引,采集器状态 running、未暂停;这只数了条数,不是 FTS 完整性验收。10 月 11 日 23:52 那次是 11,376 / 4,274 / 6,393。同日 16:36 曾另查过一次:现库里事件时间早于 10 月 11 日 14:00 的有 11,356 条、引用 4,269 个不同正文对象——这是 16:36 时还留在库里的数,不是 14:00 当时的总数(没有 14:00 快照,之后有没有删除也没核对)。
  • Backup(备份):最近一次近线备份 2026-11-03 18:25:03 完整通过,integrity=ok,当时 13,300 events / 5,312 blobs / 7,887 FTS,没有文件告警;11 月 4 日 09:09 回读,任务就绪、最近结果 0,下一次排在 11 月 4 日 18:25。这次只读了备份回执里的状态和条数,没有重新校验或恢复这份副本;G 盘只留一份最新副本。
  • Backup(备份,历史):2026-10-11 18:25:37 那次完整通过,integrity=ok,当时 11,373 events / 4,274 blobs / 6,393 FTS,没有文件告警。
  • Contract(合同):adapter(执行适配器)返回 timeaudit.clipboard-export.response.v1、source profile src.timeaudit.windows_clipboard、1 个事件且 payload_absent=true;这验证接口形状,不验证实际下游消费。
  • Gap(缺口):这次没有运行会写入合成内容的 smoke_test.py,没有把最新 G 盘副本恢复到空目录,没有打开界面或试再次复制,也没有验收实际下游 writer;不能声称真机 lineage 或端到端灾难恢复已经完成。
与其他模块的关系

这是与 PostgreSQL/Grafana 主时间线并列的独立产品轴;PCConfig 拥有机器路径、ACL、三任务、快捷方式、看门狗与近线恢复,密码中心提供日常查看界面,TimeAudit 拥有采集语义、SQLite schema(数据结构)与增量合同。它不依赖其他模块,但可把获准的版本化事件交给独立消费者。

依据与来源(二)
  • 模型、存储、查看、lineage、adapter(执行适配器)与备份回归
如何验证
  • Source(源码):已发布 001cee0 包含完整 clipboard_history 实现与合同;当前源码 12491e2(10 月 20 日)里 test_clipboard_history.py 仍是 19 个测试函数、clipboard_history/test_personal_access.py 有 11 个,这次没有运行;c5ca4eeb 之后的 17 次提交没有改剪贴板记录。
  • Tests(测试):8 月 31 日使用 Python 3.11 -B -m unittest -v test_clipboard_history.py,11 项全部通过,用时 0.806 秒;单元测试包含 SQLite Online Backup 到空目录的合成读回。
  • Runtime(运行,历史):8 月 31 日 PCConfig 无正文验证 status=passed;当时 5234 events / 2312 blobs / 3406 FTS rows。
  • Runtime(运行,2026-10-12 05:37 只读计数):schema v1,11,382 条 events、4,277 个 blobs、6,397 条 FTS 索引,采集器状态 running、未暂停;这只数了条数,不是 FTS 完整性验收。10 月 11 日 23:52 那次是 11,376 / 4,274 / 6,393。同日 16:36 曾另查过一次:现库里事件时间早于 10 月 11 日 14:00 的有 11,356 条、引用 4,269 个不同正文对象——这是 16:36 时还留在库里的数,不是 14:00 当时的总数(没有 14:00 快照,之后有没有删除也没核对)。
  • Backup(备份):最近一次近线备份 2026-11-03 18:25:03 完整通过,integrity=ok,当时 13,300 events / 5,312 blobs / 7,887 FTS,没有文件告警;11 月 4 日 09:09 回读,任务就绪、最近结果 0,下一次排在 11 月 4 日 18:25。这次只读了备份回执里的状态和条数,没有重新校验或恢复这份副本;G 盘只留一份最新副本。
  • Backup(备份,历史):2026-10-11 18:25:37 那次完整通过,integrity=ok,当时 11,373 events / 4,274 blobs / 6,393 FTS,没有文件告警。
  • Contract(合同):adapter(执行适配器)返回 timeaudit.clipboard-export.response.v1、source profile src.timeaudit.windows_clipboard、1 个事件且 payload_absent=true;这验证接口形状,不验证实际下游消费。
  • Gap(缺口):这次没有运行会写入合成内容的 smoke_test.py,没有把最新 G 盘副本恢复到空目录,没有打开界面或试再次复制,也没有验收实际下游 writer;不能声称真机 lineage 或端到端灾难恢复已经完成。
与其他模块的关系

这是与 PostgreSQL/Grafana 主时间线并列的独立产品轴;PCConfig 拥有机器路径、ACL、三任务、快捷方式、看门狗与近线恢复,密码中心提供日常查看界面,TimeAudit 拥有采集语义、SQLite schema(数据结构)与增量合同。它不依赖其他模块,但可把获准的版本化事件交给独立消费者。

复制 AI 续作说明

项目:Windows 剪贴板历史、再次复制与增量出口;仓库:wlyaaaaa/TimeAudit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。