U远程 · 星栈远程控制插件

U远程是 星栈（AsterDock） 的原生轻应用插件，提供设备列表、远程桌面、本机被控、远程终端和文件传输功能。

本项目是插件，需要在星栈中使用，不提供独立桌面应用。 此仓库用于维护插件源码；首次使用请先前往星栈项目。

界面预览

当前界面采用左侧本机被控／远程协助面板、中间设备桌面预览卡片和右侧导航，支持网格与列表切换、搜索、收藏及深浅主题。

上图于 2026-10-15 使用当前界面代码渲染，设备名称、壁纸、屏幕缩略图和协助码均为演示数据，不包含真实账号或远控凭据。左侧被控状态与标题同行，验证码使用显隐、刷新与复制图标，设备卡片底栏显示功能图标。实际设备预览使用上传的桌面壁纸，并非实时视频。

查看 UI 设计参考图

设计图中的设备、壁纸和协助码为示例，实际功能及显示以插件为准。

开始使用

1. 前往 星栈项目首页，按其说明安装并启动星栈。发布版本可在 星栈 Releases 查看。
2. 在星栈的轻应用列表中打开 U远程。如果所用版本已包含此插件，无需重复安装。
3. 在插件的“账号与设置”中完成登录，再从“我的设备”发起远程连接，或在“本机被控”中管理共享与控制权限。

插件下载：前往 U远程 Releases，下载 AsterDock-App-u-remote.appbundle，通过星栈的应用包安装入口导入。请勿同时保留同一插件的旧目录副本。源码开发者也可按下方说明构建模块。

功能与运行条件

必须安装 FFmpeg 9.0.0 或更高版本，并确保包含 libx264 编码器。主控与被控端均需满足此要求。 可运行 ffmpeg -version 查看版本；在 U远程“账号与设置 → 高级设置”中可填写 FFmpeg 可执行文件的完整路径，并点击“验证并应用”。

• 设备壁纸预览、网格／列表切换、搜索与收藏；点击预览在独立视窗打开远程桌面。
• 卡片底栏提供文件传输与终端入口。终端支持命令输入和 Ctrl+C，暂不支持全屏终端程序；文件窗口支持目录浏览、单文件上传下载、进度与取消。端口映射、远程开机尚未实现，入口置灰。
• Linux / Wayland 本机被控，包含多屏、键鼠、远程终端及文件传入/取出。
• macOS 本机被控，使用原生 ScreenCaptureKit 屏幕采集与键鼠输入，支持设备上线、壁纸预览和桌面快捷操作。
• 本机被控与远程协助开关；本机手动关闭被控的状态会保存。
• 显示器变化及部分网络、采集故障自动重试。

Linux 本机被控需要已登录的 Wayland 桌面及带 libx264 的 FFmpeg 9.0.0 或更高版本。niri 使用 wlr-screencopy 和虚拟键鼠协议；KDE Plasma / GNOME 使用原生桌面 Portal / PipeWire 对接，需要对应桌面的 Portal 实现及 GStreamer / PipeWire 原生库，不再依赖 Python 3 / PyGObject。详见 本机依赖与配置。Linux 系统声音需要 PipeWire/pw-cat，文本剪贴板需要 wl-clipboard。

macOS 本机被控需要在系统设置中授予星栈“屏幕录制”和“辅助功能”权限，并配置 FFmpeg 9.0.0 或更高版本（含 libx264）。macOS 系统声音、触控及被控远程终端尚未实现；Windows 本机被控后端尚未实现。

声音、剪贴板、跨客户端兼容性及长期稳定性仍需验证。文件接收目录为 ~/Downloads/uurc。不提供虚拟显示器，无登录桌面或系统休眠时不保证远控可用。

更多细节见 功能与验证说明 和 无人值守说明。无人值守文档中的服务配置描述开发机部署，安装插件不会自动安装系统服务。

已验证环境

系统版本	桌面环境	会话类型	已验证范围
NixOS 26.11（Zokor，x86_64；Linux 7.2.5）	niri 26.04	Wayland	Windows / iOS 客户端连接本机、桌面传屏与键鼠控制、多屏画面及切屏、远程终端；本机主控通过外网连接 Windows，画面与键鼠正常
Ubuntu 26.04.1 LTS（Kubuntu 桌面）	KDE Plasma 6.6.6	Wayland	桌面环境识别、Portal 授权与连续画面采集、键鼠接口、取消采集后保持共享、关闭会话，以及主题默认壁纸预览
macOS 26.5（arm64）	macOS 桌面；Mac mini，Apple M4（Mac16,10）	本机图形会话	账号登录与设备上线、原生屏幕采集与键鼠控制、刷新率读取、当前壁纸识别与预览上传；不含系统声音、触控及被控远程终端

以上仅代表各行列出的实际验证范围，不代表所有客户端组合、声音、双向剪贴板及长期稳定性均已验证。NixOS / niri 一行汇总此前本机联调结果；Linux 环境信息核对于 2026-09-30；Mac mini 一行依据 2026-10-15 的实机联调结果补充，本次文档更新未重新执行完整功能回归。GNOME 尚待实测；后续环境验证通过后会补充到此表。

插件开发

使用 .NET 10 SDK：

dotnet restore URemote.slnx
dotnet build URemote.slnx -c Release --no-restore -m:1
dotnet run --project tests/URemote.ProtocolChecks -c Release --no-build

可执行 python3 scripts/package.py 生成 .appbundle 和 SHA-256 校验文件，输出位于 artifacts/release/。

构建后，将 src/URemote.Module/bin/Release/net10.0/ 的完整内容放入星栈的 Apps/URemote/ 目录，保留插件清单、依赖和第三方声明。运行界面需要星栈宿主；仓库中的 CLI 仅用于开发诊断。

项目	用途
URemote.Core	登录、设备、信令及控制协议
URemote.Linux	Wayland 采集、输入、PTY 与系统信息
URemote.Media	WebRTC、H.264 与系统音频
URemote.Host	会话管理和开发诊断
URemote.Module	星栈轻应用界面与远控窗口
AsterDock.Contracts	星栈插件接口
tests	协议、媒体及集成检查

本仓库从星栈提交 2f71522 拆出，可独立构建插件。依赖完整星栈宿主的 DesktopCheck 保留在星栈仓库。

第三方声明

第三方来源、许可证和依赖使用条件见 THIRD-PARTY-NOTICES 及其链接的许可证文件。请随插件保留这些声明。