# دليل المستخدم باللغة العربية

<p align="center">
	<img src="https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/icons/nekro-agent-toolkit-icons.png" alt="Nekro Agent Toolkit吉祥物">
</p>

Nekro Agent Toolkit هي أداة شاملة لنشر، نسخ احتياطي، واستعادة Nekro Agent والخدمات ذات الصلة، مع دعم الأتمتة في بيئات Docker.

## 🌐 روابط إلى لغات أخرى

| [Read in English](https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/doc/README/README-EN.md) | [اقرأ باللغة العربية](https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/doc/README/README-AR.md) | [Lire en français](https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/doc/README/README-FR.md) | [Читать на русском](https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/doc/README/README-RU.md) | [Leer en español](https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/doc/README/README-ES.md) | [日本語で読む](https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/doc/README/README-JP.md) |

## ✨ الميزات الرئيسية

- تثبيت، ترقية، نسخ احتياطي، واستعادة Nekro Agent بنقرة واحدة
- الكشف الذكي ودعم متعدد اللغات
- دعم النسخ الاحتياطي والاستعادة التلقائية لأحجام Docker

## 🚀 الاستخدام السريع

### التثبيت

```bash
pip install nekro-agent-toolkit
# أو تشغيل من المصدر
git clone https://github.com/your-repo/nekro-agent-toolkit.git
cd nekro-agent-toolkit
```

### الأوامر الشائعة

```bash
# تثبيت/ترقية/نسخ احتياطي/استعادة
nekro-agent-toolkit -i [PATH]
nekro-agent-toolkit -u [PATH]
nekro-agent-toolkit -b [DATA_DIR] BACKUP_DIR
nekro-agent-toolkit -r BACKUP_FILE [DATA_DIR]
```

### إدارة التبعيات باستخدام uv (موصى به)

يدعم هذا المشروع الآن استخدام `uv` لإدارة التبعيات وإنشاء ملفات قفل قابلة لإعادة الإنتاج `uv.lock`.

## معلومات إضافية

- متطلبات النظام: Python 3.6+، Docker، Docker Compose
- الترخيص: انظر [LICENSE](https://cdn.jsdelivr.net/gh/greenhandzdl/nekro-agent-toolkit@main/LICENSE)