企业官网建设流程全解析

想让 Linux 眼镜（AR/XR 眼镜）变成一台真正的"随身多屏工作站"吗？开源项目Breezy Desktop正是为此而生——它为 GNOME 桌面提供 XR 虚拟桌面扩展，让你的眼镜显示不再只是主屏幕的镜像，而是可以承载多块虚拟显示器 + 物理显示器的沉浸式 XR 多屏工作区。本教程将带你从零完成 Breezy Desktop 的 GNOME 安装、启用 XR 效果、添加虚拟显示器，并调出最舒服的观看距离与布局。

Breezy Desktop 是什么？为什么选择 GNOME 版

Breezy Desktop 是一组用于 Linux 的工具集，核心能力是：

• XR 虚拟桌面：把桌面画面渲染进眼镜，支持 3DoF（头部朝向）跟随，像站在大屏前一样工作
• 虚拟多显示器：在物理屏幕之外，凭空"生成" 1080p、1440p 或自定义分辨率的虚拟屏
• 沉浸调节项：显示距离、大小、曲面屏、跟随模式、多屏环绕角度等
• 双桌面支持：KDE Plasma 6（KWin 效果）与 GNOME 45–51（Shell 扩展），本教程聚焦 GNOME

⚠️ 使用前请确认：你的眼镜在 XRLinuxDriver 支持设备列表 中且固件为最新；GNOME 必须运行在 Wayland 会话（Xorg 下无法启动虚拟显示器）；XREAL Ones 等带内置 3DoF 的眼镜需先在眼镜菜单中关闭内置稳定/锚定功能。

安装前的 3 个关键检查 ✅

1. 确认 Wayland：登录界面选择 GNOME on Wayland 会话，X11会话无法创建虚拟显示器
2. 眼镜显示模式：首次连接眼镜时打开Displays设置，选择Join（扩展工作区），而不是镜像
3. 拔掉眼镜安装：按官方建议，安装脚本执行时保持眼镜未连接

一键安装：Breezy GNOME 两步搞定

方式一：官方脚本安装（推荐新手）

1. 下载 Breezy GNOME 安装脚本breezy_gnome_setup，并赋予执行权限：

   chmod +x ~/Downloads/breezy_gnome_setup

2. 运行脚本，等待安装完成：

   ~/Downloads/breezy_gnome_setup

3. 注销并重新登录（至少一次），让 GNOME 扩展生效

方式二：Arch 用户通过 AUR 安装

yay -S breezy-desktop-gnome-git systemctl --user enable --now xr-driver.service

安装后系统中会出现名为Breezy Desktop的应用。首次试用免输 Token：安装完成后上线一次即可自动激活 2 个月的免费试用期（之后需要 Productivity 许可证才能继续使用生产力功能）。

启用 XR 效果：进入沉浸工作区

GNOME 侧的核心是一个 Shell 扩展（见 extension.js，扩展元数据在 metadata.json）。它在启用时会自动完成这些工作：

• 启动设备数据流，监听眼镜姿态数据（devicedatastream.js）
• 接管显示器配置：自动选择最优分辨率/刷新率、可自动关闭物理屏（monitormanager.js）
• 注册 5 个默认键盘快捷键

XR多屏工作区中的显示距离校准纹理

启用步骤：

1. 从应用菜单启动Breezy Desktop应用（基于 GTK4 构建，主逻辑见 ui/src/main.py）
2. 按提示完成验证（应用会依次检查扩展、驱动、许可证、设备连接，见 ui/src/window.py）
3. 插上眼镜，在General Settings标签页打开XR effect开关 —— 物理屏幕熄灭，眼前出现悬浮的虚拟桌面
4. 再次拨动开关（或按快捷键）即可恢复普通桌面

💡 Breezy Desktop 应用不需要一直开着：XR 效果和快捷键由扩展接管，关掉应用也能正常使用。

一键添加虚拟显示器：打造真正的"多屏"

在 General Settings 的Virtual displays行中，选择分辨率并点击+按钮，即可凭空创建一块虚拟显示器：

• 1080p/1440p/Add custom（自定义分辨率，对话框实现见 customresolutiondialog.py）
• 虚拟显示器管理逻辑位于 virtualdisplaymanager.py
• 多块屏幕就位后，可用Rearrange displays跳转到系统显示设置调整排列

调节沉浸感：距离、大小与跟随模式

Adjustments区域是调校沉浸感的核心（界面定义见 connected-device.ui）：

配合General Settings中的四个功能开关，基本体验就完整了：

• Zoom on focus：注视哪块屏，哪块屏自动拉近
• Follow mode：让当前聚焦屏始终保持在视野中心
• Curved display：平面 ↔ 曲面屏切换（弯曲渲染在 Sombrero.frag 中完成）
• Disable physical displays：启用 XR 效果时自动关闭物理屏（默认开启）

键盘快捷键：免应用快捷操作清单

所有快捷键都可在 Breezy Desktop 应用的Keyboard Shortcuts标签页中重新绑定（绑定逻辑见 shortcutdialog.py），默认值定义在 com.xronlinux.BreezyDesktop.gschema.xml：

进阶玩家还可以在Advanced Settings中调整最高刷新率（use-highest-refresh-rate）、宽屏 SBS 模式（widescreen-mode）、帧率上限、IMU 姿态修正（倒置 X/Y/Z 轴、俯仰角偏移）等参数，全部键值定义可查阅 com.xronlinux.BreezyDesktop.gschema.xml。

常见问题与卸载指南 🛠️

Q：应用里显示"未安装扩展"？确认注销重登过；仍不生效可重启一次 Shell（Alt + F2输入r，仅 Xorg 可用，Wayland 下直接重启系统）。

Q：虚拟显示器不出现？检查是否运行在 Wayland 会话；Steam Deck 用户需先在登录界面切换到 Wayland 会话。

Q：文字发虚、显示太大？把Display size调到 0.9–1.0×，并适当增大显示距离。

卸载（如不再需要）：

# 脚本安装的用户 ~/.local/bin/breezy_gnome_uninstall # AUR 安装的用户 pacman -R breezy-desktop-gnome-git

结语

至此，你已经用 Breezy Desktop 在 GNOME 上搭建好了属于自己的 XR 多屏工作区：眼镜里是无限延展的虚拟屏幕，物理屏随时待命，快捷键一按即"入"即"出"。后续可以试着添加两块 1080p 虚拟屏 + 启用 Zoom on focus，体验"低头看文档、抬眼回聊天"的悬浮工作流——这正是 XR 生产力的乐趣所在。