

PC Panel Hub · 功能说明
屏幕上的每个数字不仅要“能取到”,还要知道它来自哪里、多久前更新、是不是估算或空闲状态。
当前情况:指标读取、逐项可信度打分和异常处理都在用;单个传感器陈旧时只让那一项退回最近可信值,其余照常显示。11 月 6 日 13:54 读到的可信度是 100/100,缺项 0、退回旧值 0、陈旧数据 0,各项都正常,天气是实时的,帧数在采。这个分数会随时变;它只反映来源完整程度和新鲜程度,不说明传感器校准过,也不说明电脑不卡(11 月 4 日 13:30 那次也是 100/100,9 月 28 日那次是 86/100)。实际数字仍由各传感器提供,没有逐项对照外部仪表。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库

PC Panel Hub · 功能说明
屏幕上的每个数字不仅要“能取到”,还要知道它来自哪里、多久前更新、是不是估算或空闲状态。
当前情况:指标读取、逐项可信度打分和异常处理都在用;单个传感器陈旧时只让那一项退回最近可信值,其余照常显示。11 月 6 日 13:54 读到的可信度是 100/100,缺项 0、退回旧值 0、陈旧数据 0,各项都正常,天气是实时的,帧数在采。这个分数会随时变;它只反映来源完整程度和新鲜程度,不说明传感器校准过,也不说明电脑不卡(11 月 4 日 13:30 那次也是 100/100,9 月 28 日那次是 86/100)。实际数字仍由各传感器提供,没有逐项对照外部仪表。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


用途与实际影响
虚拟网卡叠加、CPU 口径混用、探针陈旧、无游戏帧被写成 0 FPS,都会让漂亮面板给出错误判断。
我问“开着 Tailscale 和虚拟机时,这个网速数字还准吗?”系统只认唯一的物理公网出口;如果分不清,就直接显示网络数据不可用,绝不会把几张虚拟网卡相加成一个离谱数字。
机箱屏每秒更新主要状态,较慢的程序排行另更新;每个值都知道来自哪里、多久前取得。没有可靠来源时显示等待或不可用,而不是一个看似正常的零。

用途与实际影响
虚拟网卡叠加、CPU 口径混用、探针陈旧、无游戏帧被写成 0 FPS,都会让漂亮面板给出错误判断。
我问“开着 Tailscale 和虚拟机时,这个网速数字还准吗?”系统只认唯一的物理公网出口;如果分不清,就直接显示网络数据不可用,绝不会把几张虚拟网卡相加成一个离谱数字。
机箱屏每秒更新主要状态,较慢的程序排行另更新;每个值都知道来自哪里、多久前取得。没有可靠来源时显示等待或不可用,而不是一个看似正常的零。

来源明确且新鲜时显示实际值。
一个来源过期或明显错误时只让该项失效,其他可信数值继续显示。
真实物理网口或传感器分不清时留空,不把虚拟设备数值相加。

来源明确且新鲜时显示实际值。
一个来源过期或明显错误时只让该项失效,其他可信数值继续显示。
真实物理网口或传感器分不清时留空,不把虚拟设备数值相加。

平时直接看机箱屏;读数疑似不对时,在已接入项目的本机 AI 对话中说出指标和当时的程序。
- 疑问指标与时间
- 物理网卡、游戏或虚拟设备情况


平时直接看机箱屏;读数疑似不对时,在已接入项目的本机 AI 对话中说出指标和当时的程序。
- 疑问指标与时间
- 物理网卡、游戏或虚拟设备情况


这里保留实现、关键条件、精确入口、历史记录和验证结果。
源码按 11 月 2 日最后一次提交 ddba2b0 核对;11 月 6 日 13:54:44 只读 GET /snapshot:trust.score=100、level=ok、missing_count=0、fallback_count=0、stale_count=0,九个分项都 ok,FPS status=active、weather status=live;FPS active 不代表实体屏像素验收过(历史:11 月 4 日 13:30:15 也是 100 分、level=ok、stale_count=0、FPS status=idle,9 月 28 日是 86/100)。9 月 7 日 87 项指标回归为历史结果,11 月 6 日核对时没有重跑;实时采集值仍由各来源负责,未逐项对照外部仪表


- metrics_agent.py 通过只在本机可访问的 loopback HTTP 提供有界 snapshot(快照)。源码默认端口是 18765,这台电脑的配置和电脑配置(PCConfig)登记用的是 18766;配置里的地址和实际监听必须一致,不拿旧端口反过来盖掉配置。
- top_processes_helper.py 每 3 秒独立采样并写有界 JSON。各项各有自己的节拍:主快照目标每 1 秒一份,TimeAudit 缓存 0.75 秒,帧数样本 10 秒,进程排行最多容忍 10 秒,天气缓存 10 分钟;不是每个数字都每秒重新采一次。
- 物理网络按接口身份筛选,TUN、虚拟化和小型虚拟盘按合同排除。除了机箱屏,同一份网络和 DPC 采样还经一个很窄的公共出口给出延迟、抖动、丢包、尝试成功数、统计窗口和观察时间,以及 DPC 占用(% DPC Time,系统处理硬件中断的时间占比,不是卡顿原因或驱动延迟值);不返回网卡名、探测地址、进程、前台程序和原始错误。
- TimeAudit 只提供可选 FPS 事实,本项目经 PostgreSQL 的
fact_system_hardware读取数值、fps_capture_status与fps_capture_detail,不直接连接或启停 RTSS,也不复制长期数据库。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
源码按 11 月 2 日最后一次提交 ddba2b0 核对;11 月 6 日 13:54:44 只读 GET /snapshot:trust.score=100、level=ok、missing_count=0、fallback_count=0、stale_count=0,九个分项都 ok,FPS status=active、weather status=live;FPS active 不代表实体屏像素验收过(历史:11 月 4 日 13:30:15 也是 100 分、level=ok、stale_count=0、FPS status=idle,9 月 28 日是 86/100)。9 月 7 日 87 项指标回归为历史结果,11 月 6 日核对时没有重跑;实时采集值仍由各来源负责,未逐项对照外部仪表


- metrics_agent.py 通过只在本机可访问的 loopback HTTP 提供有界 snapshot(快照)。源码默认端口是 18765,这台电脑的配置和电脑配置(PCConfig)登记用的是 18766;配置里的地址和实际监听必须一致,不拿旧端口反过来盖掉配置。
- top_processes_helper.py 每 3 秒独立采样并写有界 JSON。各项各有自己的节拍:主快照目标每 1 秒一份,TimeAudit 缓存 0.75 秒,帧数样本 10 秒,进程排行最多容忍 10 秒,天气缓存 10 分钟;不是每个数字都每秒重新采一次。
- 物理网络按接口身份筛选,TUN、虚拟化和小型虚拟盘按合同排除。除了机箱屏,同一份网络和 DPC 采样还经一个很窄的公共出口给出延迟、抖动、丢包、尝试成功数、统计窗口和观察时间,以及 DPC 占用(% DPC Time,系统处理硬件中断的时间占比,不是卡顿原因或驱动延迟值);不返回网卡名、探测地址、进程、前台程序和原始错误。
- TimeAudit 只提供可选 FPS 事实,本项目经 PostgreSQL 的
fact_system_hardware读取数值、fps_capture_status与fps_capture_detail,不直接连接或启停 RTSS,也不复制长期数据库。

metrics_agent.py把 gated_idle 映射为 idle、starting 映射为 connecting、waiting_frames 映射为 error,并另行核对数据库样本年龄。帧从哪个程序取、RTSS 和 PresentMon 谁优先,是 TimeAudit 自己的事;这次没有重读它的选择算法,以 TimeAudit 页面为准。


metrics_agent.py把 gated_idle 映射为 idle、starting 映射为 connecting、waiting_frames 映射为 error,并另行核对数据库样本年龄。帧从哪个程序取、RTSS 和 PresentMon 谁优先,是 TimeAudit 自己的事;这次没有重读它的选择算法,以 TimeAudit 页面为准。



| 名词 | 意思 |
|---|---|
| PDH(Windows 性能计数器) | 当前代码从这里优先取得 % Processor Utility(处理器效用率),并保留来源与失败状态。 |
| physical egress(物理公网出口) | 真实承载上网流量的物理接口,不含隧道或虚拟交换接口。 |
| fresh / stale(新鲜 / 陈旧) | 值是否在允许时间内更新;陈旧值可显示但不能冒充当前。 |

把硬件、物理公网、磁盘、天气、FPS、前台和进程排行汇成带新鲜度与 trust(可信度)的本地快照,来源不确定时失败关闭。



把硬件、物理公网、磁盘、天气、FPS、前台和进程排行汇成带新鲜度与 trust(可信度)的本地快照,来源不确定时失败关闭。

解决什么
解决来源混加、不同口径同名、慢采集阻塞主循环、无值清零和陈旧值冒充实时。

- 天气、网络质量和功耗可能包含外部来源或估算。
- FPS 来自 TimeAudit 的 RTSS 优先 / PresentMon 后备链;本项目只读其 PostgreSQL 结果,不拥有帧源、RTSS 运行或历史。允许桌面渲染帧时,正 FPS 不自动代表游戏成绩。
- 进程名和技术指标可公开;具体通知正文和凭据值不进入快照页面。
- 物理公网出口歧义: 失败关闭,不叠加多个候选。
- TimeAudit 样本新鲜且明确为 gated_idle: 显示正常等待游戏帧,不用 0 FPS 冒充已取得帧。
- TimeAudit 返回 waiting_frames、source_unavailable、error、缺采集状态或样本过旧: 显示相应采集异常、来源不足或陈旧;不因为数值为 0 就判健康,不由副屏另启帧源。
- 慢来源超过 deadline: 使用最后一份好快照并降低 trust,主渲染不等待。

解决什么
解决来源混加、不同口径同名、慢采集阻塞主循环、无值清零和陈旧值冒充实时。

- 天气、网络质量和功耗可能包含外部来源或估算。
- FPS 来自 TimeAudit 的 RTSS 优先 / PresentMon 后备链;本项目只读其 PostgreSQL 结果,不拥有帧源、RTSS 运行或历史。允许桌面渲染帧时,正 FPS 不自动代表游戏成绩。
- 进程名和技术指标可公开;具体通知正文和凭据值不进入快照页面。
- 物理公网出口歧义: 失败关闭,不叠加多个候选。
- TimeAudit 样本新鲜且明确为 gated_idle: 显示正常等待游戏帧,不用 0 FPS 冒充已取得帧。
- TimeAudit 返回 waiting_frames、source_unavailable、error、缺采集状态或样本过旧: 显示相应采集异常、来源不足或陈旧;不因为数值为 0 就判健康,不由副屏另启帧源。
- 慢来源超过 deadline: 使用最后一份好快照并降低 trust,主渲染不等待。

- 9月7日完整软件回归中,test_metrics_agent.py 运行 87 项并通过;8 月 31 日 84 项为更早的历史验收。现在这份测试文件定义了 96 个测试方法,另有端点恢复 3 个、天气 7 个;这些是源码里的数量,11 月 4 日核对时没有运行,不能写成“今天 96 项通过”。
- 11 月 4 日 09:09 只读 check-runtime.ps1 -AsJson:ready=true、missing=[],Python 与 TimeAudit 读取依赖就绪(旧页记录过 Python 3.11 的同类结果);这只说明依赖在,不代表数据库采样每一项都准。
- 没有逐项对照实体传感器或外部仪表,真实值准确度仍按来源解释;可信度 100 分也只表示来源齐、状态对,不等于仪表校准过。
安装与换机模块提供当前机私有来源配置;本模块为机箱屏渲染提供当前值,并经窄公共出口给出网络质量和 DPC 占用;TimeAudit 继续拥有长期历史。水冷屏(HS2)原来读这里的硬件告警,9 月 27 日告警功能删除后已不再读本模块,它的网络提醒直接读 Windows。

- 9月7日完整软件回归中,test_metrics_agent.py 运行 87 项并通过;8 月 31 日 84 项为更早的历史验收。现在这份测试文件定义了 96 个测试方法,另有端点恢复 3 个、天气 7 个;这些是源码里的数量,11 月 4 日核对时没有运行,不能写成“今天 96 项通过”。
- 11 月 4 日 09:09 只读 check-runtime.ps1 -AsJson:ready=true、missing=[],Python 与 TimeAudit 读取依赖就绪(旧页记录过 Python 3.11 的同类结果);这只说明依赖在,不代表数据库采样每一项都准。
- 没有逐项对照实体传感器或外部仪表,真实值准确度仍按来源解释;可信度 100 分也只表示来源齐、状态对,不等于仪表校准过。
安装与换机模块提供当前机私有来源配置;本模块为机箱屏渲染提供当前值,并经窄公共出口给出网络质量和 DPC 占用;TimeAudit 继续拥有长期历史。水冷屏(HS2)原来读这里的硬件告警,9 月 27 日告警功能删除后已不再读本模块,它的网络提醒直接读 Windows。
复制 AI 续作说明
项目:一秒指标、物理来源与可信度边界;仓库:wlyaaaaa/PC-Panel-Hub;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








