

TimeAudit · 功能说明
系统不因进程仍显示 Running 就假定它工作,而以最近成功写入判断真假健康。看门狗每分钟先查数据库和看板依赖,再查各条采集链,只恢复确认出问题的那一条;它依赖的 Docker 只有在明确显示“已停止”连续满 10 分钟后,才尝试一次有时限的恢复;它还顺带最多每 10 分钟写一份“今日用电”回执,供驾驶舱显示。
当前情况:11 月 4 日 12:41 完整健康检查返回正常,内存黑匣子也正常;今天 11:40:02 开始的备份已于 12:09:02 完成,本地快照与云端同步都成功。但当天 09:08 和 09:09 两次读到的是整体降级,只有内存黑匣子这一项读不到(blackbox_coverage_unavailable),其余组件都正常,没有待写积压、写入失败或采集错误;09:09 单独读黑匣子又是成功的。原因没查实,所以不能说它从没出过问题,也没有证据说黑匣子停过。每晚 03:00 还有一次只读自检,11 月 4 日 03:01 这项退出码 0。这些读数都没有注入故障或重验恢复路径;10 月 20 日凌晨新加的 Docker 停止自愈还没有真实演练过。
项目源码:公开仓库

TimeAudit · 功能说明
系统不因进程仍显示 Running 就假定它工作,而以最近成功写入判断真假健康。看门狗每分钟先查数据库和看板依赖,再查各条采集链,只恢复确认出问题的那一条;它依赖的 Docker 只有在明确显示“已停止”连续满 10 分钟后,才尝试一次有时限的恢复;它还顺带最多每 10 分钟写一份“今日用电”回执,供驾驶舱显示。
当前情况:11 月 4 日 12:41 完整健康检查返回正常,内存黑匣子也正常;今天 11:40:02 开始的备份已于 12:09:02 完成,本地快照与云端同步都成功。但当天 09:08 和 09:09 两次读到的是整体降级,只有内存黑匣子这一项读不到(blackbox_coverage_unavailable),其余组件都正常,没有待写积压、写入失败或采集错误;09:09 单独读黑匣子又是成功的。原因没查实,所以不能说它从没出过问题,也没有证据说黑匣子停过。每晚 03:00 还有一次只读自检,11 月 4 日 03:01 这项退出码 0。这些读数都没有注入故障或重验恢复路径;10 月 20 日凌晨新加的 Docker 停止自愈还没有真实演练过。
项目源码:公开仓库


用途与实际影响
采集程序可能真的退出,也可能还挂在任务列表里却不写数据。只看进程在不在,会留下看不见的记录空档;恢复还得避免同时启动两份。
大盘突然停住,但任务列表里的采集进程还在。系统会看最后一次真正写入是什么时候;确认主采集已经“人还在、活不干了”后,只重启这一条,其他仍在正常记录的组件不跟着折腾。
看到哪一条记录链还在写、哪一条停住、系统是否已尝试恢复,以及失败时还缺什么。重新启动后缺失的历史仍是缺口,不会被填成正常。

用途与实际影响
采集程序可能真的退出,也可能还挂在任务列表里却不写数据。只看进程在不在,会留下看不见的记录空档;恢复还得避免同时启动两份。
大盘突然停住,但任务列表里的采集进程还在。系统会看最后一次真正写入是什么时候;确认主采集已经“人还在、活不干了”后,只重启这一条,其他仍在正常记录的组件不跟着折腾。
看到哪一条记录链还在写、哪一条停住、系统是否已尝试恢复,以及失败时还缺什么。重新启动后缺失的历史仍是缺口,不会被填成正常。

对应程序真正持续写入,而且它依赖的数据库和看板服务也可用时,才说这条链活着。
程序退出或假活时只恢复确认故障的部分,保留失败原因;依赖探测超时或读不出状态只记“引擎状态未知、下轮重试”,这本身不算重启的理由。只有 Docker Desktop 连续 10 分钟明确报告“已停止”,才尝试一次有时限的官方重启;还不行才只结束 Docker 自己安装目录里的进程,再走原有的开机任务。同一次故障只试这一回,不反复重启。
每晚 03:00 电脑配置与恢复的总任务还会跑一次只读健康检查,新的红灯写进驾驶舱交 AI 跟进,变回绿才退出;它只看退出码,不修项目,也不直接启动 AI。
自动任务或保存服务读不到时只说对应层未知,不拿其他组件仍在运行代替。

对应程序真正持续写入,而且它依赖的数据库和看板服务也可用时,才说这条链活着。
程序退出或假活时只恢复确认故障的部分,保留失败原因;依赖探测超时或读不出状态只记“引擎状态未知、下轮重试”,这本身不算重启的理由。只有 Docker Desktop 连续 10 分钟明确报告“已停止”,才尝试一次有时限的官方重启;还不行才只结束 Docker 自己安装目录里的进程,再走原有的开机任务。同一次故障只试这一回,不反复重启。
每晚 03:00 电脑配置与恢复的总任务还会跑一次只读健康检查,新的红灯写进驾驶舱交 AI 跟进,变回绿才退出;它只看退出码,不修项目,也不直接启动 AI。
自动任务或保存服务读不到时只说对应层未知,不拿其他组件仍在运行代替。

TimeAudit 大盘停止更新时,在已接入本机诊断的 AI 对话中说明最后正常时间;现有看门狗负责精确组件恢复。
- 停更时间
- 受影响的是采集、入库还是大盘


TimeAudit 大盘停止更新时,在已接入本机诊断的 AI 对话中说明最后正常时间;现有看门狗负责精确组件恢复。
- 停更时间
- 受影响的是采集、入库还是大盘


这里保留实现、关键条件、精确入口、历史记录和验证结果。
8 月 31 日容器/LHM/全链测试与 9 月 8 日受管换代保留原日期;本轮未换代或注入故障;10 月 20 日加入的 Docker 停止自愈未演练


- Python 主调度程序提供单例与外层异常恢复。
- runtime_health.py 原子写 heartbeat,并提供路径识别与有界退避辅助。
- telemetry_watchdog.ps1 每分钟串行检查,先看 Docker、数据库和 Grafana 依赖,再看 main.py、LHM 18085、AHK 与 audit-ingester;全局 mutex(互斥锁)阻止恢复重叠。Docker Desktop 整个退出时只调用现有的自动启动任务 TimeAudit_AutoStart,任务正在启动就不重复。Desktop 还在、引擎接口却不可用时,只有
docker desktop status --format json成功返回且 Status=stopped,才开始计 600 秒(10 分钟)的确认窗;探测失败、超时、格式不对或其他状态都会清零重算,两次观测间隔超过 3 分钟也重算。确认窗和“已尝试”标记存在log/,这份回执读不出就暂缓恢复。连续确认满 10 分钟后,先记下这次尝试,再执行一次官方docker_engine_recovery.json desktop restart --timeout 110,总时限 120 秒;重启成功或接口随后恢复,就不结束任何进程。重启失败、接口仍不可用、且新一轮状态探测仍明确为 stopped,才只结束可执行路径在 Docker 安装目录里的 Docker Desktop.exe、com.docker.backend.exe、com.docker.build.exe、docker-desktop.exe,再调用现有自动启动任务;自动启动任务正在运行或不存在时暂缓。同一次未解决的故障不重复重启或兜底,接口恢复健康才清掉标记(提交 6dea0bf,北京时间 10 月 20 日 00:58 提交、01:05 合入 main)。停掉的 Postgres/Grafana 容器可以启动、不重建数据;Grafana 有 120 秒启动宽限,15 秒复核仍失败才只重启 Grafana。Docker 引擎探测限时 8 秒。另外,个人活动读取遇到 Docker 子进程超过 25 秒,直接报docker_unavailable(Docker 不可用),不再把时间段拆小反复重试;只有数据库语句超时(query_timeout)或输出过大才缩小时间段(提交 5cb3ea9,北京时间 10 月 20 日 00:08)。10 月 29 日起(提交 f62b807),个人活动读取的每条只读语句锁等待从 1 秒放宽到 5 秒;仍失败时保留原原因码,另附分阶段诊断:卡在docker_exec、connection、lock_wait、execute_sql还是serialization,异常类型,以及经凭据清理、最多 1200 字的消息;psql 非零退出再带 SQLSTATE、退出码、查询窗口和查询类别,不回传原始行或 SQL 上下文。没取到的数据不当作空集,也不因此重启采集器。
- 主采集心跳 90 秒算陈旧,睡醒后宽限 45 秒,启动宽限 180 秒,自动启动等待 240 秒;入库心跳阈值 45 秒、辅助进程 15 秒。LHM 独立任务拥有运行实例,hardware worker 只读,看门狗经 15 秒宽限、20 秒启动等待、端点 3 秒超时和精确项目路径过滤恢复端点。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
8 月 31 日容器/LHM/全链测试与 9 月 8 日受管换代保留原日期;本轮未换代或注入故障;10 月 20 日加入的 Docker 停止自愈未演练


- Python 主调度程序提供单例与外层异常恢复。
- runtime_health.py 原子写 heartbeat,并提供路径识别与有界退避辅助。
- telemetry_watchdog.ps1 每分钟串行检查,先看 Docker、数据库和 Grafana 依赖,再看 main.py、LHM 18085、AHK 与 audit-ingester;全局 mutex(互斥锁)阻止恢复重叠。Docker Desktop 整个退出时只调用现有的自动启动任务 TimeAudit_AutoStart,任务正在启动就不重复。Desktop 还在、引擎接口却不可用时,只有
docker desktop status --format json成功返回且 Status=stopped,才开始计 600 秒(10 分钟)的确认窗;探测失败、超时、格式不对或其他状态都会清零重算,两次观测间隔超过 3 分钟也重算。确认窗和“已尝试”标记存在log/,这份回执读不出就暂缓恢复。连续确认满 10 分钟后,先记下这次尝试,再执行一次官方docker_engine_recovery.json desktop restart --timeout 110,总时限 120 秒;重启成功或接口随后恢复,就不结束任何进程。重启失败、接口仍不可用、且新一轮状态探测仍明确为 stopped,才只结束可执行路径在 Docker 安装目录里的 Docker Desktop.exe、com.docker.backend.exe、com.docker.build.exe、docker-desktop.exe,再调用现有自动启动任务;自动启动任务正在运行或不存在时暂缓。同一次未解决的故障不重复重启或兜底,接口恢复健康才清掉标记(提交 6dea0bf,北京时间 10 月 20 日 00:58 提交、01:05 合入 main)。停掉的 Postgres/Grafana 容器可以启动、不重建数据;Grafana 有 120 秒启动宽限,15 秒复核仍失败才只重启 Grafana。Docker 引擎探测限时 8 秒。另外,个人活动读取遇到 Docker 子进程超过 25 秒,直接报docker_unavailable(Docker 不可用),不再把时间段拆小反复重试;只有数据库语句超时(query_timeout)或输出过大才缩小时间段(提交 5cb3ea9,北京时间 10 月 20 日 00:08)。10 月 29 日起(提交 f62b807),个人活动读取的每条只读语句锁等待从 1 秒放宽到 5 秒;仍失败时保留原原因码,另附分阶段诊断:卡在docker_exec、connection、lock_wait、execute_sql还是serialization,异常类型,以及经凭据清理、最多 1200 字的消息;psql 非零退出再带 SQLSTATE、退出码、查询窗口和查询类别,不回传原始行或 SQL 上下文。没取到的数据不当作空集,也不因此重启采集器。
- 主采集心跳 90 秒算陈旧,睡醒后宽限 45 秒,启动宽限 180 秒,自动启动等待 240 秒;入库心跳阈值 45 秒、辅助进程 15 秒。LHM 独立任务拥有运行实例,hardware worker 只读,看门狗经 15 秒宽限、20 秒启动等待、端点 3 秒超时和精确项目路径过滤恢复端点。

- start_all.bat 固定 CRLF、WorkingDirectory 和项目
.venv里的 pythonw.exe(从 Python 3.11 基座重建,当前 3.11.9);保留已有的精确 AHK 实例,容器用up -d --no-recreate启动,配置变更要另行部署,不靠重启自动套用。
- 历史诊断 summary 只做有界聚合:数据库语句 12 秒、锁 1 秒,外层总超时 14 秒,输出上限 1 MiB,最长 168 小时,拒绝畸形、非有限或意外字段。原先给电脑配置项目的异常摘要 v2(连续观测、游标和待重查标记)已于 2026-09-29 删除,不再运行。
- 看门狗最多每 10 分钟用现有数据库容器只读查询一次,按北京时间切今天和昨天,写 CPU 封装与显卡板功率积分的用电回执;采样间隔 60 秒以上不累计。回执写失败不改变恢复结果和退出码,也不另起采集进程。
- GUI 状态、AI 健康与看门狗读同一个 timeaudit_health.py;core-only 排除备份、黑匣子和上一次守护结果,避免递归。exit 2 可以是有效的 degraded/unavailable,心跳、实际持久写入和最后守护结果分开判断;可选两秒开销统计只看精确主采集链子进程,不含独立传感器、Docker 与原生记录,RSS 相加不是独占内存。
- 每晚只读自检归 PCConfig:计划任务 PCConfig Nightly Project Checks 每天 03:00 在已登录的交互用户下运行,错过会补;按 registries/project_cards.json 登记的命令跑项目 .venv 的 python.exe -B timeaudit_health.py,限时 180 秒,只判断退出码、不保存输出。发现新红灯写驾驶舱 ai_following,已有故障接手继续,变绿才退出;停掉总任务只停自动检查,不停采集或已有接手。


- start_all.bat 固定 CRLF、WorkingDirectory 和项目
.venv里的 pythonw.exe(从 Python 3.11 基座重建,当前 3.11.9);保留已有的精确 AHK 实例,容器用up -d --no-recreate启动,配置变更要另行部署,不靠重启自动套用。
- 历史诊断 summary 只做有界聚合:数据库语句 12 秒、锁 1 秒,外层总超时 14 秒,输出上限 1 MiB,最长 168 小时,拒绝畸形、非有限或意外字段。原先给电脑配置项目的异常摘要 v2(连续观测、游标和待重查标记)已于 2026-09-29 删除,不再运行。
- 看门狗最多每 10 分钟用现有数据库容器只读查询一次,按北京时间切今天和昨天,写 CPU 封装与显卡板功率积分的用电回执;采样间隔 60 秒以上不累计。回执写失败不改变恢复结果和退出码,也不另起采集进程。
- GUI 状态、AI 健康与看门狗读同一个 timeaudit_health.py;core-only 排除备份、黑匣子和上一次守护结果,避免递归。exit 2 可以是有效的 degraded/unavailable,心跳、实际持久写入和最后守护结果分开判断;可选两秒开销统计只看精确主采集链子进程,不含独立传感器、Docker 与原生记录,RSS 相加不是独占内存。
- 每晚只读自检归 PCConfig:计划任务 PCConfig Nightly Project Checks 每天 03:00 在已登录的交互用户下运行,错过会补;按 registries/project_cards.json 登记的命令跑项目 .venv 的 python.exe -B timeaudit_health.py,限时 180 秒,只判断退出码、不保存输出。发现新红灯写驾驶舱 ai_following,已有故障接手继续,变绿才退出;停掉总任务只停自动检查,不停采集或已有接手。





| 名词 | 意思 |
|---|---|
| native crash(原生崩溃) | C 扩展访问冲突直接终止进程,Python 异常捕获无效。 |
| false alive(假活) | 进程仍在但采集/入库停止。 |
| bounded backoff(有界退避) | 连续失败延长重试并设上限。 |

用单例、无 payload heartbeat、外部 Watchdog、退避、睡眠宽限和精确身份,把 native 崩溃、假活、探针掉线与数据库重连限制在受影响组件。



用单例、无 payload heartbeat、外部 Watchdog、退避、睡眠宽限和精确身份,把 native 崩溃、假活、探针掉线与数据库重连限制在受影响组件。

- 看门狗只恢复 TimeAudit 精确组件;对共享的 Docker,只在明确停止连续 10 分钟后做一次有时限的官方重启,失败才只结束 Docker 安装目录里的四类进程并走原有开机任务,同一次故障不重复。
- heartbeat 不含采样值、窗口、进程或凭据。
- 在线不证明数据正确或历史无空档;进程在跑、任务结果 0 或 core-only 正常都不等于全量恢复已验收。

- 看门狗只恢复 TimeAudit 精确组件;对共享的 Docker,只在明确停止连续 10 分钟后做一次有时限的官方重启,失败才只结束 Docker 安装目录里的四类进程并走原有开机任务,同一次故障不重复。
- heartbeat 不含采样值、窗口、进程或凭据。
- 在线不证明数据正确或历史无空档;进程在跑、任务结果 0 或 core-only 正常都不等于全量恢复已验收。

- 主循环、重连与心跳
- 心跳与退避
- 外部恢复
- 启动顺序与绝对路径
- 运行回归
- 入库恢复回归
- 8 月 31 日基线:三条 heartbeat 新鲜、3 容器运行、ingester healthy、LHM 18085 返回 HTTP 200、看门狗结果 0;10 月 12 日 05:36 完整健康检查仍全部 healthy,待写事件、字符、文件、字节都是 0,写入失败、溢出、捕获错误都是 0,FPS 采集 active、GPU 热点仍 unsupported;05:39 看门狗回执 healthy、没有降级组件,任务结果 0。这只是当时的运行快照,没有注入故障,不等于自愈路径已端到端验收。
- 11 月 4 日 09:08:30 和已提权的 09:09:53,两次完整健康检查都是 degraded,降级名单只有 memory_blackbox,reason=blackbox_coverage_unavailable;其余组件 healthy,待写事件、字符、文件、字节都是 0,写入失败、溢出、捕获错误都是 0,FPS=gated_idle,GPU 热点 unsupported。09:09:14 单独运行 PCConfig 的 Get-MemoryFreezeEvidence.ps1 -CoverageOnly -Json 成功,status=ok,collector_state=running,滚动封闭日志跨度 13.013 小时(CoverageOnly 不读所选区间样本,它的 read_segments=0 不说明黑匣子没记录)。10:33:48—10:33:53 再连读 3 次,整体 healthy、降级名单为空;11:40 又只读一次,仍为 healthy,memory_blackbox=healthy;12:41:34 再读一次 scope=full,仍为 healthy、降级名单为空、memory_blackbox=healthy,待写事件、字符、文件、字节以及写入失败、溢出、捕获错误都是 0。原因没查实;timeaudit_health.py 第 198–221 行里这项子读取限时 6 秒,只是排查线索,不能当结论。
- 每晚只读自检:11 月 4 日 03:00:01 总任务运行,TimeAudit 这项 03:01:15 退出码 0,failed_since、red_since 都是 null(E:\
Data\ PCConfig\ NightlyProjectChecks\ last-run.json);任务 Ready、已启用,下次 11 月 5 日 03:00。
- 8 月 31 日运行/入库回归纳入 001cee0 的 182 项 + 11 子测试,LHM/看门狗定向 10/10;9 月 8 日 e5459ce 另验证 39 项相关回归。之后未重新运行;当前源码有 356 个以 test_ 开头的测试函数,这次没有运行。

- 主循环、重连与心跳
- 心跳与退避
- 外部恢复
- 启动顺序与绝对路径
- 运行回归
- 入库恢复回归
- 8 月 31 日基线:三条 heartbeat 新鲜、3 容器运行、ingester healthy、LHM 18085 返回 HTTP 200、看门狗结果 0;10 月 12 日 05:36 完整健康检查仍全部 healthy,待写事件、字符、文件、字节都是 0,写入失败、溢出、捕获错误都是 0,FPS 采集 active、GPU 热点仍 unsupported;05:39 看门狗回执 healthy、没有降级组件,任务结果 0。这只是当时的运行快照,没有注入故障,不等于自愈路径已端到端验收。
- 11 月 4 日 09:08:30 和已提权的 09:09:53,两次完整健康检查都是 degraded,降级名单只有 memory_blackbox,reason=blackbox_coverage_unavailable;其余组件 healthy,待写事件、字符、文件、字节都是 0,写入失败、溢出、捕获错误都是 0,FPS=gated_idle,GPU 热点 unsupported。09:09:14 单独运行 PCConfig 的 Get-MemoryFreezeEvidence.ps1 -CoverageOnly -Json 成功,status=ok,collector_state=running,滚动封闭日志跨度 13.013 小时(CoverageOnly 不读所选区间样本,它的 read_segments=0 不说明黑匣子没记录)。10:33:48—10:33:53 再连读 3 次,整体 healthy、降级名单为空;11:40 又只读一次,仍为 healthy,memory_blackbox=healthy;12:41:34 再读一次 scope=full,仍为 healthy、降级名单为空、memory_blackbox=healthy,待写事件、字符、文件、字节以及写入失败、溢出、捕获错误都是 0。原因没查实;timeaudit_health.py 第 198–221 行里这项子读取限时 6 秒,只是排查线索,不能当结论。
- 每晚只读自检:11 月 4 日 03:00:01 总任务运行,TimeAudit 这项 03:01:15 退出码 0,failed_since、red_since 都是 null(E:\
Data\ PCConfig\ NightlyProjectChecks\ last-run.json);任务 Ready、已启用,下次 11 月 5 日 03:00。
- 8 月 31 日运行/入库回归纳入 001cee0 的 182 项 + 11 子测试,LHM/看门狗定向 10/10;9 月 8 日 e5459ce 另验证 39 项相关回归。之后未重新运行;当前源码有 356 个以 test_ 开头的测试函数,这次没有运行。
数字截至 2026 年 11 月 6 日

- 8 月 31 日的 hardware_worker 字节/进程时序与 LHM 单一活实例是历史证明;9 月 8 日 e5459ce 换代后的 worker 与新样本窗口另列,两个运行时代不能混用。9 月 17 日另有一次 231 条新合同样本、单实例的激活回执。
- 8 月 31 日 21/21 只读健康没有做故障注入;9 月 8 日真实停止过旧采集 worker 并由看门狗恢复,但未阻断 LHM 18085、断库或模拟睡眠,其他恢复 E2E(端到端验证)仍缺。10 月 20 日加入的 Docker 停止自愈同样没有真实演练:本轮没有注入 Docker 故障,也没有运行测试。
监管采集和探针持续性,顺带产出用电回执;备份模块处理持久恢复。

- 8 月 31 日的 hardware_worker 字节/进程时序与 LHM 单一活实例是历史证明;9 月 8 日 e5459ce 换代后的 worker 与新样本窗口另列,两个运行时代不能混用。9 月 17 日另有一次 231 条新合同样本、单实例的激活回执。
- 8 月 31 日 21/21 只读健康没有做故障注入;9 月 8 日真实停止过旧采集 worker 并由看门狗恢复,但未阻断 LHM 18085、断库或模拟睡眠,其他恢复 E2E(端到端验证)仍缺。10 月 20 日加入的 Docker 停止自愈同样没有真实演练:本轮没有注入 Docker 故障,也没有运行测试。
监管采集和探针持续性,顺带产出用电回执;备份模块处理持久恢复。
复制 AI 续作说明
项目:单例、心跳、看门狗与长期运行不变量;仓库:wlyaaaaa/TimeAudit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








