Vibe-Trading: وكيل التداول الشخصي الخاص بك

أمر واحد يمنح وكيلك قدرات تداول شاملة

الموقع · الوثائق · الأخبار · الميزات · حساب الظل · العرض التوضيحي · البدء السريع · أمثلة · API / MCP · خارطة الطريق · المساهمة

📰 الأخبار

2026-05-25 🧼 واجهة Chat أنظف + سير composer: أصبحت واجهة Web UI تترك التركيز للمدخل التالي: انتقلت أوضاع upload وswarm وresearch-goal إلى قائمة + في composer بدلاً من لوحات عائمة تقاطع المحادثة. يظهر السياق النشط فوق حقل الإدخال كشرائح compact، ولا تتوسع تفاصيل goal إلا inline عند النقر على الشريحة. أزيلت طبقة i18n المخصصة القديمة لصالح نصوص إنجليزية مباشرة، وتظهر بطاقة Full Report فقط للتشغيلات ذات تقرير فعلي، كما أصبح تشغيل التطوير المحلي وتقارير الحالة أكثر ثباتاً لاختبارات browser smoke.
2026-05-24 🎯 Research Goal runtime: أضيفت طبقة Research Goal مرتبطة بالجلسة عبر backend وCLI وAPI/MCP وSSE وWeb UI. تحفظ الأهداف claims وacceptance criteria وevidence rows وbudgets وcompletion policy؛ تستطيع agent tools إنشاء الأهداف وإضافة evidence؛ أصبح /goal مدخل CLI؛ تعرض REST/MCP لقطات goal وكتابات evidence؛ وتحافظ SSE على حداثة حالة chat clients. أغلقت إصلاحات audit اللاحقة مسارات verified evidence، ومنعت live-trading risk tiers عبر agent tools، وربطت goals المنشأة من CLI بالمنعطفات اللاحقة، ونظفت goal ledger عند حذف الجلسة، ووصلت replay-all، وأصلحت race في frontend snapshot بين الجلسات.
2026-05-23 🖥️ تحديث CLI التفاعلي: تفتح واجهة الطرفية الآن ببانر Vibe-Trading أكبر، وفاصل prompt أوضح، وملخص للدورة السابقة، وتوقيت بعد التشغيل، ومسار نشاط بأسلوب Claude Code لعمل الوكيل الحي. تُعرض استدعاءات الأدوات، وجلب الويب/البيانات، وأفعال نمط shell، وإجابات Markdown، وجداول pipe كسجل أكثر قابلية للقراءة، بينما تحافظ تشغيلات pipe أو non-TTY على إخراج نصي مناسب للأتمتة. أصبحت لقطات CLI المولدة artifacts محلية بدلاً من ملفات docs ملتزم بها، مما يبقي المستودع أخف.

أخبار سابقة

2026-05-22 🧭 استعادة Swarm + إبقاء MCP حياً: أصبحت حالة Swarm تُصالح من ملفات المهام الحية عند كل قراءة، لذلك تستعيد عروض API/MCP/SSE/list التشغيلات التي تعطلت أو صارت stale بدلاً من عرض لقطة running للأبد. يرسل run_swarm نبضات MCP progress أثناء polling، مع إطار أول ثابت swarm_started run_id=<id> كي يستطيع العملاء استعادة المقبض بعد سقوط النقل؛ كما يصدر worker نبضات خلال LLM streaming وgrounding fetch وتنفيذ الأدوات. يستخدم stale-run reaper عتبات خاصة بكل run ويستنتج الحالة النهائية من حالات المهام. لم يعد SwarmTool يلغي team ما زال يعمل لمجرد انتهاء wait budget، ويمكن لعملاء MCP استدعاء reap_stale_runs() للتنظيف الصريح. حدّثت دفعة DX اليوم أيضاً النماذج الافتراضية للمزودين، وواءمت فحص CI syntax مع حزمة agent/cli/ الجديدة. تغطي 22 اختباراً انحدارياً جديداً hydration، واستعادة الحالات النهائية، وجمع التشغيلات stale، وإيقاع keepalive، وتحمل env parsing، وربط heartbeat؛ ومجموعة swarm/MCP الكاملة عند 169 passed و4 skipped.
2026-05-21 🧱 إعادة هيكلة حزمة CLI: تقسيم agent/cli.py (3216 سطراً) إلى حزمة agent/cli/ — واجهة تفاعلية، موجّه slash، مكوّنات Rich، وطبقة _legacy.py تحافظ على كل الأوامر الفرعية وتعيد تصدير كل الرموز العامة فتبقى cli.cmd_* / cli._INIT_ENV_PATH / cli.Confirm كما هي. Middleware جديد في FastAPI يخدم قشرة SPA عند فتح /runs/{id} أو /correlation مباشرة من المتصفح، مع نفس التضييق في بروكسي Vite للتطوير. توحيد سلسلة الإصدار عبر cli/_version.py (إنهاء الانحراف بين --version والبانر)، استعادة python -m cli عبر __main__.py، وتضييق بوابة chat بحيث تصل chat --help / chat extra إلى argparse القديم بدلاً من ابتلاع REPL لها.
2026-05-20 🔬 Hypothesis Registry CLI: استكمال جانب CLI لـ Hypothesis Registry الذي شُحن backend فقط في 2026-05-16. يُخرج vibe-trading hypothesis list جدول Rich أو JSON (مع فلتر --status و--limit)؛ يعرض show <id> لوحة تفاصيل تتضمن run cards المرتبطة؛ يقلب invalidate <id> --note "..." الحالة إلى rejected ويُبقي ملاحظات الإبطال السابقة عند حذف --note. متغير البيئة VIBE_TRADING_HYPOTHESES_PATH ما زال مدعوماً، مع إضافة --path لكل استدعاء. تغطي 22 اختباراً جديداً الربط، إخراج JSON، فلتر الحالة، الحد، أخطاء معرّف مفقود، وثبات الملاحظات.
2026-05-19 ✨ تغذية راجعة حيّة للأدوات + إلغاء سلس: لم تعد الأدوات الطويلة (backtests، PDF كبيرة، عمّال swarm) تبدو متجمدة. كل استدعاء أداة يُصدر الآن نبضة قلب كل 3 ثوانٍ، بالإضافة إلى تقدّم مرحلي مهيكل — يُظهر run_backtest علامات الأطوار (validate / simulate / finalize)، ويُحدّث read_document عدّاد كل صفحة على PDF أو كل ورقة على Excel، ويُعلِم read_url بمرحلتي fetch / parse. تعرض لوحة Rich Live في CLI دوّاراً Unicode وشريط تقدّم ASCII وETA، وتُكدّس حتى 3 أدوات متوازية مفهرسة بالاسم. تضيف الواجهة الأمامية مكوّن ToolProgressIndicator جديد مع تجميع rAF، وARIA role="status" + <progress> أصلي مخفي لقارئات الشاشة، وSVG ProgressRing حتمي عندما يكون المجموع معروفاً. أول Ctrl+C أثناء تشغيل CLI يستدعي الآن agent.cancel() للخروج السلس (تكتمل الخطوة الحالية وتُغلق التتبعات بنظافة)، والثاني خلال ثانيتين يفرض الإنهاء. تم استخراج عناصر أساسية قابلة لإعادة الاستخدام: ProgressBar.tsx وlib/tools.ts (تعيين i18n لأسماء الأدوات المشترك).
2026-05-18 🧹 تنظيف + إصلاح 3 أخطاء كامنة: لم يعد CompositeEngine يوجّه رموز العقود الآجلة الصينية بدون لاحقة (مثل RB2410) إلى GlobalFuturesEngine بشكل خاطئ — انتقل _is_china_futures إلى وحدة _market_hooks المشتركة مع تطبيع حالة جدول المنتجات + حارس لبورصة غير صينية، وأُضيفت 9 حالات اختبار انحدار. تحفظ فهارس FTS5 للجلسات الآن الطوابع الزمنية، فيمكن لبحث الجلسات الفرز بالتاريخ، ونفس التغيير أصلح مسار إعادة الإدراج الذي كان يستبدل started_at بساعة الحائط في كل مرة. أُضيف /alpha المفقود إلى بروكسي تطوير Vite، فتُحلّ صفحة AlphaZoo الآن على npm run dev. تم تقييد tests/test_e2e_harness_v2.py (مجموعة e2e بـ LLM حقيقي) خلف VIBE_TRADING_RUN_LIVE_E2E=1 كي لا تغيّر CI شكلها بناءً على وجود مفتاح البيئة. أُضيفت إلى ruff قاعدة per-file-ignores لمكتبة المعاملات (الضوضاء F401 من 3783 إلى 0)، وفُعِّلت noUnusedLocals / noUnusedParameters في tsconfig الواجهة كحواجز انحدار، وحُذف 76 سطراً من نموذج vw = vwap(...) غير المستخدم في ملفات gtja191. الصافي -918 سطراً.
2026-05-17 🧬 Alpha Zoo v1 (0.1.8): 452 ألفا كمّي جاهز عبر 4 zoos — qlib158 (ميزات Alpha158 من Microsoft Qlib، إسناد Apache-2.0)، alpha101 (إعادة تنفيذ "101 Formulaic Alphas" من Kakushadze بناءً على ورقة arXiv:1601.00991)، gtja191 (تقرير بحث Guotai Junan 2014 لعوامل تداول قصيرة الأجل)، academic (Fama-French 5 + Carhart momentum كـ proxy قائم على الأسعار). سطر أوامر واحد للـ bench على أي universe: vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025. تتضمن بوابة AST للنقاء، اختبار حماية lookahead، عزل الشبكة عبر pytest-socket، LICENSE.md لكل zoo، وسير عمل توقيع DCO لمساهمات المجتمع. تقديم Alpha Library تلقائياً على vibetrading.wiki/alpha-library/، مع منشور Research Lab Which of the 191 GTJA alphas still work in 2026?.
2026-05-16 🧪 تحديث عمود البحث: أضيف backend Hypothesis Registry مع create_hypothesis وupdate_hypothesis وlink_backtest وsearch_hypotheses. تضيف قارئات المحتوى الخارجي الآن security_warnings تحذيرية فقط، وانتقل ماسح Shadow Account من calendar-phase stub القديم إلى تقييم حتمي لميزات OHLCV.
2026-05-15 🪪 تعرض صفحة تفاصيل الـ run الآن بطاقة Trust Layer run card إلى جانب المقاييس والمخرجات، لتكمل الجانب الواجهي من عمل run_card.json الذي هبط في 2026-05-12. كما تم تعزيز PersistentMemory.add() على مسارات الطول والأسماء الفارغة أو التي تحتوي على فراغات فقط وبايتات التحكم C0/C1 ضمن فرز #108/#109/#110 (#112، شكراً @Teerapat-Vatpitak).
2026-05-14 🌐 أصبح الويكي العام متاحاً على vibetrading.wiki مع أقسام docs وtutorials وResearch Lab وAlpha Library، ويُنشر عبر Cloudflare Pages. أصبحت الذاكرة الدائمة أيضاً قابلة للفحص من سطر الأوامر عبر vibe-trading memory list/show/search/forget (#102، شكراً @Teerapat-Vatpitak)، كما يدعم توليد الرموز وslugs للذاكرة الآن التايلاندية والعربية والعبرية والنص السيريلي (#104).
2026-05-13 🧭 أصبحت تشغيلات السرب تؤسس عمل الوكلاء على بيانات سوق مجلوبة مسبقاً، مع تقارير محفوظة أنظف (#93، #84).
2026-05-12 🧾 أصبحت الاختبارات الرجعية تنتج run_card.json وrun_card.md إلى جانب المخرجات لدعم تشغيلات بحثية قابلة لإعادة الإنتاج.
2026-05-11 🧭 Memory slugs، ومحاسبة السرب، وفحص CLI المسبق: أصبحت الذاكرة الدائمة تحفظ أحرف CJK عند توليد slugs للملفات، مما يمنع اصطدامات أسماء صامتة لملاحظات الصينية/اليابانية/الكورية (#95، شكراً @voidborne-d). تفضل مجاميع تشغيل السرب الآن استخدام استهلاك الرموز المبلغ من المزود مع الإبقاء على التقدير الاحتياطي الحالي (#94، شكراً @Teerapat-Vatpitak)، كما حصلت واجهة تشغيل CLI على فحص بدء مبكر للمشكلات البيئية الشائعة (#96، شكراً @ykykj).
2026-05-10 🧱 حواجز انحدار وبيانات تشغيل وصفية: أصبح استدعاء الذاكرة يتعامل مع الشرطات السفلية كحدود رموز، لذلك تطابق ذكريات snake_case مثل mcp_wiring_test استعلامات طبيعية مثل "mcp wiring" (#87، شكراً @hp083625). يملك خادم MCP الآن اختبار smoke عبر subprocess يغطي initialize → tools/list → tools/call لحماية مسار التعطل في أول استدعاء (#86)، كما وصلت تحسينات منخفضة المخاطر لاختبارات مسارات Windows، ومعالجة استثناءات API best-effort، والتحقق من allowed-root في run_dir للاختبار الرجعي، وبيانات provider/model في SwarmRun (#88، #90، #91، #92، شكراً @Teerapat-Vatpitak).
2026-05-09 🛡️ تعزيز مسارات API واستقرار خادم MCP: تتحقق مسارات run/session في API الآن من معرفات المسار قبل البحث، وترفض المعاملات المشوهة التي تحتوي على أسطر جديدة مع تثبيت السلوك في مجموعة اختبارات auth/security (#80، شكراً @SJoon99). يسخن خادم MCP سجل الأدوات على الخيط الرئيسي قبل خدمة tools/call لتجنب تعطل أول استدعاء في اكتشاف الأدوات الكسول (#85، شكراً @Teerapat-Vatpitak). كما يحترم Vite dev proxy المتغير VITE_API_URL لأهداف الخلفية غير الافتراضية (#82، شكراً @voidborne-d).
2026-05-08 🧾 حقول قوائم Tushare داخل المرشحات: تستطيع اختبارات أسهم A اليومية الآن طلب حقول قوائم مالية آمنة زمنياً عبر fundamental_fields، بحيث يمكن لمحركات الإشارات الفرز على أعمدة مثل income_total_revenue وincome_n_income وbalancesheet_total_hldr_eqy_exc_min_int وfina_indicator_roe بعد تواريخ الإعلان/الإفصاح (#76، شكراً @mrbob-git). ويجعل التعزيز اللاحق طلب حقول القوائم الصريح يفشل سريعاً إذا تعذر تشغيل إثراء Tushare، بدلاً من الرجوع بصمت إلى أشرطة الأسعار الخام (#77).
2026-05-07 📈 أساسيات Tushare وفرز المجتمع: أضيف عقد TushareFundamentalProvider بنمط point-in-time لتدفقات البحث الأساسي، مع تغطية انحدار لمسار متغير البيئة TUSHARE_TOKEN في المشروع (#74). كما أوضح فرز المجتمع أن Vibe-Trading يركز حالياً على لغة واجهة واحدة لتسريع التكرار، ويتجنب تبعيات بحث زائدة ما دام web_search المدعوم من DuckDuckGo مضمناً، ويتعامل مع النشر المستضاف غير الرسمي كمكان غير موثوق لمفاتيح API أو رموز مصادر البيانات.
2026-05-06 🚀 إصدار v0.1.7 (Release notes، pip install -U vibe-trading-ai): نُشر تعزيز حدود الأمان على PyPI وClawHub، ويغطي افتراضات أكثر أماناً للـ API/القراءة/الرفع/الملفات/URL/الكود المولد/أدوات shell/Docker مع إبقاء تدفقات CLI/Web UI المحلية سهلة. تشمل الدورة أيضاً Web UI Settings، وخريطة ارتباط حرارية، وOpenAI Codex OAuth، ومرشح A-share pre-ST، وتحسين CLI التفاعلي، وفحص swarm presets، وتحليل التوزيعات، وصقل سير التطوير، ورفع حدود أمان تبعيات بناء الواجهة. شكراً لمساهمي 0.1.7 وlemi9090 (S2W) على التحقق الأمني المنسق.
2026-05-05 🛡️ متابعة حدود الأمان: استكمال تعزيز الأمان حول CORS origins الصريحة، ومؤشرات بيانات الاعتماد في Settings، وقراءة عناوين الويب، وتوليد كود Shadow Account، مع اختبارات انحدار لكل مسار. تبقى تدفقات CLI/Web UI على localhost كما هي؛ وعلى عمليات النشر البعيدة استخدام API_AUTH_KEY وorigins موثوقة صريحة.
2026-05-04 🖥️ تجربة CLI تفاعلية وتنظيف CI: يعرض الوضع التفاعلي الآن شريط حالة سفلياً مباشراً يبين provider/model ومدة الجلسة وكمون آخر تشغيل وإحصاءات استدعاءات الأدوات، مع تصفح سجل الأوامر وتحرير المؤشر بمفاتيح الأسهم عبر prompt_toolkit (#69). يعود CLI إلى Rich prompts عند غياب prompt_toolkit أو TTY. كما وُئمت توقعات مسارات CI مع صندوق استيراد الملفات المعزز وحل /tmp عبر المنصات، فعاد main إلى الأخضر (bb67dc7).
2026-05-03 🛡️ تصحيح تعزيز الأمان: يشدد مصادقة API الافتراضية للنشر غير المحلي، ويحمي قراءات run/session/swarm الحساسة، ويقيد حدود الرفع وقراءة الملفات المحلية، ويقيد أدوات shell بحسب نقطة الدخول، ويتحقق من تحميل الاستراتيجيات المولدة قبل الاستيراد، ويشغل صورة Docker كمستخدم غير root مع منفذ localhost فقط افتراضياً. تبقى تدفقات CLI وWeb UI المحلية سهلة؛ وعلى نشر API/Web البعيد ضبط API_AUTH_KEY.
2026-05-02 🧭 تحليل التوزيعات وخارطة طريق أوضح: أضيفت مهارة dividend-analysis لأسهم الدخل، واستدامة التوزيعات، ونموها، وعائد المساهمين، وآليات ex-dividend، وفحص مصائد العائد، مع تثبيتها باختبارات انحدار للمهارات المضمنة. تركز خارطة الطريق العامة الآن على Research Autopilot وData Bridge وOptions Lab وPortfolio Studio وAlpha Zoo وResearch Delivery وTrust Layer ومشاركة Community.
2026-05-01 🔥 خريطة ارتباط حرارية وOpenAI Codex OAuth ومرشح A-share pre-ST: لوحة/API ارتباط جديدة تحسب ارتباطات العوائد المتحركة وتعرض خريطة حرارية ECharts لتحليل المحافظ والرموز (#64). يدعم مزود OpenAI Codex الآن ChatGPT OAuth عبر vibe-trading provider login openai-codex مع بيانات Settings واختبارات انحدار للمحول (#65). أضيفت وعُززت مهارة ashare-pre-st-filter لفحص مخاطر ST/*ST في أسهم A، مع فلترة صلة عقوبات Sina حتى لا تضخم إشارات حسابات الأوراق المالية عدادات E2 (#63).
2026-04-30 ⚙️ Web UI Settings وتعزيز validation CLI: صفحة Settings جديدة لمزود/نموذج LLM، وbase URL، وreasoning effort، وبيانات اعتماد مصادر البيانات، مدعومة بواجهات settings API محلية/محمية وببيانات مزودين قابلة للتكوين (#57). كما تعزز python -m backtest.validation <run_dir> حتى تفشل المدخلات الناقصة أو الفارغة أو المشوهة أو غير الموجودة أو غير الدليل برسائل واضحة قبل بدء التحقق (#60).
2026-04-28 🚀 إصدار v0.1.6 (pip install -U vibe-trading-ai): إصلاح إرجاع vibe-trading --swarm-presets فارغاً بعد pip install / uv tool install (#55)، حيث أصبحت ملفات preset YAML مضمنة داخل حزمة src.swarm ومثبتة بستة اختبارات انحدار. كما أصبح محمل AKShare يوجه ETFs مثل 510300.SH والفوركس مثل USDCNH إلى النقاط الصحيحة مع fallback registry معزز. يجمع الإصدار كل ما بعد v0.1.5: لوحة مقارنة معيارية، بث /upload وحدود الحجم، محمل Futu (HK + A-share)، مهارة تصدير vnpy، تعزيز أمني، وتحميل واجهة كسول من 688KB إلى 262KB.
2026-04-27 📊 لوحة مقارنة معيارية وأمان الرفع: مخرجات الاختبار الرجعي تتضمن الآن لوحة مقارنة معيارية (ticker / benchmark return / excess return / information ratio) مع حل عبر yfinance لـ SPY وCSI 300 وغيرها (#48). كما تبث /upload جسم الطلب في أجزاء 1 MB وتتوقف بعد MAX_UPLOAD_SIZE، مما يحد الذاكرة تحت العملاء الضخمين/المشوهين (#53)، ومثبتة بأربعة اختبارات انحدار.
2026-04-22 🛡️ تعزيز وتكاملات جديدة: فرض احتواء المسارات في safe_path وصندوق أدوات journal/shadow، وإرسال .env.example / الاختبارات / ملفات Docker في sdist عبر MANIFEST.in، وتصغير الحزمة الأولية للواجهة من 688KB إلى 262KB عبر التحميل الكسول على مستوى المسارات. إضافة محمل Futu لأسهم HK وA-share (#47) ومهارة تصدير vnpy CtaTemplate (#46).
2026-04-21 🛡️ مساحة العمل والوثائق: تطبيع run_dir النسبي إلى دليل التشغيل النشط (#43). أمثلة استخدام README (#45).
2026-04-20 🔌 Reasoning وSwarm: الحفاظ على reasoning_content عبر جميع مسارات ChatOpenAI، لتعمل أفكار Kimi / DeepSeek / Qwen من البداية للنهاية (#39). بث Swarm وإيقاف Ctrl+C نظيف (#42).
2026-04-19 📦 v0.1.5: النشر إلى PyPI وClawHub. رفع حد python-multipart لسد CVE، وربط 5 أدوات MCP جديدة (analyze_trade_journal + 4 أدوات shadow-account)، وإصلاح سجل pattern_recognition → pattern، ومطابقة تبعيات Docker، ومزامنة بيان SKILL (22 أداة MCP / 71 مهارة).
2026-04-18 👥 Shadow Account: استخرج قواعد استراتيجيتك من سجل وسيط → اختبر الظل عبر الأسواق → تقرير HTML/PDF من 8 أقسام يوضح ما تتركه على الطاولة (خرق القواعد، الخروج المبكر، الإشارات الفائتة، الصفقات المضادة). 4 أدوات جديدة، ومهارة واحدة، و32 أداة إجمالاً. أمثلة Trade Journal + Shadow Account موجودة الآن في شاشة ترحيب Web UI.
2026-04-17 📊 محلل سجل التداول وقارئ ملفات شامل: ارفع صادرات الوسطاء (同花顺/东财/富途/generic CSV) → ملف تداول تلقائي (أيام الاحتفاظ، معدل الربح، نسبة PnL، التراجع) + 4 تشخيصات سلوكية (disposition effect، الإفراط في التداول، مطاردة الزخم، anchoring). أصبح read_document يوجه PDF وWord وExcel وPowerPoint والصور (OCR) و40+ صيغة نصية خلف استدعاء موحد.
2026-04-16 🧠 Agent Harness: ذاكرة دائمة عبر الجلسات، بحث جلسات FTS5، مهارات ذاتية التطور (CRUD كامل)، ضغط سياق بخمس طبقات، وتجميع أدوات القراءة/الكتابة. 27 أداة، و107 اختبارات جديدة.
2026-04-15 🤖 Z.ai + MiniMax: مزود Z.ai (#35)، وإصلاح temperature في MiniMax وتحديث النموذج (#33). 13 مزوداً.
2026-04-14 🔧 استقرار MCP: إصلاح خطأ Connection closed في أداة الاختبار الرجعي على نقل stdio (#32).
2026-04-13 🌐 اختبار رجعي مركب عبر الأسواق: محرك CompositeEngine جديد يختبر محافظ مختلطة الأسواق (مثل أسهم A + crypto) بمجمع رأس مال مشترك وقواعد لكل سوق. كما أصلح fallback لمتغيرات قالب السرب ومهلة الواجهة.
2026-04-12 🌍 تصدير متعدد المنصات: يصدر /pine الاستراتيجيات إلى TradingView (Pine Script v6)، وTDX (通达信/同花顺/东方财富)، وMetaTrader 5 (MQL5) بأمر واحد.
2026-04-11 🛡️ الموثوقية وتجربة المطور: إعداد .env عبر vibe-trading init (#19)، وفحوصات مسبقة، وfallback لمصادر البيانات وقت التشغيل، ومحرك اختبار رجعي معزز. README متعدد اللغات (#21).
2026-04-10 📦 v0.1.4: إصلاح Docker (#8)، وأداة MCP web_search، و12 مزود LLM، وتبعيات akshare/ccxt. النشر إلى PyPI وClawHub.
2026-04-09 📊 الموجة الثانية للاختبار الرجعي: محركات ChinaFutures وGlobalFutures وForex وOptions v2. تحقق Monte Carlo وBootstrap CI وWalk-Forward.
2026-04-08 🔧 اختبار رجعي متعدد الأسواق مع قواعد لكل سوق، وتصدير Pine Script v6، و5 مصادر بيانات مع fallback تلقائي.

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

🔍 وكيل تداول ذاتي التحسن • بحث سوقي باللغة الطبيعية • مسودات استراتيجيات وتحليل ملفات/ويب • تدفقات عمل مدعومة بالذاكرة	🐝 فرق تداول متعددة الوكلاء • فرق استثمار وكمّ وكريبتو ومخاطر • تقدم مباشر وتقارير محفوظة • وكلاء مؤسسون على بيانات سوق مجلوبة
📊 بيانات واختبارات رجعية عبر الأسواق • أسهم A/HK/US، وكريبتو، وعقود آجلة، وفوركس • fallback للبيانات واختبارات مركبة • بيانات PIT، وتحقيق، وبطاقات تشغيل	👥 Shadow Account • تشخيص سلوكي لسجلات الوسطاء • مقارنات Shadow Account قائمة على القواعد • تقارير تدقيق وكود استراتيجية قابلان للتصدير

💡 ما هو Vibe-Trading؟

Vibe-Trading مساحة عمل بحثية مفتوحة المصدر تحول الأسئلة المالية إلى تحليل قابل للتشغيل. يربط المطالبات باللغة الطبيعية بمحملات بيانات السوق، وتوليد الاستراتيجيات، ومحركات الاختبار الرجعي، والتقارير، والتصدير، وذاكرة البحث الدائمة.

صُمم للبحث والمحاكاة والاختبار الرجعي. لا ينفذ صفقات حية.

✨ ما الذي يمكنك فعله؟

المهمة	الناتج
طرح سؤال تداول	بحث سوقي باستخدام الأدوات والبيانات والمستندات وسياق جلسة قابل لإعادة الاستخدام.
اختبار فكرة استراتيجية رجعياً	كود استراتيجية، ومقاييس، وسياق معياري، ومخرجات تحقق، وبطاقات تشغيل.
مراجعة صفقاتك الخاصة	قراءة سجلات الوسطاء، وتشخيص السلوك، واستخراج القواعد، ومقارنات Shadow Account.
تحسين الأبحاث المتكررة	الذاكرة الدائمة والمهارات القابلة للتحرير تحول الروتينات المفيدة إلى تدفقات قابلة لإعادة الاستخدام.
تشغيل فرق محللين	مراجعات بحث متعددة الوكلاء لتدفقات الاستثمار والكم والكريبتو والماكرو والمخاطر.
إنتاج مخرجات قابلة للاستخدام	تقارير، وTradingView Pine Script، وTDX، وMetaTrader 5، وأدوات MCP، وجلسات بحث لاحقة.
bench ألفا zoo جاهزة	تشغيل IC + IR + تصنيف alive/reversed/dead عبر 452 ألفا (Qlib 158 + Kakushadze 101 + GTJA 191 + FF5 + Carhart) بسطر أوامر واحد على universe الخاص بك.

⚡ مثال سريع

pip install vibe-trading-ai

# بحث بلغة طبيعية
vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024, summarize return and drawdown, then export the report"

# bench لـ alpha zoo جاهز بسطر واحد
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

vibe-trading --upload trades_export.csv
vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, and compare it with my actual trades"

👥 حساب الظل

ينطلق Shadow Account من سجلات تداولك أنت، لا من قالب استراتيجية عام.

ارفع تصديراً من وسيطك، ودع الوكيل يلخص سلوكك، ثم قارن مسار التداول الحقيقي باستراتيجية ظل قائمة على قواعد.

الخطوة	ناتج الوكيل
1. قراءة سجلك	يقرأ صادرات الوسطاء من 同花顺 و东方财富 و富途 وصيغ CSV العامة.
2. بناء ملف سلوكك	أيام الاحتفاظ، ومعدل الربح، ونسبة PnL، والتراجع، وdisposition effect، والإفراط في التداول، ومطاردة الزخم، وفحوصات anchoring.
3. استخراج قواعدك	يحول أنماط الدخول/الخروج المتكررة إلى ملف استراتيجية صريح بدلاً من ملخص ضبابي.
4. تشغيل الظل	يختبر القواعد المستخرجة رجعياً ويبرز خرق القواعد، والخروج المبكر، والإشارات الفائتة، ومسارات التداول البديلة.
5. تسليم التقرير	ينتج تقرير HTML/PDF يمكن فحصه أو أرشفته أو تحسينه في جلسة لاحقة.

vibe-trading --upload trades_export.csv
vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, and compare it with my actual trades"

🧪 سير البحث

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

الطبقة	ما يحدث
Plan	يختار المهارات المالية والأدوات ومصادر البيانات وإعداد السرب الملائمة عند الحاجة.
Ground	يجلب أسهم A، وأسهم HK/US، والكريبتو، والعقود الآجلة، والفوركس، والمستندات، أو سياق الويب عبر المحملات المتاحة.
Execute	يولد كود استراتيجية قابل للاختبار، ويشغل الأدوات، ويستخدم محرك الاختبار الرجعي أو سير التحليل المناسب.
Validate	يضيف المقاييس، والمقارنة المعيارية، وMonte Carlo، وBootstrap، وWalk-Forward، وبطاقات التشغيل، والتحذيرات عند اللزوم.
Deliver	يعيد التقارير والمخرجات وآثار الأدوات والتصديرات إلى TradingView وTDX وMetaTrader 5 وعملاء MCP أو جلسات لاحقة.

🔩 القدرات التفصيلية

القوائم التفصيلية مطوية أدناه حتى يبقى README سهل القراءة. افتحها عندما تريد فحص اللبنات المتاحة.

مكتبة المهارات المالية _{75 مهارة عبر 8 فئات}

📊 75 مهارة مالية متخصصة منظمة في 8 فئات
🌐 تغطية كاملة من الأسواق التقليدية إلى الكريبتو وDeFi
🔬 قدرات شاملة من مصادر البيانات إلى البحث الكمي

الفئة	المهارات	أمثلة
Data Source	6	`data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `ccxt`
Strategy	17	`strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy`
Analysis	17	`factor-research`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-analysis`
Asset Class	9	`options-strategy`, `options-advanced`, `convertible-bond`, `etf-analysis`, `asset-allocation`, `sector-rotation`
Crypto	7	`perp-funding-basis`, `liquidation-heatmap`, `stablecoin-flow`, `defi-yield`, `onchain-analysis`
Flow	7	`hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare`
Tool	11	`backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export`, `alpha-zoo`
Risk Analysis	1	`ashare-pre-st-filter`

فرق تداول جاهزة _{29 إعداد سرب مسبق}

🏢 29 فريق وكلاء جاهزاً للاستخدام
⚡ تدفقات مالية مهيأة مسبقاً
🎯 إعدادات للاستثمار والتداول وإدارة المخاطر

الإعداد	سير العمل
`investment_committee`	مناظرة صعود/هبوط → مراجعة مخاطر → قرار مدير المحفظة النهائي
`global_equities_desk`	باحث أسهم A + HK/US + كريبتو → استراتيجي عالمي
`crypto_trading_desk`	تمويل/أساس + تصفية + تدفق → مدير مخاطر
`earnings_research_desk`	أساسيات + مراجعات + خيارات → استراتيجي أرباح
`macro_rates_fx_desk`	أسعار فائدة + FX + سلع → مدير محفظة ماكرو
`quant_strategy_desk`	فرز + بحث عوامل → اختبار رجعي → تدقيق مخاطر
`technical_analysis_panel`	TA كلاسيكي + Ichimoku + harmonic + Elliott + SMC → إجماع
`risk_committee`	تراجع + مخاطر ذيل + مراجعة نظام → اعتماد
`global_allocation_committee`	أسهم A + كريبتو + HK/US → تخصيص عبر الأسواق

_{بالإضافة إلى أكثر من 20 إعداداً متخصصاً آخر — شغل vibe-trading --swarm-presets لاستكشافها كلها.}

Alpha Zoo _{452 ألفا كمّي جاهز عبر 4 zoos}

🧬 452 ألفا cross-sectional، مع منع lookahead على طبقة العوامل (operators)
📈 IC + IR + تصنيف alive/reversed/dead بأمر CLI واحد
🔬 بوابة نقاء AST + اختبار حماية lookahead بـ 300 صف + قاطع شبكة عبر pytest-socket
📦 إسناد Apache-2 لـ Qlib؛ ملف LICENSE.md لكل zoo يصرّح بأن الصيغ محتوى رياضي
🤝 سير عمل توقيع Developer Certificate of Origin (DCO) لمساهمات المجتمع

Zoo	العدد	المصدر	الرخصة
qlib158	154	Microsoft Qlib `Alpha158` (Apache-2.0، مثبّت على commit)	Apache-2.0
alpha101	101	Kakushadze (2015)، "101 Formulaic Alphas"، arXiv:1601.00991	الصيغ محتوى رياضي
gtja191	191	Guotai Junan (2014)، "191 Short-period Trading Alpha Factors"	الصيغ محتوى رياضي
academic	6	Fama-French 5 + Carhart momentum (proxy قائم على الأسعار)	أدبيات أكاديمية عامة

شغّل vibe-trading alpha list للتصفح، وvibe-trading alpha show <id> للحصول على الصيغ + المصدر، وvibe-trading alpha bench --zoo X --universe Y --period Z لتقييم zoo كاملة.

🎬 العرض التوضيحي

cli_sm.mp4	frontend_sm.mp4
_{☝️ اختبار رجعي باللغة الطبيعية ومناظرة سرب متعدد الوكلاء — Web UI + CLI}

🚀 البدء السريع

تثبيت بسطر واحد (PyPI)

pip install vibe-trading-ai

ثم شغل أول مهمة بحثية:

vibe-trading init
vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024 and summarize return and drawdown"

اسم الحزمة مقابل الأوامر: حزمة PyPI هي vibe-trading-ai. بعد التثبيت تحصل على ثلاثة أوامر:

الأمر الغرض

vibe-trading CLI / TUI تفاعلي

vibe-trading serve تشغيل خادم ويب FastAPI

vibe-trading-mcp بدء خادم MCP (لـ Claude Desktop وOpenClaw وCursor وغيرها)

الأمر	الغرض
`vibe-trading`	CLI / TUI تفاعلي
`vibe-trading serve`	تشغيل خادم ويب FastAPI
`vibe-trading-mcp`	بدء خادم MCP (لـ Claude Desktop وOpenClaw وCursor وغيرها)

vibe-trading init              # interactive .env setup
vibe-trading                   # launch CLI
vibe-trading serve --port 8899 # launch web UI
vibe-trading-mcp               # start MCP server (stdio)

أو اختر مساراً

المسار	الأنسب لـ	الوقت
A. Docker	التجربة الآن، دون إعداد محلي	دقيقتان
B. تثبيت محلي	التطوير والوصول الكامل إلى CLI	5 دقائق
C. MCP plugin	وصله بوكيلك الحالي	3 دقائق
D. ClawHub	أمر واحد دون استنساخ	دقيقة واحدة

المتطلبات المسبقة

مفتاح API لنموذج LLM من أي مزود مدعوم — أو التشغيل محلياً عبر Ollama (لا يحتاج مفتاحاً)
Python 3.11+ للمسار B
Docker للمسار A
يمكن استخدام OpenAI Codex أيضاً عبر ChatGPT OAuth: اضبط LANGCHAIN_PROVIDER=openai-codex، ثم شغل vibe-trading provider login openai-codex. هذا لا يستخدم OPENAI_API_KEY.

مزودو LLM المدعومون: OpenRouter, OpenAI, DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, Xiaomi MIMO, Z.ai, Ollama (local). راجع .env.example للإعداد.

نصيحة: تعمل كل الأسواق دون مفاتيح API بفضل fallback التلقائي. yfinance (HK/US)، وOKX (crypto)، وAKShare (A-shares, US, HK, futures, forex) مجانية. رمز Tushare اختياري، إذ يغطي AKShare أسهم A كبديل مجاني.

المسار A: Docker (دون إعداد)

git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
cp agent/.env.example agent/.env
# Edit agent/.env — uncomment your LLM provider and set API key
docker compose up --build

افتح http://localhost:8899. الخلفية والواجهة الأمامية داخل حاوية واحدة.

ينشر Docker الخلفية على 127.0.0.1:8899 افتراضياً ويشغل التطبيق كمستخدم حاوية غير root. إذا كنت تقصد تعريض API خارج جهازك، فاضبط API_AUTH_KEY قوياً وأرسل Authorization: Bearer <key> من العملاء.

المسار B: التثبيت المحلي

git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
python -m venv .venv

# Activate
source .venv/bin/activate          # Linux / macOS
# .venv\Scripts\Activate.ps1       # Windows PowerShell

pip install -e .
cp agent/.env.example agent/.env   # Edit — set your LLM provider API key
vibe-trading                       # Launch interactive TUI

تشغيل واجهة الويب (اختياري)

# Terminal 1: API server
vibe-trading serve --port 8899

# Terminal 2: Frontend dev server
cd frontend && npm install && npm run dev

افتح http://localhost:5899. تمرر الواجهة الأمامية استدعاءات API إلى localhost:8899.

وضع الإنتاج (خادم واحد):

cd frontend && npm run build && cd ..
vibe-trading serve --port 8899     # FastAPI serves dist/ as static files

المسار C: MCP plugin

راجع قسم MCP Plugin أدناه.

المسار D: ClawHub (أمر واحد)

npx clawhub@latest install vibe-trading --force

تُنزل المهارة وإعداد MCP إلى مجلد مهارات وكيلك. راجع تثبيت ClawHub للتفاصيل.

🧠 متغيرات البيئة

انسخ agent/.env.example إلى agent/.env وأزل التعليق عن كتلة المزود التي تريدها. يحتاج كل مزود إلى 3-4 متغيرات:

المتغير	مطلوب	الوصف
`LANGCHAIN_PROVIDER`	نعم	اسم المزود (`openrouter`, `deepseek`, `groq`, `ollama`, إلخ)
`<PROVIDER>_API_KEY`	نعم*	مفتاح API (`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY`, إلخ)
`<PROVIDER>_BASE_URL`	نعم	عنوان URL لنقطة نهاية API
`LANGCHAIN_MODEL_NAME`	نعم	اسم النموذج (مثل `deepseek-v4-pro`)
`TUSHARE_TOKEN`	لا	رمز Tushare Pro لبيانات أسهم A (يرجع إلى AKShare عند الحاجة)
`TIMEOUT_SECONDS`	لا	مهلة استدعاء LLM، الافتراضي 120s
`API_AUTH_KEY`	موصى به للنشر الشبكي	Bearer token مطلوب عندما يكون API قابلاً للوصول من عملاء غير محليين
`VIBE_TRADING_ENABLE_SHELL_TOOLS`	لا	تفعيل صريح للأدوات القادرة على shell في نشر API/MCP-SSE البعيد
`VIBE_TRADING_ALLOWED_FILE_ROOTS`	لا	جذور إضافية مفصولة بفواصل لاستيراد المستندات وسجلات الوسطاء
`VIBE_TRADING_ALLOWED_RUN_ROOTS`	لا	جذور إضافية مفصولة بفواصل لأدلة تشغيل الكود المولد

_{* لا يحتاج Ollama إلى مفتاح API. يستخدم OpenAI Codex ChatGPT OAuth ويخزن الرموز عبر oauth-cli-kit، لا داخل agent/.env.}

بيانات مجانية (دون مفتاح): أسهم A عبر AKShare، وأسهم HK/US عبر yfinance، والكريبتو عبر OKX، وأكثر من 100 بورصة كريبتو عبر CCXT. يختار النظام تلقائياً أفضل مصدر متاح لكل سوق.

🎯 النماذج الموصى بها

Vibe-Trading وكيل كثيف الأدوات؛ المهارات والاختبارات الرجعية والذاكرة والأسراب كلها تمر عبر استدعاءات أدوات. اختيار النموذج يحدد مباشرة هل سيستخدم الوكيل أدواته أم سيصطنع إجابات من بيانات التدريب.

المستوى	أمثلة	متى تستخدمه
الأفضل	`anthropic/claude-opus-4.7`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.5-pro`, `google/gemini-3.5-flash`	أسراب معقدة (3+ وكلاء)، جلسات بحث طويلة، تحليل بمستوى ورقة علمية
النقطة المثلى (افتراضي)	`deepseek-v4-pro`, `deepseek/deepseek-v4-pro`, `x-ai/grok-4.20`, `z-ai/glm-5.1`, `moonshotai/kimi-k2.6`, `qwen/qwen3-max-thinking`	الاستخدام اليومي، tool-calling موثوق بنحو عُشر التكلفة
تجنبها لاستخدام الوكيل	`-nano`, `-flash-lite`, `*-coder-next`, small / distilled variants	tool-calling غير موثوق؛ سيبدو الوكيل وكأنه "يجيب من الذاكرة" بدلاً من تحميل المهارات أو تشغيل الاختبارات الرجعية

يأتي agent/.env.example افتراضياً مع DeepSeek official API + deepseek-v4-pro; ويمكن لمستخدمي OpenRouter استخدام deepseek/deepseek-v4-pro.

🖥 مرجع CLI

vibe-trading               # interactive TUI
vibe-trading run -p "..."  # single run
vibe-trading serve         # API server
vibe-trading alpha list    # استعرض 452 ألفا جاهز؛ متاح show / bench / compare / export-manifest

أوامر الشرطة المائلة داخل TUI

الأمر	الوصف
`/help`	عرض كل الأوامر
`/skills`	عرض كل المهارات المالية الـ 75
`/swarm`	عرض إعدادات فرق السرب الـ 29
`/swarm run <preset> [vars_json]`	تشغيل فريق سرب مع بث مباشر
`/swarm list`	سجل تشغيلات السرب
`/swarm show <run_id>`	تفاصيل تشغيل السرب
`/swarm cancel <run_id>`	إلغاء سرب قيد التشغيل
`/list`	التشغيلات الأخيرة
`/show <run_id>`	تفاصيل التشغيل + المقاييس
`/code <run_id>`	كود الاستراتيجية المولدة
`/pine <run_id>`	تصدير المؤشرات (TradingView + TDX + MT5)
`/trace <run_id>`	إعادة تشغيل التنفيذ كاملة
`/continue <run_id> <prompt>`	متابعة تشغيل بتعليمات جديدة
`/sessions`	عرض جلسات الدردشة
`/settings`	عرض إعدادات التشغيل
`/clear`	مسح الشاشة
`/quit`	خروج

تشغيل واحد والخيارات

vibe-trading run -p "Backtest BTC-USDT MACD strategy, last 30 days"
vibe-trading run -p "Analyze AAPL momentum" --json
vibe-trading run -f strategy.txt
echo "Backtest 000001.SZ RSI" | vibe-trading run

vibe-trading -p "your prompt"
vibe-trading --skills
vibe-trading --swarm-presets
vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}'
vibe-trading --list
vibe-trading --show <run_id>
vibe-trading --code <run_id>
vibe-trading --pine <run_id>           # Export indicators (TradingView + TDX + MT5)
vibe-trading --trace <run_id>
vibe-trading --continue <run_id> "refine the strategy"
vibe-trading --upload report.pdf

vibe-trading alpha list --zoo gtja191 --limit 10
vibe-trading alpha show gtja191_171
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

💡 أمثلة

الاستراتيجيات والاختبار الرجعي

# Moving average crossover on US equities
vibe-trading run -p "Backtest a 20/50-day moving average crossover on AAPL for the past year, show Sharpe ratio and max drawdown"

# RSI mean-reversion on crypto
vibe-trading run -p "Test RSI(14) mean-reversion on BTC-USDT: buy below 30, sell above 70, last 6 months"

# Multi-factor strategy on A-shares
vibe-trading run -p "Backtest a momentum + value + quality multi-factor strategy on CSI 300 constituents over 2 years"

# After backtesting, export to TradingView / TDX / MetaTrader 5
vibe-trading --pine <run_id>

bench ألفا zoo جاهز بسطر واحد:

vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

استعرض الكتالوج وافحص ألفا مفردة:

vibe-trading alpha list --zoo gtja191 --theme reversal --limit 10
vibe-trading alpha show gtja191_171

ركّب إشارة متعدد العوامل من ألفات zoo (Python):

from src.skills.multi_factor.zoo_signal_engine import ZooSignalEngine
engine = ZooSignalEngine.from_zoo(["gtja191_171", "gtja191_111", "gtja191_163"])
panel = ...  # your wide OHLCV panel
signal = engine.compute_signal(panel)

بحث السوق

# Equity deep-dive
vibe-trading run -p "Research NVDA: earnings trend, analyst consensus, option flow, and key risks for next quarter"

# Macro analysis
vibe-trading run -p "Analyze the current Fed rate path, USD strength, and impact on EM equities and gold"

# Crypto on-chain
vibe-trading run -p "Deep dive BTC on-chain: whale flows, exchange balances, miner activity, and funding rates"

تدفقات السرب

# Bull/bear debate on a stock
vibe-trading --swarm-run investment_committee '{"topic": "Is TSLA a buy at current levels?"}'

# Quant strategy from screening to backtest
vibe-trading --swarm-run quant_strategy_desk '{"universe": "S&P 500", "horizon": "3 months"}'

# Crypto desk: funding + liquidation + flow → risk manager
vibe-trading --swarm-run crypto_trading_desk '{"asset": "ETH-USDT", "timeframe": "1w"}'

# Global macro portfolio allocation
vibe-trading --swarm-run macro_rates_fx_desk '{"focus": "Fed pivot impact on EM bonds"}'

ذاكرة عبر الجلسات

# Save your preferences once
vibe-trading run -p "Remember: I prefer RSI-based strategies, max 10% drawdown, hold period 5–20 days"

# The agent recalls them in future sessions automatically
vibe-trading run -p "Build a crypto strategy that fits my risk profile"

رفع المستندات وتحليلها

# Analyze a broker export or earnings report
vibe-trading --upload trades_export.csv
vibe-trading run -p "Profile my trading behavior and identify any biases"

vibe-trading --upload NVDA_Q1_earnings.pdf
vibe-trading run -p "Summarize the key risks and beats/misses from this earnings report"

🌐 خادم API

vibe-trading serve --port 8899

الطريقة	نقطة النهاية	الوصف
`GET`	`/runs`	عرض التشغيلات
`GET`	`/runs/{run_id}`	تفاصيل التشغيل
`GET`	`/runs/{run_id}/pine`	تصدير مؤشرات متعدد المنصات
`POST`	`/sessions`	إنشاء جلسة
`POST`	`/sessions/{id}/messages`	إرسال رسالة
`GET`	`/sessions/{id}/events`	بث أحداث SSE
`POST`	`/upload`	رفع PDF/ملف
`GET`	`/swarm/presets`	عرض إعدادات السرب
`POST`	`/swarm/runs`	بدء تشغيل سرب
`GET`	`/swarm/runs/{id}/events`	بث SSE للسرب
`GET`	`/alpha/list`	قائمة ألفات مع تصفية حسب zoo/theme/universe
`GET`	`/alpha/{alpha_id}`	بيانات وصفية + الكود المصدري للألفا
`POST`	`/alpha/bench`	بدء مهمة bench (يعيد `job_id`)
`GET`	`/alpha/bench/{job_id}/stream`	تدفق تقدّم SSE
`GET`	`/settings/llm`	قراءة إعدادات LLM في Web UI
`PUT`	`/settings/llm`	تحديث إعدادات LLM المحلية
`GET`	`/settings/data-sources`	قراءة إعدادات مصادر البيانات المحلية
`PUT`	`/settings/data-sources`	تحديث إعدادات مصادر البيانات المحلية

توثيق تفاعلي: http://localhost:8899/docs

الإعدادات الأمنية الافتراضية

للتطوير على localhost، يبقي vibe-trading serve سير المتصفح بسيطاً. لأي عميل غير محلي، تتطلب نقاط API الحساسة API_AUTH_KEY؛ استخدم Authorization: Bearer <key> لطلبات JSON/الرفع. تتعامل Web UI مع تدفقات Browser EventSource بعد إدخال المفتاح نفسه مرة واحدة في Settings.

تتوفر الأدوات القادرة على shell للـ CLI المحلي وتدفقات localhost الموثوقة، لكنها لا تُعرض لجلسات API البعيدة ما لم تضبط صراحة VIBE_TRADING_ENABLE_SHELL_TOOLS=1. قارئات المستندات والسجلات محدودة افتراضياً بجذور الرفع/الاستيراد؛ ضع الملفات تحت agent/uploads أو agent/runs أو ./uploads أو ./data أو ~/.vibe-trading/uploads أو ~/.vibe-trading/imports، أو أضف دليلاً مخصصاً عبر VIBE_TRADING_ALLOWED_FILE_ROOTS.

إعدادات Web UI

تتيح صفحة Settings في Web UI للمستخدمين المحليين تحديث مزود/نموذج LLM، وbase URL، ومعلمات التوليد، وreasoning effort، وبيانات اعتماد السوق الاختيارية مثل رمز Tushare. تُحفظ الإعدادات في agent/.env؛ وتُحمّل قيم المزودين الافتراضية من agent/src/providers/llm_providers.json.

قراءات Settings بلا آثار جانبية: لا تنشئ GET /settings/llm ولا GET /settings/data-sources ملف agent/.env، ولا تعيدان إلا مسارات نسبية للمشروع. قد تكشف قراءات وكتابات Settings حالة بيانات الاعتماد أو تحدث بيانات الاعتماد/بيئة التشغيل، لذلك تتطلب API_AUTH_KEY عند ضبطه. إذا كان API_AUTH_KEY غير مضبوط في وضع التطوير، فلا يقبل الوصول إلى Settings إلا من عملاء loopback.

🔌 MCP Plugin

يعرض Vibe-Trading 22 أداة MCP لأي عميل متوافق مع MCP. يعمل كعملية stdio فرعية، دون إعداد خادم. 21 من أصل 22 أداة تعمل دون أي مفاتيح API (HK/US/crypto). يحتاج run_swarm وحده إلى مفتاح LLM.

Claude Desktop

أضف إلى claude_desktop_config.json:

{
  "mcpServers": {
    "vibe-trading": {
      "command": "vibe-trading-mcp"
    }
  }
}

OpenClaw

أضف إلى ~/.openclaw/config.yaml:

skills:
  - name: vibe-trading
    command: vibe-trading-mcp

Cursor / Windsurf / عملاء MCP آخرون

vibe-trading-mcp                  # stdio (default)
vibe-trading-mcp --transport sse  # SSE for web clients

أدوات MCP المعروضة (22): list_skills, load_skill, backtest, factor_analysis, analyze_options, pattern_recognition, get_market_data, web_search, read_url, read_document, read_file, write_file, analyze_trade_journal, extract_shadow_strategy, run_shadow_backtest, render_shadow_report, scan_shadow_signals, list_swarm_presets, run_swarm, get_swarm_status, get_run_result, list_runs.

التثبيت من ClawHub (أمر واحد)

npx clawhub@latest install vibe-trading --force

--force مطلوب لأن المهارة تشير إلى واجهات API خارجية، مما يطلق فحص VirusTotal الآلي. الكود مفتوح المصدر بالكامل وآمن للفحص.

ينزل هذا المهارة وإعداد MCP إلى مجلد مهارات وكيلك. لا حاجة للاستنساخ.

تصفح على ClawHub: clawhub.ai/skills/vibe-trading

OpenSpace — مهارات ذاتية التطور

كل المهارات المالية الـ 75 منشورة على open-space.cloud وتتطور ذاتياً عبر محرك التطور الذاتي في OpenSpace.

للاستخدام مع OpenSpace، أضف خادمي MCP إلى إعداد وكيلك:

{
  "mcpServers": {
    "openspace": {
      "command": "openspace-mcp",
      "toolTimeout": 600,
      "env": {
        "OPENSPACE_HOST_SKILL_DIRS": "/path/to/vibe-trading/agent/src/skills",
        "OPENSPACE_WORKSPACE": "/path/to/OpenSpace"
      }
    },
    "vibe-trading": {
      "command": "vibe-trading-mcp"
    }
  }
}

سيكتشف OpenSpace كل المهارات الـ 75 تلقائياً، مما يتيح auto-fix وauto-improve والمشاركة المجتمعية. ابحث عن مهارات Vibe-Trading عبر search_skills("finance backtest") في أي وكيل متصل بـ OpenSpace.

📁 هيكل المشروع

انقر للتوسيع

Vibe-Trading/
├── agent/                          # Backend (Python)
│   ├── cli/                        # CLI package — interactive TUI + subcommands
│   ├── api_server.py               # FastAPI server — runs, sessions, upload, swarm, SSE
│   ├── mcp_server.py               # MCP server — 22 tools for OpenClaw / Claude Desktop
│   │
│   ├── src/
│   │   ├── agent/                  # ReAct agent core
│   │   │   ├── loop.py             #   5-layer compression + read/write tool batching
│   │   │   ├── context.py          #   system prompt + auto-recall from persistent memory
│   │   │   ├── skills.py           #   skill loader (75 bundled + user-created via CRUD)
│   │   │   ├── tools.py            #   tool base class + registry
│   │   │   ├── memory.py           #   lightweight workspace state per run
│   │   │   ├── frontmatter.py      #   shared YAML frontmatter parser
│   │   │   └── trace.py            #   execution trace writer
│   │   │
│   │   ├── memory/                 # Cross-session persistent memory
│   │   │   └── persistent.py       #   file-based memory (~/.vibe-trading/memory/)
│   │   │
│   │   ├── tools/                  # 31 auto-discovered agent tools
│   │   │   ├── backtest_tool.py    #   run backtests
│   │   │   ├── remember_tool.py    #   cross-session memory (save/recall/forget)
│   │   │   ├── skill_writer_tool.py #  skill CRUD (save/patch/delete/file)
│   │   │   ├── session_search_tool.py # FTS5 cross-session search
│   │   │   ├── swarm_tool.py       #   launch swarm teams
│   │   │   ├── web_search_tool.py  #   DuckDuckGo web search
│   │   │   └── ...                 #   bash, file I/O, factor analysis, options, alpha browser + bench, etc.
│   │   │
│   │   ├── factors/                # Alpha Zoo — 452 ألفا عبر 4 zoos
│   │   │   ├── base.py             #   19 عاملاً (rank/scale/ts_*/delta/decay_linear/safe_div/vwap)
│   │   │   ├── registry.py         #   تحميل بيانات وصفية AST فقط + حساب كسول + بوابات سلامة
│   │   │   ├── bench_runner.py     #   IC + تصنيف alive/reversed/dead
│   │   │   └── zoo/                #   qlib158 (154) + alpha101 (101) + gtja191 (191) + academic (6)
│   │   │
│   │   ├── api/                    # وحدات مسارات FastAPI
│   │   │   └── alpha_routes.py     #   /alpha/list, /alpha/{id}, /alpha/bench, SSE stream
│   │   │
│   │   ├── skills/                 # 75 finance skills in 8 categories (SKILL.md each)
│   │   ├── swarm/                  # Swarm DAG execution engine
│   │   │   └── presets/            #   29 swarm preset YAML definitions
│   │   ├── session/                # Multi-turn chat + FTS5 session search
│   │   └── providers/              # LLM provider abstraction
│   │
│   └── backtest/                   # Backtest engines
│       ├── engines/                #   7 engines + composite cross-market engine + options_portfolio
│       ├── loaders/                #   6 sources: tushare, okx, yfinance, akshare, ccxt, futu
│       │   ├── base.py             #   DataLoader Protocol
│       │   └── registry.py         #   Registry + auto-fallback chains
│       └── optimizers/             #   MVO, equal vol, max div, risk parity
│
├── frontend/                       # Web UI (React 19 + Vite + TypeScript)
│   └── src/
│       ├── pages/                  #   Home, Agent, AlphaZoo, RunDetail, Compare, Correlation, Settings
│       ├── components/             #   chat, charts, layout
│       └── stores/                 #   Zustand state management
│
├── Dockerfile                      # Multi-stage build
├── docker-compose.yml              # One-command deploy
├── pyproject.toml                  # Package config + CLI entrypoint
├── tools/                          # Repo-level CI helpers
│   └── ci_grep_gates.sh            # rejects yaml.load / trademark / per-stock-data leaks
└── LICENSE                         # MIT

🏛 النظام البيئي

Vibe-Trading جزء من نظام وكلاء HKUDS:

NanoBot
_{Ultra-Lightweight Personal AI Assistant}

AI-Trader
_{Agent-Native Signal & Copy Trading Platform}

CLI-Anything
_{Making All Software Agent-Native}

OpenSpace
_{Self-Evolving AI Agent Skills}

ClawTeam
_{Agent Swarm Intelligence}

🗺 خارطة الطريق

نشحن على مراحل. تنتقل العناصر إلى Issues عندما يبدأ العمل.

المرحلة	الميزة	الحالة
Trust Layer	بطاقات تشغيل قابلة لإعادة الإنتاج تُنتج وتظهر في Run Detail؛ يضيف v1 آثار الأدوات والاستشهادات	v0 شُحن
Hypothesis Registry	فرضيات بحثية دائمة مع حالة lifecycle ومصادر بيانات ومهارات وروابط run-card وملاحظات إبطال	Backend MVP شُحن
Research Autopilot	حلقة بحث يدوية أولاً: فرضية → اختبار رجعي حتمي → تقرير أدلة	التالي
Data Bridge	أحضر بياناتك: موصلات CSV/Parquet/SQL محلية مع schema mapping	مخطط
Options Lab	سطح تقلب، ولوحة Greeks، ومستكشف payoff/scenario	مخطط
Portfolio Studio	أشعة مخاطر، وقيود، ومحسن يراعي الدوران، وملاحظات إعادة توازن	مخطط
Alpha Zoo	452 ألفا كمّي جاهز عبر 4 zoos (Qlib 158 + Kakushadze 101 + GTJA 191 + FF5 + Carhart)، سطر أوامر واحد للـ bench، تكامل agent، وواجهة Web	تم الإطلاق 0.1.8
Research Delivery	موجزات مجدولة إلى Slack / Telegram / قنوات شبيهة بالبريد	مخطط
Community	مهارات وإعدادات مسبقة وبطاقات استراتيجية قابلة للمشاركة	قيد الاستكشاف

المساهمة

نرحب بالمساهمات! راجع CONTRIBUTING.md للإرشادات.

المشكلات الجيدة للمبتدئين موسومة بـ good first issue — اختر واحدة وابدأ.

هل تريد المساهمة بشيء أكبر؟ راجع خارطة الطريق أعلاه وافتح issue للنقاش قبل البدء.

المساهمون

شكراً لكل من ساهم في Vibe-Trading!

مساهمو واعتمادات دورة v0.1.8 الأخيرة:

@GTC2080 / TaoMu — Web UI Settings وواجهات إعداد provider/data-source (#57)
@BigNounce90 — تعزيز validation CLI لمدخل run_dir في الاختبار الرجعي (#60)
@shadowinlife — مهارة A-share pre-ST filter (#63)
@MB-Ndhlovu — لوحة خريطة الارتباط الحرارية وإصلاحات المراجعة (#64, #66)
@ykykj — خيار مزود OpenAI Codex OAuth (#65)
@RuifengFu — شريط حالة CLI التفاعلي وتحرير prompt (#69)
@SiMinus — أمر فحص swarm preset (#73)
@warren618 / Haozhe Wu — تعزيز الأمان، وتكامل الإصدار، والوثائق، وDocker، والتغليف، وسير التطوير المحلي
lemi9090 (S2W) — بحث أمني منسق، وتحقق، ودعم الإفصاح

إخلاء المسؤولية

Vibe-Trading مخصص للبحث والمحاكاة والاختبار الرجعي فقط. ليس نصيحة استثمارية ولا ينفذ صفقات حية. الأداء السابق لا يضمن النتائج المستقبلية.

الرخصة

رخصة MIT — راجع LICENSE

تاريخ النجوم

⭐ إذا ساعدك Vibe-Trading في بحثك، فإن منح نجمة يساعد المزيد على اكتشافه.

شكراً لزيارة Vibe-Trading ✨

FilesExpand file tree

README_ar.md

Latest commit

History