الصفحاتQuantCraft AI · 26 / 29

QuantCraft AI

يتضمن QuantCraft مساعد ذكاء اصطناعي مدمجًا في الشريط الجانبي الأيمن لبيئة التطوير (تخطيط مساحة العمل) — لوحة محادثة تساعدك على كتابة وتحرير شيفرة Python لاستراتيجيات التداول مع إدراكٍ لمساحة عملك. يرى الملف المفتوح في المحرر وأي ملفات تذكرها بـ @ ومخططات ملفاتك المفتوحة الأخرى، فتأتي إجاباته وتعديلاته ضمن السياق. ويعمل كوكيل برمجة داخل بيئة التطوير: إذ يمكنه إنشاء ملفات جديدة أو تحرير ملفات موجودة نيابةً عنك في دور محادثة واحد.

لاستخدامه، افتح الشريط الجانبي الأيمن وانتقل إلى علامة التبويب QuantCraft AI. النموذج الذي تربطه على مستوى التطبيق كله — فالاتصال نفسه يشغّل هذه المحادثة وعقد AI Prompt وAI Builder في الوكلاء ووكلاء الذكاء الاصطناعي الخاصين بـ Test / Optimization. استخدم محرر Python وتشغيل الشيفرة للتحقق من أي تغييرات مقترحة على الاستراتيجية عبر Test / Run.

وهناك أيضًا لوحة Documentation في الشريط الجانبي نفسه — مرجع ثابت لواجهة الاستراتيجية (دورة الحياة وOHLCV والمؤشرات والبيانات الأساسية والعوامل والمدخلات والحساب)، إضافةً إلى صفحتي Agent Scripts وScreener Script. راجع المرجع.

أوضاع المساعد

الوضع	ما يفعله
Chat	نصائح وشروحات فقط — دون تعديل ملفات.
Plan	يُنتج خطة تنفيذ منظّمة — دون تعديلات.
Agent	ينشئ ملفات مساحة العمل ويحرّرها. تمرّ التعديلات المقترحة بمراجعة Accept / Undo وتُبرَز الأسطر المتغيّرة في المحرر. يُبقي Auto-continue agent turns (مفعّل افتراضيًا) المساعد يعمل بعد كل ردّ يغيّر الملفات إلى أن ينتهي أو تضغط Stop.

يمكنك تبديل الوضع وAuto-continue من منطقة الإدخال، أو ضمن Assistant mode في نافذة API Providers.

ربط نموذج

يعمل QuantCraft AI مع عدة مزوّدين. بعضها أحضر مفتاحك بنفسك (تُحاسَب على حسابك لدى المزوّد)؛ أما QuantCraft Premium والخيارات المستضافة فتعمل بوصول مُدار بدلًا من ذلك. افتح AI → API Providers من القائمة العلوية (عنوان النافذة AI API Providers؛ ورابط الاتصال في المحادثة يفتحها أيضًا)، واختر مزوّدًا، ثم املأ حقوله.

المزوّد	ما تضبطه
Anthropic (Claude)	مفتاح API ونموذج Claude و"Extended thinking" الاختياري. المسار الأكثر دعمًا. احصل على مفتاح من `console.anthropic.com`.
QuantCraft Premium	دون مفتاح — يُسنَد الوصول إلى حسابك؛ يعرض المزوّد والحالة والرصيد وتاريخ الانتهاء (منحة Claude أو DeepSeek). لا يظهر إلا عند وجود منحة لديك.
DeepSeek	مفتاح API ونموذج DeepSeek و"Extended thinking" الاختياري.
DeepSeek (hosted)	لا يُخزَّن أي مفتاح (يستخدم مفتاح الخادم)، و"Extended thinking" اختياري. لا يظهر إلا عند تسجيل دخولك وعند عرض الخادم له.
OpenCode	مفتاح API وOpenCode plan (Zen أو Go) وOpenCode model وCustom model id اختياري لنموذج غير موجود في القائمة. تعمل نماذج Claude وQwen ونماذج نمط Chat-Completions؛ ولا تعمل نماذج GPT وGrok وMuse وGemini.
Custom LLM	Endpoint URL وModel name وAPI key اختياري (رمز bearer).

قد يظهر GitHub Copilot وCursor في القائمة، لكن أدوار المحادثة غير موصولة بعد (واجهات مؤقتة) — كما ترفضها ميزات الذكاء الاصطناعي في الوكلاء. استخدم Anthropic أو DeepSeek (بمفتاحك أو المستضاف) أو OpenCode أو QuantCraft Premium أو Custom LLM.

الصق المفتاح (حيث يلزم)، واختر النموذج، ثم انقر Save.

Custom LLM

استخدم Custom LLM لربط نموذجك الخاص أو نموذج مستضاف ذاتيًا متوافق مع OpenAI.

الحقل	ملاحظات
Endpoint URL	عنوان URL الأساسي المتوافق مع OpenAI — مثل Ollama أو llama.cpp أو vLLM (`http://localhost:11434/v1`).
Model name	معرّف النموذج الذي تخدمه تلك النقطة (مثل `qwen2.5-coder:7b-instruct`).
API key	رمز bearer اختياري — اتركه فارغًا لخادم محلي لا يحتاج إليه.

يُعدّ الاتصال جاهزًا بمجرد ضبط URL. في تطبيق سطح المكتب يمرّ HTTP نحو المزوّدين عبر إضافة HTTP الخاصة بـ Tauri؛ وتقع نقاط localhost / 127.0.0.1 ضمن النطاق. أما مضيفو Custom LLM البعيدون العشوائيون فلا يمكن للمستخدم ضبطهم عبر واجهة قائمة سماح — فضّل خادمًا محليًا متوافقًا مع OpenAI أو مزوّدًا مدعومًا أعلاه.

أين تُحفظ المفاتيح: تُخزَّن قيم "أحضر مفتاحك بنفسك" على جهازك فقط (في سلسلة مفاتيح نظام التشغيل في تطبيق سطح المكتب، أو في التخزين المحلي لهذا المتصفح). ولا تُرفع أبدًا إلى QuantCraft ولا تُرسل إلا إلى المزوّد الذي اخترته. وإذا مسحت بيانات المتصفح أو انتقلت إلى حاسوب آخر فستحتاج إلى إعادة إدخال المفتاح.

إلى أين تذهب الطلبات: مع مزوّد "أحضر مفتاحك بنفسك" يستدعي QuantCraft AI المزوّد مباشرةً من جهازك باستخدام مفتاحك. ويستخدم تطبيق سطح المكتب (Tauri) جسر HTTP حتى لا تحجب CORS في المتصفح الطلبات — وقد يعرض تشغيل QuantCraft AI في نسخة المتصفح رسالة "Request failed" متعلقة بـ CORS؛ استخدم نسخة سطح المكتب للحصول على أفضل تجربة.

اختيار نموذج

لكل مزوّد قائمة منسدلة للنماذج بجوار حقل المفتاح. تعرض شارة الاتصال أسفل المحادثة المزوّد النشط والاسم المختصر للنموذج (مثل Anthropic (Claude) · Claude Sonnet 4.6). يمكن حفظ عدة مزوّدين — وتعرض الشارة الأحدث استخدامًا مع اللاحقة +N عند وجود أكثر من مفتاح.

بالنسبة إلى Anthropic تسرد القائمة Claude Sonnet 4.6 وClaude Opus 4.8 وClaude Opus 4.7 وClaude Haiku 4.5 وغيرها من متغيرات Opus / Sonnet الحالية. اختر ما يتاح لحسابك. وإذا حاولت إرسال رسالة عبر مسار Anthropic دون مفتاح محفوظ يردّ المساعد بتذكير بإضافة مفتاح.

استخدام المحادثة

اكتب في منطقة الإدخال واضغط Enter للإرسال، وShift+Enter لسطر جديد.
اكتب @ لفتح قائمة إشارة إلى الملفات وإدخال ملف آخر من مساحة العمل في السياق.
تُعرض الردود بصيغة markdown مع كتل شيفرة.
يوقف Stop ردًّا قيد التوليد.

منطقة الإدخال والمرفقات

يفتح زر Attach files منتقي ملفات. ويمكنك أيضًا سحب الملفات وإفلاتها على منطقة الإدخال، أو لصق ملف/صورة من الحافظة.
يعرض صف من الشرائح للمرفقات فوق مربع النص كل ملف أُدرج في قائمة الانتظار. لكل شريحة اسمها (وصورة مصغّرة للصور) وعلامة × لإزالتها.
يُقبل أي نوع ملف. وتعرض ملفات الصور صورة مصغّرة صغيرة ضمن تدفّق الرسائل بعد الإرسال.
تنتمي المرفقات إلى الرسالة التي أُرسلت معها — وتظهر بجانب تلك الرسالة في سجل المحادثة.
في محادثة بيئة التطوير تُعرض المرفقات لكن لا يُرسل محتواها إلى النموذج. ولمشاركة محتوى ملف من مساحة العمل، اذكره بـ @ بدلًا من ذلك.

أثناء توليد المساعد لردٍّ تكون منطقة الإدخال معطّلة مع نص "Please wait…" ويظهر صف حالة صغير في قائمة الرسائل (مثل Building API messages… وStreaming reply… 1,234 characters وSyncing to workspace folder on disk…).

جلسات المحادثة

يحتفظ QuantCraft AI بسجل لجلسات المحادثة. كل جلسة محادثة مستقلة بها رسائلها ومرفقاتها. يتضمن الشريط في أعلى لوحة المحادثة:

New chat — يبدأ جلسة جديدة فارغة. يكون معطّلًا أثناء عمل المساعد، أو عند وجود تعديل ملف معلّق، أو إن كانت محادثتك الحالية فارغة أصلًا.
Chats — قائمة منسدلة تسرد كل الجلسات المحفوظة، الأحدث أولًا. يعرض كل إدخال عنوانه (مشتقًّا تلقائيًا من أول رسالة للمستخدم) ووقت آخر تحديث. انقر صفًّا للتبديل، أو أيقونة سلة المهملات لحذفه.

تُحفظ الجلسات تلقائيًا (في تطبيق سطح المكتب ضمن الإعدادات المحلية، وإلا ففي التخزين المحلي للمتصفح) وتبقى بعد إعادة التحميل وإعادة التشغيل. ويكون التبديل بين المحادثات وإنشاء جديدة محظورًا أثناء تدفّق ردّ أو عند وجود شريط Accept/Undo غير محسوم — أنهِ التغيير أو تراجع عنه أولًا.

ما يمكن للمساعد رؤيته

في كل مرة ترسل فيها رسالة يبني QuantCraft AI الطلب من:

وثائق مطوّري QuantCraft المدمجة (ليعرف دورة الحياة وواجهة الحساب ووحدات OHLCV / البيانات الأساسية وسلاسل المؤشرات وغيرها).
لقطة حديثة لمساحة العمل — مسار مجلد مساحة العمل المرتبط، والملف المفتوح حاليًا في المحرر، وقائمة علامات التبويب والمجلدات المفتوحة.
الأدوار السابقة من جلسة المحادثة النشطة (رسائلك وردوده).
رسالتك الجديدة مع أي مرفقات.

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

تعديلات الملفات من المساعد

في وضع Agent يمكن للمساعد أن يُرجع إجراء ملفات واحدًا أو أكثر في ردٍّ واحد: إنشاء ملف جديد، أو تحرير الملف الحالي في المحرر، أو تحرير ملف محدد بالاسم في مساحة العمل. وعندما يحدث ذلك:

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

الاستراتيجيات متعددة الملفات

في وضع Agent يمكن للمساعد تقسيم استراتيجية إلى وحدات مساعدة في مجلدات (indicators/ وrisk/ …) واستيرادها في ملف الخوارزمية الجذري. ويُبقي دوال دورة الحياة (on_init وon_bar …) في الملف الجذري ويستخدم استيرادات مطلقة من جذر مساحة العمل، مثل from indicators.momentum import calc_rsi، دون ملفات __init__.py.

يرى المساعد الملفات التي يستوردها الملف النشط والملفات التي تستورده كاملةً. ولا يرى من بقية ملفاتك إلا مخططاتها — فلكي يحرّر أحدها اذكره بـ @.
تُفحص تغييرات الملفات في كل ردّ قبل تطبيق أيٍّ منها. فإن تعذّر تنفيذ خطوة بأمان (مثلًا ستنشئ ملفًا موجودًا أو ستعيد كتابة ملف لم يره إلا كمخطط) فلا يُطبَّق أيٌّ من الخطوات ويشرح الردّ السبب.
بعد تطبيق التغييرات، تُسرد تحت الردّ استيرادات مساحة العمل التي ستفشل وقت التشغيل (مثل وحدة مساعدة أُعيدت تسميتها دون تحديث الملفات التي تستوردها). ويصلحها الوكيل في دوره التالي.

المزامنة مع القرص

تُزامَن الملفات أيضًا مع مجلد مساحة العمل المرتبط على القرص (في تطبيق سطح المكتب). وعند تشغيل نسخة المتصفح تُحدَّث الملفات في المحرر وعلامات التبويب لكنها لا تُنسَخ إلى القرص — ويشير الردّ إلى ذلك لتعرف أن تستخدم نسخة سطح المكتب لتكامل الملفات الكامل.

أدوات QuantCraft المدمجة

مجموعة خاصة من أدوات السوق للقراءة فقط — OHLCV والمؤشرات والبيانات الأساسية والماسح والحساب والمراكز — مفعّلة افتراضيًا ويمكن استدعاؤها مباشرةً من المحادثة (ومن عقد AI Prompt للوكلاء). أدِرها من AI → MCPs (صف QuantCraft Tools (built-in) في الأعلى). راجع أدوات QuantCraft.

أدوات الماسح (Screener)

عند تفعيل ميزة AI Screener يمكن للمحادثة أيضًا تشغيل الماسح نيابةً عنك: فتح نافذة الماسح، وبناء مرشّح أو تحميله، وتشغيله وقراءة النتائج. تعرض النافذة "The AI is using this window" وتقفل عناصر التحكم فيها أثناء عمل الذكاء الاصطناعي. في وضعي Chat وPlan يحصل الذكاء الاصطناعي على المجموعة الفرعية للقراءة فقط (يمكنه الاطلاع على المرشّحات والنتائج دون تغييرها)؛ أما وضع Agent فيحصل على المجموعة الكاملة. راجع الماسح (Screener).

الأدوات

الأدوات هي خدمات بيانات خارجية يمكن لنموذج المحادثة استدعاؤها أثناء الإجابة. أضفها من AI → AI Tools.

الأداة المتاحة هي LLMQuant Data — فعّلها بخانة Enable for chat والصق API key (يوجد رابط "Get a key").
بعد التفعيل يستطيع المساعد جلب بيانات حيّة أثناء المحادثة في فئات مثل الويكي والأوراق البحثية، وأسعار الأسهم والعملات المشفرة، والبحث عن صناديق ETF ومكوّناتها، والمؤشرات الكلية، وإيداعات SEC ومراكز 13F، وبيانات أسواق التنبؤ.

لا تُرفَق الأدوات إلا بمزوّدي المحادثة العاملين (Anthropic وDeepSeek وOpenCode وPremium وCustom LLM). لم يُنفَّذ Copilot / Cursor للمحادثة، لذا لا تعمل الأدوات أبدًا مع هذين الخيارين.

خوادم MCP

تعرض خوادم MCP (Model Context Protocol) أدواتها الخاصة للمساعد. أضفها وأدِرها من AI → MCPs. تبدأ القائمة بالصف المدمج QuantCraft Tools (built-in)؛ ولكل خادم محفوظ مفتاح Enabled for chat إضافةً إلى Edit / Remove، وتصبح أدوات الخوادم المفعّلة متاحة للمحادثة.

لإضافة خادم انقر Add server واختر Transport:

النقل	الحقول
Stdio (command)	Command (مثل `npx` أو `node` أو `python`) وArgs (واحد في كل سطر أو مفصولة بمسافات) وEnv (أسطر `KEY=VALUE`).
HTTP (Streamable)	URL وHeaders اختياري (أسطر `KEY=VALUE`، مثل `Authorization=Bearer …`).

امنح الخادم Name، واستخدم Test connection للتحقق منه (يُبلغ بعدد الأدوات التي يعرضها الخادم)، ثم Apply لإضافته إلى القائمة وSave للحفظ.

عقد AI Prompt في الوكلاء

داخل وكيل يمكنك إضافة عقدة AI Prompt — النظير الذكي لعقدة Strategy.

تكتب موجّهًا نصيًا حرًّا واحدًا يطرح سؤال نعم/لا، مثل "بالنظر إلى حركة السعر الأخيرة والبيانات الأساسية، هل هذا إعداد صعودي؟" ولا توجد قواعد منظّمة.
يعرض قسم Data sent to the AI شرائح للبيانات السابقة التي يتلقاها النموذج (نافذة OHLCV والبيانات الأساسية وغيرها). اربط عقدة Data أبًا، وإلا حذّرت العقدة من أن الذكاء الاصطناعي بلا مدخلات.
تُجبَر إجابة الذكاء الاصطناعي على true / false، وتتحكم تلك النتيجة بعقد أبنائها عبر البوابة السابقة — تمامًا مثل نتيجة Strategy.
ويمكن للنموذج أيضًا استدعاء أدوات QuantCraft للقراءة فقط (OHLCV والمؤشرات والبيانات الأساسية والماسح والحساب والمراكز) ضمن نطاق التشغيل.

النموذج الذي يشغّلها يعتمد على اتصالك النشط:

QuantCraft Premium — يُنفَّذ الاستدعاء في الخلفية باستخدام الوصول المُسنَد إليك. لا تعمل هنا إلا منحة Claude؛ وتوقف منحة DeepSeek التشغيل برسالة "not supported for AI Prompt nodes yet".
أحضر مفتاحك بنفسك (Anthropic أو OpenCode أو Custom LLM) — يُنفَّذ الاستدعاء من التطبيق بمفتاحك الخاص الذي لا يُرسل إلى الخلفية أبدًا.

لا يعمل DeepSeek — بمفتاحك أو المستضاف — مع عقد AI Prompt حتى الآن.

يُتتبَّع استهلاك الرموز من عقد AI Prompt في Agent Test وAI Builder لكل وكيل ويظهر كشارة في ترويسة المحرر: Tokens · This month: … · Lifetime: … (يُعاد ضبط الرقم الشهري كل شهر تقويمي).

نصائح

اربط مجلد مساحة العمل أولًا. في الشريط الجانبي Files اختر مجلد مشروعك. فبدونه يجيب المساعد عن الأسئلة لكنه لا يستطيع إنشاء ملفات أو تحريرها على القرص.
كن صريحًا في مسارات الملفات. عند طلب تعديل اذكر عنوان علامة التبويب أو مسارًا مثل utils/foo.py. يفهم المساعد كليهما.
استخدم Undo بحرّية. من الأسلم ترك المساعد يجرّب تغييرًا متعدد الملفات ثم التراجع عنه بدل إدارة كل خطوة بنفسك — فالتراجع يستعيد مخزن المحرر فورًا.
بدّل النموذج بحسب المهمة. استخدم نموذج Claude أسرع للتعديلات الروتينية، وأقوى (Opus) لإعادة الهيكلة الكبيرة أو تصميم الاستراتيجيات.
حافظ على مفاتيحك. تعيش قيم "أحضر مفتاحك بنفسك" على هذا الجهاز فقط. تعامل معها كأنها كلمات مرور — ولا تلصقها في أي مكان خارج نافذة AI API Providers.

11 دقائق للقراءةاقترح تعديلًا ↗