唯一串口写入者、1 Hz 混合刷新与全帧恢复
现在
常用
发送慢帧和超时还没根治,11 月 4 日 11:43 重读原因仍未查明
截至 11 月 4 日 · 项目源码和发送记录

机箱屏先收到完整画面,之后每秒更新变化;若设备漏掉一轮,就重新发送整张纠偏。主机发送记录与实体画面是否动起来分别核对。

当前情况:发送故障还没根治。根修复验收到 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 日。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

唯一串口写入者、1 Hz 混合刷新与全帧恢复
现在
常用
发送慢帧和超时还没根治,11 月 4 日 11:43 重读原因仍未查明
截至 11 月 4 日 · 项目源码和发送记录

机箱屏先收到完整画面,之后每秒更新变化;若设备漏掉一轮,就重新发送整张纠偏。主机发送记录与实体画面是否动起来分别核对。

当前情况:发送故障还没根治。根修复验收到 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 对话中点名这块实体屏并描述最后一次变化。

需要准备什么
  • 实际串口设备
  • 冻结时间与现有写入进程
从开始到拿到结果
1先找到真正连着机箱屏的端口
系统确认设备身份与旧发送程序是否退出,不沿用旧电脑的端口编号。
2重新建立画面
发送完整基线,再每秒更新变化部分,定期补全帧避免漏帧长期冻结。
3看真实屏幕
交回时钟是否重新跳动;主机发送成功没有设备确认时保留未知,由看门狗按实际故障恢复。
从哪里开始

机箱屏冻结时,在已接入项目的本机 AI 对话中点名这块实体屏并描述最后一次变化。

需要准备什么
  • 实际串口设备
  • 冻结时间与现有写入进程
从开始到拿到结果
1先找到真正连着机箱屏的端口
系统确认设备身份与旧发送程序是否退出,不沿用旧电脑的端口编号。
2重新建立画面
发送完整基线,再每秒更新变化部分,定期补全帧避免漏帧长期冻结。
3看真实屏幕
交回时钟是否重新跳动;主机发送成功没有设备确认时保留未知,由看门狗按实际故障恢复。
技术实现与依据(一)

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

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

关键规则与设计选择
1
command 200 是保守已验证全帧路径;command 204 始终标为设备特定候选:它来自厂商程序里的导出,没有设备确认回执,也不是可以复用的公开协议。
2
安装默认保持 1 Hz,不把降到 3 秒当通用稳定性修复;计划任务参数里虽然还写着 3000 毫秒,混合模式实际强制每秒一帧。
3
增量 900 ms、全帧 10 秒上限,首次发送失败即退出。这两个上限从发送线程启动后的等待(Join)算起,不含之前的位图转换;一帧的总发送时间包含转换,成功的增量也可能超过 900 ms,所以它们不是端到端的硬截止。
4
heartbeat 必须包含 send_attempted 和恢复基线,不能只报进程 alive。
当前怎样实现
  • 启动执行 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 日仍未通过,见“如何验证”

关键规则与设计选择
1
command 200 是保守已验证全帧路径;command 204 始终标为设备特定候选:它来自厂商程序里的导出,没有设备确认回执,也不是可以复用的公开协议。
2
安装默认保持 1 Hz,不把降到 3 秒当通用稳定性修复;计划任务参数里虽然还写着 3000 毫秒,混合模式实际强制每秒一帧。
3
增量 900 ms、全帧 10 秒上限,首次发送失败即退出。这两个上限从发送线程启动后的等待(Join)算起,不含之前的位图转换;一帧的总发送时间包含转换,成功的增量也可能超过 900 ms,所以它们不是端到端的硬截止。
4
heartbeat 必须包含 send_attempted 和恢复基线,不能只报进程 alive。
当前怎样实现
  • 启动执行 vendor-shaped priming、亮度恢复和两帧 command 200。
  • 稳态每秒发送 command 204 差分。差分载荷改为直接线性扫描 BGRA 像素生成(337c830,10 月 24 日),不再走厂商助手里逐像素的混淆分派;字节布局(含单像素和帧尾情况)与本机厂商助手兼容,用 TestDiffPayload.ps1 离线比对。这不放宽 900 ms 预算,也不证明实体屏已刷新。
  • warmup 60/120/180 帧与长期 900 帧重建 serial session 并补全帧。
技术实现与依据(二)
1
确认唯一 COM 设备和旧 owner 已退出。
2
打开串口并发送完整基线。
3
每秒发送有界差分。
4
到恢复边界时重开会话并补全帧。
5
失败退出,由长期看门狗恢复。
  • 看门狗校验 mode、period、send_ms、last_full_frame 和 failed。
  • 发送诊断按阶段记录 UTC 边界、快照读取时间和发送线程号;成功但总耗时超过 900 ms 的差分把位图转换时间和受限调用时间分开记,超时时记下卡在哪一步;启动阶段也记边界,用来查心跳缺失(c23c87c、dba51c8、2d9cf7d、57d663b)。这些是诊断,不是修复。
执行流程
技术实现与依据(二)
1
确认唯一 COM 设备和旧 owner 已退出。
2
打开串口并发送完整基线。
3
每秒发送有界差分。
4
到恢复边界时重开会话并补全帧。
5
失败退出,由长期看门狗恢复。
  • 看门狗校验 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 限制静默冻结。

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

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