用途与实际影响
这项功能怎样使用
为什么需要它
电脑指标、程序活动和窗口使用记录的速度不同，硬塞在一条处理线上会互相拖慢。这里分别记录，再按时间合起来看，睡眠和断线不会被编造成持续使用。
举个实际例子
我合盖睡了两小时再回来，时间线会把这段明确记成睡眠，网络速率也从醒来后的新起点继续；屏幕上不会凭空多出两小时“持续使用”或一根吓人的假尖刺。
最后我会得到什么
得到按时间回看的硬件、程序、前台使用和睡眠记录；每一类都说明更新到什么时候、是否有空档。
正常时
相应记录持续保存时，按时间给出可对照的活动和硬件变化。
发现问题时
某个传感器或程序扫描失败时标明这一类缺口，其他仍能继续记录。
入口不可用或证据不足时
保存位置或必要权限不可用时停相应写入，不补造成功记录。
从哪里开始
日常由已安装的 TimeAudit 自动采集；要理解一段记录，在 Grafana 选择时间范围或请已接入的 AI 说明覆盖。
需要准备什么
- 目标日期与时间段
- 要看硬件、前台或进程活动
从开始到拿到结果
- 1
确定这段时间
先看机器是否开机、睡眠以及记录有没有中断。
- 2
读取对应记录
系统分别采集快速指标和较慢的进程信息，按来源写入，不把两条前台管线重复相加。
- 3
交回有边界的时间线
看到真实覆盖和缺口；探针失败留空，睡眠回来从新起点算，不制造连续使用或网速尖刺。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
8月31日001cee0全链健康21/21保留；9月8日e5459ce已部署采集worker并验证180个新GPU样本，未重验全部链路关键规则与设计选择
先分清 AHK 区间与 Python 全量遥测，避免查错表。
慢扫描不阻塞 1 秒快车道；未完成就跳拍。
睡眠用墙上时间，速率用单调时间。
分区预热和时间下界支持长期查询。
本模块用到的名词
- fast / slow lane
- 高频硬件路径与昂贵进程扫描分开调度。
- interval event（区间事件）
- 有开始和持续时间的前台、暂离或睡眠记录。
- partition pruning（分区裁剪）
- 按时间下界只扫需要的周/月分区。
专业定义
用 1 秒硬件/FPS 快车道、3 秒进程慢车道和独立 AHK 区间管线，把不同频率与语义的数据写入 PostgreSQL，并保留来源、空值、睡眠和重试边界。
解决什么
解决阻塞、重复实例、跨睡眠脏会话、对时假尖刺、spool 重放、缺分区和双管线口径混淆。
当前怎样实现
- Python 主调度程序建立连接池、单例与双节拍；慢车道在线程中单飞。
- 四个 worker 各管前台、进程、硬件和生灭。
- AHK 写唯一 spool；ingest.py 事务入库并按事件 id 去重。
- schema.sql 定义维度、事实、周/月分区、索引与约束。
- 硬件采样用单调时钟截止点，提前唤醒继续等待，慢处理跳过错过时隙而不追赶堆积；Windows互斥必须真实创建并取得，失败不准第二采集器启动。新行增加可空measurement_quality、collector_instance_id、collector_sample_seq，不重写旧行。
执行流程
- 1
启动单例、闭合旧会话并确认分区。
- 2
每 1 秒采硬件、FPS、前台与生命周期。
- 3
每约 3 秒在线程中扫描活跃进程。
- 4
批量写库并更新 heartbeat。
- 5
AHK spool 事务成功后删除源段。
边界
- 两条管线用途不同，不合成一张模糊总表。
- 网络按连接占比估算，不是抓包精确归因。
- 探针失败允许字段为空，不造连续真值。
失败与恢复
- 进程扫描超时
- 跳过下一慢拍，不阻塞快车道。
- 数据库连接失效
- 限时关闭连接池，超时 terminate 后退避重连。
- spool 入库失败
- 保留源段重试，事务成功后才删除。
真实入口
E:\Projects\Tools\TimeAudit\main.py调度、连接、睡眠与分区
E:\Projects\Tools\TimeAudit\context_worker.py前台会话
E:\Projects\Tools\TimeAudit\activity_worker.py进程资源
E:\Projects\Tools\TimeAudit\hardware_worker.py硬件与 FPS
E:\Projects\Tools\TimeAudit\lifecycle_worker.py进程生灭
E:\Projects\Tools\TimeAudit\TimeAudit.ahk简版使用区间
E:\Projects\Tools\TimeAudit\ingest.pyspool 入库
E:\Projects\Tools\TimeAudit\schema.sql表、分区与索引
如何验证
- runtime（运行环境） hardening 与 ingest resilience 纳入 001cee0 的 182 项 + 11 个子测试完整通过结果。
- 容器与三条 heartbeat 在观察时持续推进。
- 未读原始表、未跑完整数据库审计，故保持 mixed。
与其他模块的关系
为其他模块提供可信时间轴；可靠性监管它，恢复模块保存它。