# Yujin Forge -- دليل المستخدم

مساعد تطوير صوتي أولاً لبناء تطبيقات React + NAC-3. مصمم ليتمكن مرافق أو طفل يتعلم البرمجة من تشغيله دون الحاجة إلى لمس الطرفية.

## مرحباً

يقوم Yujin Forge بثلاثة أشياء بسيطة:

- يقرأ المستندات بصوت عالٍ (PDF، Word، HTML، MD، EPUB، CSV، Excel، الكود المصدري، txt، RTF).
- يأخذ مواصفات التصميم ويولد كود التطبيق تلقائياً.
- يتحدث مع مساعد ذكاء اصطناعي يعرف مشروعك: قراءة البيان، البحث في SPEC، تحرير المكونات، إجراء الالتزامات.

## التثبيت

1. قم بتثبيت Node.js 18.17 أو أحدث من nodejs.org.
2. في الطرفية:

       npm install -g @yujin/forge-cli@alpha

3. تحقق باستخدام `yf --version`.
4. قم بتشغيل `yf doctor`.

## التشغيل الأول

    yf chat

يفتح المتصفح لوحة Yujin. انقر فوق زر المفاتيح وحمّل مفاتيح API. يظهر كل مفتاح مرة واحدة فقط عند إدخاله.

## الأوامر الصوتية

يفهم Yujin الإسبانية والإنجليزية والبرتغالية والفرنسية والألمانية والإيطالية واليابانية والصينية والهندية والعربية.

تقول | ماذا يحدث
--- | ---
"افتح الملف" | يفتح المستند.
"التالي" / "استمر" | ينتقل إلى الكتلة التالية.
"ابحث عن كلمة" | يبحث ويقرأ أول تطابق.
"علامة هنا باسم اسم" | يضع علامة مرجعية.
"انتقل إلى العلامة اسم" | يعود إلى العلامة.
"تلخيص" | يعيد قراءة آخر الكتل.
"افتح الدليل" | يفتح هذا الدليل بلغتك.

## استيعاب المواصفات

اسحب ملف مواصفات إلى اللوحة. تظهر شاشة بنفسجية بها كانجي. أفلت الملف عليها.

1. يقرأ Yujin المستند.
2. يستخرج Claude المتطلبات والكيانات ونقاط النهاية والمكونات.
3. يقدم Claude خطة للملفات المراد إنشاؤها.
4. يعرض Yujin الخطة. قل "موافق".
5. ينشئ الملفات في مجلد مشروعك.
6. إذا حدث خطأ، قل "تراجع".

## حل المشكلات

الميكروفون لا يعمل
  يطلب المتصفح الإذن لأول مرة. انقر فوق القفل بجانب URL.
لا يفهمني
  حمّل مفتاح OpenAI في خانة `openai`.
الصوت سيء
  حمّل مفتاح ElevenLabs للحصول على صوت أكثر طبيعية.
أريد البدء من جديد
  أغلق Yujin. احذف `~/.yujin-forge/`. قم بتشغيل `yf chat` مرة أخرى.

## الدعم

الدعم: pablo@rpaforce.com