

PC Panel Hub · 功能说明
换电脑、重装系统或重新布线时,我能从公开仓库重建一套属于当前机器的双副屏安装,而不用复制旧路径、旧串口和旧硬件实例号,也不会为了方便把私人配置或厂商二进制塞回 Git。
当前情况:这台电脑上,水冷屏浮层已经从容易被清掉的编译输出搬到固定的永久目录,9 月 28 日本人粗看正常、正式安装位置验收已关闭(当时包版本 1.0.0.2);之后为接 vivo 通知、安卓调试电量和手机桥又发了新包,11 月 4 日读到正在运行的是 1.0.0.7(10 月 20 日早上是 1.0.0.4),没重新做安装位置验收;源码包和本机原任务重启也有验证。干净新机、重装与新硬件双屏安装仍未实际走通。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库

PC Panel Hub · 功能说明
换电脑、重装系统或重新布线时,我能从公开仓库重建一套属于当前机器的双副屏安装,而不用复制旧路径、旧串口和旧硬件实例号,也不会为了方便把私人配置或厂商二进制塞回 Git。
当前情况:这台电脑上,水冷屏浮层已经从容易被清掉的编译输出搬到固定的永久目录,9 月 28 日本人粗看正常、正式安装位置验收已关闭(当时包版本 1.0.0.2);之后为接 vivo 通知、安卓调试电量和手机桥又发了新包,11 月 4 日读到正在运行的是 1.0.0.7(10 月 20 日早上是 1.0.0.4),没重新做安装位置验收;源码包和本机原任务重启也有验证。干净新机、重装与新硬件双屏安装仍未实际走通。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


用途与实际影响
公开源码能下载,不等于这台电脑已接上两块屏。厂商程序、串口、网卡、天气位置和显示器身份要在本机合法取得并重新确认;照搬旧编号可能把画面送错。水冷屏浮层如果直接从编译输出运行,一次清理就可能把正在用的程序删掉。
我说“把水冷屏浮层更新到新版”,AI 会把新版发布到一个新的永久目录、先只读检查、再注册,并回读注册位置和运行进程,旧版本目录留着等新版实体确认后再处理。我说“这台新电脑也要用上两块副屏”,安装过程会重新识别当前串口、网卡、天气位置和显示器,不照抄旧机器编号。
得到在这台电脑上安装的两块副屏和自动启动设置;源码、程序运行、安装位置、机箱屏实体更新、水冷屏实际落点分别验收,缺一项只说明缺一项。

用途与实际影响
公开源码能下载,不等于这台电脑已接上两块屏。厂商程序、串口、网卡、天气位置和显示器身份要在本机合法取得并重新确认;照搬旧编号可能把画面送错。水冷屏浮层如果直接从编译输出运行,一次清理就可能把正在用的程序删掉。
我说“把水冷屏浮层更新到新版”,AI 会把新版发布到一个新的永久目录、先只读检查、再注册,并回读注册位置和运行进程,旧版本目录留着等新版实体确认后再处理。我说“这台新电脑也要用上两块副屏”,安装过程会重新识别当前串口、网卡、天气位置和显示器,不照抄旧机器编号。
得到在这台电脑上安装的两块副屏和自动启动设置;源码、程序运行、安装位置、机箱屏实体更新、水冷屏实际落点分别验收,缺一项只说明缺一项。

厂商文件、私有配置和两块真实设备都确认后,安装启动任务,再分别看两块实体屏。
端口、显示器或旧绑定不对时停在那一层修正,不靠整机重启碰运气。
合法厂商文件或唯一设备身份缺失时不能完成本机安装;软件演示仍只算演示。

厂商文件、私有配置和两块真实设备都确认后,安装启动任务,再分别看两块实体屏。
端口、显示器或旧绑定不对时停在那一层修正,不靠整机重启碰运气。
合法厂商文件或唯一设备身份缺失时不能完成本机安装;软件演示仍只算演示。

在已接入项目的本机 AI 对话中说要在这台新电脑安装双副屏,并准备合法取得的厂商程序和两块实体设备。
- 本机串口、物理网口和天气位置
- 合法取得的厂商运行文件
- HS2 显示器和背景选择


在已接入项目的本机 AI 对话中说要在这台新电脑安装双副屏,并准备合法取得的厂商程序和两块实体设备。
- 本机串口、物理网口和天气位置
- 合法取得的厂商运行文件
- HS2 显示器和背景选择


HS2 包 1.0.0.2 注册在永久目录,9 月 28 日正式安装位置验收关闭;11 月 4 日运行中进程旁 AppxManifest 为 1.0.0.7(10 月 20 日早上是 1.0.0.4;安装位置都未重新验收);9 月 7 日公开 ZIP 和本机既有任务重新启动已验证。clean clone(干净克隆)、换机、系统重装和新硬件双屏验收仍未执行


HS2 包 1.0.0.2 注册在永久目录,9 月 28 日正式安装位置验收关闭;11 月 4 日运行中进程旁 AppxManifest 为 1.0.0.7(10 月 20 日早上是 1.0.0.4;安装位置都未重新验收);9 月 7 日公开 ZIP 和本机既有任务重新启动已验证。clean clone(干净克隆)、换机、系统重装和新硬件双屏验收仍未执行



- build-release.ps1 从源码构建 ZIP,只纳入 README、AGENTS、LICENSE、docs、scripts 与三套 tool source;测试会解包核对 HS2 源码和公开清单。这是公开源码包,和下面的 HS2 安装布局是两种不同的成品。
- Publish-HS2Overlay.ps1 -OutputDirectory <新的永久目录>:构建 Release 版并复制 Windows App SDK 要求的全部依赖和资源,逐文件记哈希,目录已存在就拒绝;它不注册、不启动、不改任务。
- Install-HS2Overlay.ps1 -PackageDirectory <永久目录>:默认只读检查;加 -Apply 才在目标用户会话里注册(沿用原来的包身份、权限和设置),注册后回读安装位置,读回来不一致就判失败。源码 Package.appxmanifest 当前是 1.0.0.7(11 月 4 日运行中的也是 1.0.0.7;后续发布继续递增这个版本号),应用基于 .NET 10 和 Windows App SDK 2.3.1,运行时要求 WindowsAppRuntime 2.3.1 以上。
- 发布规则只允许 tools/turzx_side_screen/config.example.json 这一份配置示例;真实 config.json、weather local JSON、out、bin、obj、AppPackages、厂商 EXE/DLL 和生成预览全部排除。
- config.json 保存当前机 serial、480×1920 刷新、loopback metrics(这台电脑用 18766 端口,源码默认 18765)、天气、时区、物理公网接口与 UI 选项;天气也可从显式私有路径或成对环境变量注入,未填坐标时失败关闭。
- check-runtime.ps1 发现合适 Python 与 C# 编译器,核对 RJCP/TURZX 文件和 stack 入口,并返回 ready/missing;TimeAudit 凭据存在时才要求 Python 同时具备 psutil 与 asyncpg。
- StartSideScreenWatchdog.ps1 在 ignored(已被版本控制忽略) out 中维护 hs2-usb-topology-binding.json;新机器或改线后由健康拓扑生成,旧绑定不作为跨机事实。


- build-release.ps1 从源码构建 ZIP,只纳入 README、AGENTS、LICENSE、docs、scripts 与三套 tool source;测试会解包核对 HS2 源码和公开清单。这是公开源码包,和下面的 HS2 安装布局是两种不同的成品。
- Publish-HS2Overlay.ps1 -OutputDirectory <新的永久目录>:构建 Release 版并复制 Windows App SDK 要求的全部依赖和资源,逐文件记哈希,目录已存在就拒绝;它不注册、不启动、不改任务。
- Install-HS2Overlay.ps1 -PackageDirectory <永久目录>:默认只读检查;加 -Apply 才在目标用户会话里注册(沿用原来的包身份、权限和设置),注册后回读安装位置,读回来不一致就判失败。源码 Package.appxmanifest 当前是 1.0.0.7(11 月 4 日运行中的也是 1.0.0.7;后续发布继续递增这个版本号),应用基于 .NET 10 和 Windows App SDK 2.3.1,运行时要求 WindowsAppRuntime 2.3.1 以上。
- 发布规则只允许 tools/turzx_side_screen/config.example.json 这一份配置示例;真实 config.json、weather local JSON、out、bin、obj、AppPackages、厂商 EXE/DLL 和生成预览全部排除。
- config.json 保存当前机 serial、480×1920 刷新、loopback metrics(这台电脑用 18766 端口,源码默认 18765)、天气、时区、物理公网接口与 UI 选项;天气也可从显式私有路径或成对环境变量注入,未填坐标时失败关闭。
- check-runtime.ps1 发现合适 Python 与 C# 编译器,核对 RJCP/TURZX 文件和 stack 入口,并返回 ready/missing;TimeAudit 凭据存在时才要求 Python 同时具备 psutil 与 asyncpg。
- StartSideScreenWatchdog.ps1 在 ignored(已被版本控制忽略) out 中维护 hs2-usb-topology-binding.json;新机器或改线后由健康拓扑生成,旧绑定不作为跨机事实。

- install-startup-admin.ps1 先调用 runtime(运行环境) check,再把已解析 Root、Port、Interval 与 Hybrid 模式写进计划任务动作;wscript 父适配器保持无窗口长期运行。遇到旧的恢复任务仍会禁用。
- uninstall-startup-admin.ps1 可移除主任务;安装器只禁用旧 stock 任务而不删除,Hybrid 不兼容时另有显式 command-200 三秒兼容模式。旧 Resume 脚本和隐藏启动器 9 月 29 日已删除。
- 验收记录把当前主机运行证据和新机/重装 E2E(端到端验证) 分开;没有摄像头或设备 ACK 时,以人工观察两块实体屏和自然启动作为最后一层。


- install-startup-admin.ps1 先调用 runtime(运行环境) check,再把已解析 Root、Port、Interval 与 Hybrid 模式写进计划任务动作;wscript 父适配器保持无窗口长期运行。遇到旧的恢复任务仍会禁用。
- uninstall-startup-admin.ps1 可移除主任务;安装器只禁用旧 stock 任务而不删除,Hybrid 不兼容时另有显式 command-200 三秒兼容模式。旧 Resume 脚本和隐藏启动器 9 月 29 日已删除。
- 验收记录把当前主机运行证据和新机/重装 E2E(端到端验证) 分开;没有摄像头或设备 ACK 时,以人工观察两块实体屏和自然启动作为最后一层。





| 名词 | 意思 |
|---|---|
| source package(源码包) | 能公开克隆、构建和检查的代码/文档集合,不包含一台机器的可执行依赖、配置、绑定或运行输出。 |
| private config(私有配置) | 由 config.example.json 派生、被 Git 忽略的当前机串口、物理网卡和天气等值;可备份但不能公开提交。 |
| machine binding(机器绑定) | 当前电脑上 TURZX 串口与 HS2 Hub/controller/LED/display 的实际身份关系;换机或重接后必须重新发现。 |
| runtime gate(运行依赖门) | check-runtime 返回 ready 前不允许安装启动任务,避免把缺依赖的路径变成开机故障。 |
| 永久安装目录 | HS2 浮层发布出来的固定目录,每个版本一个新目录、不覆盖旧的;系统按这里注册和启动,清理源码编译输出不会影响正在用的浮层。这台电脑现在运行的是 E:\ |
| layered acceptance(分层验收) | 源码、测试、安装、进程/heartbeat、实体像素、睡眠恢复和自然启动分别给结论,不能互相替代。 |

把 clean clone(干净克隆)、合法取得的厂商运行文件、每台机器自己的串口/物理网卡/天气配置和双屏绑定按顺序组装;依赖未齐时不装启动任务,主机通过后仍单独看实体像素。



把 clean clone(干净克隆)、合法取得的厂商运行文件、每台机器自己的串口/物理网卡/天气配置和双屏绑定按顺序组装;依赖未齐时不装启动任务,主机通过后仍单独看实体像素。

解决什么
解决公开源码缺少本机私有运行态、换机误复制硬件身份、厂商文件误入 Git、依赖未齐先装任务、旧路径残留、双屏只验进程不验像素,以及安装失败后没有清晰回退的问题。

- 厂商 TURZX 程序、RJCP 二进制和 Wallpaper Engine 场景必须从安装者有权使用的来源取得;PUBLIC(公开) 仓库与源码 ZIP 不重新分发。
- config.json、天气坐标、物理网卡名、TIMEAUDIT 凭据、设备拓扑绑定、日志和生成输出保持在 Git 外;公开示例继续为空值。
- 旧机器的 COM7、DISPLAY 编号、8091/AD23/LED 实例号和任务 Root 都不是新机器事实;迁移必须重新发现并回读。
- 内部 USB 排针改线属于实体操作,必须关机并断开整机电源;安装页面不会把源码接线说明写成已完成实测。
- 安装和卸载启动任务需要时自动提权,会改变当前用户的 Task Scheduler;repair-hs2.ps1 仅在 -Apply 且非 -WhatIf 的实际硬件修复时自动提权。网站刷新和本模块证据采集保持只读。
- 当前主机健康、公开 ZIP 回归或 source contract 都不能证明另一台机器、重装系统、睡眠或异常断电后的真实 E2E(端到端验证)。
- Python、csc、RJCP、TURZX 运行文件或 stack 入口缺失 check-runtime 返回具体 missing 且非零退出;安装器立即停止,不留下半注册启动任务。
- 私有串口、物理网卡或天气值仍是旧机器内容 保留公开示例不动,在 ignored(已被版本控制忽略) config.json 中重新发现并填写;天气坐标缺失时 shim(受保护入口垫片) 失败关闭,不回落作者位置。

解决什么
解决公开源码缺少本机私有运行态、换机误复制硬件身份、厂商文件误入 Git、依赖未齐先装任务、旧路径残留、双屏只验进程不验像素,以及安装失败后没有清晰回退的问题。

- 厂商 TURZX 程序、RJCP 二进制和 Wallpaper Engine 场景必须从安装者有权使用的来源取得;PUBLIC(公开) 仓库与源码 ZIP 不重新分发。
- config.json、天气坐标、物理网卡名、TIMEAUDIT 凭据、设备拓扑绑定、日志和生成输出保持在 Git 外;公开示例继续为空值。
- 旧机器的 COM7、DISPLAY 编号、8091/AD23/LED 实例号和任务 Root 都不是新机器事实;迁移必须重新发现并回读。
- 内部 USB 排针改线属于实体操作,必须关机并断开整机电源;安装页面不会把源码接线说明写成已完成实测。
- 安装和卸载启动任务需要时自动提权,会改变当前用户的 Task Scheduler;repair-hs2.ps1 仅在 -Apply 且非 -WhatIf 的实际硬件修复时自动提权。网站刷新和本模块证据采集保持只读。
- 当前主机健康、公开 ZIP 回归或 source contract 都不能证明另一台机器、重装系统、睡眠或异常断电后的真实 E2E(端到端验证)。
- Python、csc、RJCP、TURZX 运行文件或 stack 入口缺失 check-runtime 返回具体 missing 且非零退出;安装器立即停止,不留下半注册启动任务。
- 私有串口、物理网卡或天气值仍是旧机器内容 保留公开示例不动,在 ignored(已被版本控制忽略) config.json 中重新发现并填写;天气坐标缺失时 shim(受保护入口垫片) 失败关闭,不回落作者位置。

- TURZX 串口不唯一或旧 writer 仍占用 不启动第二个 writer,不把 COM7 当常量;先确认当前设备身份和旧 Owner 退出。
- HS2 绑定缺失、歧义或只出现 A108 Boot ROM 不复制旧绑定、不发送模式命令;等待唯一完整拓扑,并在 AD23/MI_00 与 LED 连续两次健康后再保存。
- HS2 注册后读回的安装位置不对,或新版实体没通过 判为失败,不宣布完成;旧版本目录一直留着,直到新版实体确认通过。
- 启动任务 Root、参数或安装结果错误 运行 uninstall-startup-admin.ps1 撤销本项目任务,修正路径/配置并重新通过 runtime(运行环境) check 后再安装。
- 1 Hz Hybrid 在目标 TURZX 上不兼容 显式使用
-HybridRefresh:$false回到已验证 command 200 三秒兼容模式;不把自动降频当修复成功。
- 主机检查通过但实体画面未更新 把问题留在实体/设备层,不升级 PASS;观察真实 TURZX 时钟和 HS2 背景/浮层,必要时交给串口或电源恢复模块。

- TURZX 串口不唯一或旧 writer 仍占用 不启动第二个 writer,不把 COM7 当常量;先确认当前设备身份和旧 Owner 退出。
- HS2 绑定缺失、歧义或只出现 A108 Boot ROM 不复制旧绑定、不发送模式命令;等待唯一完整拓扑,并在 AD23/MI_00 与 LED 连续两次健康后再保存。
- HS2 注册后读回的安装位置不对,或新版实体没通过 判为失败,不宣布完成;旧版本目录一直留着,直到新版实体确认通过。
- 启动任务 Root、参数或安装结果错误 运行 uninstall-startup-admin.ps1 撤销本项目任务,修正路径/配置并重新通过 runtime(运行环境) check 后再安装。
- 1 Hz Hybrid 在目标 TURZX 上不兼容 显式使用
-HybridRefresh:$false回到已验证 command 200 三秒兼容模式;不把自动降频当修复成功。
- 主机检查通过但实体画面未更新 把问题留在实体/设备层,不升级 PASS;观察真实 TURZX 时钟和 HS2 背景/浮层,必要时交给串口或电源恢复模块。

- 8 月 31 日旧验收记录:PUBLIC(公开) main=8c217eadf76e6849c382c909b407d9dc436f9005,本地 HEAD、origin/main 与实时远端 main 当时一致且源工作树干净;该次公开发布测试构建并解包 ZIP,确认 config.example、双屏源码和安装脚本存在,厂商二进制、本机 JSON 与生成目录不存在。
- 9月7日现有主机依赖 ready、missing=0;既有 TURZX 任务已重新启动,新隐藏入口的异常退出恢复实际执行,唯一 stream 与新鲜 Hybrid 心跳存在。a4d8e22 公开 ZIP 构建并解包通过;这些只证明现有机器与源码包。
- 9 月 28 日 13:53 正式安装位置验收关闭:本人粗看正常,AI 清掉旧的编译输出并回读位置;当时已装包版本 1.0.0.2、注册在该永久目录。10 月 20 日早上运行中进程旁的清单为 1.0.0.4;11 月 4 日 09:10 读到唯一运行的 HS2.CrystalOverlay 在 E:\
Tools\ PC-Panel-Hub\ HS2\ release-20261020-phone-bridge-r3,旁边清单 1.0.0.7,进程 11 月 3 日 16:02:24 启动。Appx 注册位置没有回读,只能证明运行路径和旁边清单,不能说新版已通过安装验收。这项验收不覆盖每类通知、快捷键、睡眠、断电和新机。
- runtime(运行环境)checker 回归和 HS2 安装模拟测试(模拟注册定义)都还在源码里,11 月 4 日核对时没有重跑,也没有重做公开 ZIP。也没有在 clean clone、另一台电脑或重装后的 Windows 上重建 private(私有) config、重新绑定两块屏、安装任务并完成自然启动;换机、HS2 当前实体画面、睡眠和异常断电仍未验收。
本模块把公开源码变成当前机器可运行的前置安装态,为指标、渲染、串口和 HS2 浮层提供私有配置与双屏绑定;安装完成后的睡眠、冻结、端点消失和运行期自愈仍由电源恢复模块负责。

- 8 月 31 日旧验收记录:PUBLIC(公开) main=8c217eadf76e6849c382c909b407d9dc436f9005,本地 HEAD、origin/main 与实时远端 main 当时一致且源工作树干净;该次公开发布测试构建并解包 ZIP,确认 config.example、双屏源码和安装脚本存在,厂商二进制、本机 JSON 与生成目录不存在。
- 9月7日现有主机依赖 ready、missing=0;既有 TURZX 任务已重新启动,新隐藏入口的异常退出恢复实际执行,唯一 stream 与新鲜 Hybrid 心跳存在。a4d8e22 公开 ZIP 构建并解包通过;这些只证明现有机器与源码包。
- 9 月 28 日 13:53 正式安装位置验收关闭:本人粗看正常,AI 清掉旧的编译输出并回读位置;当时已装包版本 1.0.0.2、注册在该永久目录。10 月 20 日早上运行中进程旁的清单为 1.0.0.4;11 月 4 日 09:10 读到唯一运行的 HS2.CrystalOverlay 在 E:\
Tools\ PC-Panel-Hub\ HS2\ release-20261020-phone-bridge-r3,旁边清单 1.0.0.7,进程 11 月 3 日 16:02:24 启动。Appx 注册位置没有回读,只能证明运行路径和旁边清单,不能说新版已通过安装验收。这项验收不覆盖每类通知、快捷键、睡眠、断电和新机。
- runtime(运行环境)checker 回归和 HS2 安装模拟测试(模拟注册定义)都还在源码里,11 月 4 日核对时没有重跑,也没有重做公开 ZIP。也没有在 clean clone、另一台电脑或重装后的 Windows 上重建 private(私有) config、重新绑定两块屏、安装任务并完成自然启动;换机、HS2 当前实体画面、睡眠和异常断电仍未验收。
本模块把公开源码变成当前机器可运行的前置安装态,为指标、渲染、串口和 HS2 浮层提供私有配置与双屏绑定;安装完成后的睡眠、冻结、端点消失和运行期自愈仍由电源恢复模块负责。
复制 AI 续作说明
项目:从干净源码到双副屏本机安装态;仓库:wlyaaaaa/PC-Panel-Hub;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








