3.2. تثبيت التطبيق

قم بتثبيت Naia كتطبيق مستقل على نظام التشغيل الموجود لديك. تتوفر جميع ملفات التثبيت على صفحة التنزيل أو itch.io.

Windows (موصى به — برنامج التثبيت)

متطلبات النظام

• نظام التشغيل: Windows 10 / Windows 11 (x64)
• وقت التشغيل: WebView2 (يُدرج تلقائياً إذا كان Edge مثبتاً)

طريقة التثبيت

1. حمّل Naia-Shell-x86_64-setup.exe من صفحة التنزيل
2. انقر نقراً مزدوجاً على الملف لتشغيل معالج الإعداد
3. اختر لغتك (كورية/إنجليزية) واتبع التعليمات
4. شغّل Naia من سطح المكتب أو قائمة ابدأ

التحديث التلقائي: عند إصدار نسخة جديدة، ستظهر إشعاراً. وافق للتحديث تلقائياً.

حزمة MSI (لمسؤولي تقنية المعلومات)

للنشر المؤسسي أو التثبيت عبر نهج المجموعة، استخدم حزمة .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 في مساحة معزولة للسلامة. عندما يحتاج الذكاء الاصطناعي إلى التحكم في جهاز الكمبيوتر الخاص بك، فإنه يطلب الأذونات الضرورية فقط.

تنسيقات أخرى

AppImage، و DEB (Debian/Ubuntu)، و RPM (Fedora/RHEL) متوفرة أيضًا على صفحة التنزيل.

(للمطورين) دليل بناء Flatpak المحلي

لبناء تطبيق Flatpak sandbox من الشفرة المصدرية، اتبع الخطوات التالية:

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 sandbox، يقوم وكيل الذكاء الاصطناعي داخليًا بتغليف جميع طلبات أداة execute_command باستخدام flatpak-spawn --host bash -c ... في agent/src/gateway/tool-bridge.ts.