Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

114 KB
Raw Blame

DeepTutor

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

الوثائق — deeptutor.info  التعاون — اعمل معنا

مستودع GitHub الرائج لهذا اليوم HKUDS/DeepTutor | Trendshift ترتيب تاريخ النجوم

English  简体中文  繁體中文  日本語  Español  Français  Arabic  Русский  Hindi  Português  Thai  Polski

Python 3.11+ Next.js 16 License GitHub release arXiv

Discord Feishu WeChat

الميزات · البدء · الاستكشاف · واجهة CLI · النظام البيئي · المجتمع


🤝 نرحب بجميع أنواع المساهمات! صوّت على عناصر خارطة الطريق أو اقترح عناصر جديدة في Roadmap، وراجع دليل المساهمة لمعرفة استراتيجية الفروع ومعايير البرمجة وكيفية البدء.

📰 الأخبار

  • 2026-09-20 🎉 40 ألف نجمة في 9 أشهر! سنواصل توسيع منظومة التعلّم في DeepTutor.
  • 2026-05-22 🌐 موقع الوثائق الرسمي متاح على deeptutor.info — الأدلة والمراجع وجولات القدرات كلها في مكان واحد.
  • 2026-04-19 🎉 20 ألف نجمة في 111 يومًا! شكراً على الدعم نحو تدريس شخصي وذكي حقيقي.
  • 2026-04-10 📄 ورقتنا البحثية متاحة على arXiv — اقرأ النسخة الأولية للتعرف على التصميم والأفكار وراء DeepTutor.
  • 2026-02-06 🚀 10 آلاف نجمة في 39 يومًا فقط! شكر جزيل لمجتمعنا الرائع.
  • 2026-01-01 🎊 كل عام وأنتم بخير! انضم إلى Discord أو WeChat أو النقاشات — لنشكّل معاً مستقبل DeepTutor.
  • 2025-12-29 🎓 تم إطلاق DeepTutor رسميًا!

✨ الميزات الرئيسية

DeepTutor هو بيئة تعلم أصيلة للوكلاء تربط التدريس وحل المشكلات وتوليد الاختبارات والبحث والتصور وممارسة الإتقان في نظام واحد قابل للتوسيع.

  • بيئة تشغيل واحدة لجميع الأوضاع — تشترك Chat وAsk Questions وQuiz وResearch وVisualize وSolve وMastery Path وImmersive Reading وAudio Overview في بيئة تشغيل واحدة للقدرات وسياق الجلسة، مع احتفاظ كل منها بحلقات وخطوط أنابيب مصممة لغرضها.
  • Task Board — تتبّع مهام الدراسة ضمن «للإنجاز» و«قيد التنفيذ» و«مكتمل»، مع ملاحظات وسحب وإفلات أو أزرار نقل يمكن استخدامها بلوحة المفاتيح، وأرشيف يمكنك الاستعادة منه. تبقى البطاقات في مساحة العمل الحالية وتتبع إعدادات المظهر واللغة القائمة؛ ولا يلزم تهيئة أي نموذج.
  • سياق تعلم متصل — يمكن إعادة استخدام قواعد المعرفة والكتب وصفحات دفتر التعلّم والمفضلة وبنوك الأسئلة والشخصيات والذاكرة عبر سير العمل التي تدعمها، وفقاً لمنح الحساب وسياسات التعلّم.
  • التعلّم الغامر بالفيديو — أضف روابط YouTube أو Bilibili إلى Reading للتشغيل الأصلي والبحث في النصوص المفرّغة والتدريس المرتكز على الطوابع الزمنية والملاحظات المحفوظة والتقدّم القابل للاستئناف؛ ويمكن استخدام نسخة Invidious يهيئها المشرف لجلب ترجمات YouTube وتصفّحه.
  • الوكلاء الفرعيون والشركاء — من داخل Chat، استشر مُشغِّل وكيل حيّاً (Claude Code أو Codex أو Grok CLI أو Antigravity أو Kimi أو opencode أو MiMo أو Hermes أو OpenClaw أو DeepSeek) أو Partner، واستورد المحادثات السابقة، وشغّل رفاق IM دائمين على نفس الدماغ.
  • معرفة متعددة المحركات — مكتبات RAG مُصدَّرة عبر LlamaIndex وPageIndex وGraphRAG وLightRAG، أو LightRAG Server عن بُعد، أو قاعدة معرفة WeKnora ذاتية الاستضافة، أو مكتبة Tencent IMA أو MarginNote 4، أو أرشيف Kiwix ZIM متصل، أو مخزن Obsidian مرتبط، مع تحليل مستندات قابل للتوصيل. راجع نماذج أدوار LightRAG الأصلية لإعدادات مستقلة للاستخراج والاستعلام والرؤية، والإنشاء بالنماذج الافتراضية فقط، وإعادة البناء بعد التأكيد.
  • أدوات ومهارات قابلة للتوسيع — أدوات مدمجة وخوادم MCP وتطبيقات CLI ونماذج توليد الصور/الفيديو/الصوت ومهارات مجتمع قابلة للتثبيت من EduHub.
  • ذاكرة قابلة للتدقيق — تجعل آثار L1 وملخصات أسطح L2 وتركيب L3 التخصيص مرئياً وقابلاً للتحرير؛ ويربط Memory Graph حقائق L2 بأدلة L1 وتركيب L3 بالأسطح المساهمة.

🚀 البدء

دع وكيلك يُعِدّ DeepTutor

انسخ هذا الطلب إلى وكيل الذكاء الاصطناعي الذي يمكنه استخدام الطرفية (مثل Codex أو Claude Code):

Help me install and configure the current dev version of DeepTutor from https://github.com/HKUDS/DeepTutor.
Clone the dev branch, or inspect and reuse my existing checkout, and read SKILL.md and
docs-for-dev/AGENT_SETUP.md first. Follow that guide to prepare the environment,
configure my model provider, verify the setup, and start the Web app.
Ask me for any missing provider, model, or credential-source information;
do not print API keys. Preserve my existing files and settings, and finish
with the access URL and the results of your checks.

يغطي دليل إعداد الوكيل التدفق كاملاً، بما فيه التهيئة غير التفاعلية عبر CLI. لتثبيته بنفسك، اختر أحد المسارات أدناه.

يأتي DeepTutor بأربعة مسارات تثبيت. وكلها تشترك في تخطيط واحد لمساحة عمل وقت التشغيل: تعيش الإعدادات الخاصة في data/user/settings/ تحت الدليل الذي تُطلق منه التطبيق (أو تحت DEEPTUTOR_HOME / deeptutor start --home إذا حددت واحداً صراحةً). راجع حفظ البيانات المحلية للاطلاع على تخطيط التخزين الكامل ودعم قواعد البيانات وملاحظات النسخ الاحتياطي. للتطبيق الكامل، التدفق الموصى به هو اختر دليل مساحة عمل وقت التشغيل → تثبيت → deeptutor init → deeptutor start.

تجربة Docker بأمر واحد

إذا لم يكن Docker مثبتاً بعد، ثبّت Docker أولاً. ثم جرّب التطبيق الكامل دون إعداد Python أو Node.js:

docker run --rm --name deeptutor \
  -p 127.0.0.1:3782:3782 \
  -v deeptutor-data:/app/data \
  ghcr.io/hkuds/deeptutor:latest

افتح http://127.0.0.1:3782، وهيّئ مزودي النماذج في الإعدادات ← المزودون، واضغط Ctrl+C عند الانتهاء. تحتفظ وحدة التخزين المسماة deeptutor-data بالإعدادات والبيانات المحلية للتشغيل التالي.

مساحة عمل المحتوى

مساحة عمل المحتوى منفصلة عن مساحة عمل DeepTutor الخاصة لوقت التشغيل. إنها المجلد الذي يمكن للوكلاء قراءته، وتوضع الملفات المُولَّدة تحت outputs/<capability>/<session>/<turn>/. تعزل مساحات العمل المخصصة المحادثات والمواد التعليمية والتقدم والذاكرات المؤقتة في شجرة خاصة .deeptutor/data/ لا تستطيع أدوات الملفات تصفحها. وتبقى الإعدادات وبيانات الاعتماد وMemory مشتركة على مستوى الحساب.

بدون تهيئة، تكون مساحة عمل المحتوى هي <runtime-home>/data/user/workspace. يمكن للتثبيتات المحلية من PyPI وCLI والمصدر اختيار المجلدات في الإعدادات ← مساحات العمل؛ واضبط المجلد الافتراضي باستخدام:

deeptutor workspace show
deeptutor workspace set /absolute/path/to/my-folder
deeptutor workspace reset

تفحص القدرات مساحة العمل المحددة لها من خلال أدوات مساحة العمل المدمجة. لا يتلقى النموذج سوى مسارات نسبية مثل outputs/...؛ وعندما يستخدم workspace_present، تُصيِّر الواجهة لقطة مصادَق عليها وقابلة للفتح. يعمل المسار النسبي الدقيق نفسه أيضاً في رابط أو صورة Markdown عادية. تغيير الملف المصدر لاحقاً لا يغيّر لقطة قُدِّمت مسبقاً.

يدير فضاء التعلم مكتبة الموارد. في الإعدادات ← مساحات العمل، عيّن المهارات وخدمات MCP وقواعد المعرفة لكل مساحة عمل، أو احتفظ بقواعد الوصول الحالية. تحتفظ مساحات العمل الموجودة بصلاحيات وصولها الحالية حتى يُحفظ الاختيار. تشير التعيينات إلى الموارد الأصلية دون نسخ بيانات الاعتماد أو فهارس المعرفة؛ ويمكن للمهارات الخاصة بمساحة عمل أن تتجاوز النسخ المشتركة. راجع تعيين موارد مساحات العمل.

التنفيذ للقراءة فقط خارج outputs/. نسخ ملف مُولَّد إلى مكان آخر في مساحة عمل المحتوى يتطلب تأكيد السماح مرة واحدة الصريح لذلك المصدر والوجهة المحددين تماماً. يفرض صندوق أمان النظام أو مُشغِّل Docker هذا الحد عند توفره؛ ويظهر الرجوع إلى العملية الفرعية المقيَّدة محلياً كـ أفضل جهد ممكن في إعدادات مساحة العمل.

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

التثبيت المعياري في 1.7.0: استخدم deeptutor[full] لتطبيق الويب وCLI، أو deeptutor للمحادثة الأساسية. يجب أن تطابق إصدارات وحدات الميزات إصدار النواة؛ وتستخدم الإصدارات 1.6.15 والأقدم تخطيط الحزم السابق. للتطوير على فرع dev الحالي، اتبع تعليمات المصدر أدناه أو ابنِ حزم wheel محلية. يتطلب Python 3.11–3.14 وبيئة تشغيل Node.js 20+ على PATH (يشغّل deeptutor start خادم Next.js المستقل المضمّن في الحزمة).

mkdir -p my-deeptutor && cd my-deeptutor
pip install -U "deeptutor[full]"
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.

الترقية إلى 1.7.0: أوقف التطبيق وأنشئ نسخة احتياطية من دليل وقت التشغيل. استخدم python -m pip install --upgrade "deeptutor[full]==1.7.0"، ثم python -m pip check وdeeptutor module list. إذا كانت حزمة deeptutor-cli القديمة مثبتة، فشغّل أولاً python -m pip uninstall deeptutor-cli، ثم أمر الترقية (مع إضافة deeptutor-cli==1.7.0 اختيارياً). تمتلك حزمة CLI القديمة ملفات Python مشتركة، ولذلك قد تؤدي ترقيتها في العملية نفسها إلى حذف النواة الجديدة. لا يؤدي إلغاء تثبيت الحزمة إلى حذف بيانات دليل وقت التشغيل. احتفظ بقيمة DEEPTUTOR_HOME نفسها وبالإعدادات الحالية. في 1.7.0، يختار pip install -U deeptutor وحده النواة فقط؛ استخدم [full] لطلب مجموعة تثبيت التطبيق الكامل. للحزم المبنية محلياً، اتبع تعليمات الترقية باستخدام wheel محلية.

بعد deeptutor start، افتح عنوان URL للواجهة الأمامية المطبوع في الطرفية — افتراضياً http://127.0.0.1:3782. اضغط Ctrl+C في تلك الطرفية لإيقاف الخلفية والواجهة الأمامية معاً. تخطي deeptutor init لا بأس به للتجربة السريعة؛ يُقلع التطبيق بالمنافذ الافتراضية وإعدادات نموذج فارغة، قم بتهيئتها لاحقاً في الإعدادات ← المزودون ونماذج اللغة.

تفريغ صوت ميكروفون المتصفح: ترسل موائمات STT المتوافقة مع OpenAI صوت المتصفح إلى المزود دون تحويل محلي. تحوّل موائمات STT الأصلية لـ DashScope وVolcengine صوت المتصفح من WebM/Opus إلى WAV بتردد 16 kHz، وتتطلب ملفاً تنفيذياً لـ ffmpeg على PATH الخاص بـ DeepTutor. يتجاوز ملف WAV القياسي أحادي القناة بترميز PCM وتردد 16 kHz هذا التحويل. عند تثبيت إصدار PyPI على Windows واستخدام أيٍّ من الموائمين الأصليين، ثبّت FFmpeg، وأضف دليل bin الخاص به إلى PATH للخدمة، ثم أعد تشغيل DeepTutor. تظهر حالات فشل التحويل أسفل حقل إدخال المحادثة.

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

للتطوير مقابل نسخة مسحوبة. استخدم Python 3.11–3.14 وNode.js 22 LTS لمطابقة CI وDocker.

git clone --branch dev 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 -r requirements/full.txt
python -m pip install -e . --no-deps
( cd web && npm ci --legacy-peer-deps )

deeptutor init
deeptutor start --dev

يبني أمر deeptutor start واجهة web/ المحلية للإنتاج مرة واحدة ويعيد استخدامها؛ بينما يشغّل --dev تطبيق Next.js مع إعادة التحميل الفوري للوحدات (HMR). تخطيط التهيئة، والمنافذ، والإيقاف بـ Ctrl+C يطابق الخيار 1.

بيئة Conda (بديلاً عن venv)
conda create -n deeptutor python=3.11
conda activate deeptutor
python -m pip install --upgrade pip
إضافات التثبيت الاختيارية — محركات RAG / dev / partners / matrix / math-animator
python scripts/install_extras.py rag-lightrag    # Built-in LightRAG engine (exact supported SDK)
python scripts/install_extras.py graphrag        # Microsoft GraphRAG engine (Python 3.11–3.13)
python scripts/install_extras.py dev             # tests/lint tools
python scripts/install_extras.py partners        # Partner IM channel SDKs
python scripts/install_extras.py video-learning  # captions for reading/video-learning
python scripts/install_extras.py matrix          # Matrix channel without E2EE/libolm
python scripts/install_extras.py matrix-e2e      # Matrix E2EE; requires libolm
python scripts/install_extras.py math-animator   # Manim addon; requires LaTeX/ffmpeg/system libs
python scripts/install_extras.py edge-tts        # Optional free speech provider and video-lesson narration

درس فيديو: اختر Video Lesson في المحادثة أو شغّل deeptutor run video_lesson "Explain a concept". تحتاج الخلفية إلى Node.js 22+ وnpm. يُنزّل الاستخدام الأول حزم Remotion ذات الإصدارات المثبّتة ومفسّر JavaScript يعمل عبر WebAssembly؛ ولا يلزم Docker. تُجرى فحوص الإطارات داخل المفسّر دون الوصول إلى نظام ملفات المضيف أو بيانات الاعتماد أو الشبكة أو واجهات العمليات، مع حدود للذاكرة والتنفيذ. يوقف الإلغاء عملية البناء. تستخدم عمليات النشر المحلية والحاويات مسار التنفيذ نفسه، دون بديل يتجاوز صندوق الأمان. يعمل الدرس الناتج في المتصفح، مع نصوص توضيحية عندما لا يتوفر السرد الصوتي الاختياري.

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

تغيير تبعيات الواجهة الأمامية: شغّل npm install --legacy-peer-deps لتحديث web/package-lock.json، ثم ارفع كلاً من web/package.json وweb/package-lock.json.

خادم تطوير متوقف: إذا أبلغ deeptutor start --dev عن واجهة أمامية موجودة لا تستجيب، أوقف الـ PID الذي يطبعه. إذا لم يكن هناك أي عملية Next.js تعمل فعلياً، فملفات القفل قديمة — احذفها وأعد المحاولة:

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:<version> — الإصدار المحدد بدقة من دون v في البداية (مثلاً :1.6.3)؛ لا تحصل الإصدارات الأولية إلا على وسم إصدارها

راجع CONTAINERIZATION.md لعمليات نشر podman/rootless/read-only-rootfs والدليل الكامل لكل تثبيت.

docker run --rm --name deeptutor \
  -p 127.0.0.1:3782:3782 \
  -v deeptutor-data:/app/data \
  ghcr.io/hkuds/deeptutor:latest

لاختيار مجلد محتوى مضيف عند بدء تشغيل الحاوية، ثبّته على مسار الحاوية الثابت واحبس DeepTutor على ذلك المسار:

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. تُنشئ الحاوية /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 على عنوان الشبكة الداخلية الذي يستخدمه خادم الواجهة الأمامية للوصول إلى الخلفية (يُقرأ من جانب الخادم، ولا يُرسَل أبداً إلى المتصفح).

{
  "next_public_api_base": "http://backend:8001"
}

يُقبَل next_public_api_base_external (واسمه المستعار public_api_base) كبدائل ذات أولوية أقل. يستخدم CORS منشآت الواجهة الأمامية، وليس عناوين URL لواجهة برمجة التطبيقات. مع تعطيل المصادقة، يسمح DeepTutor بمنشآت متصفح HTTP/HTTPS العادية افتراضياً. مع تفعيل المصادقة، أضف منشآت الواجهة الأمامية الدقيقة:

{
  "cors_origins": ["https://deeptutor.example.com"]
}
الاتصال بـ Ollama / LM Studio / llama.cpp / vLLM / Lemonade على المضيف

داخل Docker، يشير localhost إلى الحاوية نفسها، وليس جهازك المضيف. للوصول إلى خدمة نموذج تعمل على المضيف، استخدم بوابة المضيف (موصى بها):

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 (أو 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).

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

عندما لا تحتاج إلى واجهة الويب، استخدم CLI من هذه النسخة وتجاوز إعداد Node/npm. تتيح نسخة المصدر جميع الوحدات الموجودة في المستودع وتحتاج إلى تبعياتها في Python. للتثبيت الأدنى مع الإصدار المعياري 1.7.0، استخدم حزمة wheel للنواة deeptutor وأضف وحدات الميزات بشكل منفصل.

git clone --branch dev 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 -r requirements/full.txt
python -m pip install -e . --no-deps
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 النشط والنموذج.

الأوامر الشائعة
deeptutor chat                                          # interactive REPL
deeptutor chat --capability deep_solve --kb my-kb
deeptutor run chat "Explain Fourier transform"
deeptutor run deep_solve "Solve x^2 = 4" --kb my-kb
deeptutor kb create my-kb --doc textbook.pdf
deeptutor memory show
deeptutor config show

يتضمن هذا التثبيت من المصدر تبعيات الخادم، لكنه يتجاوز إعداد الواجهة الأمامية. احتفظ بنسخة المستودع، فالتثبيت القابل للتحرير يشير إليها. لإضافة واجهة الويب لاحقاً، ثبّت Node.js 22 LTS، وشغّل npm ci --legacy-peer-deps داخل web/، ثم شغّل 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 عادي. صفحة الإعدادات هي المحرر الموصى به؛ وتُحفظ تسجيلات مساحات العمل بشكل منفصل في data/user/.runtime/workspaces.sqlite3.

الملف الغرض
model_catalog.json اتصالات المزودين، إضافة إلى ملفات تعريف LLM والمهام والتضمين والبحث وTTS وSTT والصور والفيديو، وبيانات الاعتماد والاختيارات النشطة
system.json منافذ الخلفية/الواجهة الأمامية، وقاعدة API العامة، وCORS، والتحقق من SSL، ودليل المرفقات وحدود الرفع/الاستخراج
auth.json تبديل مصادقة اختياري، واسم مستخدم، وتجزئة كلمة مرور، وإعدادات الرمز/الكوكي
integrations.json إعدادات تكامل PocketBase والمرافق الاختيارية
interface.json تفضيلات لغة واجهة المستخدم ولغة مخرجات النموذج / الثيمة / الشريط الجانبي
document_parsing.json اختيار محرك التحليل ونموذج وصف الصور ونقاط النهاية البعيدة والخيارات الخاصة بكل محرك
video_learning.json مزود ترجمات YouTube، وأصول Invidious والوصول إلى الحساب، وإعدادات النصوص المفرّغة
main.yaml افتراضيات سلوك وقت التشغيل وحقن المسار
agents.yaml إعدادات درجة حرارة القدرة/الأداة والرمز

تُرشَّح مراجع Web Search افتراضياً: لا تظهر سوى عناوين URL عامة من http/https لا تتضمن بيانات اعتماد مضمنة أو منافذ غير معتادة. ويمكن لعمليات النشر إضافة سياسة نطاقات تركّز على التعليم في data/user/settings/system.json:

{
  "web_search_source_filtering": {
    "enabled": true,
    "blocked_domains": ["spam.example"],
    "trusted_domains": ["edu.cn", "arxiv.org"]
  }
}

عندما لا تكون trusted_domains فارغة، تقتصر المراجع على تلك النطاقات ونطاقاتها الفرعية؛ وتكون الأولوية دائماً لـ blocked_domains.

ملف .env في جذر المشروع لا يُقرأ كملف تهيئة للتطبيق. للإعداد الأدنى للنموذج، احفظ عنوان URL أساسياً ومفتاح API في الإعدادات ← المزودون، ثم أضف نموذج LLM وحدّده في نماذج اللغة. أضف ملف تعريف التضمين فقط إذا كنت تخطط لاستخدام ميزات قاعدة المعرفة / RAG.

لاستخدام API Route، اختر API Route في الإعدادات ← المزودون وأدخل مفتاح API Route. يستخدم الإعداد المسبق https://global.api-route.com/v1؛ ثم أضف نموذجاً باستخدام معرّف نموذج API Route الخاص به في نماذج اللغة. راجع دليل البدء السريع لـ API Route لإعداد المفتاح والنموذج.

تعرض ملفات تعريف 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. أزل الحزمة المثبَّتة. استخدم الأمر المطابق للتوزيع:

    python -m pip uninstall deeptutor
    python -m pip uninstall deeptutor-cli
    

    إذا أُنشئت البيئة الافتراضية لـ DeepTutor وحده، فأزلها عبر مدير البيئات. في التثبيت من المصدر، عطّل البيئة، وغادر دليل المصدر، وشغّل git status --short داخل تلك النسخة المحددة. لا تنقل النسخة إلى سلة المهملات/المحذوفات إلا بعد التأكد من أنها لا تحتوي عملاً غير ذي صلة أو غير ملتزم به.

  4. بالنسبة إلى مسار Docker، افحص الحاوية الدقيقة ووحدة التخزين المسماة قبل إزالتهما. تؤدي إزالة وحدة التخزين إلى محو البيانات التي يديرها Docker نهائياً:

    docker ps -a --filter name=^/deeptutor$
    docker volume inspect deeptutor-data
    docker rm -f deeptutor
    docker volume rm deeptutor-data
    

📖 استكشاف DeepTutor

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

إذا فقدت إجابة قيداً سابقاً، أو استشهدت بدليل ضعيف، أو خالفت المادة المحددة، فاجمع بيانات التشخيص في REASONING_SAFETY_CHECKLIST.md قبل فتح مشكلة.

الصفحة الرئيسية والتنقل بين مساحات العمل في DeepTutor
🏗️ معمارية النظام
معمارية نظام DeepTutor
💬 Chat — حلقة الوكيل التي تستخدمها فعلاً

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

مساحة عمل محادثة DeepTutor

يستدعي المدرّس الأدوات حسب الحاجة ويمكنه التوقف لطرح أسئلة توضيحية. يتيح تخصيص الصفحة في أعلى اليمين اختيار الأوضاع الظاهرة وعناصر التحكم في المهارات وMCP والشركاء والتفضيلات والإدخال الصوتي. ضمن مطالبات البداية، أضف عناوين ومطالبات «اشرح» و«حلّ» و«تدرّب» و«خطّط» و«ابحث»، أو عدّلها أو احذفها. يطبّق الحفظ تفضيلات حسابك؛ ويلغي الإلغاء التعديلات، بينما تعيد استعادة الافتراضيات الخيارات الأصلية.

حلقة وكيل محادثة DeepTutor

الأدوات القابلة للتبديل من قِبَل المستخدم هي brainstorm وweb_search وpaper_search وzotero_search وreason وgeogebra_analysis — بالإضافة إلى imagegen وvideogen بمجرد تهيئة نموذج التوليد المطابق. الأدوات السياقية مثل rag وkb_files وknowledge_frontier وread_source وread_memory وwrite_memory وread_skill وload_tools وexec وweb_fetch وask_user وlist_favorites وsave_favorite وwrite_note وsearch_notes وquestion_bank وgithub وconsult_subagent وworkspace_list وworkspace_read وworkspace_search وworkspace_present وworkspace_export تُثبَّت تلقائياً عندما يكون للدور السياق الصحيح.

يأتي السياق في نوعين: يستمر السياق الثابت للجلسة (القدرة، ومساحة العمل أو الدورة، والأدوات، وقواعد المعرفة، والشخصية، والنموذج، وحالة Reading / Mastery) عبر الأدوار؛ وتأتي المراجع لمرة واحدة (الملفات وتاريخ المحادثة والكتب وأقسام القراءة ودفاتر الملاحظات ومدخلات بنك الأسئلة المحددة والوكلاء المستوردون) من قائمة + لدور واحد. ولا يفعل زر الصوت سوى تفريغ الرسالة الحالية نصياً.

مع مجموعة التثبيت الكاملة، تتيح الصفحة الرئيسية Chat وAsk Questions وQuiz وVisualize وVideo Lesson بنقرة واحدة؛ وتقع Research للتقارير ذات الاستشهادات وSolve للاستدلال المشروح تحت المزيد من القدرات. يفتح التعلّم ← تعلّم جديد، فوق جميع أنشطة التعلّم، صفحة مخصصة للكتب وMastery Path وImmersive Reading والتدريب. يتيح عنصر تخصيص الصفحة إخفاء طرق التعلّم أو استعادتها دون تغيير السجلات الحالية؛ وتبقى الوحدات غير المتاحة مستبعدة. تجمع Reading المستندات والفيديو والصوت مع استشهادات موثّقة وملاحظات محفوظة وقراءة طبيعية بصوت عالٍ من مقاطع المصدر / إجراءات الإرشاد الدراسي / المفردات / الاختبار / الترجمة، والتقاط المحتوى إلى دفتر الملاحظات.

🤝 Partner — رفاق دائمون على نفس الدماغ
مساحة عمل شركاء DeepTutor

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

معمارية شركاء DeepTutor

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

إعداد قناة IM لكل شريك

طبقة القناة مدفوعة بالمخطط ويمكنها الاتصال بمنصات 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

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

توصيل Grok CLI. ثبّت Grok CLI الخاص بـ xAI على الجهاز الذي يشغّل خلفية DeepTutor، وشغّل grok login هناك، وتحقق من أن grok --help يسرد --output-format streaming-json. ثم افتح My Agents ← Connect، واختر Grok CLI، وحدّد دليل عمل. يفحص الاكتشاف دعم البروتوكول في الملف التنفيذي؛ ولا يتحقق من تسجيل الدخول أو الوصول إلى النموذج. جُرِّب الموصِّل مع Grok CLI الإصدار 1.0.3؛ والأوامر الأخرى من جهات خارجية غير ذات صلة والمسماة أيضاً grok غير مدعومة.

في الإعدادات ← الشركاء والوكلاء ← Grok CLI، اترك النموذج وجهد الاستدلال فارغين لاستخدام افتراضيات CLI، أو أدخل قيماً يدعمها ناتج grok models الخاص بحسابك. تُمرَّر تعليمات النظام عبر --rules. وضع الصلاحيات الافتراضي هو dontAsk: يستخدم Grok قواعده الحالية ومعالجته المدمجة للقراءة فقط، ويرفض العمليات التي تحتاج موافقة. هذه سياسة صلاحيات لـ CLI، وليست صندوق أمان لنظام الملفات. يمكن اختيار أوضاع أوسع صراحةً في الإعدادات؛ وتبقى أعلام CLI المتقدمة متاحة عبر backends.grok.extra_args في واجهة برمجة إعدادات الوكيل الفرعي.

يستخدم Grok مصادقته وتخزين جلسته الخاصين؛ ولا ينسخ DeepTutor بيانات اعتماده. تستأنف الاستشارات اللاحقة جلسة الاتصال نفسها في دليل العمل نفسه. يُبث النص ونشاط الأدوات مباشرة؛ وتُحذَف حمولات التفكير الخاصة. تُعطَّل ذاكرة Grok عبر الجلسات افتراضياً. يدعم هذا الموصِّل الأسئلة النصية وأدوات CLI، لا إعادة توجيه الصور أو استيراد محادثات Grok السابقة. في Docker، ثبّت Grok وصادِق عليه داخل حاوية الخلفية؛ فـ CLI المثبَّت فقط على جهاز المتصفح لا يمكن الوصول إليه.

تخصيص الحساب: الوكلاء والشخصيات والمهارات والاتصالات

استيراد المحادثات السابقة — أحضر تاريخ ChatGPT وClaude Code وCodex الموجود لديك كمحادثات قابلة للبحث والاستئناف. اختر ملف conversations.json من تصدير بيانات ChatGPT رسمي لاستيراد لقطة آمنة ومتكافئة القوة (idempotent)، أو اختر تاريخ Claude حسب المشروع / دليل العمل، أو اختر تاريخ Codex حسب تاريخ التقويم. يبقى الوكلاء المستندون إلى مجلد قابلين للتحديث بحيث يمكن للنطاق المحدد أن يسحب محادثات جديدة. ارجع إلى إحداها من دور Chat عبر + ← My Agents، وسيقرأها DeepTutor كنصوص محادثة لطرف ثالث — تبقى محادثتهم، وليس صوت DeepTutor الخاص.

✍️ دفتر التعلّم — الصفحات والمصادر وDito
صفحات دفتر التعلّم

ينظّم دفتر التعلّم، المعروف سابقاً باسم Co-Writer، كتاباتك في صفحات وصفحات فرعية وكتل داخل مساحة العمل النشطة. استورد مستندات Word، ورتّب شجرة الصفحات، وأدرج السجلات الأصلية من المفضلة كأدلة. تعرض الصفحات حالة الحفظ بوضوح وتُصدَّر إلى Markdown أو Word؛ ويصبح المحتوى التفاعلي ثابتاً في Word.

محرر كتل دفتر التعلّم وDito

ناقش مقطعاً أو كتلة مع Dito: اطلب شرحاً أو مثالاً أو إعادة صياغة أو سؤالاً تدريبياً. تبقى المحادثات مرتبطة بالصفحة والسطر المعنيين. راجع التعديلات المقترحة قبل قبولها، أو أدرج إجابة أسفل السطر وواصل العمل. تحفظ المفضلة سجلات المصادر؛ أما دفتر التعلّم فهو المكان الذي تبني فيه فهمك الخاص.

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

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

كتلة اختبار في الكتاب   مخطط الكتاب وفصوله   كتلة ودجت تفاعلية في الكتاب

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

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

قواعد المعرفة هي مجموعات المستندات وراء RAG — إنها ترسّخ أدوار Chat وتحرير دفتر التعلّم وتوليد 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) التطبيق ويتم التنقل فيها بأدوات مخصصة)، Kiwix (أرشيف ZIM قابل للبحث يُقدَّم عبر HTTP دون فهرسة محلية)، أو مخزن Obsidian مرتبط يقرأ المدرس ويكتب فيه في مكانه. كل قاعدة معرفة مرتبطة بمحرك واحد.

إنشاء قاعدة معرفة

هل تنقل مكتبة Obsidian أو Hermes أو Markdown موجودة؟ راجع دليل نقل المعرفة لمساري المخزن المتصل والنسخة المفهرسة.

عند إنشاء قاعدة معرفة، يمكنك إنشاء جديدة (تحميل المستندات وفهرستها)، أو ربط موجودة (إعادة استخدام فهرس في مكانه)، أو توصيل Kiwix (البحث عند الطلب في أرشيف ZIM واحد يقدّمه خادم). اختر مساحة عمل التخزين عند الإنشاء؛ ويمكن نقل قاعدة معرفة موجودة بين مساحات العمل بعد معاينة، مع الاحتفاظ بالتعيينات والمراجع المحفوظة. يمكن لقاعدة المعرفة أيضاً تتبُّع مستودعات GitHub (المستودع والفرع ونمط glob) أو عناوين URL لمواقع التوثيق (مع حدود لعمق الزحف وعدد الصفحات، وتُعاد مزامنتها كل 24 ساعة افتراضياً)؛ تقارن المزامنة تجزئات المحتوى لتحديد ما أُضيف أو تغيّر أو أُزيل، كي تبقى الوثائق التي تتابعها محدَّثة دون إعادة رفع، وتلتقط المجلدات المرتبطة الملفات المحلية الجديدة أو المتغيرة عند المزامنة. تكتب إعادة الفهرسة دليل 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/connect-kiwix/add/search/eval/eval-diff/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.

يتطلب استعلام LightRAG الأصلي والفهرسة التزايدية تهيئة التضمين المسجَّلة في الفهرس المنشور، بما يشمل النموذج والبُعد وهوية نقطة النهاية. إذا تغيّرت، فاستعد التهيئة الأصلية أو أعد البناء باستخدام التضمين الحالي؛ والفهارس التي لا تحمل هوية تضمين مسجَّلة تتطلب إعادة البناء. تعرض صفحات تفاصيل قاعدة المعرفة وإصدارات الفهرس إرشادات التعافي، بينما تبقى الملفات متاحة للعرض والتنزيل.

تقييم قاعدة المعرفة. مع توفر عدة محركات، يصبح سؤال «أيها يسترجع أفضل النتائج هنا؟» سؤالاً تجريبياً — ولذلك يجيب عنه deeptutor kb eval. اكتب مجموعة أسئلة وأجوبة (كائن JSON واحد في كل سطر: query مع مقاطع gold التي ينبغي أن يُرجعها الاسترجاع المثالي)، ثم قيّم قاعدة المعرفة باستخدام deeptutor kb eval <name> --dataset qa.jsonl --top-k 5 [--mode hybrid] [--save baseline.json]. يُجرى الاسترجاع لكل حالة عبر المسار نفسه الذي يستخدمه دور المحادثة، وتُطابَق استشهاداتها المرتّبة مع المقاطع المرجعية باستخدام النص المطابق تماماً أو التداخل اللفظي (يمكن ضبط العتبات عبر --min-ratio؛ ولا يُقيَّم التكافؤ الدلالي)، ويُبلّغ التشغيل عن Recall@k / Precision@k / nDCG@k / MRR / MAP / Hit@k. المقاييس دوال خالصة على الترتيب؛ ولا يحكم أي نموذج على المخرجات. قارن التقارير المحفوظة باستخدام deeptutor kb eval-diff baseline.json candidate.json لمعرفة التغيّرات لكل مقياس ولكل حالة. استخدم --rewrite off أو --rewrite standalone مع kb eval لمقارنة الاستعلامات الأصلية والمعاد صياغتها؛ وتحتفظ التقارير بسجلّ إعادة الصياغة. الحالات التي يفشل بحثها (فهرس مفقود أو بيانات اعتماد غير صالحة) لا تحصل على درجة وتُعرض منفصلة بدلاً من خفض المتوسطات. يستخدم PageIndex الاستدلال للاسترجاع ولا يُرجع مقاطع مرتّبة، ولذلك يُستثنى.

{"query": "Why do transformers scale attention?", "gold": ["Scaling keeps the dot products from growing with the dimension."]}
🌐 الموارد والتخصيص — المواد والمساعدة القابلة لإعادة الاستخدام
الموارد في مساحة العمل النشطة

تجمع الموارد سجل المحادثات والمفضلة بسجلات قابلة للنقل وتصدير إلى Markdown، ويوميات التعلّم، ومركز المعرفة، وبنك أسئلة مع الإجابات والشروح. ابدأ التدريب من مجموعة أسئلة محددة في بنك الأسئلة أو من التعلّم ← التدريب لجلسات المراجعة وتتبع الأخطاء والتكرار المجدول. تضم صفحة التخصيص المنفصلة الشخصيات والمهارات (أدلة SKILL.md) وخدمات MCP بنقرة واحدة وتطبيقات CLI من كتالوج CLI-Anything، ولكل تطبيق دليل استخدام عند الطلب. ويجمع التعلّم الكتب ومسارات الإتقان ومجموعات القراءة ومحادثات المدرّسين المرتبطة بها؛ ولا يُتاح كل أصل إلا في سير العمل التي تدعمه.

مكتبة مهارات التخصيص

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

🧠 Memory — تخصيص قابل للتدقيق
نظرة عامة على ذاكرة DeepTutor

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

رسم بياني لذاكرة DeepTutor

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

⚙️ الإعدادات — لوحة تحكم واحدة
التنقل في الإعدادات

الإعدادات هي لوحة التحكم التشغيلية، وتُفتح على صفحة عام لضبط لغة الواجهة ومخرجات النموذج. يربط شريط التنقل القابل للبحث صفحات مستقلة: تضم شخصي مساحات العمل ونقل البيانات والمظهر وإحصاءات الاستخدام؛ وتضم التعلم والمحادثة نقاط الانطلاق والمرفقات وVideo Learning وعناصر تحكم المتعلم وولي الأمر وتقدّم التعلّم والذاكرة؛ وتضم النماذج والخدمات المزودين ونماذج اللغة ونماذج المهام والتضمين والبحث والصوت والتوليد متعدد الوسائط؛ وتضم الميزات والتكاملات الأدوات ومعاملات القدرات والشركاء والوكلاء والمعرفة والمستندات. يضم النظام الشبكة وحالة التشغيل وحول؛ وتتيح المحادثات المؤرشفة البحث في المحادثات المؤرشفة واستعادتها أو حذفها نهائياً. تحتوي حالة التشغيل على سلامة الخلفية والذاكرة المقيمة ومصفوفة جاهزية (Readiness) التي تقيّم عوائق القدرات وتحذيراتها واقتراحاتها. تفصل مساحات العمل ملفات المواضيع وحالة التعلم، مع نقل موثَّق وتصدير ضمن نقل البيانات. يحتفظ المزود بعنوان مقدم الخدمة وبيانات اعتماده لتعيد نماذج خدماته استخدامها؛ وتختار صفحات النماذج مزودين محفوظين وتضبط أسماء النماذج وقدراتها. تُثبّت نماذج المهام نموذجاً صغيراً وسريعاً للأعمال الخلفية — تسمية المحادثات وكتابة نقاط الانطلاق — وتستخدم النموذج الافتراضي النشط عند تركها فارغة. يجمع الصوت توليد الكلام وتفريغه؛ ويجمع التوليد متعدد الوسائط نماذج الصور والفيديو. تضبط صفحة الشركاء والوكلاء المُشغِّلات المحلية وبوابة Hermes بعيدة.

الكلام عبر Xiaomi MiMo. أضف مزود Xiaomi MiMo بعنوان https://api.xiaomimimo.com/v1 ومفتاح API الخاص به، ثم أضف mimo-v2.5-tts ضمن الإعدادات ← الصوت. اختر صوتاً مسبقاً مثل mimo_default أو 冰糖 أو 苏打، واستخدم إخراج wav أو pcm16، وجرّبه قبل تطبيقه. تتحكم تعليمات الصوت في الأسلوب وسرعة الكلام. يدعم هذا الموائم الكلام بالأصوات المسبقة فقط؛ ويتطلب تصميم الأصوات واستنساخها نماذج منفصلة ولا يدعمهما. إذا كان نموذج MiMo صوتي قديم مهيّأً عبر الموائم العام المتوافق مع OpenAI، فأعد إنشاء مدخل الكلام باستخدام مزود Xiaomi MiMo كي يستخدم بروتوكول chat-completions. راجع دليل MiMo الرسمي لتوليد الكلام.

الكلام عبر MiniMax — في الإعدادات ← الصوت، اختر MiniMax لتحويل النص إلى كلام وحدّد speech-2.8-hd. هيّئ مفتاح API لـ MiniMax واختر صراحةً صوتاً من أصوات النظام أو أدخل معرّف صوت مخصص. عنوان API الأساسي الافتراضي هو https://api.minimax.io/v1؛ ولمنطقة الصين استخدم https://api.minimaxi.com/v1. تستخدم القراءة بصوت عالٍ ومعاينات الصوت نقطة نهاية الكلام الأصلية، مع إخراج MP3 أو WAV أو FLAC أو PCM، وعناصر تحكم في معدل أخذ العينات والسرعة واللغة. راجع واجهة API للكلام في MiniMax لمعرّفات الأصوات وتوفرها للحساب.

Video Learning ضمن الإعدادات ← التعلم والمحادثة يهيّئ ترجمات YouTube والوصول إلى Invidious لاستخدامهما في Reading. لاستخدام Invidious، اضبط أصل API الخلفية الذي يديره المشرف (مثلاً http://127.0.0.1:3000) والأصل العام الذي يمكن للمتصفح الوصول إليه، واختبر الاتصال، واختر Invidious، ثم احفظ. يبحث تصفّح Invidious في مربع حوار إضافة المواد في Reading عن مقاطع الفيديو ويتيح الوصول إلى الاشتراكات وقوائم التشغيل المتصلة. يستخدم تشغيل YouTube المشغّل الرسمي المعزَّز للخصوصية؛ ويظل غياب الترجمات ظاهراً ويحدّ من الأدلة المتاحة للمدرّس دون تعطيل التشغيل الأصلي. في نسخة المصدر، شغّل python scripts/install_extras.py video-learning لاستخدام مُحمِّل ترجمات YouTube الافتراضي. تنتقل روابط Watching الموجودة إلى Reading مع الحفاظ على سجل المحادثة والنصوص المفرّغة المتوافقة والملاحظات والتقدّم؛ وتصبح الملاحظات الزمنية الجديدة تعليقات Reading التوضيحية. يستخدم Bilibili مساره الخاص للتشغيل والترجمات.

إعدادات المظهر والثيمات في DeepTutor

تستخدم معظم الأقسام تدفق صياغة-وتطبيق، لذا يمكنك اختبار مزود قبل الالتزام به. يمكنك أيضاً أن تطلب ذلك ببساطة في Chat: يقرأ المساعد التهيئة الحالية، ويطبّق التغيير، ويخبرك إن كان يحتاج إلى إعادة تشغيل أو إعادة فهرسة — مع اختبار النموذج الجديد قبل الالتزام به، بحيث لا يمكنه تبديل نفسه إلى شيء يتعذّر الوصول إليه. مفاتيح API لا تمرّ أبداً عبر النموذج، الذي يفتح لك بدلاً من ذلك الاستمارة المطابقة. تشحن أربع ثيمات في الصندوق — Default وCream وDark وGlass. ملفات .env في جذر المشروع تُتجاهل عمداً؛ تعيش تهيئة وقت التشغيل تحت data/user/settings/*.json إلا إذا وجّه DEEPTUTOR_HOME أو deeptutor start --home التطبيق في مكان آخر.

OpenAI Codex OAuth (تجريبي). إضافة OpenAI Codex ضمن الإعدادات ← المزودون تفتح تسجيل دخول عبر المتصفح يعمل مقابل خطة ChatGPT الخاصة بك، لذا لا حاجة إلى OPENAI_API_KEY. تعيش الرموز (tokens) فقط في data/system/user-secrets/<owner>/private/openai-codex/ — في نشر Compose متعدد الحاويات، خارج كل شجرة يمكن لصندوق أمان التنفيذ الوصول إليها — ولا يقرأ DeepTutor أو يعدّل أبداً تسجيل دخولك إلى CLI في ~/.codex. تأتي قائمة النماذج من الكتالوج الحي لذلك الحساب؛ تسجيل الدخول ينشر الملف الشخصي لكنه لا يصبح النموذج النشط إلا عندما لا يكون هناك LLM مهيأ بعد. ولأن الرمز يخوّل خطة شخص واحد فقط، فالملف الشخصي غير قابل للمشاركة عبر منح المستخدمين — كل حساب يسجّل دخوله بنفسه، بما في ذلك المستخدمون العاديون: تظهر بطاقة تسجيل دخولهم ضمن المزودون، وتبقى النماذج الناتجة والكتالوج وتسجيل الخروج خاصة بذلك الحساب.

عند تسجيل الدخول وعند تحديث النماذج، يقرأ DeepTutor أحدث إصدار مستقر من @openai/codex من سجل npm الرسمي ويستخدمه كـ client_version في طلب الكتالوج. هذا بيانات وصفية فقط: لا يُثبِّت ولا يُنزِّل ولا يُحدِّث CLI الخاص بـ Codex، ولا يحمل طلب npm أي بيانات اعتماد OAuth. للاكتشاف حد زمني ثلاث ثوانٍ وحد أقصى لحجم الاستجابة 64 كيلوبايت. وإذا فشل، يستخدم DeepTutor آخر إصدار ناجح لذلك الحساب، أو خياره الاحتياطي المدمج عندما لا يوجد شيء مخزَّن مؤقتاً. لا يُحفَظ إصدار جديد إلا عند تحليل كتالوج حي بنجاح؛ ولا تُعاد أبداً استخدام أدوات التحقق عبر الإصدارات أو أجيال بيانات الاعتماد. يسمح رفض إصدار أو بنية كتالوج غير متوافقة بإعادة محاولة واحدة بالإصدار السابق؛ ولا تُعاد محاولة أعطال المصادقة أو حدود المعدل أو TLS باعتبارها مشاكل إصدار. يُبلِّغ التحديث اليدوي الفاشل عن خطأ بدلاً من تقديم كتالوج قديم مخزَّن مؤقتاً كأنه مُحدَّث.

يبقى سجل الإصدارات الناجحة قائماً عبر تجديد الرمز لنفس الحساب وأخطاء مصادقة الكتالوج، دون أن يعيد ذلك صلاحية بيانات نماذج أو ETags أُلغيت صلاحيتها. يمسح تسجيل الخروج الذاكرة المؤقتة المحلية لذلك الحساب، بما يشمل سجل الإصدارات. لا تستعلم قراءات الحالة العادية والاستدلال npm. لا تستبدل إدخالات الكتالوج الجديدة نموذجاً اخترته مسبقاً ولا تُعيد تشغيل جلسات التعلّم؛ وظهور نموذج في الكتالوج لا يثبت توافقاً كاملاً مع بروتوكول الاستدلال. لا يوجد مُحدِّث إصدار في الخلفية ولا إعداد إصدار يتحكم فيه المستخدم.

تستخدم عمليات نشر Docker وPodman المحلية الافتراضية شبكات loopback منفصلة وتحتاج إلى جسر مؤقت أثناء تسجيل الدخول. اتبع دليل جسر OAuth المؤقت المحلي لـ Codex للاطلاع على أوامر Docker وCompose وPodman والإزالة الدقيقة.

في حالة النشر عن بُعد، يكون localhost الخاص بالمتصفح وlocalhost الخاص بالخادم جهازين مختلفين، لذا لا يستطيع وكيل عكسي عادي وحده نقل استدعاء (callback) localhost من المتصفح إلى الخادم. استخدم نفق SSH كجسر للاستدعاء. يصل النفق إلى منفذ الويب المنشور بالفعل؛ يعيد Next.js توجيه مسار الاستدعاء الدقيق فقط إلى وسيط الاستدعاء العام، ويتحقق الوسيط من state قبل التوجيه إلى عملية OAuth الأصلية. يبقى مستمع الاستدعاء على loopback الخلفية، والمنفذان 1455 و1457 غير منشورين، ويدعم هذا المسار شبكة جسر Docker الافتراضية.

ssh -N -L 1455:127.0.0.1:3782 <ssh-user>@<server-host>

إذا أبلغ DeepTutor عن منفذ استدعاء احتياطي (fallback) 1457، استخدم:

ssh -N -L 1457:127.0.0.1:3782 <ssh-user>@<server-host>

نفّذ الأمر الواحد المطابق لمنفذ الاستدعاء الفعلي فقط؛ لا تُشغّل كليهما أبداً. 3782 هو فقط منفذ الويب المثال: إنه منفذ الواجهة الأمامية/الحاوية المهيأ والمُبلَّغ عنه كـ callback_forward_port. لا تضمن هذه القيمة أن المنفذ نفسه يستمع على 127.0.0.1 الخاص بمضيف SSH. إذا نشر Docker أو Podman منفذ مضيف مختلفاً، أو استمع وكيل عكسي على منفذ مختلف، استبدل فقط منفذ الهدف الظاهر في الجهة اليمنى من الأمر (3782 أعلاه) بمنفذ الويب الذي يستمع فعلياً على 127.0.0.1 الخاص بمضيف SSH؛ أبقِ منفذ الاستدعاء الظاهر في الجهة اليسرى كما هو، أي 1455 أو 1457. <server-host> هو مضيف SSH الذي يملك loopback الذي يستضيف ذلك المنفذ المستمع. إذا كان عنوان URL في المتصفح يشير إلى وكيل عكسي أو موازن تحميل، استبدله بمضيف SSH الأمامي الصحيح.

تطبع واجهة سطر الأوامر (CLI) أمر النفق ثم تحاول فوراً فتح المتصفح. في حالة النشر عن بُعد، أبقِ صفحة التفويض مفتوحة دون إتمامها، أنشئ النفق المطبوع في طرفية أخرى، ثم تابع عملية التفويض بعد ذلك فقط.

لاكتشاف الطوبولوجيا عن بُعد حدٌّ يتعلق بـ localhost. إذا كان الوصول إلى الويب نفسه يتم عبر إعادة توجيه localhost من SSH أو من بيئة تطوير (IDE)، فلا يستطيع المتصفح معرفة أن الخادم بعيد. بالنسبة لعملية الويب الحالية، اترك صفحة تفويضها دون إنهاء، واقرأ redirect_uri في عنوان URL الخاص بالتفويض لتلك العملية لتحديد منفذ الاستدعاء 1455 أو 1457، وأنشئ النفق الثاني من ذلك المنفذ المحلي إلى منفذ الويب الفعلي. بدلاً من ذلك، ألغِ عملية الويب تلك وابدأ عملية جديدة عبر CLI؛ إذ يخص ناتج CLI العملية الجديدة ويجب ألا يُستخدم لعملية الويب القائمة. تُبلَّغ أخطاء الحصة وفشل الكتالوج كما هي ولا تتراجع أبداً إلى مزود مدفوع. مسار التوافق هذا تجريبي: قد تتغيّر واجهة المصدر الأعلى (upstream).

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

المصادقة معطلة افتراضياً — يعمل DeepTutor لمستخدم واحد. فعّلها وشجرة data/ واحدة تستضيف مساحة عمل المشرف ومساحات عمل معزولة لكل مستخدم ومساحات عمل الشريك جنباً إلى جنب:

data/
├── user/                    # Admin workspace + global settings
├── users/<uid>/             # Per-user scope: chat history, memory, notebooks, KBs
├── partners/<id>/workspace/ # Partner (synthetic-user) scope
├── cli-apps/                # Installed CLI apps, mounted read-only into the sandbox
└── system/                  # auth · grants · audit · user-secrets/<owner> (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 ووصول تنفيذ الرمز من خلال المنح؛ وهيّئ الكتب المشتركة من لوحة الوصول إلى الكتب لكل مستخدم.

بالنسبة إلى الأصول (origins) الخاصة/العامة المنفصلة، اضبط auth.private_login_hosts (أو AUTH_PRIVATE_LOGIN_HOSTS) على مضيفات الواجهة الأمامية الخاصة التي يجوز لها إظهار تسجيل الدخول بكلمة مرور والتسجيل. تُمرِّر الواجهة الأمامية رأس Host الوارد عبر HTTP إلى الخلفية كتأكيد لمضيف الواجهة الأمامية. حافظ على Host الخاص بالمتصفح عبر وكيلك العكسي، واجعل مدخل الشبكة العام يرفض الطلبات التي تسمّي مضيفاً خاصاً؛ ولا تكشف منفذ Next.js الخام الذي يقبل أي قيمة لـ Host. يمكن تزوير Host عبر HTTP من قِبَل عميل مباشر، فتفويض المضيف الخاص يعتمد على تلك الحدود عند المدخل. تقبل الخلفية تأكيدات مضيف الواجهة الأمامية فقط من loopback افتراضياً. إذا كانت الواجهة الأمامية للويب تتصل من حاوية أو مضيف آخر، اضبط AUTH_TRUSTED_FRONTEND_PROXY_IPS على عنوان IP الدقيق لوكيل الواجهة الأمامية ذلك في عملية الخلفية (مفصولة بفواصل لأكثر من عنوان واحد). يحل هذا محل القيم الافتراضية؛ وأضف 127.0.0.1,::1 إذا كانت اتصالات الواجهة الأمامية المحلية مطلوبة أيضاً. أبقِ واجهة برمجة تطبيقات الخلفية خاصة بوكيل الواجهة الأمامية ولا تُضمِّن شبكات العملاء العامة في هذه القائمة. عندما لا تكون private_login_hosts فارغة، يمكن لمستخدم مصادَق عليه على أصل خاص أن يفتح الملف الشخصي ← تسجيل دخول جهاز عام وينشئ رابط إقران قصير العمر ومرتبط بالمضيف لأصل عام عبر HTTPS. تستبدل صفحة /handoff العامة الرمز التسجيلي لمرة واحدة بتذكرة JWE قصيرة العمر أيضاً في نص طلب POST، وتستهلك التذكرة مرة واحدة، وتستلم كوكي الجلسة العادي HttpOnly.

يبقى PocketBase تكاملاً لمستخدم واحد — أبقِ integrations.pocketbase_url فارغاً لعمليات النشر متعددة المستخدمين إلا إذا وصلت مخزن مستخدم خارجي.

⌨️ واجهة سطر أوامر DeepTutor — الواجهة الأصيلة للوكلاء

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

قدّها بنفسك

يفتح deeptutor chat واجهة REPL تفاعلية ويختار وضعاً باستخدام --capability؛ بينما يأخذ deeptutor run <capability> "<message>" تلك القدرة كأول وسيطة موضعية ويخرج بعد دور واحد. ويقبل كلاهما --tool و--kb و--config و--workspace لاختيار مساحة عمل مسجلة.

deeptutor chat                                              # interactive REPL
deeptutor chat --capability deep_solve --kb my-kb
deeptutor run chat "Explain the Fourier transform" --kb textbook
deeptutor run chat "Find recent work beyond this material" --kb textbook
deeptutor run deep_research "Survey 2026 papers on RAG" \
  --config mode=report --config depth=standard

يوفر --kb السياق لأدوات RAG التلقائية وKnowledge Frontier؛ وتتطلب Frontier وحدتي المعرفة والبحث معاً. يختار --tool الأدوات التي يستطيع المستخدم تبديلها. كما توفر الوحدات المفعّلة أوامر قواعد المعرفة والجلسات والشركاء والمهارات ودفاتر الملاحظات والذاكرة والتهيئة.

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

DeepTutor مبنية لتكون مُشغَّلة بواسطة وكيل آخر. أضف --format json إلى أي run وكل دور يبث NDJSON — حدث واحد في كل سطر (content وtool_call وtool_result وdone و...)، وكل سطر مُعنوَن بـ session_id الخاص به. التشغيلات آمنة بدون TTY: توقف ask_user بدون TTY يحل تلقائياً برد فارغ بدلاً من التعليق.

# 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 في الجذر — وثيقة تسليم موجزة لواجهة CLI. اطلب من وكيلك قراءته صراحةً؛ ويغطي دليل إعداد الوكيل التثبيت والتهيئة. يمكنك أيضاً تغليف deeptutor run كأداة في حلقة LangChain / AutoGen. الوصفات الكاملة: Agent Handoff.

مرجع الأوامر

يغطي الجدول التثبيت الكامل والإضافات الاختيارية؛ وتتطلب الأوامر والقدرات تفعيل وحداتها. توفر النواة chat وask_questions.

الأمر الوصف
deeptutor init [--non-interactive] [--home PATH] تشغيل معالج الإعداد، أو إنشاء القيم الافتراضية الناقصة دون مطالبات
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 module list/install/uninstall/enable/disable فحص الوحدات وتغييرها مع إيقاف DeepTutor؛ وتدعم نسخ المصدر التفعيل والتعطيل
deeptutor workspace show/set/reset فحص مساحة عمل المحتوى الخاصة بالمستخدم، أو اختيارها، أو استعادتها
deeptutor run <capability> <message> تشغيل دور قدرة واحدة (chat وask_questions وdeep_solve وdeep_question وdeep_research وvisualize وmath_animator وvideo_lesson وmastery_path وimmersive_reading وaudio_overview)؛ أضف --format json لإخراج NDJSON
deeptutor chat REPL تفاعلي مع تحكمات القدرة والأداة وقاعدة المعرفة ودفتر الملاحظات والتاريخ
deeptutor partner list/create/start/stop إدارة الشركاء المتصلين بـ IM
deeptutor kb list/info/create/connect-kiwix/add/search/eval/eval-diff/set-default/delete/list-sources/sync إدارة قواعد المعرفة، وتوصيل أرشيفات Kiwix، وتقييم عمليات الاسترجاع ومقارنتها، ومزامنة مصادر GitHub/الويب المسجَّلة (مع أوامر إضافة المصادر وإزالتها)
deeptutor skill search/install/list/remove/login/logout/publish/update إدارة المهارات، التثبيت من المراكز، ونشر مهاراتك الخاصة (eduhub:<slug> افتراضياً، راجع النظام البيئي)
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/state/search/show/install/approve/enable/disable/rollback/uninstall فحص الأدوات والقدرات؛ وإدارة حزم الإضافات التي خضعت للمراجعة والموافقات على أذوناتها
deeptutor config show [--home PATH] عرض تهيئة وقت التشغيل الفعلية مع حجب بيانات الاعتماد
deeptutor config providers سرد مزودي الإعداد المدعومين وقيمهم الافتراضية بصيغة JSON
deeptutor config apply FILE [--check] [--home PATH] تطبيق إعداد JSON دون مطالبات، أو التحقق منه دون كتابة الإعدادات
deeptutor provider login <provider> مصادقة المزود (openai-codex تسجيل دخول OAuth؛ github-copilot تسجيل دخول GitHub عبر الجهاز؛ codebuddy يتحقق من مصادقة CodeBuddy SDK ويبدأ تسجيل الدخول عند الحاجة)

تخص بيانات اعتماد GitHub Copilot مالك DeepTutor المسجَّل دخوله، وتُحفَظ فقط في <runtime-home>/data/system/user-secrets/<owner-id>/private/github-copilot/credentials.v1.json، خارج مساحات عمل صندوق الأمان. يستخدم الشركاء العاملون عبر CLI أو بحساب المشرف بيانات اعتماد المشرف؛ ويسجّل المستخدمون الآخرون دخولهم بصورة منفصلة، ولا يمكن مشاركة ملفات تعريف Copilot عبر منح النماذج. لا تُستورد ملفات رموز nanobot/Copilot الخارجية أبداً: بعد الترقية، شغّل deeptutor provider login github-copilot مجدداً.

يتحقق تسجيل الدخول من الاستدلال باستخدام نموذج مكتشَف حالياً؛ ويتحقق init من النموذج المحدد ويتوقف عند الفشل دون حفظ مسودة التهيئة. نجاح مصادقة GitHub وحده لا يثبت إمكانية الوصول إلى نماذج Copilot (يُحتفَظ بتسجيل الدخول المحفوظ إذا فشل التحقق). تتبع طلبات وقت التشغيل نقطة نهاية API التي تعيدها عملية تبادل الرموز، بما في ذلك التجديدات، وتحترم بيانات نقطة النهاية الوصفية الخاصة بـ Responses/Chat Completions لكل نموذج.

يُطبَّق توافق Responses الخاص بـ Copilot عند إرسال الطلب دون إعادة كتابة السجل المحفوظ.

توزيع CLI فقط

توفر حزمة wheel للنواة CLI وSDK؛ أما deeptutor-cli فهي حزمة وصفية للتوافق. يتيح المصدر جميع الوحدات الموجودة في المستودع، لذا ثبّت تبعياتها في Python وتجاوز إعداد الواجهة الأمامية عند استخدام CLI:

python -m pip install -r requirements/full.txt
python -m pip install -e . --no-deps

للتثبيت الأدنى، استخدم حزمة wheel للنواة. تضيف التوزيعات الاختيارية أدوات وقدرات ومسارات API وخدمات خلفية وعناصر تنقل. تشترك الوحدات في بيئة Python واحدة ويجب أن تطابق إصدار النواة. يختار deeptutor[full] وحدات التطبيق الشائعة عند التثبيت؛ ويمكن إزالة الميزات الفردية لاحقاً.

أوقف DeepTutor (بالضغط على Ctrl+C في طرفيته)، ثم استخدم بيئة Python نفسها وDEEPTUTOR_HOME نفسه:

deeptutor module list                       # installed / enabled / ready
deeptutor module disable research           # hide and deactivate; keep code
deeptutor module enable research            # restore it and required modules

# Package installations only; source checkouts use enable / disable:
deeptutor module install solve              # install the matching module and dependencies
deeptutor module uninstall solve --dry-run  # inspect the plan and dependency blockers
deeptutor module uninstall solve            # remove only this module's distribution
deeptutor chat                              # restart the CLI; use start for an installed Web app

أمثلة: solve وresearch وquestions وknowledge وparsing وreading وmastery وbooks وmemory وnotebook وpartners. تمنع الوحدات التابعة إزالة ما تعتمد عليه؛ ولا يمكن إزالة النواة عبر أمر الوحدات. يحافظ التعطيل أو إلغاء التثبيت على الإعدادات والمحادثات وقواعد المعرفة والملفات المُولّدة. وتُحتفظ بتبعيات الجهات الخارجية المشتركة.

في المتصفح: تعرض الإعدادات ← حالة التشغيل ← الوحدات حالة الوحدات وأوامر الطرفية المقابلة. تتطلب تغييرات الحزم إيقاف البيئة وتُجرى عبر CLI. تغيّر المحادثة ← تخصيص الصفحة والتعلّم ← تعلّم جديد ← تخصيص الصفحة اختيارات صفحاتك الشخصية فوراً؛ ولا يؤدي إخفاء عنصر إلى إلغاء تثبيت وحدته أو سحب صلاحية الوصول إليها.

تستخدم عائلة حزم 1.7.0 إصدارات متطابقة للنواة وحزم wheel للميزات. للتثبيت من حزم wheel محلية، أضف --wheelhouse /path/to/wheels إلى module install. راجع تثبيت الوحدات والتطوير من المصدر لبناء حزم wheel وتفاصيل النشر.

🧩 النظام البيئي — EduHub ومجتمع المهارات

تستخدم مهارات DeepTutor تنسيق Agent-Skills المفتوح — مجلد يحتوي دليل SKILL.md (YAML frontmatter + Markdown) وملفات مرجعية اختيارية. لا شيء في ذلك خاص بـ DeepTutor، لذا أي سجل يتحدث التنسيق يصبح مصدراً لمكتبتك. يشحن DeepTutor مع EduHub — سجل المهارات المركّز على التعليم الخاص بنا — مُوصَّلاً كمركز افتراضي.

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

EduHub هو المركز المجتمعي الذي أطلقه DeepTutor لمشاركة مهارات الوكيل الموجهة نحو التعليم — موجهو سقراط وبناة بطاقات الفلاش وتغذية راجعة للمقالات وخطط الامتحانات وشارحو المفاهيم وغيرها. مُدمَج في DeepTutor، لذا لا شيء يجب تهيئته: slug مجرد أو بادئة eduhub: تحل إليه.

البحث والتثبيت — في المتصفح، افتح فضاء التعلم ← المهارات ← الاستيراد من EduHub لتصفح الكتالوج وتنزيل مهارة مباشرةً إلى مكتبتك. من الطرفية:

deeptutor skill search "socratic tutor"               # search EduHub (the default hub)
deeptutor skill install socratic-tutor                # fetch → verify → register
deeptutor skill install eduhub:[email protected]   # pin a hub and a version
deeptutor skill list                                  # local skills with their hub provenance

انشر مهارتك الخاصة — حزّم SKILL.md وشاركها مع المجتمع:

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 يعمل كمصدر من الدرجة الأولى أيضاً — مُدمَج جنباً إلى جنب مع EduHub. اختره ببادئة المركز:

deeptutor skill search "git release notes" --hub clawhub
deeptutor skill install clawhub:[email protected]
deeptutor skill install clawhub:udiedrichsen/stock-analysis

عندما يشترك عدة ناشرين في نفس الـ slug، يعرض البحث كل ناشر ومرجع تثبيت كامل النطاق (clawhub:<ownerHandle>/<slug>).

أضف المزيد من السجلات في data/user/settings/skill_hubs.json: إدخال type: "clawhub" يشير إلى أي HTTP API متوافق (EduHub وClawHub يتحدثانه كلاهما)، type: "command" يلفّ أي CLI جلب يشحنه السجل، و"default" يختار المركز المستخدم للـ slugs المجردة. كلها تُغذّي نفس بوابة الاستيراد.

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

PageIndex

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

🌐 المجتمع

🔗 المشرفون

Bingxi Zhao
Bingxi Zhao
Xingyu Hou
Xingyu Hou
Jiahao Zhang
Jiahao Zhang

📮 التواصل

DeepTutor هو مشروع مفتوح المصدر تقوده Bingxi Zhao ضمن مجموعة HKUDS، ويتطور بشكل مفتوح المصدر بالكامل، مبني مع المجتمع. حتى الآن، لا يوجد لدينا أي منتجات مدفوعة عبر الإنترنت من أي شكل. تفضّل بالتواصل على [email protected] للنقاشات والأفكار والتعاون.

🙏 التقدير

خالص الشكر لـ Chao Huang، مدير مختبر ذكاء البيانات @ HKU، ولزملائنا في HKUDS على دعمهم الحار — وخاصةً Jiahao Zhang، وZirui Guo، وXubin Ren. ونحن ممتنون عميقاً أيضاً لـ مجتمع المصادر المفتوحة: نجومكم والمشكلات التي تبلّغون عنها وطلبات السحب والنقاشات تشكّل DeepTutor كل يوم.

يقف DeepTutor أيضاً على أكتاف مشاريع مفتوحة المصدر متميزة أعطتنا أدوات وإلهاماً:

المشروع الدور / الإلهام
LlamaIndex العمود الفقري لخط أنابيب RAG وفهرسة المستندات
nanobot محرك وكيل خفيف الوزن للغاية مكّن TutorBot الأصلي (HKUDS)
LightRAG RAG بسيط وسريع (HKUDS)
AutoAgent إطار وكيل بدون رمز (HKUDS)
AI-Researcher خط أنابيب بحث آلي (HKUDS)
OpenClaw بوابة وكيل مفتوحة ونظام مهارات وراء ClawHub
Codex واجهة برمجة أصيلة للوكلاء ألهمت سير عمل CLI لدينا
Claude Code واجهة برمجة للوكلاء ألهمت حلقة وكيل DeepTutor
ManimCat توليد رسوم متحركة رياضية مدفوع بالذكاء الاصطناعي لـ Math Animator

🗺️ خارطة الطريق والمساهمة

نريد لـ DeepTutor أن يستمر في التطور والتحسين — وفي نهاية المطاف أن يصبح هدية نقدمها للمجتمع مفتوح المصدر. يُحدَّث خارطة طريقنا باستمرار؛ صوّت على العناصر هناك أو اقترح عناصر جديدة. إذا كنت ترغب في المساهمة، راجع دليل المساهمة لمعرفة استراتيجية الفروع ومعايير البرمجة وكيفية البدء.

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

المساهمون

ترتيب تاريخ النجوم

مرخّص بموجب رخصة Apache 2.0.

المشاهدات