
TimeAudit · 功能说明
系统会把硬件、进程、前台和生命周期按合适节拍留底,并告诉我数据来自哪条管线、是否估算、哪里有空档。
当前情况:11 月 4 日 08:09:41—09:09:41 这一小时记下 3,561 条硬件样本,最新一条离窗尾 0.76 秒,只有一个采集实例;这一小时不是逐秒记满,相邻两条最长隔 6.81 秒。活动记录那边另标了 40 秒采集空档,和硬件采样的空档不是同一个口径,不能拿来推断人在不在。10 月 12 日 05:21—05:36 那 15 分钟曾记满 900 条、最长隔 1.0 秒;10 月 11 日 13:00—14:00 那一小时的 95 秒缺采照旧算作历史缺采。这次没有重新验收整条采集链,缺采不能算作正常或睡眠。
项目源码:公开仓库


TimeAudit · 功能说明
系统会把硬件、进程、前台和生命周期按合适节拍留底,并告诉我数据来自哪条管线、是否估算、哪里有空档。
当前情况:11 月 4 日 08:09:41—09:09:41 这一小时记下 3,561 条硬件样本,最新一条离窗尾 0.76 秒,只有一个采集实例;这一小时不是逐秒记满,相邻两条最长隔 6.81 秒。活动记录那边另标了 40 秒采集空档,和硬件采样的空档不是同一个口径,不能拿来推断人在不在。10 月 12 日 05:21—05:36 那 15 分钟曾记满 900 条、最长隔 1.0 秒;10 月 11 日 13:00—14:00 那一小时的 95 秒缺采照旧算作历史缺采。这次没有重新验收整条采集链,缺采不能算作正常或睡眠。
项目源码:公开仓库


用途与实际影响
电脑指标、程序活动和窗口使用记录的速度不同,硬塞在一条处理线上会互相拖慢。这里分别记录,再按时间合起来看,睡眠和断线不会被编造成持续使用。
我合盖睡了两小时再回来,时间线会把这段明确记成睡眠,网络速率也从醒来后的新起点继续;屏幕上不会凭空多出两小时“持续使用”或一根吓人的假尖刺。
得到按时间回看的硬件、程序、前台使用和睡眠记录;每一类都说明更新到什么时候、是否有空档。

用途与实际影响
电脑指标、程序活动和窗口使用记录的速度不同,硬塞在一条处理线上会互相拖慢。这里分别记录,再按时间合起来看,睡眠和断线不会被编造成持续使用。
我合盖睡了两小时再回来,时间线会把这段明确记成睡眠,网络速率也从醒来后的新起点继续;屏幕上不会凭空多出两小时“持续使用”或一根吓人的假尖刺。
得到按时间回看的硬件、程序、前台使用和睡眠记录;每一类都说明更新到什么时候、是否有空档。

相应记录持续保存时,按时间给出可对照的活动和硬件变化。
某个传感器或程序扫描失败时标明这一类缺口,其他仍能继续记录。
保存位置或必要权限不可用时停相应写入,不补造成功记录。

相应记录持续保存时,按时间给出可对照的活动和硬件变化。
某个传感器或程序扫描失败时标明这一类缺口,其他仍能继续记录。
保存位置或必要权限不可用时停相应写入,不补造成功记录。

日常由已安装的 TimeAudit 自动采集;要理解一段记录,在 Grafana 选择时间范围或请已接入的 AI 说明覆盖。
- 目标日期与时间段
- 要看硬件、前台或进程活动


日常由已安装的 TimeAudit 自动采集;要理解一段记录,在 Grafana 选择时间范围或请已接入的 AI 说明覆盖。
- 目标日期与时间段
- 要看硬件、前台或进程活动


这里保留实现、关键条件、精确入口、历史记录和验证结果。
8 月 31 日 001cee0 全链健康 21/21、9 月 8 日 e5459ce 采集 worker 换代保留原日期;11 月 4 日 08:09:41—09:09:41 共 3,561 条硬件样本(3,557 个不同的秒,最大间隔 6.81 秒,coverage_status=fresh)、单一采集实例,活动记录覆盖 3,599 秒、未覆盖 1 秒、显式 collection_gap 40 秒,两种空档不是同一口径(10 月 12 日 05:21—05:36 的 900 条、10 月 11 日 22:00—23:00 的 3600 条、13:00—14:00 的 3412 条与 95 秒空档保留为历史);未重验全部链路


- Python 主调度程序建立连接池、单例与双节拍(硬件 1 秒、进程约 3 秒);慢车道在线程中单飞。
- 四个 worker 各管前台、进程、硬件和生灭。
- AHK 写不可变的 UTF8 CSV 段(先临时写入、flush,再原子改名成 .processing),ingest.py 事务入库并按内容去重,提交后才删源段;写失败不推进水位,待写队列有上限,满了就转成明确的未知区间。正常约 30 秒封一段,突然断电可能丢掉当前未封的那段。
- schema.sql 定义维度、事实、周/月分区、索引与约束。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
8 月 31 日 001cee0 全链健康 21/21、9 月 8 日 e5459ce 采集 worker 换代保留原日期;11 月 4 日 08:09:41—09:09:41 共 3,561 条硬件样本(3,557 个不同的秒,最大间隔 6.81 秒,coverage_status=fresh)、单一采集实例,活动记录覆盖 3,599 秒、未覆盖 1 秒、显式 collection_gap 40 秒,两种空档不是同一口径(10 月 12 日 05:21—05:36 的 900 条、10 月 11 日 22:00—23:00 的 3600 条、13:00—14:00 的 3412 条与 95 秒空档保留为历史);未重验全部链路


- Python 主调度程序建立连接池、单例与双节拍(硬件 1 秒、进程约 3 秒);慢车道在线程中单飞。
- 四个 worker 各管前台、进程、硬件和生灭。
- AHK 写不可变的 UTF8 CSV 段(先临时写入、flush,再原子改名成 .processing),ingest.py 事务入库并按内容去重,提交后才删源段;写失败不推进水位,待写队列有上限,满了就转成明确的未知区间。正常约 30 秒封一段,突然断电可能丢掉当前未封的那段。
- schema.sql 定义维度、事实、周/月分区、索引与约束。

- 另有一条串行的后台维护车道,每 12 小时一次,不阻塞每秒采样;逐程序明细保留 60 天后汇总,其他事实默认 1200 天,详见安装与恢复页。
- 硬件采样用单调时钟截止点,提前唤醒继续等待,慢处理跳过错过时隙而不追赶堆积;Windows 互斥必须真实创建并取得,失败不准第二采集器启动。新行增加可空 measurement_quality、collector_instance_id、collector_sample_seq,不重写旧行。


- 另有一条串行的后台维护车道,每 12 小时一次,不阻塞每秒采样;逐程序明细保留 60 天后汇总,其他事实默认 1200 天,详见安装与恢复页。
- 硬件采样用单调时钟截止点,提前唤醒继续等待,慢处理跳过错过时隙而不追赶堆积;Windows 互斥必须真实创建并取得,失败不准第二采集器启动。新行增加可空 measurement_quality、collector_instance_id、collector_sample_seq,不重写旧行。



| 名词 | 意思 |
|---|---|
| fast / slow lane | 高频硬件路径与昂贵进程扫描分开调度。 |
| interval event(区间事件) | 有开始和持续时间的前台、暂离或睡眠记录。 |
| partition pruning(分区裁剪) | 按时间下界只扫需要的周/月分区。 |

用 1 秒硬件/FPS 快车道、3 秒进程慢车道和独立 AHK 区间管线,把不同频率与语义的数据写入 PostgreSQL,并保留来源、空值、睡眠和重试边界。



用 1 秒硬件/FPS 快车道、3 秒进程慢车道和独立 AHK 区间管线,把不同频率与语义的数据写入 PostgreSQL,并保留来源、空值、睡眠和重试边界。

解决什么
解决阻塞、重复实例、跨睡眠脏会话、对时假尖刺、spool 重放、缺分区和双管线口径混淆。

- 两条管线用途不同,不合成一张模糊总表。
- 网络按连接占比估算,不是抓包精确归因。
- 探针失败允许字段为空,不造连续真值。
- 进程扫描超时: 跳过下一慢拍,不阻塞快车道。
- 数据库连接失效: 限时关闭连接池,超时 terminate 后退避重连。
- spool 入库失败: 保留源段重试,事务成功后才删除。

解决什么
解决阻塞、重复实例、跨睡眠脏会话、对时假尖刺、spool 重放、缺分区和双管线口径混淆。

- 两条管线用途不同,不合成一张模糊总表。
- 网络按连接占比估算,不是抓包精确归因。
- 探针失败允许字段为空,不造连续真值。
- 进程扫描超时: 跳过下一慢拍,不阻塞快车道。
- 数据库连接失效: 限时关闭连接池,超时 terminate 后退避重连。
- spool 入库失败: 保留源段重试,事务成功后才删除。

- 调度、连接、睡眠与分区(main.py)
- 前台会话(context_worker.py)
- 进程资源(activity_worker.py)
- 硬件与 FPS(hardware_worker.py)
- 进程生灭(lifecycle_worker.py)
- 简版使用区间(TimeAudit.ahk)
- spool 入库(ingest.py)
- 表、分区与索引(schema.sql)

- 调度、连接、睡眠与分区(main.py)
- 前台会话(context_worker.py)
- 进程资源(activity_worker.py)
- 硬件与 FPS(hardware_worker.py)
- 进程生灭(lifecycle_worker.py)
- 简版使用区间(TimeAudit.ahk)
- spool 入库(ingest.py)
- 表、分区与索引(schema.sql)

- runtime(运行环境)hardening 与 ingest resilience 纳入 001cee0 的 182 项 + 11 个子测试完整通过结果(2026-08-31,之后未重新运行;当前源码有 356 个以 test_ 开头的测试函数,这次没有运行)。
- 2026-10-12 05:36 只读汇总 05:21:10—05:36:10(15 分钟):900 条硬件样本(900 个不同秒)、单一采集实例、0 条快速样本,最大间隔 1.033 秒;状态区间覆盖 899 秒、未覆盖 1 秒,采集空档 0、跨状态重叠 0。10 月 11 日 23:54 汇总的 22:00—23:00 为 3600 条、最大间隔 1.069 秒,16:33 汇总的 13:00—14:00 曾有 95 秒明确采集空档,均保留为历史。
- 未读原始表、未跑完整数据库审计,当前全库精确条数未统计,故保持 mixed。
为其他模块提供可信时间轴;可靠性监管它,恢复模块保存它。

- runtime(运行环境)hardening 与 ingest resilience 纳入 001cee0 的 182 项 + 11 个子测试完整通过结果(2026-08-31,之后未重新运行;当前源码有 356 个以 test_ 开头的测试函数,这次没有运行)。
- 2026-10-12 05:36 只读汇总 05:21:10—05:36:10(15 分钟):900 条硬件样本(900 个不同秒)、单一采集实例、0 条快速样本,最大间隔 1.033 秒;状态区间覆盖 899 秒、未覆盖 1 秒,采集空档 0、跨状态重叠 0。10 月 11 日 23:54 汇总的 22:00—23:00 为 3600 条、最大间隔 1.069 秒,16:33 汇总的 13:00—14:00 曾有 95 秒明确采集空档,均保留为历史。
- 未读原始表、未跑完整数据库审计,当前全库精确条数未统计,故保持 mixed。
为其他模块提供可信时间轴;可靠性监管它,恢复模块保存它。
数字截至 2026 年 11 月 6 日
复制 AI 续作说明
项目:双节拍采集、两条前台管线与分区写入;仓库:wlyaaaaa/TimeAudit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








