3.2. 应用安装

将 Naia 作为独立应用程序安装到您现有的操作系统上。所有安装文件均可在 下载页面 或 itch.io 上获取。

Windows（推荐 — 安装程序）

系统要求

• OS: Windows 10 / Windows 11 (x64)
• 运行时: WebView2（已安装 Edge 则自动包含）

安装步骤

1. 从下载页面下载 Naia-Shell-x86_64-setup.exe
2. 双击文件启动安装向导
3. 选择语言（韩语/英语）并按提示操作
4. 从桌面或开始菜单启动 Naia

自动更新: 应用运行时若有新版本发布，将显示通知，确认后自动更新。

MSI 安装包（IT 管理员）

企业部署或组策略安装请使用 .msi 包：

msiexec /i Naia-Shell-x86_64.msi /quiet

Linux（推荐 Flatpak）

系统要求

• 操作系统： Linux (Ubuntu, Fedora, Bazzite 等)
• 显示器： Wayland（推荐）或 X11
• Flatpak 安装无需额外的运行时设置。

Flatpak（推荐）

最安全的安装方式。应用程序在其独立的沙盒空间中运行 — 您的系统保持洁净。

从下载页面下载 .flatpak 捆绑包并通过终端安装：

flatpak install --user ./Naia-Shell-x86_64.flatpak

工作原理： Naia 在独立的沙盒空间中运行以确保安全。当 AI 需要控制您的电脑时，它只会请求必要的权限。

其他格式

AppImage、DEB (Debian/Ubuntu) 和 RPM (Fedora/RHEL) 也可在下载页面上获取。

（面向开发者）本地 Flatpak 构建指南

要从源代码构建 Flatpak 沙盒应用程序，请遵循以下步骤：

1. 安装 Flatpak Builder

   Copy

   # Fedora / Bazzite
   sudo dnf install flatpak-builder
   
   # Ubuntu
   sudo apt install flatpak-builder
   

2. 添加构建依赖项 (SDK)

   Copy

   flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
   flatpak install --user flathub org.gnome.Platform//50 org.gnome.Sdk//50 org.freedesktop.Sdk.Extension.rust-stable//25.08 org.freedesktop.Sdk.Extension.node22//25.08 org.freedesktop.Sdk.Extension.llvm20//25.08
   

3. 运行打包构建 在项目根目录 (Naia-OS) 中执行此操作。

   Copy

   # Compiles and builds into the build-dir
   flatpak-builder --user --install --force-clean build-dir flatpak/io.nextain.naia.yml
   

4. 运行应用程序

   Copy

   flatpak run com.naia.shell
   

开发者注意： 为了从 Flatpak 沙盒内部操作用户的主机环境，AI 代理在 agent/src/gateway/tool-bridge.ts 中，将所有 execute_command 工具请求内部包装为 flatpak-spawn --host bash -c ...。