# OneShotAiPanel

> مكوّن React مفتوح المصدر يتصل بـ LLM تهيّئه (opencode أو shadcn أو fallback) وينفّذ مهامك في جولة واحدة: streaming بتنسيق JSON، ومخطط مُتحقَّق منه، ومراجعة الفروقات (diff)، وإدماج مباشر في بيئتك.

## ما هو OneShotAiPanel؟

مكوّن React يتصل بـ LLM الذي تختاره ويحوّل الطلب إلى مخرجات مُتحقَّق منها، دون نسخ ولصق يدوي.

## المزايا

- **الاتصال بـ LLM المُهيَّأ** : يستدعي المكوّن الموفر الذي تهيّئه (opencode أو shadcn أو fallback أو onSend مخصص)
- **Streaming JSON في الوقت الفعلي** : تصل استجابة النموذج بتدفّق وتُتحقَّق وفق المخططات (zod)
- **مخططات JSON مُتحقَّق منها** : ينتظر كل ticket بنيةً محددة يضبطها المخطط
- **تحقّق تلقائي** : عند أي انحراف، يُعاد إرسال ملاحظات موجّهة لجولة ثانية
- **Diff والمراجعة** : إذا وُجد محتوى سابق، يعرض لك diff سطرًا بسطر ما الذي سيتغيّر قبل الإدماج
- **إدماج مباشر** : استرجع المحتوى المحدد عبر onPlug واربطه في الكود أو المحوّل أو الـ SDK الخاص بك

## كيف يعمل

- **1. صِف المهمة** — prompt للمستخدم، وprompt للنظام، وملفات سياق. يجمع المكوّن الـ prompt النهائي.
- **2. هيّئ الاتصال بالنموذج** — يتصل المكوّن بالموفر الذي تهيّئه عبر المحوّل (opencode أو shadcn أو fallback) أو عبر onSend الخاص بك. دون هذا الاتصال، لا يعمل شيء.
- **3. إرسال واحد** — يستجيب النموذج بتدفّق JSON. ينتظر كل ticket بنيةً محددة يضبطها المخطط.
- **4. تحقّق تلقائي** — يُتحقَّق من صحة الاستجابة وفق المخططات. عند أي انحراف، يُعاد إرسال ملاحظات موجّهة لجولة ثانية.
- **5. Diff والمراجعة** — إذا وُجد محتوى سابق، يعرض لك diff سطرًا بسطر ما الذي سيتغيّر قبل الإدماج.
- **6. الإدماج** — استرجع المحتوى المحدد عبر onPlug واربطه في الكود أو المحوّل أو الـ SDK الخاص بك.

## الإعدادات (أهم الخصائص)

### المحتوى

- `title` — العنوان المعروض في ترويسة المكوّن.
- `systemPrompt` — الدور والقواعد المعطاة للنموذج.
- `initialUserPrompt` — الطلب الأولي المعبأ مسبقًا في حقل المستخدم.

### السياق

- `files` — ملفات المشروع المقدمة كسياق للنموذج.
- `tickets` — تقسيم المهمة، مع مخطط JSON لكل ticket.

### العقد

- `parser` — تخصيص تحليل الاستجابة (parsing) والتحقّق منها.
- `invalidMode` — التحذير أو المنع عندما لا تتطابق الاستجابة مع المخططات.

### Adapter

- `adapter` — Provider (opencode, shadcn, fallback)، والنموذج ومفتاح API.
- `onSend` — استبدال الإرسال بمنطقك الخاص (SDK، proxy...).

### الأحداث

- `onPlug` — يُستدعى عند إدماج المستخدم للمحتوى المحدد.

### i18n

- `language` — لغة الواجهة.
- `labels` — تعديل دقيق لأي تسمية.

### UI

- `actionLabel` — تسمية زر التشغيل الرئيسي.
- `showInfoButton` — يعرض زر المساعدة/الإدماج/الاعتمادات.
- `showSettingsButton` — يعرض زر الإعدادات.
- `showInfoIntegration` — يعرض نقطة الإدماج في لوحة المساعدة.
- `showInfoCredits` — يعرض الاعتمادات في لوحة المساعدة.

## التثبيت

الكود المصدري والعرض التجريبي على GitHub:

- المستودع : https://github.com/bn-dev-19/one-shot-ai-panel
- النسخة الحالية : v1.1.3 (أرشيف : https://github.com/bn-dev-19/one-shot-ai-panel/archive/refs/tags/v1.1.3.zip)

## Playground

يعمل المكوّن فعليًا على الموقع: : https://oneshot-ai-panel.asistem19.com/ar#playground

## روابط

- الرئيسية : https://oneshot-ai-panel.asistem19.com/ar
- GitHub : https://github.com/bn-dev-19/one-shot-ai-panel
- الرخصة : https://oneshot-ai-panel.asistem19.com/ar/license
- شروط الاستخدام : https://oneshot-ai-panel.asistem19.com/ar/terms
- سياسة الخصوصية : https://oneshot-ai-panel.asistem19.com/ar/privacy
- الاعتمادات : https://oneshot-ai-panel.asistem19.com/ar/credits