Notify2XSO v1.2.1

Notify2XSO v1.2.1

首个 GitHub 发布版本 / First GitHub release

中文

Notify2XSO 将 Windows 系统通知转发到 XSOverlay。QQ 等聊天消息默认使用大通知显示发送人和正文，普通提醒默认使用小通知；可通过应用规则调整，也可从系统托盘暂停和恢复转发。

本次发布包含：

• 大、小通知与本机 WebSocket / UDP 连接；按应用设置自动、大通知、小通知或屏蔽规则。
• 同步应用图标，并优先使用每条通知提供的本地联系人 / 群聊头像，保留圆形裁切。头像不可用时回退应用图标。
• “预览通知头像”可检查通知中心已有条目的头像，不会将旧通知补发到 XSO。
• 简洁的扁平化软件图标，应用于窗口、托盘、程序和安装包。
• 示例姓名修正为 LinYe，邀请文案修正为 “今晚玩vrc吗”。

下载与安装

1. 下载附件 Notify2Xso-1.2.1-win11-x64.zip 并完整解压。此包适用于 Windows 11 x64，已包含 .NET 运行时。
2. 如已安装旧版，先从托盘退出；运行解压目录中的 Install.cmd，使用当前 Windows 帐户确认 UAC。
3. 从开始菜单或 Launch.cmd 启动，点击“开始转发”并允许通知访问。启动 XSOverlay，使用大、小测试通知检查 VR 显示。
4. 通知中心已有聊天通知时，点击“预览通知头像”核对联系人 / 群头像；再用一条新系统通知验证实际转发。

附件 SHA256SUMS.txt 提供下载文件的 SHA-256 校验值。校验值用于检查文件完整性，不等同于数字签名。

安装包为未签名的个人本地测试版。 安装器不导入证书、不修改开发者模式；开机启动默认关闭。Windows 10 需要自行构建并使用受信任证书签名的 MSIX。安装与卸载详情见包内 README.txt 和 README.en.txt。

头像兼容性与验证范围

Windows 公开通知监听 API 不提供头像。已授权监听后，程序只读 Windows 自身的私有通知存储，按通知 ID、来源应用、时间和文字核对，读取该条通知引用的本地图片。它不读取 QQ 聊天数据库，也不下载远程头像；Windows 或应用更新可能影响此兼容功能，失败时回退应用图标。开启“隐藏发送人、消息正文与头像”后会跳过个人头像。

1.2.0 已通过 6 组核心测试和 15 组 Windows 图标 / 头像测试。1.2.1 仅修正示例文字，已重新编译、打包并检查界面渲染，未重复运行完整功能测试。尚未完成真实 QQ → Windows 监听器 → XSOverlay 头显显示的端到端验证；本地头像样本和自动测试不代表已验证真实设备上的最终呈现。

English

Notify2XSO forwards Windows system notifications to XSOverlay. Chat messages, including QQ notifications, use large cards with the sender and message by default; ordinary alerts use small cards. Application rules control this behavior, and the system tray provides pause and resume controls. The application UI is currently in Chinese; documentation is available in Chinese and English.

This release includes:

• Large and small notifications over local WebSocket or UDP, with per-application automatic, large, small, or block rules.
• Application icons and, when available, the local contact or group avatar supplied by each notification, including circular cropping. Unavailable avatars fall back to the application icon.
• A Preview notification avatars button (“预览通知头像”) to inspect existing notification images locally without forwarding old notifications to XSO.
• A flat application icon used by the window, tray, executable, and installation package.
• Corrected sample sender LinYe and invitation “今晚玩vrc吗”.

Download and install

1. Download and fully extract Notify2Xso-1.2.1-win11-x64.zip. It targets Windows 11 x64 and includes the .NET runtime.
2. Exit an older version from its tray menu before updating. Run Install.cmd from the extracted folder and approve UAC using the current Windows account.
3. Launch from the Start menu or Launch.cmd. Click Start forwarding (“开始转发”) and allow notification access. Start XSOverlay and use the large and small test notifications to check the VR display.
4. With chat notifications present in Notification Center, click Preview notification avatars to check the contact or group image, then use a new system notification to verify forwarding.

The attached SHA256SUMS.txt contains SHA-256 checksums for the download files. Checksums verify file integrity; they are not a publisher's digital signature.

The binary is an unsigned package for personal local testing. The installer does not import certificates or enable Developer Mode. Startup at sign-in is disabled by default. Windows 10 requires building an MSIX signed with a trusted certificate. See README.txt and README.en.txt inside the archive for installation and removal details.

Avatar compatibility and validation

The public Windows notification listener API does not expose avatars. After notification access is granted, the application reads the private Windows notification store in read-only mode, matches the notification ID, source application, time, and text, then loads the local image referenced by that notification. It does not read the QQ chat database or download remote avatars. Windows or application updates may break this compatibility path; failures fall back to the application icon. The privacy option hides the sender, message, and personal avatar.

Version 1.2.0 passed 6 core test groups and 15 Windows icon / avatar test groups. Version 1.2.1 changes sample text only and has been rebuilt, packaged, and checked through UI rendering; the complete functional test suite was not rerun for this version. Real QQ → Windows listener → XSOverlay headset display has not yet been verified end to end. Local avatar samples and automated tests do not establish the final result on a real headset.