📘 دليل استخدام دليل الواجب

👋 مرحباً بالأهل الكرام

هذا الدليل سيساعدكم على تجهيز تطبيق "دليل الواجب" لأطفالكم. التطبيق مجاني ويعمل عبر الذكاء الاصطناعي، ولكن يحتاج إلى مفتاح API من Google ليعمل. لا تقلقوا، الأمر بسيط!

🔑 الخطوة 1: الحصول على مفتاح API مجاني من Google

1. اذهبوا إلى موقع Google AI Studio.

2. سجلوا الدخول بحساب Google (يمكنكم إنشاء حساب مجاني إذا لم يكن لديكم).

3. اضغطوا على زر "Create API Key" (إنشاء مفتاح API).

4. سيظهر لكم مفتاح طويل مثل: AIzaSyBmXyP7.... انسخوه.

🔑 مثال: AIzaSyAoAd5BjCY3SPAhQlOduNezucJ-Wz9LV2E

🔒 هذا المفتاح مجاني ويتيح 60 طلباً في الدقيقة، وهو كافٍ تماماً للاستخدام العائلي.

⚙️ الخطوة 2: إدخال المفتاح في التطبيق

1. افتحوا التطبيق عبر الرابط الذي وصلكم.

2. في أعلى الصفحة، بجانب العنوان، ستجدون أيقونة ترس . اضغطوا عليها.

3. ستظهر لوحة الإعدادات. في الحقل الأول، الصقوا المفتاح الذي نسختموه.

4. يمكنكم ترك باقي الإعدادات كما هي (نموذج Gemini 2.5 Flash هو الأنسب).

5. اضغطوا على الترس مرة أخرى لإخفاء اللوحة (اختياري).

✅ الآن التطبيق جاهز للاستخدام!

🧒🏻 كيفية استخدام الطفل للتطبيق

1. يختار الطفل اللغة المناسبة من القائمة المنسدلة في الأعلى (بجانب الترس).

2. يكتب سؤاله في المربع الكبير (مثلاً: "كيف أحسب مساحة المستطيل؟") أو يضغط على "اختر صورة" لتصوير المسألة من الكتاب.

3. يضغط على زر "🔍 ابدأ المحادثة".

4. سيظهر رد المدرس الذكي مع تلميحات. الطفل يحاول الإجابة، ويكتب إجابته في الحقل السفلي ثم يضغط "إرسال".

5. تستمر المحادثة حتى يصل الطفل إلى الحل الصحيح. عندها ستظهر شخصية كرتونية لطيفة مع رسالة تشجيعية (مثل: "أحسنت! اشرب الماء").

6. يمكن البدء بسؤال جديد بالضغط على "🔄 بداية جديدة".

ملاحظة: عداد الرصيد الموجود في لوحة الإعدادات يساعدكم على متابعة عدد الطلبات المتبقية في الدقيقة (الحد الأقصى 60). هذا مجرد تقدير محلي، لكنه مفيد لتنظيم الاستخدام.

👋 Hello dear parents

This guide will help you set up the "Homework Guide" app for your children. The app is free and uses AI, but it requires a free API key from Google. Don't worry, it's simple!

🔑 Step 1: Get a free API key from Google

1. Go to Google AI Studio.

2. Sign in with your Google account (you can create a free account if you don't have one).

3. Click "Create API Key".

4. You'll see a long key like: AIzaSyBmXyP7.... Copy it.

🔑 Example: AIzaSyAoAd5BjCY3SPAhQlOduNezucJ-Wz9LV2E

🔒 This key is free and allows 60 requests per minute, which is enough for family use.

⚙️ Step 2: Enter the key in the app

1. Open the app via the link you received.

2. At the top, next to the title, you'll find a gear icon . Click it.

3. The settings panel will appear. Paste your key into the first field.

4. You can leave other settings as they are (Gemini 2.5 Flash is recommended).

5. Click the gear again to hide the panel (optional).

✅ Now the app is ready to use!

🧒🏻 How your child can use the app

1. The child selects their language from the dropdown menu at the top (next to the gear).

2. They type their question in the big box (e.g., "How do I calculate the area of a rectangle?") or click "Choose file" to take a picture of the problem.

3. They press the "🔍 Start conversation" button.

4. The AI teacher will respond with hints. The child tries to answer, types their answer in the bottom field, and clicks "Send".

5. The conversation continues until the child reaches the correct answer. Then a cute cartoon character appears with an encouraging message (like "Great job! Drink water").

6. They can start a new question by pressing "🔄 New start".

Note: The credit counter in the settings panel helps you track how many requests are left in the current minute (max 60). This is a local estimate, but it's useful for managing usage.

👋 Вітаємо, шановні батьки

Цей посібник допоможе вам налаштувати додаток "Довідник з домашніх завдань" для ваших дітей. Додаток безкоштовний і використовує ШІ, але для роботи потрібен безкоштовний ключ API від Google. Не хвилюйтеся, це просто!

🔑 Крок 1: Отримайте безкоштовний ключ API від Google

1. Перейдіть на сайт Google AI Studio.

2. Увійдіть у свій обліковий запис Google (можна створити безкоштовний, якщо його немає).

3. Натисніть "Create API Key" (Створити ключ API).

4. Ви побачите довгий ключ, наприклад: AIzaSyBmXyP7.... Скопіюйте його.

🔑 Приклад: AIzaSyAoAd5BjCY3SPAhQlOduNezucJ-Wz9LV2E

🔒 Цей ключ безкоштовний і дозволяє 60 запитів на хвилину, чого достатньо для сімейного використання.

⚙️ Крок 2: Введіть ключ у додаток

1. Відкрийте додаток за отриманим посиланням.

2. Вгорі, поруч із заголовком, ви знайдете значок шестірні . Натисніть його.

3. З'явиться панель налаштувань. Вставте ваш ключ у перше поле.

4. Інші налаштування можна залишити як є (рекомендується Gemini 2.5 Flash).

5. Натисніть шестірню знову, щоб приховати панель (не обов'язково).

✅ Тепер додаток готовий до використання!

🧒🏻 Як дитина може користуватися додатком

1. Дитина обирає мову зі списку вгорі (біля шестірні).

2. Вона вводить своє запитання у велике поле (наприклад, "Як обчислити площу прямокутника?") або натискає "Вибрати файл", щоб сфотографувати завдання.

3. Натискає кнопку "🔍 Почати розмову".

4. Учитель-ШІ відповідає підказками. Дитина намагається відповісти, вводить свою відповідь у нижнє поле та натискає "Надіслати".

5. Розмова триває, поки дитина не дійде до правильної відповіді. Тоді з'являється милий мультяшний персонаж із підбадьорливим повідомленням (наприклад, "Молодець! Випий води").

6. Можна почати нове питання, натиснувши "🔄 Новий початок".

Примітка: Лічильник кредитів на панелі налаштувань допомагає відстежувати, скільки запитів залишилося в поточну хвилину (максимум 60). Це локальна оцінка, але вона корисна для контролю використання.

👋 Përshëndetje prindër të dashur

Ky udhëzues do t'ju ndihmojë të vendosni aplikacionin "Udhëzuesi i Detyrave" për fëmijët tuaj. Aplikacioni është falas dhe përdor AI, por kërkon një çelës API falas nga Google. Mos u shqetësoni, është e thjeshtë!

🔑 Hapi 1: Merrni një çelës API falas nga Google

1. Shkoni te Google AI Studio.

2. Hyni me llogarinë tuaj Google (mund të krijoni një llogari falas nëse nuk e keni).

3. Klikoni "Create API Key" (Krijo çelës API).

4. Do të shihni një çelës të gjatë si: AIzaSyBmXyP7.... Kopjojeni.

🔑 Shembull: AIzaSyAoAd5BjCY3SPAhQlOduNezucJ-Wz9LV2E

🔒 Ky çelës është falas dhe lejon 60 kërkesa në minutë, mjaftueshëm për përdorim familjar.

⚙️ Hapi 2: Vendosni çelësin në aplikacion

1. Hapni aplikacionin përmes linkut që keni marrë.

2. Në krye, pranë titullit, do të gjeni një ikonë ingranazhi . Klikoni atë.

3. Do të shfaqet paneli i cilësimeve. Ngjitni çelësin tuaj në fushën e parë.

4. Cilësimet e tjera mund t'i lini siç janë (Gemini 2.5 Flash rekomandohet).

5. Klikoni përsëri ingranazhin për të fshehur panelin (opsionale).

✅ Tani aplikacioni është gati për përdorim!

🧒🏻 Si ta përdorë fëmija aplikacionin

1. Fëmija zgjedh gjuhën nga menyja në krye (pranë ingranazhit).

2. Shkruan pyetjen e tij në kutinë e madhe (p.sh., "Si të llogaris sipërfaqen e drejtkëndëshit?") ose klikon "Zgjidh skedarin" për të fotografuar problemin.

3. Klikon butonin "🔍 Fillo bisedën".

4. Mësuesi AI përgjigjet me sugjerime. Fëmija përpiqet të përgjigjet, shkruan përgjigjen në fushën e poshtme dhe klikon "Dërgo".

5. Biseda vazhdon derisa fëmija të arrijë përgjigjen e saktë. Pastaj shfaqet një personazh vizatimor i lezetshëm me një mesazh inkurajues (p.sh., "Shkëlqyeshëm! Pini ujë").

6. Mund të fillojë një pyetje të re duke klikuar "🔄 Fillo përsëri".

Shënim: Numëruesi i kreditit në panelin e cilësimeve ju ndihmon të gjurmoni sa kërkesa kanë mbetur në minutën aktuale (maksimumi 60). Ky është një vlerësim lokal, por është i dobishëm për menaxhimin e përdorimit.