v0.2.1

控制端补测：重启/关机、终端会话列表、Wayland；主机远程关机不再等待授权弹窗。/ Viewer power, terminal list and Wayland tested; host power actions never wait for a polkit prompt.

修复 / Fixed

• 远程重启/关机不再卡在授权弹窗：被控端用户没有 polkit 权限时（例如本机没有活动的图形会话），systemctl reboot/poweroff
  会一直等待，并可能在被控端屏幕上弹出密码框。现在加了 --no-ask-password，没有权限时直接失败并在日志记录 ok=false。
  正常情况下（本机有活动的图形会话）行为不变。
  Reboot/shutdown no longer wait for a polkit authentication dialog on the host; without permission they fail and are logged.

控制端实测补充 / Viewer testing

在虚拟机中用第二个主机身份实测通过（uuremote-viewer 连接本项目主机）：

• 远程重启、关机，以及关机后重新开机上线。
• 终端会话列表：新建、双击接回（重放历史输出、原 shell 环境保留）、确认后结束会话。
• Wayland（Hyprland）下的桌面窗口与剪贴板（wl-copy/wl-paste，双向）。
  ⚠️ 仍未实测：GNOME/KDE Wayland 下的窗口与剪贴板、H.265 与 4:4:4（只解码 H.264 4:2:0）、多显示器。
  Tested in a VM: reboot, shutdown and power-on, terminal session list, Wayland (Hyprland) window and clipboard.

下载 / Download

uu-remote-linux-v0.2.1-x86_64-linux.tar.gz：主机 uuremote-server（X11 版）与控制端 uuremote-viewer（x86_64，glibc ≥ 2.35；控制端需 SDL2、GTK3、ffmpeg），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.2.0

新增实验性 Linux 控制端 uuremote-viewer。/ Experimental Linux viewer uuremote-viewer.

新增 / Added

• 🧪 原生控制端 uuremote-viewer（#36）：在 Linux 上用 UU 账号连接并控制其他设备——官方 Windows / Mac 被控端或本项目的 Linux 主机，
  也可凭对方的设备 ID 和验证码发起远程协助。包含启动窗口（设备列表）、桌面窗口（H.264 画面、键鼠、声音、文本剪贴板、只看模式）、
  文件传输、终端与终端会话列表、端口映射（只监听 127.0.0.1）、重启/关机。与主机 uuremote-server 相互独立，主机行为不变。
  • 使用：uuremote-viewer login 扫码登录，uuremote-viewer ui 打开启动窗口；命令行用法见 uuremote-viewer --help 和 README。
  • 运行依赖：GTK3、SDL2（Ubuntu/Debian libsdl2-2.0-0）、ffmpeg 命令；剪贴板需 xclip/xsel 或 wl-clipboard。
  • 与主机共用 ~/.config/uuremote/config.json（UU_CONFIG 可另指定），因此不能用同一身份连接本机上的主机。
  • 已实测：官方 Windows 被控端（画面、键鼠、文件列表与下载）、官方 Mac 被控端（画面）、本项目主机（画面、键鼠、文件、
    端口映射、终端；剪贴板、声音和远程协助在虚拟机中）。
  • ⚠️ 未实测：重启/关机、终端会话列表的新建与接回、Wayland 下的窗口与剪贴板、多显示器；只解码 H.264 4:2:0。
    这是实验性功能，欢迎反馈问题。
    An experimental viewer/controller for UU Remote hosts; the host build and behaviour are unchanged. See the README for usage,
    dependencies and the tested scope (reboot/shutdown, terminal session list and Wayland are not tested live).

下载 / Download

uu-remote-linux-v0.2.0-x86_64-linux.tar.gz：主机 uuremote-server（X11 版）与控制端 uuremote-viewer（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.31

GNOME 修改缩放后画面恢复更快。/ Faster capture recovery after GNOME display changes.

修复 / Fixed

• GNOME Wayland 改缩放后黑屏/停顿时间缩短（#27，感谢 @wanglz111，#35）：以前切换缩放（如 200% ↔ 166.67%）后，Portal 采集要等
  5 秒兜底才恢复。现在监听 Mutter 的显示配置变化通知，采集持续「暂停且无有效格式」超过 200 毫秒宽限即提前进入原有恢复流程；
  正常重协商会取消提前判定，连续切换只恢复一次，5 秒兜底保留。贡献者在 Ubuntu 26.04、GNOME 50、单屏 3840×2160 上实测：
  通知到会话恢复从约 6.2 秒降到约 1.4 秒。⚠️ 200 毫秒是在该机器上测得的初始值；官方客户端侧的画面恢复耗时、多屏、
  物理分辨率变化与旋转未验收。X11 与其他桌面不受影响。
  On GNOME, Mutter MonitorsChanged lets a stalled Portal capture recover after a 200 ms grace instead of the 5 s fallback
  (host-side recovery about 6.2 s → 1.4 s on the contributor's 4K display).

内部 / Internal

• CONTROL 生命周期单测改用虚拟网络，不再因本机网卡环境偶发超时。/ CONTROL lifecycle tests run on the virtual network.

下载 / Download

uu-remote-linux-v0.1.31-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.30

修复未登录（访客）远程协助时 X11 没有画面。/ Fix missing video during guest remote assistance on X11.

修复 / Fixed

• X11 访客远程协助无画面：未登录账号、以访客身份开启远程协助时，设备初始化过程会临时打开再关闭一次屏幕采集，
  把正在使用的 X11 连接一起关掉，日志出现 Live desktop stream stopped: X11 display wake failed，控制端连上后一直黑屏。
  现在 X11 连接按引用计数管理，只有最后一个采集对象释放时才关闭；X11 分辨率变化后重建采集也不再有同样的隐患。
  已在虚拟机（Xvfb 虚拟桌面）上实测：访客协助加入、画面、鼠标移动/点击、键盘均正常。⚠️ 未用官方客户端在真机上复测。
  Guest assistance on X11 no longer loses the display connection; video, mouse and keyboard verified in a VM.

下载 / Download

uu-remote-linux-v0.1.30-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.29

GNOME Wayland 锁屏时也能连接并自动解锁。/ Connect and auto unlock while GNOME Wayland is locked.

修复 / Fixed

• GNOME Wayland（Portal）锁屏冷连接（#28，感谢 @wanglz111，#30）：服务在已解锁时启动、随后锁屏，再从客户端连接时，
  以前因为 Portal 无法创建而整个连接被丢弃，无法远程自动解锁。现在先建立控制通道、上报锁屏状态并处理「自动解锁被控端」，
  Portal 就绪后再恢复画面、输入和剪贴板；锁屏期间不发画面、不注入桌面输入，并唤醒显示器（不会解锁）。
  官方 Mac 客户端已实机验证（锁屏 → 连接 → 自动解锁 → 画面和输入恢复）。
• iPhone 锁屏冷连接自动解锁（#29，感谢 @wanglz111，#34）：iPhone 4.42.0 要先收到视频帧才会发起自动解锁。Portal 等待就绪且
  确认锁屏时，主机每秒在已协商的视频轨上发一帧生成的黑画面（需 FFmpeg 带 libx264/libx265），解锁后由真实画面接续。
  贡献者用同一二进制做了 开→关→开 对照，iPhone 4.42.0 + H.265 实机通过；⚠️ H.264 手机实机、其他客户端版本、慢速中继未验收。
  黑帧不是真实锁屏画面，锁屏界面不能操作键鼠；未开启「自动解锁被控端」时无法远程解锁（控制中心 → 安全 → 自动解锁被控端）。
  Locked cold connections on GNOME Wayland now establish CONTROL first and support auto unlock (Mac verified); black video
  while locked lets iPhone 4.42.0 start auto unlock (H.265 verified by the contributor).
• 断开事件只关闭对应 ice_id 的连接，不再误关同时打开的文件传输、终端、端口映射连接。
  Releases close only the matching peer; tool peers stay open.
• X11 主机回归：控制通道处理改动后，已在 X11 + NVENC 主机上实测连接、Echo、锁屏状态上报和画面；画质切换由自动化测试覆盖。
  X11 host re-checked live (connection, Echo, lock state, video).

下载 / Download

uu-remote-linux-v0.1.29-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.28

编码探针支持固定输入，测试更稳定。/ Fixed-input encoder probe and deterministic WebRTC tests.

新增 / Added

• desktop-video-probe 支持固定输入（#9，感谢 @hiclaw 的建议）：设置 UU_PROBE_INPUT=<视频或图片序列>（如 clip.y4m、
  clip.mp4、frames/%05d.png）时不采集桌面，而是用与生产会话相同的 FFmpeg 编码参数（编码器、码率档、GOP、色度、缩放）
  编码该输入，消除桌面内容对测量的影响；UU_PROBE_LOOP=1 循环输入直到 UU_PROBE_FRAMES。输入打不开或帧数不足时非零退出。
  正常会话路径不变。已用 Y4M、MP4、PNG 序列验证，重复运行输出逐字节一致。⚠️ NVENC/VAAPI 下的固定输入未实机验证。
  desktop-video-probe can encode a fixed input (UU_PROBE_INPUT) with the production encoder arguments.

内部 / Internal

• 本地 WebRTC 单测改用虚拟网络，修复全量并行测试时偶发的 30 秒超时。/ Local WebRTC tests run on a virtual network.

下载 / Download

uu-remote-linux-v0.1.28-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.27

GNOME Wayland 连接中切换缩放后的停帧修复。/ Recover from live scaling changes on GNOME Wayland.

修复 / Fixed

• GNOME Wayland 连接中切换显示缩放后画面持续冻结（#25、#26，感谢 @wanglz111）：已推流的 Portal 流若「暂停且没有有效格式」
  持续 5 秒，复用现有会话恢复；恢复时允许逻辑尺寸变化，仍校验采集帧尺寸。启动阶段和静态画面不会触发这个超时，
  等待授权与 D-Bus 的过程不再占用输入锁。
  ⚠️ 贡献者实测：Ubuntu 26.04 + GNOME Wayland、单屏 3840×2160，连接中 200%→166.67%→200% 恢复后画面和全屏鼠标正常；
  切换时会短暂停顿、黑屏后恢复，并非无缝；5 秒是判定阈值，不是总恢复时间。物理分辨率变化、多屏、锁屏恢复未实机验证。
  Portal recovers after a live scale change (brief freeze/black, not seamless); physical resolution changes remain unsupported.
• Portal 失效检查出错时只记日志，不再让主机主循环退出。/ A failed Portal staleness check no longer ends the host loop.

下载 / Download

uu-remote-linux-v0.1.27-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。
GNOME/KDE Wayland 的 Portal 后端需自行用 --features wayland,portal 构建（需要 libei-dev ≥ 1.1）。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.26

大目录文件传输修复、上报实际刷新率、NVENC 省掉 CPU 颜色转换。/ Large-folder file transfer fix, real refresh rate, NVENC without CPU color conversion.

修复 / Fixed

• 文件传输打开文件很多的目录时一直转圈：目录回复同时带了未压缩和压缩两份列表，几千个文件时超过数据通道单条消息上限，
  回复被丢弃。现在压缩列表始终发送，未压缩副本只在放得下时附带；同时把 SCTP 发送上限从 64 KB 提到 256 KB
  （与官方控制端在 SDP 中声明的一致）。已在 5600 个文件的目录上实测。
  Large directory listings no longer exceed the data-channel message limit (verified with 5600 entries).

改进 / Improved

• 上报显示器实际刷新率（#16）：display_info、能力通知和编解码协商原先固定报 60，现在取当前显示模式
  （Hyprland 用 hyprctl，X11 用 xrandr；取不到时仍为 60，UU_DISPLAY_FPS 可手动指定）。
  The host reports the monitor's refresh rate instead of a fixed 60 (UU_DISPLAY_FPS overrides).
• NVENC 直接接收 BGRA/BGR0（#16）：4:2:0 且不缩放时，颜色转换交给 GPU，省掉 FFmpeg 子进程里的 CPU 转换；
  色彩标记与原来一致（BT.601 有限范围）。UU_NVENC_RGB=0 可恢复原路径。
  ⚠️ 已在 X11 + RTX 3090 上实测画面与颜色；Hyprland 4K 高帧率下的 CPU/帧率收益尚未实测。
  NVENC converts RGB on the GPU; verified on X11, the Hyprland 4K gain is not yet measured.

下载 / Download

uu-remote-linux-v0.1.26-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.25

GNOME Wayland 缩放下的鼠标修复。/ Pointer fix for scaled GNOME Wayland desktops.

修复 / Fixed

• GNOME Wayland 开启桌面缩放后，远程鼠标只能控制左上部分（#23、#24，感谢 @wanglz111）：Portal 后端在同一授权会话里
  改用 EIS 输入，按 mapping_id 匹配屏幕区域，并按实际帧尺寸映射坐标；缺少映射信息或 Portal 不支持 EIS 时保留原路径。
  日志不记录输入内容。X11、原生 wlroots 和 uinput 路径不变。
  ⚠️ 贡献者在此前的迭代上实测过 Ubuntu 26.04 / GNOME 50、单屏 4K、200% 缩放；最终提交、其他缩放比例、锁屏恢复、
  断线重连和多屏尚未实机验证。
  Portal input uses EIS regions mapped to the captured frame; the final commit and other scales are not yet hardware-verified.

构建 / Build

• --features wayland,portal 现在需要 libei >= 1.1 开发包（Debian/Ubuntu：libei-dev）。预编译的 X11 包不受影响。
  Portal builds now require libei >= 1.1.

下载 / Download

uu-remote-linux-v0.1.25-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.

v0.1.24

支持 Ubuntu 22.04 自带的 FFmpeg 4.4。/ Works with Ubuntu 22.04's FFmpeg 4.4.

改进 / Improved

• 自动适配 FFmpeg 版本（#22，感谢 @Guancheng-Li）：启动编码前检测所用 FFmpeg 支持的参数。FFmpeg 5 及以上继续使用
  -fps_mode vfr -enc_time_base 1/<fps>；FFmpeg 4.x（如 Ubuntu 22.04）改用 -vsync 0。检测失败时保持新版参数。
  FFmpeg 4.x 下采集卡顿后的补帧会全部编码（新版会丢弃），属于已知降级。贡献者已在 FFmpeg 4.4.2 上验证。
  The host probes the FFmpeg it uses and falls back to -vsync 0 only on FFmpeg 4.x; probe failures keep the modern arguments.

其他 / Other

• 新增几条只记结构的诊断日志（收到的 SOAC offer 结构、SDP 段落属性名、ice_id 是否一致），用于排查与官方控制端的互通，
  不记录 SDP 内容或任何 ID。
  Structure-only diagnostics for incoming offers (no SDP contents or ids).

下载 / Download

uu-remote-linux-v0.1.24-x86_64-linux.tar.gz：X11 版可执行文件（x86_64，glibc ≥ 2.35），附带 contrib/。

非官方项目，与网易无关。 / Unofficial, not affiliated with NetEase.