# DeepTutor: تدريس شخصي مدى الحياة

[![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/downloads/) [![Next.js 16](https://img.shields.io/badge/Next.js-16-000000?style=flat-square&logo=next.js&logoColor=white)](https://nextjs.org/) [![License](https://img.shields.io/badge/License-Apache_2.0-blue?style=flat-square)](../../LICENSE) [![GitHub release](https://img.shields.io/github/v/release/HKUDS/DeepTutor?style=flat-square&color=brightgreen)](https://github.com/HKUDS/DeepTutor/releases) [![arXiv](https://img.shields.io/badge/arXiv-2604.26962-b31b1b?style=flat-square&logo=arxiv&logoColor=white)](https://arxiv.org/abs/2604.26962) [![Discord](https://img.shields.io/badge/Discord-Community-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/eRsjPgMU4t) [![Feishu](https://img.shields.io/badge/Feishu-Group-00D4AA?style=flat-square&logo=feishu&logoColor=white)](../../Communication.md) [![WeChat](https://img.shields.io/badge/WeChat-Group-07C160?style=flat-square&logo=wechat&logoColor=white)](https://github.com/HKUDS/DeepTutor/issues/78) [الميزات](#-الميزات-الرئيسية) · [البدء](#-البدء) · [الاستكشاف](#-استكشاف-deeptutor) · [واجهة CLI](#️-واجهة-سطر-أوامر-deeptutor--الواجهة-الأصيلة-للوكلاء) · [النظام البيئي](#-النظام-البيئي--eduhub-ومجتمع-المهارات) · [المجتمع](#-المجتمع)

--- > 🤝 **نرحب بجميع أنواع المساهمات!** صوّت على عناصر خارطة الطريق أو اقترح عناصر جديدة في [`Roadmap`](https://github.com/HKUDS/DeepTutor/issues/498)، وراجع [دليل المساهمة](../../CONTRIBUTING.md) لمعرفة استراتيجية الفروع ومعايير البرمجة وكيفية البدء. ### 📰 الأخبار - **2026-05-22** 🌐 موقع الوثائق الرسمي متاح على [**deeptutor.info**](https://deeptutor.info/) — الأدلة والمراجع وجولات القدرات كلها في مكان واحد. - **2026-04-19** 🎉 20 ألف نجمة في 111 يومًا! شكراً على الدعم نحو تدريس شخصي وذكي حقيقي. - **2026-04-10** 📄 ورقتنا البحثية متاحة على arXiv — اقرأ [النسخة الأولية](https://arxiv.org/abs/2604.26962) للتعرف على التصميم والأفكار وراء DeepTutor. - **2026-02-06** 🚀 10 آلاف نجمة في 39 يومًا فقط! شكر جزيل لمجتمعنا الرائع. - **2026-01-01** 🎊 كل عام وأنتم بخير! انضم إلى [Discord](https://discord.gg/eRsjPgMU4t) أو [WeChat](https://github.com/HKUDS/DeepTutor/issues/78) أو [النقاشات](https://github.com/HKUDS/DeepTutor/discussions) — لنشكّل معاً مستقبل DeepTutor. - **2025-12-29** 🎓 تم إطلاق DeepTutor رسميًا! ## ✨ الميزات الرئيسية DeepTutor هو بيئة تعلم أصيلة للوكلاء تربط التدريس وحل المشكلات وتوليد الاختبارات والبحث والتصور وممارسة الإتقان في نظام واحد قابل للتوسيع. - **بيئة تشغيل واحدة لجميع الأوضاع** — تشترك Chat وAsk Questions وQuiz وResearch وVisualize وSolve وCourse Study وMastery Path وImmersive Reading وImmersive Watching في بيئة تشغيل واحدة للقدرات وسياق الجلسة، مع احتفاظ كل منها بحلقات وخطوط أنابيب مصممة لغرضها. - **سياق تعلم متصل** — يمكن إعادة استخدام قواعد المعرفة والكتب ومسودات Co-Writer ودفاتر الملاحظات وبنوك الأسئلة والشخصيات والذاكرة عبر سير العمل التي تدعمها، وفقاً لمنح الحساب وسياسات التعلّم. - **التعلّم الغامر بالفيديو** — ألصق رابط YouTube لتشغيل أصلي معزَّز الخصوصية، وترجمات متزامنة، وتدريس مرتكز على الطوابع الزمنية، وتقدّم قابل للاستئناف؛ ويمكن للمشرفين تحويل التشغيل إلى نسخة Invidious ذاتية الاستضافة دون إعادة بناء المواد. - **الوكلاء الفرعيون والشركاء** — من داخل Chat، استشر مُشغِّل وكيل حيّاً (Claude Code أو Codex أو Antigravity أو Kimi أو opencode أو MiMo أو Hermes أو OpenClaw أو DeepSeek) أو Partner، واستورد المحادثات السابقة، وشغّل رفاق IM دائمين على نفس الدماغ. - **معرفة متعددة المحركات** — مكتبات RAG مُصدَّرة عبر LlamaIndex وPageIndex وGraphRAG وLightRAG، أو LightRAG Server عن بُعد، أو قاعدة معرفة WeKnora ذاتية الاستضافة، أو مكتبة Tencent IMA أو MarginNote 4، أو مخزن Obsidian مرتبط، مع تحليل مستندات قابل للتوصيل. - **أدوات ومهارات قابلة للتوسيع** — أدوات مدمجة وخوادم MCP وتطبيقات CLI ونماذج توليد الصور/الفيديو/الصوت ومهارات مجتمع قابلة للتثبيت من EduHub. - **ذاكرة قابلة للتدقيق** — تجعل آثار L1 وملخصات أسطح L2 وتركيب L3 التخصيص مرئياً وقابلاً للتحرير؛ ويربط Memory Graph حقائق L2 بأدلة L1 وتركيب L3 بالأسطح المساهمة. --- ## 🚀 البدء يأتي DeepTutor بأربعة مسارات تثبيت. وكلها تشترك في تخطيط واحد لمساحة عمل وقت التشغيل: تعيش الإعدادات الخاصة في `data/user/settings/` تحت الدليل الذي تُطلق منه التطبيق (أو تحت `DEEPTUTOR_HOME` / `deeptutor start --home` إذا حددت واحداً صراحةً). للتطبيق الكامل، التدفق الموصى به هو **اختر دليل مساحة عمل وقت التشغيل → تثبيت → `deeptutor init` → `deeptutor start`**. ### مساحة عمل المحتوى **مساحة عمل المحتوى** منفصلة عن مساحة عمل DeepTutor الخاصة لوقت التشغيل. إنها المجلد الذي يمكن للوكلاء قراءته، والذي يوضَع فيه كل ملف ينشئه وكيل، وكل تنزيل، وتشغيل رمز، وذاكرة مؤقتة، وأصل مُصيَّر، تحت دليل مقيَّد بالدور `outputs////`. تبقى الإعدادات ومفاتيح API وقواعد البيانات وMemory وحالة التطبيق الداخلية خارجها. بدون تهيئة، تكون مساحة عمل المحتوى هي `/data/user/workspace`. يمكن للتثبيتات المحلية من PyPI وCLI والمصدر اختيار أي مجلد موجود قابل للقراءة/الكتابة في **الإعدادات ← مساحة العمل** أو عبر: ```bash deeptutor workspace show deeptutor workspace set /absolute/path/to/my-folder deeptutor workspace reset ``` يمكن لكل قدرة فحص المجلد نفسه من خلال أدوات مساحة العمل المدمجة. لا يتلقى النموذج سوى مسارات نسبية مثل `outputs/...`؛ وعندما يستخدم `workspace_present`، تُصيِّر الواجهة لقطة مصادَق عليها وقابلة للفتح. يعمل المسار النسبي الدقيق نفسه أيضاً في رابط أو صورة Markdown عادية. تغيير الملف المصدر لاحقاً لا يغيّر لقطة قُدِّمت مسبقاً. التنفيذ للقراءة فقط خارج `outputs/`. نسخ ملف مُولَّد إلى مكان آخر في مساحة عمل المحتوى يتطلب تأكيد **السماح مرة واحدة** الصريح لذلك المصدر والوجهة المحددين تماماً. يفرض صندوق أمان النظام أو مُشغِّل Docker هذا الحد عند توفره؛ ويظهر الرجوع إلى العملية الفرعية المقيَّدة محلياً كـ **أفضل جهد ممكن** في إعدادات مساحة العمل.

الخيار 1 — التثبيت من PyPI · تطبيق ويب محلي كامل + CLI، لا يلزم الاستنساخ

تطبيق ويب محلي كامل + CLI، لا يلزم الاستنساخ. يحتاج **Python 3.11–3.14** وبيئة تشغيل **Node.js 20+** في PATH (يُشغَّل خادم Next.js المستقل المُحزَّم بواسطة `deeptutor start`). ```bash mkdir -p my-deeptutor && cd my-deeptutor pip install -U deeptutor deeptutor init # prompts for ports + LLM provider + optional embedding/search deeptutor start # starts backend + frontend; keep the terminal open ``` يطلب `deeptutor init` منفذ الخلفية (افتراضي `8001`)، ومنفذ الواجهة الأمامية (افتراضي `3782`)، ومزود LLM / عنوان URL الأساسي / مفتاح API / النموذج، ومزود تضمين اختياري لقاعدة المعرفة / RAG، ومزود بحث اختياري لـ Web Search. بعد `deeptutor start`، افتح عنوان URL للواجهة الأمامية المطبوع في الطرفية — افتراضياً [http://127.0.0.1:3782](http://127.0.0.1:3782). اضغط `Ctrl+C` في تلك الطرفية لإيقاف الخلفية والواجهة الأمامية معاً. تخطي `deeptutor init` لا بأس به للتجربة السريعة؛ يُقلع التطبيق بالمنافذ الافتراضية وإعدادات نموذج فارغة، قم بتهيئتها لاحقاً في **الإعدادات ← النماذج**.

الخيار 2 — التثبيت من المصدر · للتطوير مقابل نسخة مسحوبة

للتطوير مقابل نسخة مسحوبة. استخدم **Python 3.11–3.14** و**Node.js 22 LTS** لمطابقة CI وDocker. ```bash git clone https://github.com/HKUDS/DeepTutor.git cd DeepTutor # Create a venv (macOS/Linux). Windows PowerShell: # py -3.11 -m venv .venv ; .\.venv\Scripts\Activate.ps1 python3 -m venv .venv && source .venv/bin/activate python -m pip install --upgrade pip # Install backend + frontend deps python -m pip install -e . ( cd web && npm ci --legacy-peer-deps ) deeptutor init deeptutor start --dev ``` يبني أمر `deeptutor start` واجهة `web/` المحلية للإنتاج مرة واحدة ويعيد استخدامها؛ بينما يشغّل `--dev` تطبيق Next.js مع إعادة التحميل الفوري للوحدات (HMR). تخطيط التهيئة، والمنافذ، والإيقاف بـ `Ctrl+C` يطابق الخيار 1.

بيئة Conda (بديلاً عن venv)

```bash conda create -n deeptutor python=3.11 conda activate deeptutor python -m pip install --upgrade pip ```

إضافات التثبيت الاختيارية — محركات RAG / dev / partners / matrix / math-animator

```bash pip install -e ".[rag-lightrag]" # Built-in LightRAG engine (exact supported SDK) pip install -e ".[graphrag]" # Microsoft GraphRAG engine (Python 3.11–3.13) pip install -e ".[dev]" # tests/lint tools pip install -e ".[partners]" # Partner IM channel SDKs pip install -e ".[video-learning]" # compatibility extra; captions ship in the full/CLI installs pip install -e ".[matrix]" # Matrix channel without E2EE/libolm pip install -e ".[matrix-e2e]" # Matrix E2EE; requires libolm pip install -e ".[math-animator]" # Manim addon; requires LaTeX/ffmpeg/system libs ```

تعديلات تبعيات الواجهة الأمامية وحل مشاكل خادم التطوير

**تغيير تبعيات الواجهة الأمامية:** شغّل `npm install --legacy-peer-deps` لتحديث `web/package-lock.json`، ثم ارفع كلاً من `web/package.json` و`web/package-lock.json`. **خادم تطوير متوقف:** إذا أبلغ `deeptutor start --dev` عن واجهة أمامية موجودة لا تستجيب، أوقف الـ PID الذي يطبعه. إذا لم يكن هناك أي عملية Next.js تعمل فعلياً، فملفات القفل قديمة — احذفها وأعد المحاولة: ```bash rm -f web/.next/dev/lock web/.next/lock deeptutor start --dev ```

الخيار 3 — Docker · حاوية واحدة مكتفية بذاتها

حاوية واحدة لتطبيق الويب الكامل. الصور على GitHub Container Registry: - `ghcr.io/hkuds/deeptutor:latest` — أحدث إصدار مستقر - `ghcr.io/hkuds/deeptutor:` — الإصدار المحدد بدقة من دون `v` في البداية (مثلاً `:1.6.3`)؛ لا تحصل الإصدارات الأولية إلا على وسم إصدارها > راجع [CONTAINERIZATION.md](../../CONTAINERIZATION.md) لعمليات نشر podman/rootless/read-only-rootfs والدليل الكامل لكل تثبيت. ```bash docker run --rm --name deeptutor \ -p 127.0.0.1:3782:3782 \ -v deeptutor-data:/app/data \ ghcr.io/hkuds/deeptutor:latest ``` لاختيار مجلد محتوى مضيف عند بدء تشغيل الحاوية، ثبّته على مسار الحاوية الثابت واحبس DeepTutor على ذلك المسار: ```bash mkdir -p "$PWD/deeptutor-workspace/outputs" docker run --rm --name deeptutor \ -p 127.0.0.1:3782:3782 \ -v deeptutor-data:/app/data \ -v "$PWD/deeptutor-workspace:/workspace" \ -e DEEPTUTOR_WORKSPACE_ROOT=/workspace \ -e DEEPTUTOR_WORKSPACE_ALLOWED_ROOTS=/workspace \ ghcr.io/hkuds/deeptutor:latest ``` بالنسبة إلى Compose، اضبط `DEEPTUTOR_WORKSPACE_HOST=/absolute/host/folder` قبل تشغيل `python scripts/docker_compose.py up -d`. وعند إغفاله يُستخدَم `./data/user/workspace`. تُختار مسارات Docker عند بدء التشغيل، ولذلك تظهر مقفلة في صفحة إعدادات الويب. > **يكفي نشر `3782` فقط.** يتحدث المتصفح حصرياً إلى أصل الواجهة الأمامية؛ يقوم وسيط Next.js (`web/proxy.ts`) بإعادة توجيه `/api/*` و`/ws/*` إلى خلفية FastAPI **داخل الحاوية**. نشر `8001` (`-p 127.0.0.1:8001:8001`) اختياري — مفيد فقط لاستدعاء واجهة برمجة التطبيقات مباشرةً باستخدام curl أو نصوص. افتح [http://127.0.0.1:3782](http://127.0.0.1:3782). تُنشئ الحاوية `/app/data/user/settings/*.json` عند الإقلاع الأول؛ قم بتهيئة مزودي النماذج من صفحة إعدادات الويب. تبقى التهيئة ومفاتيح API والسجلات ومساحة عمل المحتوى الافتراضية والذاكرة وقواعد المعرفة في وحدة تخزين `deeptutor-data`. أما مساحة عمل المحتوى المثبَّتة بشكل منفصل فتستمر في مسار مضيفها بدلاً من ذلك. الإضافات الاختيارية تنتمي إلى بيئة النشر، لا إلى جلسة طرفية عابرة: اضبط `DEEPTUTOR_EXTRAS` (و`DEEPTUTOR_APT_PACKAGES` لمكتبات النظام) وستعيد كل حاوية تُشغَّل انطلاقاً منها تطبيقها تلقائياً، في حين أن أمر `docker exec … pip install` سيُفقَد عند `compose down` التالي. - **منافذ مضيف مختلفة:** غيّر الجانب الأيسر من كل تعيين `-p host:container` (مثلاً `-p 127.0.0.1:8088:3782`). إذا غيّرت المنافذ على جانب الحاوية في `/app/data/user/settings/system.json`، أعد التشغيل وحدّث الجانب الأيمن من كل تعيين ليطابق ذلك. - **وضع المنفصل:** أضف `-d`، ثم `docker logs -f deeptutor` للمتابعة، و`docker stop deeptutor` للإيقاف، و`docker rm deeptutor` قبل إعادة استخدام الاسم. تحتفظ وحدة تخزين `deeptutor-data` ببيانات وقت التشغيل الخاصة ومساحة عمل المحتوى الافتراضية عبر عمليات إعادة التشغيل؛ أما مساحة عمل المحتوى المثبَّتة بشكل منفصل فتستمر في مسار مضيفها. **Docker عن بُعد / وكيل عكسي:** يتحدث المتصفح فقط إلى أصل الواجهة الأمامية (`:3782`)؛ يقوم وسيط Next.js داخل الحاوية بإعادة توجيه `/api/*` و`/ws/*` إلى خادم الخلفية من جانب الخادم. في حالة الحاوية الواحدة الشائعة لا تهيّئ قاعدة API على الإطلاق — فقط وجّه وكيلك العكسي / منهي TLS إلى `:3782`. تحتاج قاعدة API فقط لـ **النشر المنفصل** (الخلفية في حاوية/مضيف منفصل): اضبط `next_public_api_base` في `data/user/settings/system.json` على عنوان الشبكة الداخلية الذي يستخدمه خادم الواجهة الأمامية للوصول إلى الخلفية (يُقرأ من جانب الخادم، ولا يُرسَل أبداً إلى المتصفح). ```json { "next_public_api_base": "http://backend:8001" } ``` يُقبَل `next_public_api_base_external` (واسمه المستعار `public_api_base`) كبدائل ذات أولوية أقل. يستخدم CORS **منشآت** الواجهة الأمامية، وليس عناوين URL لواجهة برمجة التطبيقات. مع تعطيل المصادقة، يسمح DeepTutor بمنشآت متصفح HTTP/HTTPS العادية افتراضياً. مع تفعيل المصادقة، أضف منشآت الواجهة الأمامية الدقيقة: ```json { "cors_origins": ["https://deeptutor.example.com"] } ```

الاتصال بـ Ollama / LM Studio / llama.cpp / vLLM / Lemonade على المضيف

داخل Docker، يشير `localhost` إلى الحاوية نفسها، وليس جهازك المضيف. للوصول إلى خدمة نموذج تعمل على المضيف، استخدم بوابة المضيف (موصى بها): ```bash docker run --rm --name deeptutor \ -p 127.0.0.1:3782:3782 -p 127.0.0.1:8001:8001 \ --add-host=host.docker.internal:host-gateway \ -v deeptutor-data:/app/data \ ghcr.io/hkuds/deeptutor:latest ``` ثم في **الإعدادات ← النماذج**، وجّه عنوان URL الأساسي للمزود إلى `host.docker.internal`: - Ollama LLM: `http://host.docker.internal:11434/v1` - Ollama embedding: `http://host.docker.internal:11434/api/embed` - LM Studio: `http://host.docker.internal:1234/v1` - llama.cpp: `http://host.docker.internal:8080/v1` - Lemonade: `http://host.docker.internal:13305/api/v1` عادةً ما يحل Docker Desktop (macOS/Windows) `host.docker.internal` بدون `--add-host`. على Linux، يُعدّ هذا العلم الطريقة المحمولة لإنشاء هذا الاسم المضيف على Docker Engine الحديث. **بديل Linux — شبكة المضيف:** أضف `--network=host` وأزل علامات `-p`. تشارك الحاوية شبكة المضيف مباشرةً، لذا افتح [http://127.0.0.1:3782](http://127.0.0.1:3782) (أو `frontend_port` في `system.json`)، ويمكن الوصول إلى خدمات المضيف بعناوين URL العادية لـ localhost مثل `http://127.0.0.1:11434/v1`. لاحظ أن شبكة المضيف تكشف منافذ الحاوية مباشرةً على المضيف وقد تتعارض مع الخدمات الموجودة — للإبقاء عليها على loopback، اضبط `BACKEND_HOST=127.0.0.1` و`FRONTEND_HOST=127.0.0.1` (راجع [CONTAINERIZATION.md](../../CONTAINERIZATION.md)).

الخيار 4 — واجهة سطر الأوامر فقط · بدون واجهة ويب، من نسخة مسحوبة

عندما لا تحتاج إلى واجهة مستخدم الويب. يُثبَّت حزمة CLI فقط من نسخة مسحوبة من المصدر، وليس من PyPI. ```bash git clone https://github.com/HKUDS/DeepTutor.git cd DeepTutor # Create a venv (macOS/Linux). Windows PowerShell: # py -3.11 -m venv .venv-cli ; .\.venv-cli\Scripts\Activate.ps1 python3 -m venv .venv-cli && source .venv-cli/bin/activate python -m pip install --upgrade pip python -m pip install -e ./packaging/deeptutor-cli deeptutor init --cli deeptutor chat ``` يشارك `deeptutor init --cli` نفس تخطيط `data/user/settings/` مع التطبيق الكامل، لكنه يتخطى موجهات منفذ الخلفية/الواجهة الأمامية. ولا يزال يتيح محددي Embedding وSearch (اختر **Skip** عندما لا تحتاج إليهما)، ويكتب ملفات وقت التشغيل الأساسية (`system.json`، `auth.json`، `integrations.json`، `interface.json`، `model_catalog.json`، `main.yaml`، `agents.yaml`)، ويطلب مزود LLM النشط والنموذج.

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

```bash deeptutor chat # interactive REPL deeptutor chat --capability deep_solve --tool rag --kb my-kb deeptutor run chat "Explain Fourier transform" deeptutor run deep_solve "Solve x^2 = 4" --tool rag --kb my-kb deeptutor kb create my-kb --doc textbook.pdf deeptutor memory show deeptutor config show ```

لا يشحن تثبيت `deeptutor-cli` المحلي بأصول الويب أو تبعيات الخادم. احتفظ بالنسخة المسحوبة من المصدر — يشير التثبيت القابل للتحرير إليها. لإضافة تطبيق الويب لاحقاً، ثبّت حزمة PyPI (الخيار 1) وشغّل `deeptutor init` + `deeptutor start` من نفس مساحة العمل.

صندوق أمان تنفيذ الرمز (مهارات المكتب) · تشغيل الرمز المُولَّد بالنموذج لـ docx / pdf / pptx / xlsx

مهارات المكتب المدمجة — **docx / pdf / pptx / xlsx** — تعمل عن طريق جعل النموذج يكتب برنامج Python قصير (`python-docx`، `reportlab`، `openpyxl`، ...)، وتشغيله عبر أداة `exec` الوحيدة، وتقديم الملف المحفوظ في مساحة العمل. تُثبَّت هذه الأدوات عندما تكون خلفية صندوق الأمان نشطة. ويختار DeepTutor أقوى خلفية مهيأة بالترتيب التالي: - **Runner sidecar:** يوجّه `DEEPTUTOR_SANDBOX_RUNNER_URL` التنفيذ إلى الخدمة المحصنة والأدنى امتيازاً التي يوفرها `Dockerfile.runner`. - **Linux bubblewrap:** عند توفر `bwrap`، فإنه يعزل العملية والملفات. - **الرجوع إلى عملية فرعية مقيّدة:** لا تستخدم التثبيتات المحلية وتثبيتات الحاوية الواحدة هذا الخيار إلا عند السماح به؛ وتظل الحاوية تحت Docker حد عزل إضافياً. يتحكم إعداد `sandbox_allow_subprocess` في `data/user/settings/system.json` (افتراضي `true`) في خيار الرجوع الأخير فقط. اضبطه على `false` (أو صدّر `DEEPTUTOR_SANDBOX_ALLOW_SUBPROCESS=0`) لرفض تنفيذ العمليات الفرعية عند عدم توفر خلفية runner أو `bwrap`؛ ولا يؤدي ذلك إلى تعطيل الخلفيات الأقوى.

مرجع التهيئة — ملفات التهيئة تحت data/user/settings/ (JSON/YAML)

كل شيء تحت `data/user/settings/` هو JSON/YAML عادي. صفحة **الإعدادات** في المتصفح هي المحرر الموصى به. | الملف | الغرض | |:---|:---| | `model_catalog.json` | اتصالات المزودين، إضافة إلى ملفات تعريف LLM والمهام والتضمين والبحث وTTS وSTT والصور والفيديو، وبيانات الاعتماد والاختيارات النشطة | | `system.json` | منافذ الخلفية/الواجهة الأمامية، وقاعدة API العامة، وCORS، والتحقق من SSL، ودليل المرفقات وحدود الرفع/الاستخراج | | `auth.json` | تبديل مصادقة اختياري، واسم مستخدم، وتجزئة كلمة مرور، وإعدادات الرمز/الكوكي | | `integrations.json` | إعدادات تكامل PocketBase والمرافق الاختيارية | | `interface.json` | تفضيلات لغة واجهة المستخدم ولغة مخرجات النموذج / الثيمة / الشريط الجانبي | | `content_workspace.json` | ربط مجلدات مساحة عمل المحتوى واختيار مساحة العمل النشطة | | `video_learning.json` | مزود تشغيل YouTube/Invidious الافتراضي، ومصادر Invidious، ومحوّل اختياري للنصوص المفرّغة | | `main.yaml` | افتراضيات سلوك وقت التشغيل وحقن المسار | | `agents.yaml` | إعدادات درجة حرارة القدرة/الأداة والرمز | تُرشَّح مراجع Web Search افتراضياً: لا تظهر سوى عناوين URL عامة من `http`/`https` لا تتضمن بيانات اعتماد مضمنة أو منافذ غير معتادة. ويمكن لعمليات النشر إضافة سياسة نطاقات تركّز على التعليم في `data/user/settings/system.json`: ```json { "web_search_source_filtering": { "enabled": true, "blocked_domains": ["spam.example"], "trusted_domains": ["edu.cn", "arxiv.org"] } } ``` عندما لا تكون `trusted_domains` فارغة، تقتصر المراجع على تلك النطاقات ونطاقاتها الفرعية؛ وتكون الأولوية دائماً لـ `blocked_domains`. ملف `.env` في جذر المشروع **لا يُقرأ** كملف تهيئة للتطبيق. للإعداد الأدنى للنموذج، افتح **الإعدادات ← النماذج**، أضف ملف تعريف LLM (عنوان URL الأساسي / مفتاح API / اسم النموذج)، واحفظ. أضف ملف تعريف التضمين فقط إذا كنت تخطط لاستخدام ميزات قاعدة المعرفة / RAG. تعرض ملفات تعريف LLM وملفات تعريف نماذج المهام إعداد **تنسيق API** عندما يدعم مزودها الاختيار. أبقِ `Auto` للتوجيه والرجوع العاديين، أو اختر `OpenAI Chat Completions` أو `OpenAI Responses` أو `Anthropic Messages`؛ ويظل وضع Responses الإجباري مغلقاً عند الفشل. الحقل المحفوظ هو `api_format` (`auto` أو `openai_chat` أو `openai_responses` أو `anthropic`)؛ و`wire_api` حالة توافق مشتقة. وتغطي إعدادات التجاوز `Auto` / `Supported` / `Not supported` الخاصة بكل نموذج استدعاء الأدوات وإدخال الصور وإخراج JSON وعناصر التحكم في الاستدلال.

إلغاء التثبيت والتنظيف

يفصل DeepTutor بين شيفرته المثبَّتة، ومساحة عمله الخاصة لوقت التشغيل، ومساحة عمل المحتوى الاختيارية. افتراضياً، تكون مساحة عمل وقت التشغيل هي الدليل الذي تشغّل فيه `deeptutor init` / `deeptutor start`؛ ويمكن لـ `--home PATH` أو `DEEPTUTOR_HOME` تجاوز ذلك. حالة التطبيق الخاصة هي دليل `data` داخل تلك المساحة، ولذلك يحدد سطر لافتة بدء التشغيل الذي يبدأ بـ `Workspace:` ذلك الموقع الخاص بوقت التشغيل. إذا كانت **الإعدادات ← مساحة العمل** تشير إلى مجلد آخر، فانسخ احتياطياً أو أزل ذلك المجلد المحتوى بشكل منفصل؛ فهو لا يُمحى عمداً عند إلغاء تثبيت DeepTutor. 1. أوقف التطبيق. اضغط `Ctrl+C` في الطرفية التي تشغّل `deeptutor start`، أو شغّل `deeptutor stop [--home PATH]` إذا بدأ المُشغِّل باستخدام `--detach`؛ وأوقف أي Partner قيد التشغيل وأي حاويات Docker منفصلة قبل حذف البيانات. 2. أزل بيانات وقت التشغيل فقط إذا كنت تريد أيضاً محو كل الحالة المحلية. يشمل ذلك الإعدادات ومفاتيح API، وتاريخ المحادثة، والجلسات، وMemory، وNotebooks، وBooks، وحالة Reading، وSkills، وحالة Partners، والسجلات، وKnowledge Bases، وذاكرات التحليل المؤقتة، والمخرجات المُولَّدة، وذاكرة وقت تشغيل الواجهة الأمامية المحزّمة. انسخ أولاً مسار `Workspace:` الدقيق من لافتة بدء التشغيل وتحقق من أن مجلد `data` التابع له هو دليل بيانات DeepTutor المقصود. أنشئ نسخة احتياطية إذا كان من المحتمل أن تحتاج إلى أي شيء لاحقاً، ثم انقل ذلك الدليل المحدد إلى سلة المهملات/المحذوفات في نظام التشغيل. لا تشغّل أمراً للحذف التكراري على مسار نسبي أو متغير بيئة غير محلول. 3. أزل الحزمة المثبَّتة. استخدم الأمر المطابق للتوزيع: ```bash python -m pip uninstall deeptutor python -m pip uninstall deeptutor-cli ``` إذا أُنشئت البيئة الافتراضية لـ DeepTutor وحده، فأزلها عبر مدير البيئات. في التثبيت من المصدر، عطّل البيئة، وغادر دليل المصدر، وشغّل `git status --short` داخل تلك النسخة المحددة. لا تنقل النسخة إلى سلة المهملات/المحذوفات إلا بعد التأكد من أنها لا تحتوي عملاً غير ذي صلة أو غير ملتزم به. 4. بالنسبة إلى مسار Docker، افحص الحاوية الدقيقة ووحدة التخزين المسماة قبل إزالتهما. تؤدي إزالة وحدة التخزين إلى محو البيانات التي يديرها Docker نهائياً: ```bash docker ps -a --filter name=^/deeptutor$ docker volume inspect deeptutor-data docker rm -f deeptutor docker volume rm deeptutor-data ```

## 📖 استكشاف DeepTutor ابدأ بالأسطح الرئيسية التي ستستخدمها يومياً: Chat وPartners وMy Agents وCo-Writer وBook ومركز المعرفة وفضاء التعلم والذاكرة والإعدادات. ثم تغطي الجولة عمليات النشر متعددة المستخدمين لمساحات العمل المشتركة المعزولة. إذا فقدت إجابة قيداً سابقاً، أو استشهدت بدليل ضعيف، أو خالفت المادة المحددة، فاجمع بيانات التشخيص في [`REASONING_SAFETY_CHECKLIST.md`](../../REASONING_SAFETY_CHECKLIST.md) قبل فتح مشكلة.

الصفحة الرئيسية لـ DeepTutor — مساحة عمل Chat مع كل الأسطح في الشريط الجانبي

🏗️ معمارية النظام

💬 Chat — حلقة الوكيل التي تستخدمها فعلاً

Chat هي القدرة الافتراضية والمكان الذي يبدأ فيه معظم العمل. يمكن لخيط واحد أن يتحدث عادياً، ويستدعي الأدوات، ويرتكز على قواعد المعرفة المحددة، ويقرأ المرفقات، ويولّد الصور، ويستشير الوكلاء الفرعيين، ويكتب سجلات دفتر الملاحظات، ويستمر بنفس السياق عبر الأدوار.

الحلقة بسيطة عمداً: يفكر النموذج في جولات، ويستدعي الأدوات عند الحاجة، ويلاحظ النتائج، وينتهي برسالة خالية من الأدوات. `ask_user` خاص — بدلاً من التخمين، يمكن للوكيل إيقاف الدور مؤقتاً، وطرح سؤال توضيحي منظَّم، والاستئناف بمجرد إجابتك.

الأدوات القابلة للتبديل من قِبَل المستخدم هي `brainstorm` و`web_search` و`paper_search` و`reason` و`geogebra_analysis` — بالإضافة إلى `imagegen` و`videogen` بمجرد تهيئة نموذج التوليد المطابق. الأدوات السياقية مثل `rag` و`kb_files` و`read_source` و`read_memory` و`write_memory` و`read_skill` و`load_tools` و`exec` و`web_fetch` و`ask_user` و`list_notebook` و`write_note` و`question_bank` و`github` و`consult_subagent` و`workspace_list` و`workspace_read` و`workspace_search` و`workspace_present` و`workspace_export` تُثبَّت تلقائياً عندما يكون للدور السياق الصحيح. يأتي السياق في نوعين: يستمر **السياق الثابت للجلسة** (القدرة، ومساحة العمل أو الدورة، والأدوات، وقواعد المعرفة، والشخصية، والنموذج، وحالة Reading / Mastery) عبر الأدوار؛ وتأتي **المراجع لمرة واحدة** (الملفات وتاريخ المحادثة والكتب وأقسام القراءة ودفاتر الملاحظات وبنك الأسئلة والوكلاء المستوردون) من قائمة `+` لدور واحد. ولا يفعل زر الصوت سوى تفريغ الرسالة الحالية نصياً. تُبقي الصفحة الرئيسية **Chat** و**Ask Questions** و**Quiz** و**Visualize** على بُعد نقرة واحدة؛ وتقع **Research** للتقارير المستشهَد بها و**Solve** للاستدلال المشروح و**Immersive Watching** تحت *المزيد من القدرات*. أما **Mastery Path** و**Immersive Reading** فهما مساحتا عمل مخصصتان في الشريط الجانبي؛ وتضيف Reading استشهادات موثَّقة قابلة للنقر، واستشهادات وملاحظات محفوظة، وإجراءات قراءة بصوت عالٍ / إرشاد دراسي / مفردات / اختبار / ترجمة مرتكزة على المصدر، والتقاطاً إلى دفتر الملاحظات، بينما يحتفظ Course Study بسياقه المرتبط بالدورة.

🤝 Partner — رفاق دائمون على نفس الدماغ

الشركاء هم رفاق دائمون بروحهم الخاصة وسياسة النموذج ومكتبتهم وذاكرتهم وقنواتهم. إنهم ليسوا محرك بوت منفصلاً: كل رسالة ويب أو IM واردة تصبح دوراً عادياً لـ `ChatOrchestrator` داخل مساحة عمل محدودة بنطاق الشريك. الشريك هو "محادثة لها شخصية ورقم هاتف".

لكل شريك `SOUL.md` واختيار نموذج وقنوات وسياسة أدوات ومكتبة مخصصة. تُنسخ قواعد المعرفة والمهارات ودفاتر الملاحظات إلى `data/partners//workspace/`، لذا تعمل نفس أدوات RAG والمهارة ودفتر الملاحظات والذاكرة بدون حالات خاصة. يحتفظ المستخدمون غير المشرفين الذين تمت مصادقتهم بجلسات Partner وذاكرة علاقة خاصة، بينما يقرأ Partner ذاكرتهم الشخصية للقراءة فقط؛ وتستخدم حركة مرور المشرفين والمجموعات وغير المرتبطة نطاق Partner المشترك.

طبقة القناة مدفوعة بالمخطط ويمكنها الاتصال بمنصات IM مثل Feishu وTelegram وSlack وDiscord وDingTalk وQQ/NapCat وWeCom وWhatsApp وZulip وMattermost وMatrix وMochat وMicrosoft Teams بناءً على الإضافات المثبتة والبيانات الاعتمادية المهيأة. يمكن أيضاً توصيل الشريك كوكيل فرعي واستشارته من دور محادثة عادي — راجع **My Agents** أدناه. لإعداد أسرع، يمكن لصفحة قناة الشريك إنشاء تطبيق Feishu/Lark أو بوت WeCom AI، أو تسجيل دخول حساب WeChat شخصي، من خلال مسح رمز QR يُرسَم في المتصفح بدلاً من سجل الخادم. يكتشف Feishu/Lark نطاق الحساب ويحفظ المستخدم الذي أجرى المسح كمُرسِل مسموح به أولي. يحتفظ WeCom بقائمة سماح موجودة، وإلا فإنه يفترض افتراضياً جميع المستخدمين القادرين على الوصول إلى البوت، مع تحذير وصول مفتوح ظاهر؛ وتبقى استمارات القناة اليدوية متاحة إذا تغيّر بروتوكول المسح الخاص بأحد المزودين.

🧑‍🚀 My Agents — استشارة واستيراد الوكلاء الآخرين

يحوّل My Agents الوكلاء الآخرين إلى سياق لـ DeepTutor، ويقوم بشيئين متمايزين. **توصيل وكيل مباشر** — Claude Code أو Codex أو Antigravity أو Kimi أو opencode أو MiMo Code أو Hermes Agent أو OpenClaw أو DeepSeek Harness على جهازك، أو أحد Partners لديك — واستشارته من داخل دور محادثة: DeepTutor *يشغّل* الوكيل الآخر فعلاً ويبث عمله إلى لوحة Activity عبر أداة `consult_subagent`. اختره وحدّد له الحد الأقصى للجولات باستخدام شريحة Agent، أو صفِّ قائمة الوكلاء المتصلين نفسها باستخدام `@`؛ ويبقى اختيارك مرتبطاً بالجلسة.

**استيراد المحادثات السابقة** — أحضر تاريخ Claude Code وCodex الموجود لديك كوكلاء مسماة قابلة للبحث والاستئناف. اختر تاريخ Claude حسب المشروع / دليل العمل، وتاريخ Codex حسب تاريخ التقويم؛ ويعيد التحديث مزامنة ذلك النطاق ويسحب المحادثات الجديدة. ارجع إلى إحداها من دور Chat عبر `+` ← My Agents، وسيقرأها DeepTutor كنصوص محادثة لطرف ثالث — تبقى *محادثتهم*، وليس صوت DeepTutor الخاص.

✍️ Co-Writer — صياغة Markdown واعية بالتحديد

Co-Writer هو مساحة عمل Markdown ذات عرض مقسَّم للتقارير والدروس التعليمية والملاحظات والقطع التعليمية الطويلة. تحفظ المستندات تلقائياً وتُظهر معاينة مباشرة (رياضيات KaTeX وأسوار الرسم البياني)، ويمكن حفظها مرة أخرى في دفاتر الملاحظات عندما تصبح المسودة سياقاً قابلاً لإعادة الاستخدام. استورد ملف `.docx` لبدء مسودة جديدة، وصَدِّر المحرر الحالي كـ Markdown أو Word.

الفكرة المحورية هي **التحرير الجراحي**: حدد نطاقاً واطلب من DeepTutor إعادة كتابته أو توسيعه أو تقصيره. يمكن لوكيل التحرير ترسيخ التغيير في قاعدة معرفة أو دليل ويب، ويحتفظ بأثر استدعاءات أدواته. وإذا لم تتغير المسودة أثناء عمله، تستبدل النتيجة النص المحدد مباشرةً وتظل قابلة للعكس باستخدام **Undo**.

📖 Book — كتب حية من موادك

يحوّل Book المصادر المحددة إلى **كتاب حي** تفاعلي — ليس PDF ثابتاً، بل بيئة قراءة مبنية من كتل مكتوبة. يمكن أن يبدأ الكتاب من قواعد المعرفة أو دفاتر الملاحظات أو بنوك الأسئلة أو تاريخ المحادثة؛ يقترح تدفق الإنشاء هيكل فصل قبل توليد المحتوى، لذا تراجع الشكل بدلاً من قبول مخرجات عشوائية.

كتلة اختبار في الكتاب كتلة رسوم متحركة Manim في الكتاب كتلة ودجت تفاعلية في الكتاب

يُجمِّع كل فصل إلى كتل ذات أنواع محددة وقابلة للتحرير — نصوص وأقسام وتنبيهات واختبارات وبطاقات فلاش وجداول زمنية ورمز وأشكال وHTML تفاعلية ورسوم متحركة وأشكال مفاهيم وغوص عميق وملاحظات مستخدم — وله Page Chat الخاصة به. أدرج كتلة أو حرّكها أو أعد توليدها أو كتابتها أو غيّر نوعها؛ وتدخل المقاطع المحددة إلى صندوق وارد لمقتطفات التعلّم يمكن مراجعته. يبقى التقدّم والإشارات المرجعية ومحاولات الاختبار ومقتطفات التعلّم وPage Chat خاصاً بكل قارئ، حتى عندما يشارك المشرف كتاباً للقراءة فقط أو للتحرير التعاوني؛ ويظل حذف الكتب المشتركة مقصوراً على المشرف. يمكن تصدير أي كتاب إلى Markdown، وتتوقف عمليات التجميع الطويلة مؤقتاً وتُستأنف، ويكشف `deeptutor book health` / `refresh-fingerprints` عن انجراف المصادر.

📚 مركز المعرفة — مكتبات RAG متعددة المحركات

قواعد المعرفة هي مجموعات المستندات وراء RAG — إنها ترسّخ أدوار Chat وتحرير Co-Writer وتوليد Book ومحادثات Partner. ما يميزها هو **اختيار محرك الاسترجاع**: **LlamaIndex** (الافتراضي، مزيج من المتجهات + BM25 مع إعادة ترتيب اختيارية بمرمّز متقاطع وفهارس FAISS من نوع exact-flat أو HNSW)، **PageIndex** (استرجاع تفكيري مع استشهادات على مستوى الصفحة، مستضاف أو مفتوح المصدر ذاتي الاستضافة)، **GraphRAG** و**LightRAG** (استرجاع قائم على الرسم البياني المعرفي)، **LightRAG Server** (استرجاع مُحال إلى نسخة LightRAG خارجية تتصل بها عبر HTTP)، **WeKnora** (استرجاع من قاعدة معرفة في نشرك ذاتي الاستضافة، بلا فهرس محلي أو نسخة من المستند)، **Tencent IMA** (مكتبة تنظّمها ضمن IMA — يُبحث فيها ويُتصفَّح ويُكتَب إليها عبر OpenAPI الخاصة بها)، **MarginNote 4** (بيانات دراستك في MN4 — المستندات والمقتطفات وبطاقات الخريطة الذهنية والروابط بينها — التي تدفعها إضافة (Add-on) التطبيق ويتم التنقل فيها بأدوات مخصصة)، أو مخزن **Obsidian** مرتبط يقرأ المدرس ويكتب فيه في مكانه. كل قاعدة معرفة مرتبطة بمحرك واحد.

هل تنقل مكتبة Obsidian أو Hermes أو Markdown موجودة؟ راجع [دليل نقل المعرفة](../../KNOWLEDGE_MIGRATION.md) لمساري المخزن المتصل والنسخة المفهرسة. عند إنشاء قاعدة معرفة، إما أن **تنشئ جديدة** (تحميل مستندات وبناء فهرس جديد) أو **تربط موجودة** (إعادة استخدام فهرس مبني في مكان آخر، قراءة في مكانه بدون إعادة فهرسة). يمكن لقاعدة المعرفة أيضاً تتبُّع **مستودعات GitHub** (المستودع والفرع ونمط glob) أو **عناوين URL لمواقع التوثيق** (مع حدود لعمق الزحف وعدد الصفحات)؛ وعند المزامنة حسب الطلب، تقارن تجزئات المحتوى لتحديد ما أُضيف أو تغيّر أو أُزيل، كي تبقى الوثائق التي تتابعها محدَّثة دون إعادة رفع. تكتب إعادة الفهرسة دليل `version-N` مسطحاً جديداً وتحتفظ بالسابقة، لذا لا يُدمَّر فهرس عامل أبداً أثناء إعادة البناء. يمكن إزالة مستند واحد حتى من قاعدة في حالة **خطأ** — إسقاط ملف فشل تحليله بدون حذف وإعادة بناء كاملين. تحليل المستندات — نص فقط أو MinerU أو Docling أو Tika أو markitdown أو PyMuPDF4LLM أو LiteParse — يُختار في **الإعدادات ← قاعدة المعرفة**، مع إيقاف تنزيلات النماذج المحلية افتراضياً. يمكن لـ Docling أيضاً العمل في وضع **بعيد** مقابل خادم Docling Serve (بلا حاجة إلى تثبيت محلي أو نماذج)، يُهيَّأ عبر **الإعدادات ← تحليل المستندات** (`mode=remote`، وعنوان URL أساسي للخادم، ومفتاح API اختياري) أو متغيرات البيئة `DOCLING_MODE` / `DOCLING_API_BASE_URL` / `DOCLING_API_TOKEN`. أما Tika فهو بعيد فقط ويشير إلى خادم Apache Tika المهيَّأ في تلك الصفحة. تعكس واجهة CLI دورة الحياة عبر `list/info/create/add/search/set-default/delete`، وأوامر إضافة المصادر وإزالتها، و`list-sources`، و`sync`. يُثبَّت محرك LightRAG المدمج عبر `pip install 'deeptutor[rag-lightrag]'`. تحتوي هذه الإضافة على SDK الخاص بـ LightRAG المدعوم لكنها لا تُثبِّت MinerU. اختر MinerU بشكل مستقل في تحليل المستندات، وإما هيّئ وضعه السحابي أو ثبّت واجهة سطر أوامره المحلية الحالية عندما تحتاج إلى تحليل منظَّم. يقبل MinerU ملفات PDF والصور النقطية الشائعة وDOCX وPPTX وXLSX؛ ويظل الأمر القديم `magic-pdf` مقصوراً على PDF. لا يتطلب وضع النص فقط ومحركات التحليل الأخرى MinerU.

🌐 فضاء التعلم — المهارات والشخصيات والسياق القابل لإعادة الاستخدام

فضاء التعلم هو طبقة المكتبة والتنظيم والتخصيص. تضم **المحادثات والمواد** سجل Chat ودفاتر الملاحظات — بسجلات يمكن نقلها أو نسخها بين الدفاتر وتصديرها إلى Markdown — وبنك أسئلة يحتفظ بإجابتك والإجابة المرجعية والشرح. أما **التخصيص** فيضم الشخصيات والمهارات (أدلة `SKILL.md`) و**خدمات MCP** التي تُثبَّت بنقرة واحدة و**تطبيقات CLI** من كتالوج [CLI-Anything](https://github.com/HKUDS/CLI-Anything)، ولكل تطبيق دليل استخدام يُحمَّل عند الطلب. وتجمع مساحة **دوراتي** المنفصلة محادثات المواد ومحادثات المدرّسين؛ ولا يُتاح كل أصل إلا في سير العمل التي تدعمه.

لا يجب عليك كتابة كل مهارة بنفسك — **الاستيراد من EduHub** يتصفح الكتالوج المجتمعي ويُنزّل المهارة مباشرةً إلى مكتبتك من خلال بوابة أمان (راجع [النظام البيئي](#-النظام-البيئي--eduhub-ومجتمع-المهارات)).

🧠 Memory — تخصيص قابل للتدقيق

الذاكرة نظام ثلاثي الطبقات مدعوم بالملفات يمكنك قراءته وتنظيمه ومراجعته — وهو عمداً *ليس* مخزناً ناقلاً مخفياً. **L1** هو مرآة مساحة العمل بالإضافة إلى آثار أحداث تراكمية فقط (`trace//.jsonl`)؛ **L2** هو حقائق منظَّمة لكل سطح (`L2/.md`) مع مراجع إلى كيانات L1؛ و**L3** هو تركيب عبر الأسطح (`L3/.md`) يسجل أسطح L2 المساهمة فيه.

يُظهر Memory Graph الهرم بأكمله — تركيب L3 في المركز وL2 في الحلقة الوسطى وآثار L1 في الخارج — مع حواف أدلة دقيقة تربط حقائق L2 بأدلة L1، وروابط تصل تركيب L3 بالأسطح المساهمة. تُتتبع الذاكرة عبر أسطح `chat` و`notebook` و`quiz` و`kb` و`book` والشريك و`cowriter`؛ وتُضبط ميزانيات تحديث الموحّد / تدقيقه / إلغاء تكراره في **الإعدادات ← الذاكرة**.

⚙️ الإعدادات — لوحة تحكم واحدة

الإعدادات هي لوحة التحكم التشغيلية، تُفتح على شريط حالة مباشر (سلامة الخلفية والذاكرة المقيمة)، ولغة الواجهة ولغة مخرجات النموذج، ومصفوفة **جاهزية** (Readiness) تُقيّم كل قدرة بأنها عائق أو تحذير أو اقتراح — ثم شريط تنقّل دائم وقابل للبحث يصل إلى أي صفحة بنقرة واحدة: **المظهر** (الثيمة، وتنسيق كتل الرمز)، **الشبكة** (قاعدة API والمنافذ وCORS)، **مساحة العمل** (المجلد القابل لقراءة الوكيل ومجلد `outputs/` المشترك فيه)، **النماذج** (الاتصالات، وLLM، ونماذج المهام، والتضمين، والبحث، وتحويل النص إلى كلام، وتحويل الكلام إلى نص، وتوليد الصور، وتوليد الفيديو)، **قاعدة المعرفة** (محرك تحليل المستندات)، **Chat** (Video Learning، والأدوات القابلة للبحث، والمعاملات لكل قدرة، ونقاط الانطلاق، وحدود المرفقات)، **الشركاء والوكلاء** (تسعة مُشغِّلات محلية)، و**ملف المتعلم** (العمر، والصف، والمنهج، واللغة، ومستوى القراءة، وأسلوب الشرح)، و**ولي الأمر** (المتعلمون المصرَّح بهم، والمواد، والتقارير، وإعادة ضبط بيانات الاعتماد)، و**الذاكرة** (ميزانيات الموحّد)، و**حول** (التحقق من الإصدار والتحديثات الآمنة). يحتفظ **الاتصال** ببيانات اعتماد مزود واحد وينسخها إلى كل خدمة يمكن لذلك المزود خدمتها، لذا يُدخَل المفتاح مرة واحدة بدلاً من لصقه في خمس صفحات؛ وتُثبِّت **نماذج المهام** نموذجاً صغيراً وسريعاً للأعمال التي لم يطلبها أحد — تسمية محادثة، أو كتابة نقاط الانطلاق في شريط المؤلف — وتُحلّ إلى الافتراضي النشط عند تركها فارغة. يستخدم **Video Learning** ضمن الإعدادات ← Chat مشغّل YouTube IFrame الرسمي المعزَّز للخصوصية افتراضياً. لإبقاء التشغيل محلياً، اضبط مصدر Invidious API الذي يديره المشرف (مثلاً `http://127.0.0.1:3000`)، واختبره، وحدد Invidious، ثم احفظ. تلتقط مقاطع الفيديو الجديدة أو التي يُعاد فتحها المزود فوراً مع الاحتفاظ بمعرّف المادة والتقدّم نفسيهما. تُبث وسائط Invidious عبر وكيل النطاق البايتّي في DeepTutor؛ فلا تُكشف عناوين URL المصدرية للمتصفح ولا تُخزَّن على القرص. إذا تعطلت النسخة، يظل DeepTutor غير متصل بـ YouTube حتى يختار المتعلم صراحةً الرجوع إلى تشغيل YouTube الأصلي. التدريس بالترجمات العامة اختياري: ثبّت `.[video-learning]`؛ ويستمر التشغيل من دونه، بينما تُعطَّل ميزة **اشرح هنا** المعتمدة على النص المفرّغ مع توضيح السبب.

تستخدم معظم الأقسام تدفق صياغة-وتطبيق، لذا يمكنك اختبار مزود قبل الالتزام به. يمكنك أيضاً أن تطلب ذلك ببساطة في Chat: يقرأ المساعد التهيئة الحالية، ويطبّق التغيير، ويخبرك إن كان يحتاج إلى إعادة تشغيل أو إعادة فهرسة — مع اختبار النموذج الجديد قبل الالتزام به، بحيث لا يمكنه تبديل نفسه إلى شيء يتعذّر الوصول إليه. مفاتيح API لا تمرّ أبداً عبر النموذج، الذي يفتح لك بدلاً من ذلك الاستمارة المطابقة. تشحن أربع ثيمات في الصندوق — Default وCream وDark وGlass. ملفات `.env` في جذر المشروع تُتجاهل عمداً؛ يعيش تهيئة وقت التشغيل تحت `data/user/settings/*.json` إلا إذا وجّه `DEEPTUTOR_HOME` أو `deeptutor start --home` التطبيق في مكان آخر. **OpenAI Codex OAuth (تجريبي).** اختيار **OpenAI Codex** ضمن **النماذج ← LLM** يستبدل حقول مفتاح API بتسجيل دخول عبر المتصفح يعمل مقابل خطة ChatGPT الخاصة بك، لذا لا حاجة إلى `OPENAI_API_KEY`. تعيش الرموز (tokens) فقط في `data/system/user-secrets//private/openai-codex/` — في نشر Compose متعدد الحاويات، خارج كل شجرة يمكن لصندوق أمان التنفيذ الوصول إليها — ولا يقرأ DeepTutor أو يعدّل أبداً تسجيل دخولك إلى CLI في `~/.codex`. تأتي قائمة النماذج من الكتالوج الحي لذلك الحساب؛ تسجيل الدخول ينشر الملف الشخصي لكنه لا يصبح النموذج النشط إلا عندما لا يكون هناك LLM مهيأ بعد. ولأن الرمز يخوّل خطة شخص واحد فقط، فالملف الشخصي غير قابل للمشاركة عبر منح المستخدمين — كل حساب يسجّل دخوله بنفسه، بما في ذلك المستخدمون العاديون: تظهر بطاقتهم ضمن **النماذج ← LLM**، وتبقى النماذج الناتجة والكتالوج وتسجيل الخروج خاصة بذلك الحساب. تستخدم عمليات نشر Docker وPodman المحلية الافتراضية شبكات loopback منفصلة وتحتاج إلى جسر مؤقت أثناء تسجيل الدخول. اتبع [دليل جسر OAuth المؤقت المحلي لـ Codex](../../CONTAINERIZATION.md#temporary-local-codex-oauth-bridge) للاطلاع على أوامر Docker وCompose وPodman والإزالة الدقيقة. في حالة النشر عن بُعد، يكون `localhost` الخاص بالمتصفح و`localhost` الخاص بالخادم جهازين مختلفين، لذا لا يستطيع وكيل عكسي عادي وحده نقل استدعاء (callback) localhost من المتصفح إلى الخادم. استخدم نفق SSH كجسر للاستدعاء. يصل النفق إلى منفذ الويب المنشور بالفعل؛ يعيد Next.js توجيه مسار الاستدعاء الدقيق فقط إلى وسيط الاستدعاء العام، ويتحقق الوسيط من `state` قبل التوجيه إلى عملية OAuth الأصلية. يبقى مستمع الاستدعاء على loopback الخلفية، والمنفذان `1455` و`1457` غير منشورين، ويدعم هذا المسار شبكة جسر Docker الافتراضية. ```bash ssh -N -L 1455:127.0.0.1:3782 @ ``` إذا أبلغ DeepTutor عن منفذ استدعاء احتياطي (fallback) `1457`، استخدم: ```bash ssh -N -L 1457:127.0.0.1:3782 @ ``` نفّذ الأمر الواحد المطابق لمنفذ الاستدعاء الفعلي فقط؛ لا تُشغّل كليهما أبداً. `3782` هو فقط منفذ الويب المثال: إنه منفذ الواجهة الأمامية/الحاوية المهيأ والمُبلَّغ عنه كـ `callback_forward_port`. لا تضمن هذه القيمة أن المنفذ نفسه يستمع على `127.0.0.1` الخاص بمضيف SSH. إذا نشر Docker أو Podman منفذ مضيف مختلفاً، أو استمع وكيل عكسي على منفذ مختلف، استبدل فقط منفذ الهدف الظاهر في الجهة اليمنى من الأمر (`3782` أعلاه) بمنفذ الويب الذي يستمع فعلياً على `127.0.0.1` الخاص بمضيف SSH؛ أبقِ منفذ الاستدعاء الظاهر في الجهة اليسرى كما هو، أي `1455` أو `1457`. `` هو مضيف SSH الذي يملك loopback الذي يستضيف ذلك المنفذ المستمع. إذا كان عنوان URL في المتصفح يشير إلى وكيل عكسي أو موازن تحميل، استبدله بمضيف SSH الأمامي الصحيح. تطبع واجهة سطر الأوامر (CLI) أمر النفق ثم تحاول فوراً فتح المتصفح. في حالة النشر عن بُعد، أبقِ صفحة التفويض مفتوحة دون إتمامها، أنشئ النفق المطبوع في طرفية أخرى، ثم تابع عملية التفويض بعد ذلك فقط. لاكتشاف الطوبولوجيا عن بُعد حدٌّ يتعلق بـ localhost. إذا كان الوصول إلى الويب نفسه يتم عبر إعادة توجيه localhost من SSH أو من بيئة تطوير (IDE)، فلا يستطيع المتصفح معرفة أن الخادم بعيد. بالنسبة لعملية الويب الحالية، اترك صفحة تفويضها دون إنهاء، واقرأ `redirect_uri` في عنوان URL الخاص بالتفويض لتلك العملية لتحديد منفذ الاستدعاء `1455` أو `1457`، وأنشئ النفق الثاني من ذلك المنفذ المحلي إلى منفذ الويب الفعلي. بدلاً من ذلك، ألغِ عملية الويب تلك وابدأ عملية جديدة عبر CLI؛ إذ يخص ناتج CLI العملية الجديدة ويجب ألا يُستخدم لعملية الويب القائمة. تُبلَّغ أخطاء الحصة وفشل الكتالوج كما هي ولا تتراجع أبداً إلى مزود مدفوع. مسار التوافق هذا تجريبي: قد تتغيّر واجهة المصدر الأعلى (upstream).

👥 متعدد المستخدمين — النشر المشترك · مصادقة اختيارية، مساحات عمل معزولة لكل مستخدم

المصادقة **معطلة افتراضياً** — يعمل DeepTutor لمستخدم واحد. فعّلها وشجرة `data/` واحدة تستضيف مساحة عمل المشرف ومساحات عمل معزولة لكل مستخدم ومساحات عمل الشريك جنباً إلى جنب: ```text data/ ├── user/ # Admin workspace + global settings ├── users// # Per-user scope: chat history, memory, notebooks, KBs ├── partners//workspace/ # Partner (synthetic-user) scope ├── cli-apps/ # Installed CLI apps, mounted read-only into the sandbox └── system/ # auth · grants · audit · user-secrets/ (OAuth tokens) ``` **أول مستخدم مسجَّل يصبح مشرفاً** ويمتلك كتالوجات النماذج وبيانات اعتماد المزود وقواعد المعرفة المشتركة والمهارات والكتب المشتركة المرجعية والمنح لكل مستخدم. يختار المستخدمون المحليون الذين ينشئهم المشرف Standard أو Learner أو Custom. يقيّد Learner قدرات التعلم وسياسة المواد، ويضيف ملفاً تكيفياً، ويدعم بيانات اعتماد أجهزة قابلة للإلغاء مع انتهاء صلاحية وحدود يومية؛ ويمكن لأولياء الأمور المصرَّح لهم عرض التقارير والموافقة على المواد وإعادة ضبط بيانات الاعتماد. يحصل المستخدمون الآخرون على مساحات عمل معزولة، إضافةً إلى نماذج وقواعد معرفة ومهارات وPartners ووصول إلى الكتب المشتركة ضمن نطاق محدد، من دون الحصول على مفاتيح API الخام. إذا كان `auth.json` يحتوي مسبقاً على `username` + `password_hash`، فإن ذلك الحساب هو المشرف: يظل `/register` مغلقاً، وتكون الحسابات المنشأة من `/admin/users` دائماً `role=user` إلى أن ترفع صلاحياتها. **تفعيله:** فعّل المصادقة في `data/user/settings/auth.json`، وأعد تشغيل `deeptutor start`، وسجّل أول مشرف على `/register`، ثم أضف المستخدمين من `/admin/users` وعيّن النماذج وقواعد المعرفة والمهارات والـ Partners وسياسة الأداة/MCP/تطبيق CLI ووصول تنفيذ الرمز من خلال المنح؛ وهيّئ الكتب المشتركة من لوحة **الوصول إلى الكتب** لكل مستخدم. > يبقى PocketBase تكاملاً لمستخدم واحد — أبقِ `integrations.pocketbase_url` فارغاً لعمليات النشر متعددة المستخدمين إلا إذا وصلت مخزن مستخدم خارجي.

## ⌨️ واجهة سطر أوامر DeepTutor — الواجهة الأصيلة للوكلاء ثنائي `deeptutor` واحد، طريقتان للدخول: **REPL** تفاعلي للأشخاص الذين يعيشون في الطرفية، و**JSON** منظَّم للوكلاء الأخرى التي تقود DeepTutor كأداة. نفس القدرات والأدوات وقواعد المعرفة في كلتا الحالتين.

قدّها بنفسك

يفتح `deeptutor chat` واجهة REPL تفاعلية ويختار وضعاً باستخدام `--capability`؛ بينما يأخذ `deeptutor run ""` تلك القدرة كأول وسيطة موضعية ويخرج بعد دور واحد. ويقبل كلاهما `--tool` و`--kb` و`--config`. ```bash deeptutor chat # interactive REPL deeptutor chat --capability deep_solve --kb my-kb --tool rag deeptutor run chat "Explain the Fourier transform" --tool rag --kb textbook deeptutor run deep_research "Survey 2026 papers on RAG" \ --config mode=report --config depth=standard ``` تتوفر هنا أيضاً إدارة مساحة العمل الأساسية — قواعد المعرفة (`kb`)، والجلسات (`session`)، والشركاء (`partner`)، والمهارات (`skill`)، ودفاتر الملاحظات، والذاكرة، والتهيئة؛ بينما يظل تنظيم الدورات والجلسات في تطبيق الويب. القائمة الكاملة أدناه.

دع وكيلاً يقودها

DeepTutor مبنية لتكون *مُشغَّلة بواسطة وكيل آخر*. أضف `--format json` إلى أي `run` وكل دور يبث **NDJSON — حدث واحد في كل سطر** (`content` و`tool_call` و`tool_result` و`done` و...)، وكل سطر مُعنوَن بـ `session_id` الخاص به. التشغيلات آمنة بدون TTY: توقف `ask_user` بدون TTY يحل تلقائياً برد فارغ بدلاً من التعليق. ```bash # One shot, machine-readable deeptutor run deep_solve "Find d/dx[sin(x^2)]" --tool reason --format json # Chain turns in one stateful session — capture the id, reuse it SID=$(deeptutor run deep_research "Survey 2026 papers on RAG" \ --config mode=report --config depth=standard --format json \ | jq -r 'select(.type=="done").session_id') deeptutor run deep_question "Quiz me on that survey" --session "$SID" --format json ``` يشحن المستودع بملف [`SKILL.md`](../../SKILL.md) في الجذر — وثيقة تسليم بنحو 200 سطر تعلّم أي LLM يستخدم الأدوات السطح بأكمله في قراءة واحدة. سلّمها إلى Claude Code أو Codex أو OpenCode (يلتقطون `SKILL.md` تلقائياً)، أو لفّ `deeptutor run` كأداة في حلقة LangChain / AutoGen. الوصفات الكاملة: [Agent Handoff](https://deeptutor.info/docs/cli/agent-handoff/).

مرجع الأوامر

| الأمر | الوصف | |:---|:---| | `deeptutor init` | إنشاء أو تحديث `data/user/settings` في مساحة عمل وقت التشغيل الحالية | | `deeptutor doctor [--online]` | التحقق مما إذا كان وقت التشغيل جاهزاً لبدء جلسة؛ `--online` يفحص أيضاً مزود النموذج المهيَّأ، و`--format json` يطبع التقرير | | `deeptutor start [--home PATH] [--dev] [--detach] [--no-browser]` | تشغيل الخلفية + الواجهة الأمامية معاً؛ مع خيار العمل منفصلاً أو منع فتح المتصفح | | `deeptutor stop [--home PATH]` | إيقاف مُشغِّل بدأ باستخدام `--detach` | | `deeptutor serve [--port PORT]` | تشغيل خلفية FastAPI فقط | | `deeptutor workspace show/set/reset` | فحص مساحة عمل المحتوى الخاصة بالمستخدم، أو اختيارها، أو استعادتها | | `deeptutor run ` | تشغيل دور قدرة واحدة (`chat` و`ask_questions` و`deep_solve` و`deep_question` و`deep_research` و`visualize` و`math_animator` و`mastery_path` و`immersive_reading` و`course_study` و`immersive_watching`)؛ أضف `--format json` لإخراج NDJSON | | `deeptutor chat` | REPL تفاعلي مع تحكمات القدرة والأداة وقاعدة المعرفة ودفتر الملاحظات والتاريخ | | `deeptutor partner list/create/start/stop` | إدارة الشركاء المتصلين بـ IM | | `deeptutor kb list/info/create/add/search/set-default/delete/list-sources/sync` | إدارة قواعد المعرفة ومزامنة مصادر GitHub/الويب المسجَّلة (مع أوامر إضافة المصادر وإزالتها) | | `deeptutor skill search/install/list/remove/login/logout/publish/update` | إدارة المهارات، التثبيت من المراكز، ونشر مهاراتك الخاصة (`eduhub:` افتراضياً، راجع النظام البيئي) | | `deeptutor memory show/clear` | فحص مستندات الذاكرة L2/L3 أو مسح ذاكرة L1/الكل | | `deeptutor session list/show/open/rename/delete` | إدارة الجلسات المشتركة | | `deeptutor notebook list/create/show/add-md/replace-md/remove-record` | إدارة دفاتر الملاحظات من ملفات Markdown | | `deeptutor book list/health/refresh-fingerprints` | فحص الكتب وتحديث بصمات المصادر | | `deeptutor plugin list/info` | فحص الأدوات والقدرات المسجلة | | `deeptutor config show` | طباعة ملخص التهيئة | | `deeptutor provider login ` | مصادقة المزود (`openai-codex` OAuth login؛ `github-copilot` يتحقق من جلسة مصادقة Copilot موجودة؛ `codebuddy` يتحقق من مصادقة CodeBuddy SDK ويبدأ تسجيل الدخول عند الحاجة) |

توزيع CLI فقط

حزمة CLI فقط تعيش في `packaging/deeptutor-cli`. في هذه النسخة، ثبّتها من المصدر: ```bash python -m pip install -e ./packaging/deeptutor-cli ``` لم تُنشر على PyPI بعد، لذا يحتفظ قسم [البدء](#-البدء) الرئيسي بمسار التثبيت من المصدر.

## 🧩 النظام البيئي — EduHub ومجتمع المهارات تستخدم مهارات DeepTutor تنسيق **Agent-Skills** المفتوح — مجلد يحتوي دليل `SKILL.md` (YAML frontmatter + Markdown) وملفات مرجعية اختيارية. لا شيء في ذلك خاص بـ DeepTutor، لذا أي سجل يتحدث التنسيق يصبح مصدراً لمكتبتك. يشحن DeepTutor مع **[EduHub](https://eduhub.deeptutor.info/)** — سجل المهارات المركّز على التعليم الخاص بنا — مُوصَّلاً كمركز افتراضي.

EduHub — النظام البيئي للمهارات في DeepTutor

[**EduHub**](https://eduhub.deeptutor.info/) هو المركز المجتمعي الذي أطلقه DeepTutor لمشاركة مهارات الوكيل الموجهة نحو التعليم — موجهو سقراط وبناة بطاقات الفلاش وتغذية راجعة للمقالات وخطط الامتحانات وشارحو المفاهيم وغيرها. مُدمَج في DeepTutor، لذا لا شيء يجب تهيئته: slug مجرد أو بادئة `eduhub:` تحل إليه. **البحث والتثبيت** — في المتصفح، افتح **فضاء التعلم ← المهارات ← الاستيراد من EduHub** لتصفح الكتالوج وتنزيل مهارة مباشرةً إلى مكتبتك. من الطرفية: ```bash deeptutor skill search "socratic tutor" # search EduHub (the default hub) deeptutor skill install socratic-tutor # fetch → verify → register deeptutor skill install eduhub:socratic-tutor@1.2.0 # pin a hub and a version deeptutor skill list # local skills with their hub provenance ``` **انشر مهارتك الخاصة** — حزّم `SKILL.md` وشاركها مع المجتمع: ```bash deeptutor skill login # browser sign-in to EduHub deeptutor skill publish ./my-skill # interactive: pick a track + tags, then upload deeptutor skill update # roll back or release a new version ``` EduHub هو أيضاً سجل مستقل متوافق مع ClawHub، لذا الوكلاء الذين ليسوا DeepTutor (Claude Code وCodex و...) يمكنهم استخدامه مباشرةً من خلال واجهة `eduhub` — `npx eduhub install socratic-tutor`.

بوابة أمان الاستيراد

مهما كان المصدر، كل استيراد يمر من **نفس بوابة الأمان** قبل أن يلمس أي شيء مساحة عملك: - يُفحَص **حكم الأمان** للسجل أولاً — الحزم الموسومة ترفض إلا إذا مررت `--allow-unverified`؛ - تُستخرَج الأرشيفات بشكل دفاعي مع فحوص اجتياز المسار وعدد الإدخالات والحجم ونسبة الضغط واللاحقة والروابط الرمزية؛ وتُزال بتات التنفيذ، بينما تبقى الملفات بلا امتداد مسموحاً بها؛ - تُعيَّر الـ frontmatter إلى مخطط DeepTutor و`always:` **تُزال**، لذا مهارة محملة لا يمكنها أبداً إجبار نفسها في كل مطالبة نظام؛ - المصدر — المركز والإصدار والحكم ووقت التثبيت — يُكتب إلى `.hub-lock.json` للمراجعات والتحديثات. في عمليات النشر متعددة المستخدمين، تصل عمليات الاستيراد من المتصفح إلى طبقة مهارات المستدعي المصادَق عليه، بينما تستهدف عمليات التثبيت من CLI ووحدة تحكم المشرف مساحة عمل المالك/المشرف؛ وتبقى مهارات المشرف مخفية وللقراءة فقط للمستخدمين العاديين إلى أن تُمنح لهم.

متوافق أيضاً مع ClawHub

لأن DeepTutor يتحدث تنسيق Agent-Skills المفتوح، **[ClawHub](https://clawhub.ai/)** يعمل كمصدر من الدرجة الأولى أيضاً — مُدمَج جنباً إلى جنب مع EduHub. اختره ببادئة المركز: ```bash deeptutor skill search "git release notes" --hub clawhub deeptutor skill install clawhub:git-release-notes@1.0.1 deeptutor skill install clawhub:udiedrichsen/stock-analysis ``` عندما يشترك عدة ناشرين في نفس الـ slug، يعرض البحث كل ناشر ومرجع تثبيت كامل النطاق (`clawhub:/`). أضف المزيد من السجلات في `data/user/settings/skill_hubs.json`: إدخال `type: "clawhub"` يشير إلى أي HTTP API متوافق (EduHub وClawHub يتحدثانه كلاهما)، `type: "command"` يلفّ أي CLI جلب يشحنه السجل، و`"default"` يختار المركز المستخدم للـ slugs المجردة. كلها تُغذّي نفس بوابة الاستيراد.

## 🤝 شركاء المصادر المفتوحة

باستخدام الرمز: DEEPTUTOR20 — احصل على خصم 20 دولاراً على أول اشتراك في PageIndex!

## 🌐 المجتمع ### 🔗 المشرفون

Bingxi Zhao

Xingyu Hou

Jiahao Zhang

### 📮 التواصل DeepTutor هو مشروع مفتوح المصدر تقوده [Bingxi Zhao](https://github.com/pancacake) ضمن مجموعة [HKUDS](https://github.com/HKUDS)، ويتطور بشكل **مفتوح المصدر بالكامل**، مبني مع المجتمع. حتى الآن، **لا يوجد** لدينا أي منتجات مدفوعة عبر الإنترنت من أي شكل. تفضّل بالتواصل على **bingxizhao39@gmail.com** للنقاشات والأفكار والتعاون. ### 🙏 التقدير خالص الشكر لـ [**Chao Huang**](https://sites.google.com/view/chaoh)، مدير مختبر ذكاء البيانات @ HKU، ولزملائنا في HKUDS على دعمهم الحار — وخاصةً [**Jiahao Zhang**](https://github.com/zzhtx258)، و[**Zirui Guo**](https://github.com/LarFii)، و[**Xubin Ren**](https://github.com/Re-bin). ونحن ممتنون عميقاً أيضاً لـ **مجتمع المصادر المفتوحة**: نجومكم وإصداراتكم وطلبات السحب والنقاشات تشكّل DeepTutor كل يوم. يقف DeepTutor أيضاً على أكتاف مشاريع مفتوحة المصدر متميزة أعطتنا أدوات وإلهاماً: | المشروع | الدور / الإلهام | |:---|:---| | [**LlamaIndex**](https://github.com/run-llama/llama_index) | العمود الفقري لخط أنابيب RAG وفهرسة المستندات | | [**nanobot**](https://github.com/HKUDS/nanobot) | محرك وكيل خفيف الوزن للغاية مكّن TutorBot الأصلي *(HKUDS)* | | [**LightRAG**](https://github.com/HKUDS/LightRAG) | RAG بسيط وسريع *(HKUDS)* | | [**AutoAgent**](https://github.com/HKUDS/AutoAgent) | إطار وكيل بدون رمز *(HKUDS)* | | [**AI-Researcher**](https://github.com/HKUDS/AI-Researcher) | خط أنابيب بحث آلي *(HKUDS)* | | [**OpenClaw**](https://github.com/openclaw/openclaw) | بوابة وكيل مفتوحة ونظام مهارات وراء ClawHub | | [**Codex**](https://github.com/openai/codex) | واجهة برمجة أصيلة للوكلاء ألهمت سير عمل CLI لدينا | | [**Claude Code**](https://github.com/anthropics/claude-code) | واجهة برمجة للوكلاء ألهمت حلقة وكيل DeepTutor | | [**ManimCat**](https://github.com/Wing900/ManimCat) | توليد رسوم متحركة رياضية مدفوع بالذكاء الاصطناعي لـ Math Animator | ### 🗺️ خارطة الطريق والمساهمة نريد لـ DeepTutor أن يستمر في التطور والتحسين — وفي نهاية المطاف أن يصبح هدية نقدمها للمجتمع مفتوح المصدر. يُحدَّث [**خارطة طريقنا**](https://github.com/HKUDS/DeepTutor/issues/498) باستمرار؛ صوّت على العناصر هناك أو اقترح عناصر جديدة. إذا كنت ترغب في المساهمة، راجع [**دليل المساهمة**](../../CONTRIBUTING.md) لمعرفة استراتيجية الفروع ومعايير البرمجة وكيفية البدء.

نأمل أن يصبح DeepTutor هدية للمجتمع. 🎁

مرخّص بموجب [رخصة Apache 2.0](../../LICENSE).