

PC Panel Hub · 功能说明
机箱屏先收到完整画面,之后每秒更新变化;若设备漏掉一轮,就重新发送整张纠偏。主机发送记录与实体画面是否动起来分别核对。
当前情况:发送故障还没根治。根修复验收到 11 月 3 日 21:10 仍没通过,真正原因没查明;AI 继续查,限期 11 月 6 日 18:00,不用你操作。10 月 29 日 20:05 整理的现场里有 2 次增量发送超时、13 个异常、19 次成功的增量总耗时超过 900 毫秒,增量最长约 18 秒、整帧最长约 49 秒;11 月 3 日又有一次设备错误和一次停住后被看门狗重启。11 月 4 日 11:43 的主机心跳正常:这次会话发到第 47,355 帧、失败 0,上一次整帧在第 46,800 帧,周期约 1 秒、发一帧 21 毫秒;这只是眼前这段电脑这边的发送记录。9 月 27 日 21:27 到 28 日 21:22 连续 85,063 帧、0 次失败是更早的历史记录,不代表现在;这些都不等于每一帧都显示到了实体屏。本人确认实体屏正常和异常退出自动接回的证据仍是 9 月 7 日。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库

PC Panel Hub · 功能说明
机箱屏先收到完整画面,之后每秒更新变化;若设备漏掉一轮,就重新发送整张纠偏。主机发送记录与实体画面是否动起来分别核对。
当前情况:发送故障还没根治。根修复验收到 11 月 3 日 21:10 仍没通过,真正原因没查明;AI 继续查,限期 11 月 6 日 18:00,不用你操作。10 月 29 日 20:05 整理的现场里有 2 次增量发送超时、13 个异常、19 次成功的增量总耗时超过 900 毫秒,增量最长约 18 秒、整帧最长约 49 秒;11 月 3 日又有一次设备错误和一次停住后被看门狗重启。11 月 4 日 11:43 的主机心跳正常:这次会话发到第 47,355 帧、失败 0,上一次整帧在第 46,800 帧,周期约 1 秒、发一帧 21 毫秒;这只是眼前这段电脑这边的发送记录。9 月 27 日 21:27 到 28 日 21:22 连续 85,063 帧、0 次失败是更早的历史记录,不代表现在;这些都不等于每一帧都显示到了实体屏。本人确认实体屏正常和异常退出自动接回的证据仍是 9 月 7 日。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


用途与实际影响
只整张刷新会太慢,只发变化部分又可能在漏了一帧后越错越多。系统先给机箱屏发完整画面,再持续更新变化,必要时重新发整张纠偏。
机箱屏像是冻住了,系统会先确认旧写入者已经退出,再用一张完整画面重新打底,之后恢复每秒更新。最后仍以实体屏上的时钟重新跳动为准,而不是看到电脑“发送成功”就宣布修好。
机箱屏应恢复约每秒更新,并定期整张校正;主机记录能说明发送到哪一步,但最终仍须看实体时钟和像素真的变化。

用途与实际影响
只整张刷新会太慢,只发变化部分又可能在漏了一帧后越错越多。系统先给机箱屏发完整画面,再持续更新变化,必要时重新发整张纠偏。
机箱屏像是冻住了,系统会先确认旧写入者已经退出,再用一张完整画面重新打底,之后恢复每秒更新。最后仍以实体屏上的时钟重新跳动为准,而不是看到电脑“发送成功”就宣布修好。
机箱屏应恢复约每秒更新,并定期整张校正;主机记录能说明发送到哪一步,但最终仍须看实体时钟和像素真的变化。

唯一发送程序接上正确设备并维持刷新时,主机侧状态通过;实体结果还要现场观察。
发送太慢或失败时退出这一发送程序;看门狗先确认旧程序真的退出,再重新建立完整画面。
旧发送者没退出或设备身份不唯一时不启动第二个程序抢屏;旧程序 30 秒内没停干净,就推迟重建、看门狗继续守着,下一轮再试。

唯一发送程序接上正确设备并维持刷新时,主机侧状态通过;实体结果还要现场观察。
发送太慢或失败时退出这一发送程序;看门狗先确认旧程序真的退出,再重新建立完整画面。
旧发送者没退出或设备身份不唯一时不启动第二个程序抢屏;旧程序 30 秒内没停干净,就推迟重建、看门狗继续守着,下一轮再试。

机箱屏冻结时,在已接入项目的本机 AI 对话中点名这块实体屏并描述最后一次变化。
- 实际串口设备
- 冻结时间与现有写入进程


机箱屏冻结时,在已接入项目的本机 AI 对话中点名这块实体屏并描述最后一次变化。
- 实际串口设备
- 冻结时间与现有写入进程


这里保留实现、关键条件、精确入口、历史记录和验证结果。
9 月 27 日 21:27 至 28 日 21:22 一次会话 85,063 帧、失败 0;更早的 9 月 9 日 11:38(北京时间)曾 14,487/14,487 帧、失败 0。本人实体屏确认及异常退出自动接回保留 9 月 7 日实测日期。这些零失败都是历史;根修复验收到 11 月 3 日仍未通过,见“如何验证”


- 启动执行 vendor-shaped priming、亮度恢复和两帧 command 200。
- 稳态每秒发送 command 204 差分。差分载荷改为直接线性扫描 BGRA 像素生成(337c830,10 月 24 日),不再走厂商助手里逐像素的混淆分派;字节布局(含单像素和帧尾情况)与本机厂商助手兼容,用 TestDiffPayload.ps1 离线比对。这不放宽 900 ms 预算,也不证明实体屏已刷新。
- warmup 60/120/180 帧与长期 900 帧重建 serial session 并补全帧。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
9 月 27 日 21:27 至 28 日 21:22 一次会话 85,063 帧、失败 0;更早的 9 月 9 日 11:38(北京时间)曾 14,487/14,487 帧、失败 0。本人实体屏确认及异常退出自动接回保留 9 月 7 日实测日期。这些零失败都是历史;根修复验收到 11 月 3 日仍未通过,见“如何验证”


- 启动执行 vendor-shaped priming、亮度恢复和两帧 command 200。
- 稳态每秒发送 command 204 差分。差分载荷改为直接线性扫描 BGRA 像素生成(337c830,10 月 24 日),不再走厂商助手里逐像素的混淆分派;字节布局(含单像素和帧尾情况)与本机厂商助手兼容,用 TestDiffPayload.ps1 离线比对。这不放宽 900 ms 预算,也不证明实体屏已刷新。
- warmup 60/120/180 帧与长期 900 帧重建 serial session 并补全帧。

- 看门狗校验 mode、period、send_ms、last_full_frame 和 failed。
- 发送诊断按阶段记录 UTC 边界、快照读取时间和发送线程号;成功但总耗时超过 900 ms 的差分把位图转换时间和受限调用时间分开记,超时时记下卡在哪一步;启动阶段也记边界,用来查心跳缺失(c23c87c、dba51c8、2d9cf7d、57d663b)。这些是诊断,不是修复。


- 看门狗校验 mode、period、send_ms、last_full_frame 和 failed。
- 发送诊断按阶段记录 UTC 边界、快照读取时间和发送线程号;成功但总耗时超过 900 ms 的差分把位图转换时间和受限调用时间分开记,超时时记下卡在哪一步;启动阶段也记边界,用来查心跳缺失(c23c87c、dba51c8、2d9cf7d、57d663b)。这些是诊断,不是修复。



| 名词 | 意思 |
|---|---|
| baseline(完整基线) | 设备可据此得到完整画面的 command 200 帧。 |
| delta(差分) | 只发送变化区域的 command 204 数据,主机更快但无设备 ACK。 |
| serial session(串口会话) | 一次独占打开与写入周期;重开可清除部分驱动/设备停滞。 |

以 command 200 建完整画面基线、command 204 做有界增量,并用唯一写入者、发送上限、定期重开会话和 heartbeat 限制静默冻结。



以 command 200 建完整画面基线、command 204 做有界增量,并用唯一写入者、发送上限、定期重开会话和 heartbeat 限制静默冻结。

解决什么
解决全帧太慢、增量静默冻结、串口双写、驱动停滞、假心跳和恢复基线长期不到达。

- 端口按“命令行显式指定 → 配置文件 → 兼容默认 COM7”的顺序取;COM7 是这台电脑配置里的端口,换机后必须重验身份,不是可泛化的设备事实。
- 主机写成功不是 device ACK(设备确认);每 900 帧补一次整帧只说明主机会定期尝试纠偏,不能保证实体屏最长只会停 15 分钟。
- 900 ms/10 秒只限制发送线程启动后的等待,位图转换另算;一帧总耗时可能更长,不能读成端到端截止。
- Alt helper 仅保留隔离测试,不进入当前日常链路。
- 旧 stream 未释放 COM 启动失败关闭,不抢占或创建第二个 writer。
- 单次 send 超时或失败 worker 退出;看门狗先证明旧发送者已退出再重建。停止超过 30 秒就推迟,看门狗保持运行,下一轮重新确认后再建,不出现第二个串口写入者。
- heartbeat 新鲜但基线逾期 判为不健康,不接受假活。

解决什么
解决全帧太慢、增量静默冻结、串口双写、驱动停滞、假心跳和恢复基线长期不到达。

- 端口按“命令行显式指定 → 配置文件 → 兼容默认 COM7”的顺序取;COM7 是这台电脑配置里的端口,换机后必须重验身份,不是可泛化的设备事实。
- 主机写成功不是 device ACK(设备确认);每 900 帧补一次整帧只说明主机会定期尝试纠偏,不能保证实体屏最长只会停 15 分钟。
- 900 ms/10 秒只限制发送线程启动后的等待,位图转换另算;一帧总耗时可能更长,不能读成端到端截止。
- Alt helper 仅保留隔离测试,不进入当前日常链路。
- 旧 stream 未释放 COM 启动失败关闭,不抢占或创建第二个 writer。
- 单次 send 超时或失败 worker 退出;看门狗先证明旧发送者已退出再重建。停止超过 30 秒就推迟,看门狗保持运行,下一轮重新确认后再建,不出现第二个串口写入者。
- heartbeat 新鲜但基线逾期 判为不健康,不接受假活。

- command 200/204、deadline、heartbeat
- 已验证 command 200/123 编码边界
- 协议观察与证据边界
- 节拍与恢复基线合同
- 唯一 writer、heartbeat 和超时回归
- 11 月 4 日 15:14:53 主机心跳:ok/fresh、mode=hybrid_diff_204_full_200、frame=59526、sent=59526、failed=0、last_full_frame=59400、full_resync_every_frames=900、period=1011 ms、send_ms=47、elapsed_ms=78;这段会话从 11 月 3 日 22:18:50 看门狗重启后开始,只证明这一段主机写入,不与 9 月的 85,063 帧累加。
- 11 月 4 日 09:31 进度(电脑配置待验收登记 owner-20261018-4b1f21e646):已把 11 月 3 日 22:18 那次停顿缩小到画面发出后写心跳文件的阶段,仍未根治;仍由 AI 跟进、不要本人操作,下一检查点 11 月 4 日 15:00,限期 11 月 6 日 18:00。
- 11 月 3 日 21:10:32 根修复结论(owner-rootfix-20261103-evening-conclusion.json):causal_root_determined=false、original_pass_criteria_met=false、close_passed=false、code_or_configuration_changed=false、original_condition_regression_run=false、physical_pixel_acceptance=false。新证据:三次成功 DIFF 前的停顿分别是位图转换约 18.35 秒、程序集定位约 2.96 秒和 1.06 秒,随后受限发送只用 28、4、3 毫秒;低 CPU 时间不能单独判为 GC、调度或算法,缺原生错误码也不能套上游补丁。
- 11 月 3 日留下的真实故障(owner-rootfix-20261104-morning-runtime.json,11 月 4 日 09:24 读):12:53:44 第 51,144 帧 DIFF 在 command-204-header 阶段报 IOException: Device Error,约 94 毫秒返回;22:17:55 第 22,009 帧发送成功后心跳不再更新,看门狗 22:18:16 按 heartbeat-unhealthy 停掉重启。11 月 4 日 08:35 又有一次心跳陈旧约 45 秒,没有重启就恢复。
- 11 月 3 日 09:27 根修复记录(owner-rootfix-20261103-conclusion.json):保留日志确认 17 次独立失败,其中 2 次是串口写之前的差分计算超时;更早的日志已轮转,不代表总数。
- 10 月 29 日 20:05 根修复验收记录(owner-rootfix-20261029):original_pass_criteria_met=false、close_passed=false;保留的现场有 2 次独立 DIFF 超时、13 个异常、19 次成功 DIFF 总耗时 ≥900 ms,最长 DIFF 18,330 ms、FULL 49,025 ms。根修复没有达到验收,慢帧和超时仍是未解决的故障。
- 9 月 27 日 21:27 至 28 日 21:22 主机记录一次会话 85,063 帧、failed=0;原始心跳已被后续写入覆盖,这次没有重新读到,保留为历史记录。
- 2026-09-07T23:24:15Z(北京时间 9 月 8 日 07:24)heartbeat 为 285/285、failed=0、period=1010 ms、send_ms=22、last_full_frame=180;晚于异常退出恢复时第 5 帧,发送继续推进。8 月 31 日 2748/2748 保留为历史。
- 9月7日 StreamCadence 与 RuntimeReliability 通过;生产链实测软件启动 31.06 秒恢复,强制结束看门狗后 63.33 秒由原 VBS 接回并确认旧 sender 退出。

- command 200/204、deadline、heartbeat
- 已验证 command 200/123 编码边界
- 协议观察与证据边界
- 节拍与恢复基线合同
- 唯一 writer、heartbeat 和超时回归
- 11 月 4 日 15:14:53 主机心跳:ok/fresh、mode=hybrid_diff_204_full_200、frame=59526、sent=59526、failed=0、last_full_frame=59400、full_resync_every_frames=900、period=1011 ms、send_ms=47、elapsed_ms=78;这段会话从 11 月 3 日 22:18:50 看门狗重启后开始,只证明这一段主机写入,不与 9 月的 85,063 帧累加。
- 11 月 4 日 09:31 进度(电脑配置待验收登记 owner-20261018-4b1f21e646):已把 11 月 3 日 22:18 那次停顿缩小到画面发出后写心跳文件的阶段,仍未根治;仍由 AI 跟进、不要本人操作,下一检查点 11 月 4 日 15:00,限期 11 月 6 日 18:00。
- 11 月 3 日 21:10:32 根修复结论(owner-rootfix-20261103-evening-conclusion.json):causal_root_determined=false、original_pass_criteria_met=false、close_passed=false、code_or_configuration_changed=false、original_condition_regression_run=false、physical_pixel_acceptance=false。新证据:三次成功 DIFF 前的停顿分别是位图转换约 18.35 秒、程序集定位约 2.96 秒和 1.06 秒,随后受限发送只用 28、4、3 毫秒;低 CPU 时间不能单独判为 GC、调度或算法,缺原生错误码也不能套上游补丁。
- 11 月 3 日留下的真实故障(owner-rootfix-20261104-morning-runtime.json,11 月 4 日 09:24 读):12:53:44 第 51,144 帧 DIFF 在 command-204-header 阶段报 IOException: Device Error,约 94 毫秒返回;22:17:55 第 22,009 帧发送成功后心跳不再更新,看门狗 22:18:16 按 heartbeat-unhealthy 停掉重启。11 月 4 日 08:35 又有一次心跳陈旧约 45 秒,没有重启就恢复。
- 11 月 3 日 09:27 根修复记录(owner-rootfix-20261103-conclusion.json):保留日志确认 17 次独立失败,其中 2 次是串口写之前的差分计算超时;更早的日志已轮转,不代表总数。
- 10 月 29 日 20:05 根修复验收记录(owner-rootfix-20261029):original_pass_criteria_met=false、close_passed=false;保留的现场有 2 次独立 DIFF 超时、13 个异常、19 次成功 DIFF 总耗时 ≥900 ms,最长 DIFF 18,330 ms、FULL 49,025 ms。根修复没有达到验收,慢帧和超时仍是未解决的故障。
- 9 月 27 日 21:27 至 28 日 21:22 主机记录一次会话 85,063 帧、failed=0;原始心跳已被后续写入覆盖,这次没有重新读到,保留为历史记录。
- 2026-09-07T23:24:15Z(北京时间 9 月 8 日 07:24)heartbeat 为 285/285、failed=0、period=1010 ms、send_ms=22、last_full_frame=180;晚于异常退出恢复时第 5 帧,发送继续推进。8 月 31 日 2748/2748 保留为历史。
- 9月7日 StreamCadence 与 RuntimeReliability 通过;生产链实测软件启动 31.06 秒恢复,强制结束看门狗后 63.33 秒由原 VBS 接回并确认旧 sender 退出。

- 套件的 TestVideoStream 当时因已有生产流而跳过,没有运行;来源工程另行完成精确设备下的真实恢复,本人随后确认实体屏正常刷新。command 204 仍没有设备逐像素 ACK。
安装与换机模块先确认当前串口和本地 runtime(运行环境);本模块接收 renderer 位图,失败由电源与恢复模块处理,实体结果进入分层验收。

- 套件的 TestVideoStream 当时因已有生产流而跳过,没有运行;来源工程另行完成精确设备下的真实恢复,本人随后确认实体屏正常刷新。command 204 仍没有设备逐像素 ACK。
安装与换机模块先确认当前串口和本地 runtime(运行环境);本模块接收 renderer 位图,失败由电源与恢复模块处理,实体结果进入分层验收。
复制 AI 续作说明
项目:唯一串口写入者、1 Hz 混合刷新与全帧恢复;仓库:wlyaaaaa/PC-Panel-Hub;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








