
TimeAudit · 功能说明
当段落、网址或文件路径被下一次复制覆盖,我可以在本机按关键词、日期和类型找回;完全相同的内容合在一组并显示真正复制次数,再看完整内容或再次复制。私人历史不进浏览器或主遥测数据库。日常入口现在是开始菜单里的“TimeAudit 剪贴板历史”,它打开的是密码中心桌面版的剪贴板页。
当前情况:11 月 06 日 14:26 本机库里共有 13,680 条复制事件;每天 18:25 的近线备份最近一次(11 月 3 日 18:25)完整通过,下一次排在 11 月 4 日 18:25。这次没有打开界面、试再次复制或试恢复。
项目源码:公开仓库


TimeAudit · 功能说明
当段落、网址或文件路径被下一次复制覆盖,我可以在本机按关键词、日期和类型找回;完全相同的内容合在一组并显示真正复制次数,再看完整内容或再次复制。私人历史不进浏览器或主遥测数据库。日常入口现在是开始菜单里的“TimeAudit 剪贴板历史”,它打开的是密码中心桌面版的剪贴板页。
当前情况:11 月 06 日 14:26 本机库里共有 13,680 条复制事件;每天 18:25 的近线备份最近一次(11 月 3 日 18:25)完整通过,下一次排在 11 月 4 日 18:25。这次没有打开界面、试再次复制或试恢复。
项目源码:公开仓库


用途与实际影响
Windows 当前剪贴板只保留最新内容,临时资料很容易被覆盖;只存去重文本又会丢掉“复制了几次、何时复制、是否来自历史恢复”的真实事件。
我复制过同一个链接好几次,现在又被别的内容盖掉了。在本机剪贴板页筛选日期或链接,查看这一组的复制次数和最近时间,确认完整内容后点“再次复制”。新复制等原采集器记录后才会更新次数,不由界面先加一。
本机筛选后按完全相同内容显示分组、准确总数和复制次数;预览正确内容后可再次复制,也能暂停或继续记录。允许的消费者仍按独立游标取得原始新事件。

用途与实际影响
Windows 当前剪贴板只保留最新内容,临时资料很容易被覆盖;只存去重文本又会丢掉“复制了几次、何时复制、是否来自历史恢复”的真实事件。
我复制过同一个链接好几次,现在又被别的内容盖掉了。在本机剪贴板页筛选日期或链接,查看这一组的复制次数和最近时间,确认完整内容后点“再次复制”。新复制等原采集器记录后才会更新次数,不由界面先加一。
本机筛选后按完全相同内容显示分组、准确总数和复制次数;预览正确内容后可再次复制,也能暂停或继续记录。允许的消费者仍按独立游标取得原始新事件。

查看器按筛选条件找到本机已保存内容,重复复制次数来自真实事件,再次复制后由采集器记录新时间。
来源不允许记录、内容过大或剪贴板暂时被占用时留下不含正文的缺口,不编造丢失内容。
记录停止、数据库损坏或搜索不可用时明确报告,保留已有历史,不用低效的全库翻找冒充恢复。

查看器按筛选条件找到本机已保存内容,重复复制次数来自真实事件,再次复制后由采集器记录新时间。
来源不允许记录、内容过大或剪贴板暂时被占用时留下不含正文的缺口,不编造丢失内容。
记录停止、数据库损坏或搜索不可用时明确报告,保留已有历史,不用低效的全库翻找冒充恢复。

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


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


这里保留实现、关键条件、精确入口、历史记录和验证结果。
正式入口归密码中心剪贴板页;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 回读,没有重跑完整性检查);这次未试恢复


- 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 回读,没有重跑完整性检查);这次未试恢复


- collector.pyw 创建隐藏 Win32 消息窗口,以 AddClipboardFormatListener / WM_CLIPBOARDUPDATE 事件驱动采集,不轮询、不装键盘 hook(钩子)、DLL、驱动或 Session 0 服务。
- 读取时遵守 Windows 来源格式:ExcludeClipboardContentFromMonitorProcessing 或 CanIncludeInClipboardHistory=0 会阻止本地保存;CanUploadToCloudClipboard=0 只禁止云剪贴板,不阻止本机历史。

- 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 日起加了窄范围文件告警:杀毒软件隔离或移除了本次精确路径、或已枚举的控制文件消失时,可带告警保留此前的备份,但会标明这次新数据没有拷入;源目录或目标目录不见仍算失败。


- 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 日起加了窄范围文件告警:杀毒软件隔离或移除了本次精确路径、或已枚举的控制文件消失时,可带告警保留此前的备份,但会标明这次新数据没有拷入;源目录或目标目录不见仍算失败。





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

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


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

- sidecar(侧车文件)与 PostgreSQL/Grafana 主链完全独立;主链健康不能证明剪贴板健康,反之亦然。
- 复制事实只证明本机观察到一次复制,不证明阅读、收件、同意、执行、归属或用户意图。
- 活动私密库在 E 盘持久数据层,G 盘只是近线恢复副本且不是查询依赖;网页、Git、日志和浏览器不接触原始正文、hash(内容指纹)、FTS 或凭据。
- 当前合同只覆盖 Windows 电脑;手机来源是另一 source instance(来源实例),不能在 collector 内猜测合并。
- clipboard_sequence 只在同一 Windows clipboard station(剪贴板站)相邻事实中解释,不能当作跨启动、会话或设备的全局顺序。
- 增量合同存在不等于下游消费者已上线;现在实际有没有程序在用这个增量出口、用了多少次,没有核对。
- 版本化恢复标记只连接再次复制与原事件,不表示另一个中央系统是当前产品或消费者。

- sidecar(侧车文件)与 PostgreSQL/Grafana 主链完全独立;主链健康不能证明剪贴板健康,反之亦然。
- 复制事实只证明本机观察到一次复制,不证明阅读、收件、同意、执行、归属或用户意图。
- 活动私密库在 E 盘持久数据层,G 盘只是近线恢复副本且不是查询依赖;网页、Git、日志和浏览器不接触原始正文、hash(内容指纹)、FTS 或凭据。
- 当前合同只覆盖 Windows 电脑;手机来源是另一 source instance(来源实例),不能在 collector 内猜测合并。
- clipboard_sequence 只在同一 Windows clipboard station(剪贴板站)相邻事实中解释,不能当作跨启动、会话或设备的全局顺序。
- 增量合同存在不等于下游消费者已上线;现在实际有没有程序在用这个增量出口、用了多少次,没有核对。
- 版本化恢复标记只连接再次复制与原事件,不表示另一个中央系统是当前产品或消费者。



- 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。








