Linux

Linux 是完全支持的平台，并对 Steam Deck / SteamOS 的游戏模式给予了特别 关注。

文件系统访问

Linux 上没有应用沙盒 —— DeckCrate 拥有你普通用户的文件权限。

手柄访问权限

在 SteamOS 和其他游戏掌机上，手柄开箱即用 —— 无需任何配置。本节是为自定义的 桌面 Linux 安装准备的参考，适用于手柄未被检测到的情况。

在原版桌面发行版上，不使用 root 就使用手柄，需要把你的用户加入 input 组：

sudo usermod -aG input "$USER"
# log out and back in for the group to take effect

如果手柄提示栏始终不出现，请先检查这一点（groups | grep input）。DeckCrate 从内 核读取每个手柄的按钮映射，并按语义化的代码解析按钮，因此大多数手柄都能“直接可 用”。

Steam Deck 屏幕键盘

在 SteamOS 上，聚焦任何文本输入框 —— 搜索（Y）、重命名（X）或新建文件夹 —— 都会唤起 Steam 的浮动屏幕键盘，让你无需物理键盘也能输入。

不过，有些对话框会刻意不自动打开键盘 —— 例如服务器录入对话框和内嵌的终 端。在这些界面中，等你准备好输入时按 X 来调出屏幕键盘。这是有意为之：这些界 面可能在你并不打算输入时就获得焦点，而键盘浮层自行弹出会遮住屏幕、打断使用体验。

Steam Input（重映射、背键与陀螺仪）

当你通过 Steam 启动 DeckCrate 时，它会经由 Steam Input 读取你的手柄 —— 也就是在 Steam 浮层中为每款游戏提供手柄配置的那一层。这意味着你可以重新绑定任何 控制，包括背部拨片、触摸板和陀螺仪，DeckCrate 都会遵循这些设置。

DeckCrate 附带了一份操作清单，描述它能做什么 —— 打开、返回、复制、粘贴、移 动、搜索等等 —— 因此当你在 Steam 中编辑手柄布局时，这些操作会按名称显示出来。选择 或创建一份使用它们的配置，Steam Input 就会接管；此时屏幕上的手柄面板（在调试版本 中）会显示一行 Steam Input，其值为 active。

如果你在 Steam 之外启动，或者你的手柄使用的是普通的手柄模板，DeckCrate 会直接回退 到直接读取手柄 —— 一切照常运转，和其他地方毫无二致。Steam Input 是给 Steam/Deck 用户的额外加成，绝非必需品。

Steam 浮层与快捷访问

在游戏模式下，只要 Steam 自己的面板处于打开状态，DeckCrate 就会忽略手柄——快捷 访问菜单、Steam 菜单和电源菜单都是如此。在这些面板中操作，绝不会移动其背后文件列表 的选中项，也不会触发任何操作；面板一关闭，控制权立即回到应用。用来关闭面板的那次 按键只作用于面板本身，不会同时作用于 DeckCrate。

无论你以何种方式启动应用、使用哪种手柄布局，都是如此。在掌机游戏模式之外——桌面 模式、普通 Linux 桌面、macOS 或 Windows——并不存在这些面板，因此没有任何变化。

网络共享（SMB）

Linux 通过 GVFS 挂载 SMB 共享，无需 root 授权提示，但需要安装 GVFS 的 SMB 后端和 FUSE 桥接。一次性的软件包安装和验证步骤参见 网络共享。