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

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

` لرفض غياب الوسيط، والمسار الفارغ، والمسار غير الصالح، والمسار غير الموجود، والمسار الذي ليس دليلاً برسائل واضحة قبل بدء التحقق ([#60](https://github.com/HKUDS/Vibe-Trading/pull/60)). - **2026-04-28** 🚀 **إصدار v0.1.6** (`pip install -U vibe-trading-ai`): إصلاح إرجاع `vibe-trading --swarm-presets` فارغًا بعد `pip install` / `uv tool install` ([#55](https://github.com/HKUDS/Vibe-Trading/issues/55)) — ملفات YAML للإعدادات المسبقة الآن مضمّنة داخل حزمة `src.swarm` ومثبّتة بـ 6 اختبارات انحدار. إضافة إلى ذلك، محمّل AKShare يوجّه الآن صناديق ETF (`510300.SH`) والعملات الأجنبية (`USDCNH`) إلى نقاط النهاية الصحيحة مع تعزيز سلسلة البديل. تجميع كل التحديثات منذ v0.1.5: لوحة مقارنة المرجع، تدفق `/upload` + حدود الحجم، محمّل Futu (HK + أسهم A)، مهارة تصدير vnpy، تصليب أمني، التحميل الكسول للواجهة (688KB → 262KB).

أخبار سابقة

- **2026-04-27** 📊 **لوحة مقارنة المرجع + أمان الرفع**: مخرجات الاختبار الخلفي تشمل الآن لوحة مقارنة مرجعية (الرمز / عائد المرجع / العائد الفائض / نسبة المعلومات) مع الحلّ عبر yfinance لـ SPY و CSI 300 وغيرها ([#48](https://github.com/HKUDS/Vibe-Trading/issues/48)). إضافة إلى ذلك، نقطة `/upload` تتدفق جسم الطلب في أجزاء 1 ميغابايت وتتوقف فور تجاوز `MAX_UPLOAD_SIZE` مع تنظيف الملف الجزئي، بما يجعل حد 50 ميغابايت فعالاً تحت الطلبات الخبيثة/الضخمة ([#53](https://github.com/HKUDS/Vibe-Trading/pull/53)) — مثبّت بـ 4 اختبارات انحدار. - **2026-04-22** 🛡️ **تصليب + تكاملات جديدة**: فرض احتواء المسار في `safe_path` + عزل أدوات سجل التداول/حساب الظل، إضافة `MANIFEST.in` لتضمين `.env.example` / الاختبارات / ملفات Docker في sdist، التحميل الكسول على مستوى المسار يقلّص حزمة الواجهة الأولية من 688KB إلى 262KB. إضافة محمّل بيانات Futu لأسهم هونغ كونغ وA ([#47](https://github.com/HKUDS/Vibe-Trading/pull/47)) ومهارة تصدير vnpy CtaTemplate ([#46](https://github.com/HKUDS/Vibe-Trading/pull/46)). - **2026-04-21** 🛡️ **مساحة العمل + الوثائق**: تطبيع `run_dir` النسبي إلى دليل التشغيل النشط ([#43](https://github.com/HKUDS/Vibe-Trading/pull/43)). إضافة أمثلة استخدام إلى README ([#45](https://github.com/HKUDS/Vibe-Trading/pull/45)). - **2026-04-20** 🔌 **نماذج التفكير + إصلاحات Swarm**: الحفاظ على `reasoning_content` عبر جميع مسارات تسلسل `ChatOpenAI` — يعمل Kimi / DeepSeek / Qwen thinking من البداية إلى النهاية ([#39](https://github.com/HKUDS/Vibe-Trading/issues/39)). تدفق Swarm + إيقاف نظيف بـ Ctrl+C ([#42](https://github.com/HKUDS/Vibe-Trading/issues/42)). - **2026-04-19** 📦 **v0.1.5**: تم النشر على PyPI وClawHub. رفع حد `python-multipart` لسد ثغرة CVE، ربط 5 أدوات MCP جديدة (`analyze_trade_journal` + 4 أدوات حساب الظل)، إصلاح عدم تطابق اسم السجل `pattern_recognition` → `pattern`، مزامنة تبعيات Docker، مزامنة بيان SKILL (22 أداة MCP / 71 مهارة). - **2026-04-18** 👥 **حساب الظل Shadow Account**: استخرج قواعد إستراتيجيتك من سجل التداول الخاص بك → اختبر الظل عبر الأسواق → تقرير HTML/PDF من 8 أقسام يوضح بدقة أين فقدت المال (خرق القواعد، الخروج المبكر، الإشارات المفقودة، الصفقات العكسية). 4 أدوات جديدة، مهارة واحدة جديدة، إجمالي 32 أداة. أمثلة Trade Journal / Shadow Account متاحة الآن في شاشة الترحيب على واجهة الويب. - **2026-04-17** 📊 **محلل سجل التداول + قارئ ملفات عالمي**: حمّل سجلات التداول من الوسطاء (同花顺/东财/富途/CSV عام) → ملف تعريف تداول تلقائي (أيام الاحتفاظ، معدل الفوز، نسبة الربح/الخسارة، أقصى تراجع) + تشخيص 4 تحيزات سلوكية (تأثير التصرف، الإفراط في التداول، مطاردة الزخم، التثبيت السعري). `read_document` يوزّع الآن PDF وWord وExcel وPowerPoint والصور (OCR) و40+ صيغة نصية خلف استدعاء موحد. - **2026-04-16** 🧠 **هيكل الوكيل**: ذاكرة دائمة عبر الجلسات، بحث جلسات FTS5، مهارات ذاتية التطور (CRUD كامل)، ضغط سياق 5 طبقات، معالجة أدوات القراءة/الكتابة دفعة واحدة. 27 أداة، 107 اختبار جديد. - **2026-04-15** 🤖 **Z.ai + MiniMax**: إضافة مزود Z.ai ([#35](https://github.com/HKUDS/Vibe-Trading/pull/35))، إصلاح temperature وتحديث نموذج MiniMax ([#33](https://github.com/HKUDS/Vibe-Trading/pull/33)). 13 مزوداً. - **2026-04-14** 🔧 **استقرار MCP**: إصلاح خطأ `Connection closed` في أداة الاختبار الرجعي عبر نقل stdio ([#32](https://github.com/HKUDS/Vibe-Trading/pull/32)). - **2026-04-13** 🌐 **الاختبار الرجعي المركب عبر الأسواق**: محرك `CompositeEngine` الجديد لاختبار محافظ متعددة الأسواق (مثل أسهم A + العملات المشفرة) بمجمع رأسمال مشترك. إصلاح متغيرات قوالب Swarm ومهلة الواجهة الأمامية. - **2026-04-12** 🌍 **تصدير متعدد المنصات**: أمر `/pine` يصدّر إلى TradingView (Pine Script v6) وTDX (通达信/同花顺/东方财富) وMetaTrader 5 (MQL5) دفعة واحدة. - **2026-04-11** 🛡️ **الموثوقية وDX**: إعداد `.env` عبر `vibe-trading init` ([#19](https://github.com/HKUDS/Vibe-Trading/pull/19))، فحوصات مسبقة، بديل تلقائي لمصادر البيانات، تعزيز محرك الاختبار الرجعي. README متعدد اللغات ([#21](https://github.com/HKUDS/Vibe-Trading/pull/21)). - **2026-04-10** 📦 **v0.1.4**: إصلاح Docker ([#8](https://github.com/HKUDS/Vibe-Trading/issues/8))، أداة MCP `web_search`، 12 مزود LLM، تبعيات `akshare`/`ccxt`. النشر على PyPI وClawHub. - **2026-04-09** 📊 **الموجة الثانية من الاختبار الرجعي**: محركات ChinaFutures وGlobalFutures وForex وOptions v2. تحقق مونت كارلو وBootstrap CI وWalk-Forward. - **2026-04-08** 🔧 **اختبار رجعي متعدد الأسواق**: قواعد خاصة بكل سوق، تصدير Pine Script v6، 5 مصادر بيانات مع بديل تلقائي.

--- ## 💡 ما هو Vibe-Trading؟ Vibe-Trading هو مساحة عمل مالية متعددة الوكلاء مدعومة بالذكاء الاصطناعي تحول الطلبات بلغة طبيعية إلى استراتيجيات تداول قابلة للتنفيذ ورؤى بحثية وتحليل محافظ عبر الأسواق العالمية. ### القدرات الرئيسية: • **لغة طبيعية → استراتيجية** — صِف فكرتك؛ الوكيل يكتب الكود ويختبره ويصدّره
• **6 مصادر بيانات، بدون إعداد** — أسهم A، HK/US، العملات المشفرة، العقود الآجلة، الفوركس مع بديل تلقائي
• **29 فريق خبراء** — سير عمل سرب متعدد الوكلاء للاستثمار والتداول وإدارة المخاطر
• **ذاكرة عبر الجلسات** — يتذكر التفضيلات والرؤى؛ ينشئ ويطور المهارات القابلة لإعادة الاستخدام
• **7 محركات اختبار رجعي** — اختبار مركب عبر الأسواق + تحقق إحصائي + 4 محسّنات
• **تصدير متعدد المنصات** — نقرة واحدة إلى TradingView وTDX وMetaTrader 5 --- ## ✨ الميزات الرئيسية

🔍 بحث عميق للتداول

• 72 مهارة متخصصة مع ذاكرة دائمة عبر الجلسات
• تطور ذاتي: الوكيل ينشئ ويحسّن سير العمل من التجربة
• ضغط سياق 5 طبقات — بلا فقدان معلومات في المحادثات الطويلة
• توجيه المهام بلغة طبيعية عبر جميع المجالات المالية

🐝 ذكاء السرب

• 29 إعداد مسبق لفرق التداول الجاهزة
• تنسيق متعدد الوكلاء قائم على DAG
• لوحة معلومات بث مباشر مع حالة الوكلاء الحية
• بحث FTS5 عبر الجلسات في جميع المحادثات السابقة

📊 اختبار رجعي عبر الأسواق

• أسهم A، أسهم HK/US، العملات المشفرة، العقود الآجلة والفوركس
• 7 محركات سوق: أسهم A، أسهم US/HK، العملات المشفرة، العقود الآجلة الصينية، العقود الآجلة العالمية، الفوركس
• التحقق الإحصائي: مونت كارلو، Bootstrap CI، المشي للأمام
• 15+ مقياس أداء و4 محسّنات

🧮 أدوات التحليل الكمي

• تحليل العامل IC/IR والاختبار الرجعي للشرائح
• تسعير Black-Scholes وحساب كامل للمتغيرات اليونانية
• التعرف على الأنماط الفنية واكتشافها
• تحسين المحافظ عبر MVO/Risk Parity/BL

## 72 مهارة عبر 7 فئات - 📊 72 مهارة مالية متخصصة منظمة في 7 فئات - 🌐 تغطية شاملة من الأسواق التقليدية إلى العملات المشفرة وDeFi - 🔬 قدرات شاملة تمتد من مصادر البيانات إلى البحث الكمي | الفئة | المهارات | أمثلة | |----------|--------|----------| | مصدر البيانات | 6 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `ccxt` | | الاستراتيجية | 17 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` | | التحليل | 15 | `factor-research`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis` | | فئة الأصول | 9 | `options-strategy`, `options-advanced`, `convertible-bond`, `etf-analysis`, `asset-allocation`, `sector-rotation` | | العملات المشفرة | 7 | `perp-funding-basis`, `liquidation-heatmap`, `stablecoin-flow`, `defi-yield`, `onchain-analysis` | | التدفقات | 7 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` | | الأدوات | 8 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader` | ## 29 إعداد مسبق لفرق وكلاء السرب - 🏢 29 فرق وكلاء جاهزة للاستخدام - ⚡ سير عمل مالية مُعدة مسبقاً - 🎯 إعدادات مسبقة للاستثمار والتداول وإدارة المخاطر | الإعداد المسبق | سير العمل | |--------|----------| | `investment_committee` | مناظرة صعود/هبوط ← مراجعة مخاطر ← قرار مدير المحفظة النهائي | | `global_equities_desk` | باحث أسهم A + HK/US + العملات المشفرة ← استراتيجي عالمي | | `crypto_trading_desk` | التمويل/الأساس + التصفية + التدفق ← مدير مخاطر | | `earnings_research_desk` | أساسي + مراجعة + خيارات ← استراتيجي الأرباح | | `macro_rates_fx_desk` | أسعار الفائدة + الفوركس + السلع ← مدير محفظة كلية | | `quant_strategy_desk` | فرز + بحث العوامل ← اختبار رجعي ← تدقيق مخاطر | | `technical_analysis_panel` | TA كلاسيكي + إيشيموكو + هارمونيك + إليوت + SMC ← إجماع | | `risk_committee` | السحب + مخاطر الذيل + مراجعة النظام ← موافقة | | `global_allocation_committee` | أسهم A + عملات مشفرة + HK/US ← تخصيص عبر الأسواق | _{بالإضافة إلى 20+ إعداد مسبق متخصص إضافي — شغّل vibe-trading --swarm-presets لاستكشافها جميعاً.} ### 🎬 عرض توضيحي

https://github.com/user-attachments/assets/4e4dcb80-7358-4b9a-92f0-1e29612e6e86	https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30
_{☝️ اختبار رجعي بلغة طبيعية ومناظرة سرب متعدد الوكلاء — واجهة ويب + CLI}

--- ## 🚀 البدء السريع ### تثبيت بسطر واحد (PyPI) ```bash pip install vibe-trading-ai ``` > **اسم الحزمة مقابل الأوامر:** حزمة PyPI هي `vibe-trading-ai`. بعد التثبيت، ستحصل على ثلاثة أوامر: > > | الأمر | الغرض | > |---------|---------| > | `vibe-trading` | CLI تفاعلي / TUI | > | `vibe-trading serve` | تشغيل خادم ويب FastAPI | > | `vibe-trading-mcp` | بدء خادم MCP (لـ Claude Desktop, OpenClaw, Cursor, إلخ) | ```bash vibe-trading init # إعداد تفاعلي لملف .env vibe-trading # تشغيل CLI vibe-trading serve --port 8899 # تشغيل واجهة الويب vibe-trading-mcp # بدء خادم MCP (stdio) ``` ### أو اختر مساراً | المسار | الأنسب لـ | الوقت | |------|----------|------| | **A. Docker** | تجربته الآن، بدون إعداد محلي | دقيقتان | | **B. تثبيت محلي** | التطوير، وصول كامل لـ CLI | 5 دقائق | | **C. إضافة MCP** | ربطه بوكيلك الحالي | 3 دقائق | | **D. ClawHub** | أمر واحد، بدون استنساخ | دقيقة واحدة | ### المتطلبات المسبقة - **مفتاح API لنموذج لغة** من أي مزود مدعوم — أو التشغيل محلياً مع **Ollama** (بدون مفتاح) - **Python 3.11+** للمسار B - **Docker** للمسار A > **مزودو نماذج اللغة المدعومون:** OpenRouter, OpenAI, DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, Xiaomi MIMO, Z.ai, Ollama (محلي). راجع `.env.example` للإعدادات. > **نصيحة:** جميع الأسواق تعمل بدون أي مفاتيح API بفضل البديل التلقائي. yfinance (HK/US) و OKX (العملات المشفرة) و AKShare (أسهم A، US، HK، العقود الآجلة، الفوركس) جميعها مجانية. رمز Tushare اختياري — AKShare يغطي أسهم A كبديل مجاني. ### المسار A: Docker (بدون إعداد) ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading cp agent/.env.example agent/.env # عدّل agent/.env — أزل التعليق عن مزود نموذج اللغة وحدد مفتاح API docker compose up --build ``` افتح `http://localhost:8899`. الخلفية + الواجهة الأمامية في حاوية واحدة. ### المسار B: التثبيت المحلي ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading python -m venv .venv # التفعيل source .venv/bin/activate # Linux / macOS # .venv\Scripts\Activate.ps1 # Windows PowerShell pip install -e . cp agent/.env.example agent/.env # عدّل — حدد مفتاح API لمزود نموذج اللغة vibe-trading # تشغيل TUI التفاعلي ```

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

```bash # الطرفية 1: خادم API vibe-trading serve --port 8899 # الطرفية 2: خادم تطوير الواجهة الأمامية cd frontend && npm install && npm run dev ``` افتح `http://localhost:5899`. تعيد الواجهة الأمامية توجيه استدعاءات API إلى `localhost:8899`. **وضع الإنتاج (خادم واحد):** ```bash cd frontend && npm run build && cd .. vibe-trading serve --port 8899 # يخدم FastAPI مجلد dist/ كملفات ثابتة ```

### المسار C: إضافة MCP راجع قسم [إضافة MCP](#-إضافة-mcp) أدناه. ### المسار D: ClawHub (أمر واحد) ```bash npx clawhub@latest install vibe-trading --force ``` يتم تنزيل المهارة + إعدادات MCP إلى مجلد مهارات وكيلك. راجع [تثبيت ClawHub](#-إضافة-mcp) للتفاصيل. --- ## 🧠 متغيرات البيئة انسخ `agent/.env.example` إلى `agent/.env` وأزل التعليق عن كتلة المزود التي تريدها. كل مزود يحتاج إلى 3-4 متغيرات: | المتغير | مطلوب | الوصف | |----------|:--------:|-------------| | `LANGCHAIN_PROVIDER` | نعم | اسم المزود (`openrouter`, `deepseek`, `groq`, `z.ai`, `ollama`, إلخ) | | `_API_KEY` | نعم* | مفتاح API (`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY`, إلخ) | | `_BASE_URL` | نعم | رابط نقطة نهاية API | | `LANGCHAIN_MODEL_NAME` | نعم | اسم النموذج (مثلاً `deepseek/deepseek-v3.2`) | | `TUSHARE_TOKEN` | لا | رمز Tushare Pro لبيانات أسهم A (بديل AKShare) | | `TIMEOUT_SECONDS` | لا | مهلة استدعاء نموذج اللغة، الافتراضي 120 ثانية | _{* Ollama لا يتطلب مفتاح API.} **بيانات مجانية (بدون مفتاح):** أسهم A عبر AKShare، أسهم HK/US عبر yfinance، العملات المشفرة عبر OKX، 100+ بورصة عملات مشفرة عبر CCXT. يختار النظام تلقائياً أفضل مصدر متاح لكل سوق. ### 🎯 النماذج الموصى بها Vibe-Trading وكيل يعتمد بكثافة على استدعاءات الأدوات — المهارات والاختبار الخلفي والذاكرة و swarm كلها تعمل عبر tool calls. اختيار النموذج يحدد مباشرة ما إذا كان الوكيل **يستخدم أدواته فعلاً** أو يلفّق الإجابات من بيانات التدريب. | المستوى | أمثلة | متى يُستخدم | |---------|-------|-------------| | **الأفضل** | `anthropic/claude-opus-4.7`، `anthropic/claude-sonnet-4.6`، `openai/gpt-5.4`، `google/gemini-3.1-pro-preview` | swarm معقد (3+ وكلاء)، جلسات بحث طويلة، تحليل بمستوى ورقة علمية | | **نقطة مثلى** (افتراضي) | `deepseek/deepseek-v3.2`، `x-ai/grok-4.20`، `z-ai/glm-5.1`، `moonshotai/kimi-k2.5`، `qwen/qwen3-max-thinking` | الاستخدام اليومي — tool-calling موثوق بحوالي 1/10 من التكلفة | | **تجنّب كوكيل** | `*-nano`، `*-flash-lite`، `*-coder-next`، إصدارات صغيرة / مُقطّرة | tool-calling غير موثوق — سيبدو الوكيل وكأنه "يجيب من الذاكرة" بدلاً من تحميل المهارات أو تشغيل الاختبار الخلفي | يأتي `agent/.env.example` الافتراضي مع `deepseek/deepseek-v3.2` — الخيار الأرخص في مستوى النقطة المثلى. --- ## 🖥 مرجع سطر الأوامر ```bash vibe-trading # TUI تفاعلي vibe-trading run -p "..." # تشغيل واحد vibe-trading serve # خادم API ```

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

| الأمر | الوصف | |---------|-------------| | `/help` | عرض جميع الأوامر | | `/skills` | عرض جميع مهارات التداول الـ 72 | | `/swarm` | عرض إعدادات فرق السرب الـ 29 | | `/swarm run [vars_json]` | تشغيل فريق سرب مع بث مباشر | | `/swarm list` | سجل تشغيلات السرب | | `/swarm show ` | تفاصيل تشغيل السرب | | `/swarm cancel ` | إلغاء سرب قيد التشغيل | | `/list` | التشغيلات الأخيرة | | `/show ` | تفاصيل التشغيل + المقاييس | | `/code ` | كود الاستراتيجية المولّدة | | `/pine ` | Pine Script لـ TradingView | | `/trace ` | إعادة تشغيل التنفيذ الكاملة | | `/continue ` | متابعة تشغيل بتعليمات جديدة | | `/sessions` | عرض جلسات الدردشة | | `/settings` | عرض إعدادات التشغيل | | `/clear` | مسح الشاشة | | `/quit` | الخروج |

التشغيل الفردي والعلامات

```bash vibe-trading run -p "اختبر استراتيجية BTC-USDT MACD رجعياً، آخر 30 يوماً" vibe-trading run -p "حلل زخم AAPL" --json vibe-trading run -f strategy.txt echo "اختبر 000001.SZ RSI رجعياً" | vibe-trading run ``` ```bash vibe-trading -p "طلبك" vibe-trading --skills vibe-trading --swarm-presets vibe-trading --swarm-run investment_committee '{"topic":"توقعات BTC"}' vibe-trading --list vibe-trading --show vibe-trading --code vibe-trading --pine # Pine Script لـ TradingView vibe-trading --trace vibe-trading --continue "حسّن الاستراتيجية" vibe-trading --upload report.pdf ```

--- ## 🌐 خادم API ```bash vibe-trading serve --port 8899 ``` | الطريقة | نقطة النهاية | الوصف | |--------|----------|-------------| | `GET` | `/runs` | عرض التشغيلات | | `GET` | `/runs/{run_id}` | تفاصيل التشغيل | | `GET` | `/runs/{run_id}/pine` | تصدير Pine Script | | `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` | `/settings/llm` | قراءة إعدادات LLM في واجهة الويب | | `PUT` | `/settings/llm` | تحديث إعدادات LLM المحلية | | `GET` | `/settings/data-sources` | قراءة إعدادات مصادر البيانات المحلية | | `PUT` | `/settings/data-sources` | تحديث إعدادات مصادر البيانات المحلية | توثيق تفاعلي: `http://localhost:8899/docs` ### إعدادات Web UI تتيح صفحة Settings في واجهة الويب للمستخدمين المحليين تحديث LLM provider/model و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 يقدم Vibe-Trading 22 أداة MCP لأي عميل متوافق مع MCP. يعمل كعملية فرعية stdio — بدون إعداد خادم. **21 من 22 أداة تعمل بدون مفاتيح API** (HK/US/العملات المشفرة). فقط `run_swarm` يحتاج إلى مفتاح نموذج لغة.

Claude Desktop

أضف إلى `claude_desktop_config.json`: ```json { "mcpServers": { "vibe-trading": { "command": "vibe-trading-mcp" } } } ```

OpenClaw

أضف إلى `~/.openclaw/config.yaml`: ```yaml skills: - name: vibe-trading command: vibe-trading-mcp ```

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

```bash vibe-trading-mcp # stdio (الافتراضي) vibe-trading-mcp --transport sse # SSE لعملاء الويب ```

**أدوات 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 (أمر واحد)

```bash npx clawhub@latest install vibe-trading --force ``` > `--force` مطلوب لأن المهارة تشير إلى واجهات برمجية خارجية، مما يؤدي إلى فحص تلقائي من VirusTotal. الكود مفتوح المصدر بالكامل وآمن للفحص. هذا ينزّل المهارة + إعدادات MCP إلى مجلد مهارات وكيلك. بدون الحاجة للاستنساخ. تصفح على ClawHub: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading)

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

جميع مهارات التداول الـ 72 منشورة على [open-space.cloud](https://open-space.cloud) وتتطور بشكل مستقل عبر محرك التطور الذاتي من OpenSpace. للاستخدام مع OpenSpace، أضف خادمي MCP إلى إعدادات وكيلك: ```json { "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 تلقائياً جميع المهارات الـ 72، مما يتيح الإصلاح التلقائي والتحسين التلقائي والمشاركة المجتمعية. ابحث عن مهارات Vibe-Trading عبر `search_skills("finance backtest")` في أي وكيل متصل بـ OpenSpace.

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

انقر للتوسيع

``` Vibe-Trading/ ├── agent/ # الخلفية (Python) │ ├── cli.py # نقطة دخول CLI — TUI تفاعلي + أوامر فرعية │ ├── api_server.py # خادم FastAPI — تشغيلات، جلسات، رفع، سرب، SSE │ ├── mcp_server.py # خادم MCP — 22 أداة لـ OpenClaw / Claude Desktop │ │ │ ├── src/ │ │ ├── agent/ # نواة وكيل ReAct │ │ │ ├── loop.py # ضغط 5 طبقات + معالجة أدوات القراءة/الكتابة دفعة واحدة │ │ │ ├── context.py # موجه النظام + استرجاع تلقائي من الذاكرة الدائمة │ │ │ ├── skills.py # محمل المهارات (72 مدمجة + إنشاء CRUD من المستخدم) │ │ │ ├── tools.py # فئة الأدوات الأساسية + السجل │ │ │ ├── memory.py # حالة مساحة عمل خفيفة لكل تشغيل │ │ │ ├── frontmatter.py # محلل YAML frontmatter مشترك │ │ │ └── trace.py # كاتب أثر التنفيذ │ │ │ │ │ ├── memory/ # ذاكرة دائمة عبر الجلسات │ │ │ └── persistent.py # ذاكرة قائمة على الملفات (~/.vibe-trading/memory/) │ │ │ │ │ ├── tools/ # 27 أداة وكيل مكتشفة تلقائياً │ │ │ ├── backtest_tool.py # تشغيل الاختبارات الرجعية │ │ │ ├── remember_tool.py # ذاكرة عبر الجلسات (حفظ/استرجاع/نسيان) │ │ │ ├── skill_writer_tool.py # CRUD للمهارات (حفظ/تصحيح/حذف/ملف) │ │ │ ├── session_search_tool.py # بحث FTS5 عبر الجلسات │ │ │ ├── swarm_tool.py # إطلاق فرق السرب │ │ │ ├── web_search_tool.py # بحث ويب DuckDuckGo │ │ │ └── ... # bash، إدخال/إخراج ملف، تحليل العوامل، الخيارات، إلخ │ │ │ │ │ ├── skills/ # 72 مهارة مالية في 7 فئات (SKILL.md لكل منها) │ │ ├── swarm/ # محرك تنفيذ DAG للسرب │ │ │ └── presets/ # 29 تعريف YAML للإعدادات المسبقة للسرب │ │ ├── session/ # دردشة متعددة الأدوار + بحث FTS5 عبر الجلسات │ │ └── providers/ # تجريد مزود نموذج اللغة │ │ │ └── backtest/ # محركات الاختبار الرجعي │ ├── engines/ # 7 محركات + محرك مركب عبر الأسواق + options_portfolio │ ├── loaders/ # 6 مصادر: tushare, okx, yfinance, akshare, ccxt, futu │ │ ├── base.py # بروتوكول DataLoader │ │ └── registry.py # السجل + سلاسل البديل التلقائي │ └── optimizers/ # MVO، تساوي التقلب، أقصى تنويع، تكافؤ المخاطر │ ├── frontend/ # واجهة الويب (React 19 + Vite + TypeScript) │ └── src/ │ ├── pages/ # الرئيسية، الوكيل، تفاصيل التشغيل، المقارنة │ ├── components/ # دردشة، رسوم بيانية، تخطيط │ └── stores/ # إدارة حالة Zustand │ ├── Dockerfile # بناء متعدد المراحل ├── docker-compose.yml # نشر بأمر واحد ├── pyproject.toml # إعدادات الحزمة + نقطة دخول CLI └── LICENSE # MIT ```

--- ## 🏛 النظام البيئي Vibe-Trading هو جزء من النظام البيئي للوكلاء **[HKUDS](https://github.com/HKUDS)**:

ClawTeam
_{ذكاء سرب الوكلاء}

NanoBot
_{مساعد ذكاء اصطناعي شخصي فائق الخفة}

CLI-Anything
_{جعل جميع البرامج أصلية للوكلاء}

OpenSpace
_{مهارات وكلاء ذكاء اصطناعي ذاتية التطور}

--- ## 🗺 خارطة الطريق > نشحن على مراحل. تنتقل العناصر إلى [المشكلات](https://github.com/HKUDS/Vibe-Trading/issues) عند بدء العمل. | المرحلة | الميزة | الحالة | |-------|---------|--------| | **هيكل الوكيل** | ذاكرة دائمة عبر الجلسات (حفظ / استرجاع / نسيان) | **تم** | | | مهارات ذاتية التطور — الوكيل ينشئ ويعدل ويحذف سير العمل بنفسه | **تم** | | | بحث FTS5 عبر الجلسات في جميع المحادثات السابقة | **تم** | | | ضغط سياق 5 طبقات (micro → collapse → auto → manual → iterative) | **تم** | | | معالجة أدوات القراءة/الكتابة دفعة واحدة — تنفيذ موازٍ للأدوات للقراءة فقط | **تم** | | **التالي** | حلقة بحث مستقلة — الوكيل يكرر الفرضيات طوال الليل | قيد التنفيذ | | | تكامل المراسلة (Slack / Telegram / WeChat) | مخطط | | **التحليل والتصور** | سطح التقلب للخيارات والمتغيرات اليونانية مع تصور ثلاثي الأبعاد | مخطط | | | خريطة حرارة الارتباط عبر الأصول مع نافذة متدحرجة وتجميع | مخطط | | | مقارنة المعيار في مخرجات الاختبار الرجعي لـ CLI | مخطط | | **المهارات والإعدادات المسبقة** | مهارة تحليل الأرباح | مخطط | | | إعداد سرب مسبق للاستثمار المستدام / ESG | مخطط | | **المحافظ والتحسين** | محسّن محافظ متقدم: الرافعة المالية، حدود القطاعات، قيود التداول | مخطط | | **المستقبل** | سوق الاستراتيجيات (مشاركة واكتشاف) | قيد الاستكشاف | | | بث بيانات مباشر عبر WebSocket | قيد الاستكشاف | --- ## المساهمة نرحب بالمساهمات! راجع [CONTRIBUTING.md](CONTRIBUTING.md) للإرشادات. **المشكلات الجيدة للمبتدئين** محددة بعلامة [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) — اختر واحدة وابدأ. ترغب في المساهمة بشيء أكبر؟ راجع [خارطة الطريق](#-خارطة-الطريق) أعلاه وافتح مشكلة للمناقشة قبل البدء. --- ## المساهمون شكراً لكل من ساهم في Vibe-Trading!

--- ## إخلاء المسؤولية Vibe-Trading مخصص للبحث والمحاكاة والاختبار الرجعي فقط. وهو ليس نصيحة استثمارية ولا ينفذ صفقات حية. الأداء السابق لا يضمن النتائج المستقبلية. ## الرخصة رخصة MIT — راجع [LICENSE](LICENSE) --- ## تاريخ النجوم [![Star History Chart](https://api.star-history.com/svg?repos=HKUDS/Vibe-Trading&type=Date)](https://star-history.com/#HKUDS/Vibe-Trading&Date) ---

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