双节拍采集、两条前台管线与分区写入
现在
常用 · 诊断窗 11 月 6 日 05:10
截至 11 月 4 日 · 项目仓库和诊断摘要

系统会把硬件、进程、前台和生命周期按合适节拍留底,并告诉我数据来自哪条管线、是否估算、哪里有空档。

当前情况: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 秒缺采照旧算作历史缺采。这次没有重新验收整条采集链,缺采不能算作正常或睡眠。

项目源码:公开仓库

双节拍采集、两条前台管线与分区写入
现在
常用 · 诊断窗 11 月 6 日 05:10
截至 11 月 4 日 · 项目仓库和诊断摘要

系统会把硬件、进程、前台和生命周期按合适节拍留底,并告诉我数据来自哪条管线、是否估算、哪里有空档。

当前情况: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 说明覆盖。

需要准备什么
  • 目标日期与时间段
  • 要看硬件、前台或进程活动
从开始到拿到结果
1确定这段时间
先看机器是否开机、睡眠以及记录有没有中断。
2读取对应记录
系统分别采集快速指标和较慢的进程信息,按来源写入,不把两条前台管线重复相加。
3交回有边界的时间线
看到真实覆盖和缺口;探针失败留空,睡眠回来从新起点算,不制造连续使用或网速尖刺。
从哪里开始

日常由已安装的 TimeAudit 自动采集;要理解一段记录,在 Grafana 选择时间范围或请已接入的 AI 说明覆盖。

需要准备什么
  • 目标日期与时间段
  • 要看硬件、前台或进程活动
从开始到拿到结果
1确定这段时间
先看机器是否开机、睡眠以及记录有没有中断。
2读取对应记录
系统分别采集快速指标和较慢的进程信息,按来源写入,不把两条前台管线重复相加。
3交回有边界的时间线
看到真实覆盖和缺口;探针失败留空,睡眠回来从新起点算,不制造连续使用或网速尖刺。
技术实现与依据(一)

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

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 秒空档保留为历史);未重验全部链路

关键规则与设计选择
1
先分清 AHK 区间与 Python 全量遥测,避免查错表。
2
慢扫描不阻塞 1 秒快车道;未完成就跳拍。
3
睡眠用墙上时间,速率用单调时间;只有 Windows 挂起事件才算睡眠,时钟跳变或延迟记为采集空档。
4
分区预热和时间下界支持长期查询。
当前怎样实现
  • 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 秒空档保留为历史);未重验全部链路

关键规则与设计选择
1
先分清 AHK 区间与 Python 全量遥测,避免查错表。
2
慢扫描不阻塞 1 秒快车道;未完成就跳拍。
3
睡眠用墙上时间,速率用单调时间;只有 Windows 挂起事件才算睡眠,时钟跳变或延迟记为采集空档。
4
分区预热和时间下界支持长期查询。
当前怎样实现
  • Python 主调度程序建立连接池、单例与双节拍(硬件 1 秒、进程约 3 秒);慢车道在线程中单飞。
  • 四个 worker 各管前台、进程、硬件和生灭。
  • AHK 写不可变的 UTF8 CSV 段(先临时写入、flush,再原子改名成 .processing),ingest.py 事务入库并按内容去重,提交后才删源段;写失败不推进水位,待写队列有上限,满了就转成明确的未知区间。正常约 30 秒封一段,突然断电可能丢掉当前未封的那段。
  • schema.sql 定义维度、事实、周/月分区、索引与约束。
技术实现与依据(二)
1
启动单例、闭合旧会话并确认分区。
2
每 1 秒采硬件、FPS、前台与生命周期。
3
每约 3 秒在线程中扫描活跃进程。
4
批量写库并更新 heartbeat。
5
AHK spool 事务成功后删除源段。
  • 另有一条串行的后台维护车道,每 12 小时一次,不阻塞每秒采样;逐程序明细保留 60 天后汇总,其他事实默认 1200 天,详见安装与恢复页。
  • 硬件采样用单调时钟截止点,提前唤醒继续等待,慢处理跳过错过时隙而不追赶堆积;Windows 互斥必须真实创建并取得,失败不准第二采集器启动。新行增加可空 measurement_quality、collector_instance_id、collector_sample_seq,不重写旧行。
执行流程
技术实现与依据(二)
1
启动单例、闭合旧会话并确认分区。
2
每 1 秒采硬件、FPS、前台与生命周期。
3
每约 3 秒在线程中扫描活跃进程。
4
批量写库并更新 heartbeat。
5
AHK spool 事务成功后删除源段。
  • 另有一条串行的后台维护车道,每 12 小时一次,不阻塞每秒采样;逐程序明细保留 60 天后汇总,其他事实默认 1200 天,详见安装与恢复页。
  • 硬件采样用单调时钟截止点,提前唤醒继续等待,慢处理跳过错过时隙而不追赶堆积;Windows 互斥必须真实创建并取得,失败不准第二采集器启动。新行增加可空 measurement_quality、collector_instance_id、collector_sample_seq,不重写旧行。
执行流程
名词和入口
本模块用到的名词
名词意思
fast / slow lane高频硬件路径与昂贵进程扫描分开调度。
interval event(区间事件)有开始和持续时间的前台、暂离或睡眠记录。
partition pruning(分区裁剪)按时间下界只扫需要的周/月分区。
专业定义

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

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

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