Skip to content

About

腾讯会议 3.26.10.401-5 的 Hyprland/Wayland 屏幕共享实验性修复:Portal Hunk 0、XDPH SHM 与 PipeWire 缓冲生命周期守卫

Topics

Resources

Stars

9 stars

Watchers

1 watching

Forks

Latest commit

 

History

14 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

腾讯会议 Wayland 屏幕共享修复(实验性)

这是面向 Hyprland/XDPH 的腾讯会议 3.26.10.401-5 屏幕共享实验性修复, 并包含共享选项 ⓘ 提示气泡的布局重入修复。 仓库不包含腾讯二进制、编译产物、core dump 或私人日志。

严格版本绑定: 补丁和启动器仅支持 Arch/CachyOS 的 wemeet-bin 3.26.10.401-5。tools/stage_hunk0.py、 tools/stage_tooltip.py 与 tools/run-guarded.sh 内置了经过验证的 SHA-256 白名单,遇到任何其他二进制 都会拒绝执行。腾讯会议升级后必须重新审计所有偏移,不能复用现有补丁。

AUR 构建过程会使用 patchelf 重写 libxcast.so 的 RUNPATH。不同版本的 patchelf 会从同一份腾讯官方文件生成字节不同但代码和动态链接配置相同的 ELF 布局;启动器只接受已从官方 deb 可重复生成并审核过的精确哈希,不会 因此放宽对未知文件或其他屏幕共享 Hook 的拒绝。

问题说明

修复 Portal 调用顺序后,腾讯会议仍可能在 PipeWire stream 已释放或移除 buffer 后继续持有对应 SHM 帧指针。实测故障包括:

  • 对已经解除映射的 14,745,600 字节 SHM 帧执行延迟 rep movsb;
  • pw_stream_queue_buffer()+41 解引用已经失效的内部 buffer;
  • stream 销毁和重建期间,XDPH 报告 Out of buffers。

此前上游 straight Hook 会先用 msync() 检查映射,再复制帧。这仍然存在 TOCTOU 竞态:检查完成后,映射可能在复制过程中被另一线程解除。

完整修复由什么组成

当前实验方案包含屏幕共享的三层修复,以及一个独立的 UI 修复:

  1. Portal 调用顺序——上游 Hunk 0 让腾讯会议等待异步 SelectSources 响应完成后再调用 Start,修复 Sources not selected。
  2. CPU 可读帧——PipeWire 标准 SHM 协商 腾讯会议不发布 SPA_FORMAT_VIDEO_modifier,因此不能匹配 XDPH 带 mandatory modifier 的 DMA-BUF 候选,只能匹配其 SHM fallback。真实 A/B 测试确认最终 buffer 为 SPA_DATA_MemFd,无需设置全局 force_shm。没有启用 RGB/BGR 颜色交换。
  3. 生命周期安全——本仓库的 PipeWire Guard 在 PipeWire 仍保证帧有效时创建快照,保持镜像缓冲区长期映射,在 queue 前恢复生产者原始指针,并拒绝 buffer 移除或 stream 销毁后的迟到 queue。
  4. 共享选项提示气泡——布局闭包快照 “同时共享电脑声音”和“视频流畅度优先”右侧 ⓘ 的布局回调可能在执行 子布局时被重入替换。独立 C++ Guard 在调用前复制完整的 std::function,隔离闭包存储并保留拥有型捕获,返回或抛出异常后自动 释放。不关闭 tooltip、不吞掉崩溃;腾讯 UI framework 指令保持原样。 详见 崩溃分析、生命周期修复与验证边界。

Hunk 0、straight 和最初用于排查的 force_shm 方案均来自上游。本仓库 新增的工作是独立实现的 PipeWire buffer 生命周期守卫、mock/压力测试、严格 版本校验、隔离启动器及相关文档。后续协议分析和真实 A/B 测试证明腾讯会议 默认已经协商 SHM,因此正式方案不再要求全局 force_shm。

PipeWire Guard 设计

腾讯会议屏幕共享模块自行打开 libpipewire-0.3.so.0,并通过 dlsym() 解析 API。因此 Guard 拦截 dlsym(),且只替换以下函数:

  • pw_stream_new
  • pw_stream_destroy
  • pw_stream_add_listener
  • pw_stream_connect
  • pw_stream_disconnect
  • pw_stream_dequeue_buffer
  • pw_stream_queue_buffer

每次 dequeue 后,Guard 会在 PipeWire buffer 仍归客户端所有时复制有效的 spa_chunk 区间。它将 spa_data.data 临时替换为八个长期匿名镜像映射之一, 并在归还 buffer 前恢复 PipeWire 原始指针。镜像在进程结束前不会解除映射, 因此腾讯会议的延迟读取仍能访问有效内存。

Guard 包装 add_buffer、remove_buffer、process、disconnect 和 destroy 事件以跟踪生命周期。若完成回调尝试 queue 已移除或已销毁的 buffer,Guard 返回 -EPIPE,不会调用真正的 pw_stream_queue_buffer()。

只有设置 WEMEET_PW_GUARD=1 才会启用替换;仅加载动态库时不会替换目标 PipeWire API。

环境要求

  • x86-64 Arch/CachyOS、Hyprland 和 xdg-desktop-portal-hyprland;
  • 与内置哈希完全一致的 wemeet-bin 3.26.10.401-5;
  • PipeWire 开发头文件、C/C++ 编译器、GNU libstdc++、make、pkg-config、Python 3 和 bubblewrap;
  • desktop-file-utils 仅用于校验桌面入口和刷新应用菜单缓存。

Arch/CachyOS 软件包安装

仓库在 packaging/arch/ 中提供固定版本的 PKGBUILD。 它只下载并构建本仓库的 MIT 源码,不包含或重新分发腾讯会议二进制。

先安装 base-devel,并确保已安装的腾讯会议版本严格匹配:

pacman -Q wemeet-bin
# 必须输出:wemeet-bin 3.26.10.401-5

wemeet-bin 是 AUR 依赖,若尚未安装,需要先通过 AUR helper 安装;随后构建 并安装本修复包:

git clone https://github.com/YoungJurry/wemeet-screenshare-fix.git
cd wemeet-screenshare-fix/packaging/arch
makepkg -si

安装后可从应用菜单启动 腾讯会议(Wayland 修复版),也可以运行:

wemeet-wayland-guard

官方腾讯会议入口保持不变。卸载修复包不会修改或删除腾讯会议文件及用户 XDPH 配置:

sudo pacman -Rns wemeet-screenshare-fix

在 AUR 包正式发布前,这种本地 makepkg -si 安装方式不会被 yay -Syu 自动升级;更新时需要重新拉取本仓库并构建。

构建与测试

编译产物和测试二进制只会写入 /tmp:

make clean test

make test 还运行 UI 生命周期测试:严格 hash/staging 拒绝策略、 2,000 次双指针小对象闭包覆写、2,000 次拥有型捕获替换、坐标保持、 非目标调用透传、空回调异常与抛出时的 RAII 清理。测试不加载腾讯库、 不联网、不生成 core;离线回归不代替真实 UI、共享和退出测试。 仅运行这部分可使用 make test-tooltip。

mock PipeWire 测试覆盖:

  • 帧快照和原始指针恢复;
  • 原始映射失效后,镜像仍然可读;
  • remove_buffer、disconnect 和 destroy 后拒绝迟到 queue;
  • 2,000 次正常 process/dequeue/queue 循环;
  • process 与 destroy 并发时,destroy 等待活动回调且迟到 queue 被拒绝;
  • Guard 关闭时保持透传行为。

额外本地检查包括 GCC -fanalyzer、ASan/UBSan、50 个独立测试进程,以及 300 帧 2560×1440×4 全尺寸压力测试。ThreadSanitizer 无法与自定义 dlsym() interposer 一起初始化,即使 Guard 关闭也会失败,因此该路径使用 确定性的并发 destroy 测试覆盖。

安装与启动

本动态库不能单独修复 Portal 调用顺序,也不能让 DMA-BUF 变为 CPU 可读。 完整实验方案要求:Hunk 0、PipeWire 协商得到 SPA_DATA_MemFd、原版 libxcast.so,并且不能同时使用 straight 或颜色交换 Hook。

不需要创建或修改 ~/.config/hypr/xdph.conf。XDPH 默认同时发布 DMA-BUF 候选和 SHM fallback;腾讯会议的无 modifier 格式会自动选择后者。全局 force_shm = 1 会影响其他 Portal 应用,不属于本修复的安装步骤。

先执行测试:

make clean test

从仓库目录启动修复版腾讯会议:

./tools/run-guarded.sh

启动器会检查已安装包必须为 wemeet-bin 3.26.10.401-5,默认验证四个 腾讯会议文件的哈希(含 UI framework)。其中 libxcast.so 接受由已审核 patchelf 版本生成的有限 精确哈希集合,其他文件和未知构建仍会被拒绝。它在 $XDG_RUNTIME_DIR 的 唯一临时目录中创建经过验证的 Hunk 0 和 UI framework 副本,并且只在 腾讯会议 bubblewrap mount namespace 内覆盖这些文件,因此主机软件包 保持原版。UI framework 副本与原文件逐字节一致,修复由仅在该进程加载的 libwemeet_layout_guard.so 完成。腾讯会议退出后,启动器会删除两个临时副本。

WEMEET_TOOLTIP_FIX=0 ./tools/run-guarded.sh 可单独关闭 UI 补丁做受控对照, 不会关闭 PipeWire Guard;不要在重要会议里故意触发未修复版本的 ⓘ。 WEMEET_PW_GUARD_VALIDATE_ONLY=1 ./tools/run-guarded.sh 只校验副本与挂载, 不启动腾讯会议。

checkout 启动时优先使用当前源码及 staging 工具,不会静默使用旧安装包。 WEMEET_PW_GUARD_BUILD_DIR=/tmp/独立目录 可设置开发 Guard 的编译位置。 新发布的 v0.1.3 包含此 UI 布局回调守卫。

从源码运行时,Guard 编译产物默认仍只写入 /tmp,启动器通过 make 按需重建。 系统包则可执行:

make BUILD_DIR="$PWD/build" DESTDIR="$pkgdir" install

将两个 Guard、两个 staging 工具、系统启动器和独立 desktop 安装到标准 /usr 路径;该安装目标同样不会修改腾讯会议文件或任何用户配置。

普通 wemeet 命令仍会启动未修复的官方版本。腾讯自带的 libwemeetwrap.so 必须位于 LD_PRELOAD 首位;若 Guard 排在它前面,会 破坏 wrapper 的 RTLD_NEXT 查找,导致腾讯会议只有后台进程而不显示窗口。

可以安装一个独立应用菜单入口,不会覆盖官方入口:

./tools/install-desktop-entry.sh

菜单中会显示为 腾讯会议(Wayland 修复版)。删除方法:

rm -f ~/.local/share/applications/wemeet-wayland-guard.desktop
update-desktop-database ~/.local/share/applications

上游来源与归属

Hunk 0 的偏移和补丁字节来自:

GodKeawa/wemeet-bin-wayland-screenshare-fix

当前实测状态

Guard 已通过合成测试,并在重启前后完成两轮真实屏幕共享测试。第二轮成功 接收并编码超过 700 帧 1920×1080 画面,停止共享正常,且没有产生 Wemeet core dump。第一轮初始协商期间出现两次瞬时 XDPH Out of buffers,随后自动 恢复并正常共享。

另一次关闭全局 force_shm 的真实 A/B 测试连续完成两轮开始和停止共享。 Guard 在实际 add_buffer 事件中确认 n_datas=1、spa_data.type=2,即 SPA_DATA_MemFd;XDPH 同时记录 Building modifiers for dma 和随后实际请求 wl_shm buffer。这证明前一条日志只是发布 DMA 候选,并不表示腾讯会议最终 使用 DMA-BUF。本次测试同样没有产生 Wemeet core dump。

2026-10-12 新增 UI 回归:首版裸指针指令快照虽恢复了气泡,却在退出时 产生两次堆损坏 SIGABRT,因此已撤销,不能发布。当前实现改为完整回调 副本;用户验证两个 ⓘ、共享开始/停止及关闭窗口均正常,程序正常退出后 没有新 core。本轮记录 7,134 次布局回调快照、205 帧捕获;完整经过见 UI 生命周期分析。UI framework 指令保持原样。

这些结果是有希望的开发阶段证据,但还不能视为长期稳定性保证。欢迎在严格 匹配版本的前提下测试并提交不包含私人数据的日志摘要或问题报告。

About

腾讯会议 3.26.10.401-5 的 Hyprland/Wayland 屏幕共享实验性修复:Portal Hunk 0、XDPH SHM 与 PipeWire 缓冲生命周期守卫

Topics

Resources

Stars

9 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages