常见问题

本页汇总 HagiCode 文档中的常见问题、运行说明与排障入口。

当前 FAQ 重点覆盖 Desktop 的平台启动兼容策略，以及 Desktop 自带 Node 工具链的用途、隔离方式和排查边界。

当前 FAQ 条目

Steam Linux 启动注意事项 了解默认 Steam 启动为何使用 no-sandbox 兼容参数、这带来的安全权衡，以及如何手动直启 hagicode-desktop 保留 Electron 默认沙箱。

Desktop Node 环境说明 了解 Desktop 为什么内置 Node.js、运行时如何优先使用内置 Node 路径，以及它为什么不会替换你的系统 Node。

这个分区会放什么

FAQ 分区用于集中收纳以下内容：

• 启动和运行时的特殊说明
• 与平台、发行渠道、打包方式或内置运行时相关的兼容性提示
• 适合做成独立说明页的常见排障入口

如果你当前遇到的是 Steam for Linux 下的启动问题，请直接阅读 Steam Linux 启动注意事项。如果你想确认 Desktop 使用哪个 Node，或为什么诊断里出现 portable-fixed/toolchain，请阅读 Desktop Node 环境说明。