Steam Linux 启动注意事项
编辑此页如果你通过 Steam for Linux 启动 HagiCode Desktop，默认启动路径会优先保证应用能稳定启动，而不是优先保留 Electron 的默认沙箱保护。
这不是更理想的长期技术方案，而是当前为了避开 Steam 沙箱与 Electron 沙箱冲突所采用的兼容性默认值。
目前可以把启动方式理解成两个选项：
- Steam 默认启动：兼容性优先，默认附带
--disable-setuid-sandbox -no-sandbox，更容易避免启动崩溃，但不会保留 Electron 默认沙箱。 - 手动直启
hagicode-desktop：需要你进入实际安装目录自行启动二进制文件，不走 Steam 默认启动参数，因此可以保留 Electron 默认沙箱。
为什么 Steam 默认启动会关闭 Electron 沙箱
Section titled “为什么 Steam 默认启动会关闭 Electron 沙箱”在 Steam for Linux 环境里，Steam 本身会带来一层自己的沙箱约束。HagiCode Desktop 作为 Electron 应用启动时，如果继续按默认方式启用 Electron 沙箱，当前实现下可能出现沙箱冲突并导致启动失败或直接崩溃。
因此，当前默认 Steam 启动路径会附带 --disable-setuid-sandbox -no-sandbox。这样做的目标很明确：
- 优先让应用在 Steam 环境中成功启动
- 避免用户一启动就遇到崩溃
- 以兼容性默认值替代尚未解决的更理想技术方案
启动选项 A：使用 Steam 默认启动
Section titled “启动选项 A：使用 Steam 默认启动”如果你的首要目标是“直接从 Steam 点开就能正常进入应用”，那就继续使用 Steam 默认启动方式。
它的特点是：
- 最贴近当前发布包的默认使用路径
- 不需要额外查找安装目录
- 会自动沿用当前兼容性参数
--disable-setuid-sandbox -no-sandbox - 代价是 Electron 默认沙箱不会保留
这种方式适合：
- 想保持 Steam 内一键启动体验的用户
- 更在意先稳定进入应用的用户
- 暂时不准备手动管理启动命令的用户
启动选项 B：手动直启 hagicode-desktop
Section titled “启动选项 B：手动直启 hagicode-desktop”如果你更在意保留 Electron 默认沙箱，可以不要通过 Steam 的默认启动入口，而是直接启动安装目录中的 hagicode-desktop 可执行文件。
操作原则如下：
- 找到 Steam 库中 HagiCode Desktop 的实际安装目录
- 进入包含
hagicode-desktop二进制文件的目录 - 直接运行
hagicode-desktop - 不通过 Steam 默认“启动游戏/应用”按钮触发这次启动
可以用这个判断方式：
- 如果你优先要“从 Steam 里稳定打开”，选 Steam 默认启动
- 如果你优先要“保留 Electron 默认沙箱”，选 手动直启
hagicode-desktop
本质上，这是“兼容性默认值”和“保留默认沙箱”的取舍，不是哪个方案对所有人都绝对更好。