llmxray 0.5.0 → 0.5.1

package/README.ar.md

@@ -1,302 +1,302 @@
-<div dir="rtl">
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/LogneBudo/llmxray/master/public/favicon.svg" alt="LLMxRay" width="80" />
-</p>
-
-<h1 align="center">LLMxRay</h1>
-<p align="center"><strong>اطّلع على ما يفعله الذكاء الاصطناعي لديك فعلاً.</strong></p>
-<p align="center">
-  بث الرموز في الوقت الفعلي، وتحليل الجودة، وتوصيف الأداء، وتتبّع التكاليف<br/>
-  للنماذج اللغوية الكبيرة المحلية. بدون سحابة. بدون مفاتيح API. بدون تكلفة.
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/llmxray"><img src="https://img.shields.io/npm/v/llmxray?color=cb3837&logo=npm&logoColor=white" alt="npm" /></a>
-  <a href="https://hub.docker.com/r/djovaneli/llmxray"><img src="https://img.shields.io/docker/pulls/djovaneli/llmxray?color=2496ED&logo=docker&logoColor=white" alt="Docker" /></a>
-  <img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License" />
-  <img src="https://img.shields.io/badge/ollama-local-000?logo=ollama&logoColor=white" alt="Ollama" />
-</p>
-
-<p align="center">
-  🌐 <a href="README.md">English</a> &bull;
-  <a href="README.fr.md">Français</a> &bull;
-  <a href="README.zh-CN.md">中文</a> &bull;
-  <strong>العربية</strong> &bull;
-  <a href="README.sr.md">Srpski</a>
-</p>
-
-<p align="center">
-  <a href="#البدء-السريع">البدء السريع</a> &bull;
-  <a href="#الميزات">الميزات</a> &bull;
-  <a href="#لقطات-الشاشة">لقطات الشاشة</a> &bull;
-  <a href="#لمن-هذه-الأداة">لمن هذه الأداة</a> &bull;
-  <a href="CHANGELOG.md">سجل التغييرات</a>
-</p>
-
-<p align="center">
-  <img src="docs/public/screenshots/demo.gif" alt="عرض LLMxRay — بث الرموز في الوقت الفعلي مع تلوين الثقة" width="800" />
-</p>
-
----
-
-## البدء السريع
-
-**أمر واحد. ٣٠ ثانية.**
-
-```bash
-npx llmxray
-```
-
-أو باستخدام Docker:
-
-```bash
-docker run -p 5174:5174 djovaneli/llmxray
-```
-
-افتح **http://localhost:5174** وابدأ المحادثة. هذا كل شيء.
-
-> **متطلّب مسبق:** [Ollama](https://ollama.com/download) يعمل محلياً مع تنزيل نموذج واحد على الأقل (`ollama pull llama3.2`).
-
----
-
-## لماذا LLMxRay؟
-
-أنت تشغّل نموذجاً لغوياً محلياً. تتحدث معه. لكن ما الذي حدث فعلياً؟
-
-- ما سرعة كل رمز؟ وأيها كان النموذج واثقاً منه؟
-- هل تتدهور جودة الاستجابة عبر المحادثات الطويلة؟
-- كم كان سيكلّف هذا لو شغّلته على السحابة؟
-- هل يكرر النموذج نفسه؟ يرفض؟ يولّد كلاماً غير مفهوم؟
-- كيف تختلف درجة الحرارة 0.3 عن 0.9 على *نفس* المطالبة؟
-
-**يجيب LLMxRay على كل ذلك، بصرياً، في الوقت الفعلي، مجاناً.**
-
----
-
-## الميزات
-
-### دردشة لحظية بذكاء على مستوى الرمز
-تحدّث مع أي نموذج Ollama وراقب وصول الرموز مع **تلوين الثقة** — كل رمز يُلوَّن وفق سرعة توليده. يدعم Markdown، والمحادثات متعددة الأدوار، ومرفقات الملفات، ونماذج الرؤية، والأوامر بالشرطة المائلة. وللنماذج الاستدلالية، اضبط ميزانية التفكير لكل محادثة — إيقاف، أو ترك الاختيار للنموذج، أو جهد صريح منخفض / متوسط / مرتفع / أقصى.
-
-### بوّابات جودة الاستجابة
-كل استجابة تُحلَّل تلقائياً. تظهر شارات ملوّنة فقط حين يحدث خطأ:
-- **التكرار** — عبارات متكرّرة بإفراط (تحليل رباعي الجرامات)
-- **الرفض** — "بوصفي نموذجاً لغوياً" و٧ أنماط أخرى
-- **الكلام غير المفهوم** — نسبة عالية من الرموز غير الـ ASCII
-- **استجابة فارغة** — أقل من ١٠ كلمات
-- **البتر** — بلوغ حدّ الرموز قبل الانتهاء
-
-### طاولة عمل لمقارنة النماذج
-حتى **٤ شرائح** بنموذج ودرجة حرارة وموجّه نظام مستقلّة. تشمل الميزات البث جنباً إلى جنب، وإبراز الفروق على مستوى الكلمة، ومقارنة المقاييس، وقوالب جاهزة بنقرة واحدة (مسح درجات الحرارة، الزوج الحتمي، مقارنة اللغات مع تصوير ضريبة الرموز).
-
-### تحليلات الأداء
-- **النسب المئوية للتأخير** (P50/P95/P99) للمدّة وزمن أول رمز
-- **استخبارات الأخطاء** — مصنّف من ٧ فئات مع خطّ زمني
-- **خريطة حرارية للاستخدام** — شبكة ٧×٢٤ لساعاتك النشطة
-- **أثر الإعدادات** — مخطّطات تشتّت لدرجة الحرارة مقابل الرموز/الثانية
-- تتبّع **البداية الباردة مقابل الدافئة** مع سجلّ تحميل النموذج
-
-### لوحة التكاليف
-استهلاك الرموز لكل نموذج/يوم مع تقدير السعر المكافئ على السحابة. شاهد كم *توفّر* بتشغيلها محلياً.
-
-### معيار جراحي
-اختبر معرفة النموذج بحزم أسئلة متعدّدة الاختيار. يستخدم logprobs حقيقية عبر النقطة المتوافقة مع OpenAI لقياس دقيق للثقة. ابنِ حزماً مخصّصة بصرياً أو دع الذكاء الاصطناعي يولّدها من موضوع.
-
-### مختبر التضمينات وخط أنابيب RAG
-ضمّن النصوص، وصوّر المتجهات، وقِس تشابه جيب التمام. اطلب متجه إخراج أضيق لترى كم يكلّف اقتطاع ماتريوشكا من التشابه. ابنِ قاعدة معرفة محلية من ملفات PDF و DOCX و CSV — مقطَّعة، مضمَّنة، وقابلة للبحث. كل ذلك مخزَّن في IndexedDB. بلا تكلفة.
-
-### ورشة الأدوات (لوحة بصرية)
-لوحة عُقَد بالسحب والإفلات لبناء تعريفات الأدوات. مزامنة كود ثنائية الاتجاه (تحرير العُقَد أو TypeScript — كلاهما يتحدّث). اسبر واجهات API، ولّد المخططات تلقائياً، واختبر بتنفيذ مباشر.
-
-### ساحة الإكمال في الوسط *(جديد في v0.4.7)*
-إكمال الكود لـ Qwen-Coder و CodeLlama و Codestral و DeepSeek-Coder و StarCoder. حقلا نص (بادئة / لاحقة)، والنموذج يملأ الفراغ. يستخدم حقل `suffix` في `/api/generate` من Ollama. معاينة مدمجة تُظهر النتيجة كما ستبدو في محرّرك.
-
-### مرصد البروتوكولات *(جديد في v0.4.7)*
-أطلق نفس المطالبة عبر بروتوكولات Ollama الثلاثة للتقديم — **الأصلي** `/api/chat`، **المتوافق مع OpenAI** `/v1/chat/completions`، و **المتوافق مع Anthropic** `/v1/messages` — بالتوازي ضد نموذجك المحلي. بثّ جنباً إلى جنب، ومقاييس لكل بروتوكول، وعلامة تبويب لفروق الأظرف تُظهر كيف يصوغ كل بروتوكول أسباب الإنهاء وعدّ الرموز وأظرف الأخطاء. بلا سحابة، بلا مفاتيح API — النقاط الثلاث جميعها محلية على `localhost:11434`.
-
-### خط أنابيب تدريب الذكاء الاصطناعي
-نسّق بيانات التدريب من محادثاتك. وسِم، وراجِع، وصدِّر بصيغة JSONL للضبط الدقيق.
-
-### قاعدة بيانات تاريخ الذكاء الاصطناعي المحلية
-تُؤرشَف كل تجربة (معايير، مقارنات، محادثات، أزواج تدريب) تلقائياً في قاعدة بيانات IndexedDB قابلة للاستعلام مع فلاتر واتجاهات وتصدير وسياسات احتفاظ.
-
-### متعدّد اللغات
-ترجمات كاملة بالإنجليزية والفرنسية والصربية (لاتيني + سيريلي) والصينية والعربية. دعم تخطيط RTL. هياكل مجتمعية للعبرية واليابانية.
-
----
-
-## التوافق مع Ollama
-
-تم اختبارها والتحقّق منها مع **Ollama 0.32.x** (أحدث إصدار مستقرّ حالياً في أغسطس ٢٠٢٦). يستخدم LLMxRay نقاط Ollama التالية:
-
-| النقطة | الاستخدام |
-|---|---|
-| `/api/chat` | دردشة متدفّقة (NDJSON، مع `tools` و `think` ومخطّط `format`) |
-| `/api/generate` | التوليد والإكمال في الوسط عبر `suffix` |
-| `/api/tags` | قائمة النماذج والقدرات وطول السياق وعرض التضمين |
-| `/api/show` | المعاملات والقالب والترخيص وبيانات البنية |
-| `/api/embed` | تضمينات متّجهة لـ RAG |
-| `/api/pull`، `/api/delete`، `/api/ps`، `/api/version` | إدارة النماذج وحالتها |
-| `/v1/chat/completions` | مسار متوافق مع OpenAI يستخدمه المعيار الجراحي للحصول على logprobs حقيقية |
-| `/v1/messages` | مسار متوافق مع Anthropic يستخدمه مرصد البروتوكولات |
-
-**متوافق مع:** Ollama 0.20 وما بعده (الإصدارات الأقدم تعمل للدردشة/التوليد لكن تفتقر إلى `think` ومخطّط `format` بصيغة JSON Schema). **مُوصى به:** Ollama 0.32+ — تصل القدرات وطول السياق مع قائمة النماذج، ويقبل `think` مستويات جهد متدرّجة، وتقبل التضمينات عرض `dimensions`.
-
----
-
-## لقطات الشاشة
-
-<table>
-<tr>
-<td width="50%">
-
-**دردشة ببث الرموز ومؤشّر الثقة**
-![Chat](docs/public/screenshots/chat-diagnostics.png)
-
-</td>
-<td width="50%">
-
-**مقارنة النماذج — جنباً إلى جنب**
-![Compare](docs/public/screenshots/compare-sidebyside.png)
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-**تشريح الجلسة — مقاييس وتوقيت**
-![Session](docs/public/screenshots/session-details.png)
-
-</td>
-<td width="50%">
-
-**معيار مع رادار الثقة**
-![Benchmark](docs/public/screenshots/benchmark.png)
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-**التضمينات — تشابه جيب التمام**
-![Embeddings](docs/public/screenshots/embed-similarity.png)
-
-</td>
-<td width="50%">
-
-**مراقب النظام — العتاد وحالة Ollama**
-![System](docs/public/screenshots/my-system.png)
-
-</td>
-</tr>
-</table>
-
----
-
-## لمن هذه الأداة
-
-| أنت... | LLMxRay يساعدك على... |
-|---|---|
-| **مطوّر** | تنقيح المطالبات، توصيف التأخير، مقارنة النماذج، فحص استدعاءات الأدوات، تتبّع التكاليف |
-| **باحث** | إجراء تجارب مضبوطة بإعدادات متناسقة عبر النماذج ودرجات الحرارة |
-| **طالب / معلّم** | استكشاف سلوك النموذج بصرياً — حزمة المعلّمين المدمجة بـ ٩ وحدات تفاعلية |
-| **قائد فريق ذكاء اصطناعي** | فهم اتجاهات الجودة وأنماط الأخطاء واستخدام الموارد عبر أسطولك المحلي |
-
----
-
-## خيارات التثبيت
-
-### npx (مُوصى به)
-```bash
-npx llmxray
-npx llmxray --port 3000
-npx llmxray --ollama-url http://192.168.1.50:11434
-```
-
-### Docker
-```bash
-docker run -p 5174:5174 djovaneli/llmxray
-docker run -p 5174:5174 -e OLLAMA_URL=http://host.docker.internal:11434 djovaneli/llmxray
-```
-
-### من الكود المصدري
-```bash
-git clone https://github.com/LogneBudo/llmxray.git
-cd llmxray
-npm install
-npm run dev     # http://localhost:5173
-```
-
----
-
-## الحزمة التقنية
-
-| الطبقة | التقنية |
-|---|---|
-| إطار العمل | Vue 3.5 + Composition API |
-| اللغة | TypeScript 5.9 (وضع صارم) |
-| البناء | Vite 7.3 |
-| التنسيق | Tailwind CSS 4.2 |
-| إدارة الحالة | Pinia 3 (متجر لكل اهتمام) |
-| الرسوم البيانية | Chart.js 4، D3.js 7 |
-| اللوحة | Vue Flow (محرّر عُقَد بصري) |
-| محرّر الكود | CodeMirror 6 |
-| التخزين | IndexedDB (أصلي للمتصفّح) |
-| واجهة LLM الخلفية | Ollama (محلي) |
-
----
-
-## المعمارية
-
-**البثّ** — يقرأ NDJSON من Ollama عبر `fetch()` + `ReadableStream`. تحدّث الرموز الواجهة تفاعلياً عبر متاجر Pinia.
-
-**ثقة الرمز** — تُقدَّر من التأخير بين الرموز (الأسرع = الأكثر ثقة). موسومة بوضوح على أنها تقريب. تستخدم المعايير logprobs حقيقية عبر النقطة المتوافقة مع OpenAI.
-
-**متجر لكل اهتمام** — لكل مجال متجر Pinia خاص به: tokens و sessions و metrics و reasoning و comparison و embeddings و quality و cost وغيرها.
-
-**اكتشاف العتاد** — مكوّن Vite مخصّص يستعلم نظام التشغيل مباشرة (PowerShell/proc/sysctl) للحصول على مواصفات دقيقة للعتاد.
-
----
-
-## التطوير
-
-| الأمر | ما يفعله |
-|---|---|
-| `npm run dev` | خادم تطوير (المنفذ 5173) |
-| `npm run build` | فحص الأنواع + بناء الإنتاج |
-| `npm run test` | اختبارات وحدة (Vitest) |
-| `npm run test:e2e` | اختبارات شاملة (Playwright) |
-
----
-
-## المساهمة
-
-المساهمات مرحَّب بها! راجِع [CONTRIBUTING.md](CONTRIBUTING.md) للإعداد والإرشادات.
-
-**ترجمات المجتمع مرحَّب بها بصفة خاصّة** — ملفات الهياكل جاهزة للعبرية واليابانية.
-
----
-
-## الرخصة
-
-[Apache License 2.0](LICENSE)
-
-## العلامة التجارية
-
-**LLMxRay** علامة تجارية لـ Ivan Stankovic ([LogneBudo](https://github.com/LogneBudo)). راجِع [TRADEMARK.md](TRADEMARK.md).
-
----
-
-<p align="center">
-  <strong>إن ساعدك LLMxRay على فهم ذكائك الاصطناعي بشكل أفضل، فكّر في منح المشروع نجمة.</strong><br/>
-  هذا يساعد آخرين على اكتشاف المشروع.
-</p>
-
-<p align="center">
-  <a href="https://github.com/LogneBudo/llmxray">
-    <img src="https://img.shields.io/github/stars/LogneBudo/llmxray?style=social" alt="GitHub stars" />
-  </a>
-</p>
-
-</div>
+<div dir="rtl">
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/LogneBudo/llmxray/master/public/favicon.svg" alt="LLMxRay" width="80" />
+</p>
+
+<h1 align="center">LLMxRay</h1>
+<p align="center"><strong>اطّلع على ما يفعله الذكاء الاصطناعي لديك فعلاً.</strong></p>
+<p align="center">
+  بث الرموز في الوقت الفعلي، وتحليل الجودة، وتوصيف الأداء، وتتبّع التكاليف<br/>
+  للنماذج اللغوية الكبيرة المحلية. بدون سحابة. بدون مفاتيح API. بدون تكلفة.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/llmxray"><img src="https://img.shields.io/npm/v/llmxray?color=cb3837&logo=npm&logoColor=white" alt="npm" /></a>
+  <a href="https://hub.docker.com/r/djovaneli/llmxray"><img src="https://img.shields.io/docker/pulls/djovaneli/llmxray?color=2496ED&logo=docker&logoColor=white" alt="Docker" /></a>
+  <img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License" />
+  <img src="https://img.shields.io/badge/ollama-local-000?logo=ollama&logoColor=white" alt="Ollama" />
+</p>
+
+<p align="center">
+  🌐 <a href="README.md">English</a> &bull;
+  <a href="README.fr.md">Français</a> &bull;
+  <a href="README.zh-CN.md">中文</a> &bull;
+  <strong>العربية</strong> &bull;
+  <a href="README.sr.md">Srpski</a>
+</p>
+
+<p align="center">
+  <a href="#البدء-السريع">البدء السريع</a> &bull;
+  <a href="#الميزات">الميزات</a> &bull;
+  <a href="#لقطات-الشاشة">لقطات الشاشة</a> &bull;
+  <a href="#لمن-هذه-الأداة">لمن هذه الأداة</a> &bull;
+  <a href="CHANGELOG.md">سجل التغييرات</a>
+</p>
+
+<p align="center">
+  <img src="docs/public/screenshots/demo.gif" alt="عرض LLMxRay — بث الرموز في الوقت الفعلي مع تلوين الثقة" width="800" />
+</p>
+
+---
+
+## البدء السريع
+
+**أمر واحد. ٣٠ ثانية.**
+
+```bash
+npx llmxray
+```
+
+أو باستخدام Docker:
+
+```bash
+docker run -p 5174:5174 djovaneli/llmxray
+```
+
+افتح **http://localhost:5174** وابدأ المحادثة. هذا كل شيء.
+
+> **متطلّب مسبق:** [Ollama](https://ollama.com/download) يعمل محلياً مع تنزيل نموذج واحد على الأقل (`ollama pull llama3.2`).
+
+---
+
+## لماذا LLMxRay؟
+
+أنت تشغّل نموذجاً لغوياً محلياً. تتحدث معه. لكن ما الذي حدث فعلياً؟
+
+- ما سرعة كل رمز؟ وأيها كان النموذج واثقاً منه؟
+- هل تتدهور جودة الاستجابة عبر المحادثات الطويلة؟
+- كم كان سيكلّف هذا لو شغّلته على السحابة؟
+- هل يكرر النموذج نفسه؟ يرفض؟ يولّد كلاماً غير مفهوم؟
+- كيف تختلف درجة الحرارة 0.3 عن 0.9 على *نفس* المطالبة؟
+
+**يجيب LLMxRay على كل ذلك، بصرياً، في الوقت الفعلي، مجاناً.**
+
+---
+
+## الميزات
+
+### دردشة لحظية بذكاء على مستوى الرمز
+تحدّث مع أي نموذج Ollama وراقب وصول الرموز مع **تلوين الثقة** — كل رمز يُلوَّن وفق سرعة توليده. يدعم Markdown، والمحادثات متعددة الأدوار، ومرفقات الملفات، ونماذج الرؤية، والأوامر بالشرطة المائلة. وللنماذج الاستدلالية، اضبط ميزانية التفكير لكل محادثة — إيقاف، أو ترك الاختيار للنموذج، أو جهد صريح منخفض / متوسط / مرتفع / أقصى.
+
+### بوّابات جودة الاستجابة
+كل استجابة تُحلَّل تلقائياً. تظهر شارات ملوّنة فقط حين يحدث خطأ:
+- **التكرار** — عبارات متكرّرة بإفراط (تحليل رباعي الجرامات)
+- **الرفض** — "بوصفي نموذجاً لغوياً" و٧ أنماط أخرى
+- **الكلام غير المفهوم** — نسبة عالية من الرموز غير الـ ASCII
+- **استجابة فارغة** — أقل من ١٠ كلمات
+- **البتر** — بلوغ حدّ الرموز قبل الانتهاء
+
+### طاولة عمل لمقارنة النماذج
+حتى **٤ شرائح** بنموذج ودرجة حرارة وموجّه نظام مستقلّة. تشمل الميزات البث جنباً إلى جنب، وإبراز الفروق على مستوى الكلمة، ومقارنة المقاييس، وقوالب جاهزة بنقرة واحدة (مسح درجات الحرارة، الزوج الحتمي، مقارنة اللغات مع تصوير ضريبة الرموز).
+
+### تحليلات الأداء
+- **النسب المئوية للتأخير** (P50/P95/P99) للمدّة وزمن أول رمز
+- **استخبارات الأخطاء** — مصنّف من ٧ فئات مع خطّ زمني
+- **خريطة حرارية للاستخدام** — شبكة ٧×٢٤ لساعاتك النشطة
+- **أثر الإعدادات** — مخطّطات تشتّت لدرجة الحرارة مقابل الرموز/الثانية
+- تتبّع **البداية الباردة مقابل الدافئة** مع سجلّ تحميل النموذج
+
+### لوحة التكاليف
+استهلاك الرموز لكل نموذج/يوم مع تقدير السعر المكافئ على السحابة. شاهد كم *توفّر* بتشغيلها محلياً.
+
+### معيار جراحي
+اختبر معرفة النموذج بحزم أسئلة متعدّدة الاختيار. يستخدم logprobs حقيقية عبر النقطة المتوافقة مع OpenAI لقياس دقيق للثقة. ابنِ حزماً مخصّصة بصرياً أو دع الذكاء الاصطناعي يولّدها من موضوع.
+
+### مختبر التضمينات وخط أنابيب RAG
+ضمّن النصوص، وصوّر المتجهات، وقِس تشابه جيب التمام. اطلب متجه إخراج أضيق لترى كم يكلّف اقتطاع ماتريوشكا من التشابه. ابنِ قاعدة معرفة محلية من ملفات PDF و DOCX و CSV — مقطَّعة، مضمَّنة، وقابلة للبحث. كل ذلك مخزَّن في IndexedDB. بلا تكلفة.
+
+### ورشة الأدوات (لوحة بصرية)
+لوحة عُقَد بالسحب والإفلات لبناء تعريفات الأدوات. مزامنة كود ثنائية الاتجاه (تحرير العُقَد أو TypeScript — كلاهما يتحدّث). اسبر واجهات API، ولّد المخططات تلقائياً، واختبر بتنفيذ مباشر.
+
+### ساحة الإكمال في الوسط *(جديد في v0.4.7)*
+إكمال الكود لـ Qwen-Coder و CodeLlama و Codestral و DeepSeek-Coder و StarCoder. حقلا نص (بادئة / لاحقة)، والنموذج يملأ الفراغ. يستخدم حقل `suffix` في `/api/generate` من Ollama. معاينة مدمجة تُظهر النتيجة كما ستبدو في محرّرك.
+
+### مرصد البروتوكولات *(جديد في v0.4.7)*
+أطلق نفس المطالبة عبر بروتوكولات Ollama الثلاثة للتقديم — **الأصلي** `/api/chat`، **المتوافق مع OpenAI** `/v1/chat/completions`، و **المتوافق مع Anthropic** `/v1/messages` — بالتوازي ضد نموذجك المحلي. بثّ جنباً إلى جنب، ومقاييس لكل بروتوكول، وعلامة تبويب لفروق الأظرف تُظهر كيف يصوغ كل بروتوكول أسباب الإنهاء وعدّ الرموز وأظرف الأخطاء. بلا سحابة، بلا مفاتيح API — النقاط الثلاث جميعها محلية على `localhost:11434`.
+
+### خط أنابيب تدريب الذكاء الاصطناعي
+نسّق بيانات التدريب من محادثاتك. وسِم، وراجِع، وصدِّر بصيغة JSONL للضبط الدقيق.
+
+### قاعدة بيانات تاريخ الذكاء الاصطناعي المحلية
+تُؤرشَف كل تجربة (معايير، مقارنات، محادثات، أزواج تدريب) تلقائياً في قاعدة بيانات IndexedDB قابلة للاستعلام مع فلاتر واتجاهات وتصدير وسياسات احتفاظ.
+
+### متعدّد اللغات
+ترجمات كاملة بالإنجليزية والفرنسية والصربية (لاتيني + سيريلي) والصينية والعربية. دعم تخطيط RTL. هياكل مجتمعية للعبرية واليابانية.
+
+---
+
+## التوافق مع Ollama
+
+تم اختبارها والتحقّق منها مع **Ollama 0.33.x** (تمّ التحقّق على 0.33.3، سبتمبر ٢٠٢٦). يستخدم LLMxRay نقاط Ollama التالية:
+
+| النقطة | الاستخدام |
+|---|---|
+| `/api/chat` | دردشة متدفّقة (NDJSON، مع `tools` و `think` ومخطّط `format`) |
+| `/api/generate` | التوليد والإكمال في الوسط عبر `suffix` |
+| `/api/tags` | قائمة النماذج والقدرات وطول السياق وعرض التضمين |
+| `/api/show` | المعاملات والقالب والترخيص وبيانات البنية |
+| `/api/embed` | تضمينات متّجهة لـ RAG |
+| `/api/pull`، `/api/delete`، `/api/ps`، `/api/version` | إدارة النماذج وحالتها |
+| `/v1/chat/completions` | مسار متوافق مع OpenAI يستخدمه المعيار الجراحي للحصول على logprobs حقيقية |
+| `/v1/messages` | مسار متوافق مع Anthropic يستخدمه مرصد البروتوكولات |
+
+**متوافق مع:** Ollama 0.20 وما بعده (الإصدارات الأقدم تعمل للدردشة/التوليد لكن تفتقر إلى `think` ومخطّط `format` بصيغة JSON Schema). **مُوصى به:** Ollama 0.33.3+ — يُبلَّغ عن إعادة استخدام ذاكرة المُوجّه المؤقتة (`prompt_eval_cached_count`، و`usage.prompt_tokens_details.cached_tokens` على النقطة المتوافقة مع OpenAI)، فيُقاس معدّل التعبئة المسبقة على الرموز المُقيَّمة فعلياً. منذ 0.32: تصل القدرات وطول السياق مع قائمة النماذج، ويقبل `think` مستويات جهد متدرّجة، وتقبل التضمينات عرض `dimensions`.
+
+---
+
+## لقطات الشاشة
+
+<table>
+<tr>
+<td width="50%">
+
+**دردشة ببث الرموز ومؤشّر الثقة**
+![Chat](docs/public/screenshots/chat-diagnostics.png)
+
+</td>
+<td width="50%">
+
+**مقارنة النماذج — جنباً إلى جنب**
+![Compare](docs/public/screenshots/compare-sidebyside.png)
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+**تشريح الجلسة — مقاييس وتوقيت**
+![Session](docs/public/screenshots/session-details.png)
+
+</td>
+<td width="50%">
+
+**معيار مع رادار الثقة**
+![Benchmark](docs/public/screenshots/benchmark.png)
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+**التضمينات — تشابه جيب التمام**
+![Embeddings](docs/public/screenshots/embed-similarity.png)
+
+</td>
+<td width="50%">
+
+**مراقب النظام — العتاد وحالة Ollama**
+![System](docs/public/screenshots/my-system.png)
+
+</td>
+</tr>
+</table>
+
+---
+
+## لمن هذه الأداة
+
+| أنت... | LLMxRay يساعدك على... |
+|---|---|
+| **مطوّر** | تنقيح المطالبات، توصيف التأخير، مقارنة النماذج، فحص استدعاءات الأدوات، تتبّع التكاليف |
+| **باحث** | إجراء تجارب مضبوطة بإعدادات متناسقة عبر النماذج ودرجات الحرارة |
+| **طالب / معلّم** | استكشاف سلوك النموذج بصرياً — حزمة المعلّمين المدمجة بـ ٩ وحدات تفاعلية |
+| **قائد فريق ذكاء اصطناعي** | فهم اتجاهات الجودة وأنماط الأخطاء واستخدام الموارد عبر أسطولك المحلي |
+
+---
+
+## خيارات التثبيت
+
+### npx (مُوصى به)
+```bash
+npx llmxray
+npx llmxray --port 3000
+npx llmxray --ollama-url http://192.168.1.50:11434
+```
+
+### Docker
+```bash
+docker run -p 5174:5174 djovaneli/llmxray
+docker run -p 5174:5174 -e OLLAMA_URL=http://host.docker.internal:11434 djovaneli/llmxray
+```
+
+### من الكود المصدري
+```bash
+git clone https://github.com/LogneBudo/llmxray.git
+cd llmxray
+npm install
+npm run dev     # http://localhost:5173
+```
+
+---
+
+## الحزمة التقنية
+
+| الطبقة | التقنية |
+|---|---|
+| إطار العمل | Vue 3.5 + Composition API |
+| اللغة | TypeScript 5.9 (وضع صارم) |
+| البناء | Vite 7.3 |
+| التنسيق | Tailwind CSS 4.2 |
+| إدارة الحالة | Pinia 3 (متجر لكل اهتمام) |
+| الرسوم البيانية | Chart.js 4، D3.js 7 |
+| اللوحة | Vue Flow (محرّر عُقَد بصري) |
+| محرّر الكود | CodeMirror 6 |
+| التخزين | IndexedDB (أصلي للمتصفّح) |
+| واجهة LLM الخلفية | Ollama (محلي) |
+
+---
+
+## المعمارية
+
+**البثّ** — يقرأ NDJSON من Ollama عبر `fetch()` + `ReadableStream`. تحدّث الرموز الواجهة تفاعلياً عبر متاجر Pinia.
+
+**ثقة الرمز** — تُقدَّر من التأخير بين الرموز (الأسرع = الأكثر ثقة). موسومة بوضوح على أنها تقريب. تستخدم المعايير logprobs حقيقية عبر النقطة المتوافقة مع OpenAI.
+
+**متجر لكل اهتمام** — لكل مجال متجر Pinia خاص به: tokens و sessions و metrics و reasoning و comparison و embeddings و quality و cost وغيرها.
+
+**اكتشاف العتاد** — مكوّن Vite مخصّص يستعلم نظام التشغيل مباشرة (PowerShell/proc/sysctl) للحصول على مواصفات دقيقة للعتاد.
+
+---
+
+## التطوير
+
+| الأمر | ما يفعله |
+|---|---|
+| `npm run dev` | خادم تطوير (المنفذ 5173) |
+| `npm run build` | فحص الأنواع + بناء الإنتاج |
+| `npm run test` | اختبارات وحدة (Vitest) |
+| `npm run test:e2e` | اختبارات شاملة (Playwright) |
+
+---
+
+## المساهمة
+
+المساهمات مرحَّب بها! راجِع [CONTRIBUTING.md](CONTRIBUTING.md) للإعداد والإرشادات.
+
+**ترجمات المجتمع مرحَّب بها بصفة خاصّة** — ملفات الهياكل جاهزة للعبرية واليابانية.
+
+---
+
+## الرخصة
+
+[Apache License 2.0](LICENSE)
+
+## العلامة التجارية
+
+**LLMxRay** علامة تجارية لـ Ivan Stankovic ([LogneBudo](https://github.com/LogneBudo)). راجِع [TRADEMARK.md](TRADEMARK.md).
+
+---
+
+<p align="center">
+  <strong>إن ساعدك LLMxRay على فهم ذكائك الاصطناعي بشكل أفضل، فكّر في منح المشروع نجمة.</strong><br/>
+  هذا يساعد آخرين على اكتشاف المشروع.
+</p>
+
+<p align="center">
+  <a href="https://github.com/LogneBudo/llmxray">
+    <img src="https://img.shields.io/github/stars/LogneBudo/llmxray?style=social" alt="GitHub stars" />
+  </a>
+</p>
+
+</div>