3.2. Cài đặt ứng dụng

Cài đặt Naia dưới dạng một ứng dụng độc lập trên hệ điều hành hiện có của bạn. Tất cả các tệp cài đặt đều có sẵn trên trang Tải xuống hoặc itch.io.

Windows (Khuyến nghị — Trình cài đặt)

Yêu cầu hệ thống

• OS: Windows 10 / Windows 11 (x64)
• Runtime: WebView2 (tự động có sẵn nếu đã cài Edge)

Cài đặt

1. Tải Naia-Shell-x86_64-setup.exe từ trang tải xuống
2. Nhấp đúp vào tệp để khởi chạy trình cài đặt
3. Chọn ngôn ngữ (Hàn Quốc/Tiếng Anh) và làm theo hướng dẫn
4. Khởi chạy Naia từ màn hình nền hoặc menu Start

Tự động cập nhật: Khi có phiên bản mới, thông báo sẽ xuất hiện. Xác nhận để cập nhật tự động.

Gói MSI (Dành cho quản trị viên IT)

Để triển khai doanh nghiệp hoặc cài đặt qua Group Policy, sử dụng gói .msi:

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

Linux (Flatpak khuyến nghị)

Yêu cầu hệ thống

• Hệ điều hành: Linux (Ubuntu, Fedora, Bazzite, v.v.)
• Màn hình: Wayland (khuyên dùng) hoặc X11
• Cài đặt Flatpak không yêu cầu thiết lập môi trường thời gian chạy bổ sung.

Flatpak (Khuyên dùng)

Cách cài đặt an toàn nhất. Ứng dụng chạy trong không gian riêng biệt, hệ thống của bạn sẽ luôn sạch sẽ.

Tải gói .flatpak từ trang Tải xuống và cài đặt qua terminal:

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

Cách hoạt động: Naia chạy trong không gian cô lập để đảm bảo an toàn. Khi AI cần điều khiển PC của bạn, nó chỉ yêu cầu các quyền cần thiết.

Các định dạng khác

AppImage, DEB (Debian/Ubuntu) và RPM (Fedora/RHEL) cũng có sẵn trên trang Tải xuống.

(Dành cho nhà phát triển) Hướng dẫn xây dựng Flatpak cục bộ

Để xây dựng ứng dụng sandbox Flatpak từ mã nguồn, hãy làm theo các bước sau:

1. Cài đặt Flatpak Builder

   Copy

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

2. Thêm phụ thuộc xây dựng (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. Chạy bản dựng đóng gói Thực thi lệnh này trong thư mục gốc của dự án (Naia-OS).

   Copy

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

4. Chạy ứng dụng

   Copy

   flatpak run com.naia.shell
   

Lưu ý dành cho nhà phát triển: Để thao tác môi trường máy chủ của người dùng từ bên trong sandbox Flatpak, tác nhân AI nội bộ sẽ gói tất cả các yêu cầu công cụ execute_command bằng flatpak-spawn --host bash -c ... trong agent/src/gateway/tool-bridge.ts.