diff --git a/README.md b/README.md index b006cf7f..b02222d6 100644 --- a/README.md +++ b/README.md @@ -87,10 +87,11 @@ ## ✨ Key Features - +
+
- Self-improving trading agent
+ Self-improving trading agent

🔍 Self-Improving Trading Agent

• Natural-language market research
@@ -99,7 +100,7 @@
- Multi-agent trading teams
+ Multi-agent trading teams

🐝 Multi-Agent Trading Teams

• Investment, quant, crypto, and risk teams
@@ -110,7 +111,7 @@
- Cross-market data and backtesting
+ Cross-market data and backtesting

📊 Cross-Market Data & Backtesting

• A/HK/US equities, crypto, futures, and forex
@@ -119,8 +120,8 @@
- Trade journal and strategy audit
-

👥 Trade Journal & Strategy Audit

+ Shadow Account
+

👥 Shadow Account

• Broker-journal behavior diagnostics
• Rule-based Shadow Account comparisons
@@ -129,6 +130,7 @@
+ ## 💡 What Is Vibe-Trading? diff --git a/README_ar.md b/README_ar.md index 18db6afc..6b5c1799 100644 --- a/README_ar.md +++ b/README_ar.md @@ -9,7 +9,7 @@

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

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

@@ -17,12 +17,7 @@ FastAPI React PyPI - الرخصة -
- المهارات - السرب - الأدوات - مصادر البيانات + License
Feishu WeChat @@ -30,17 +25,15 @@

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

@@ -49,154 +42,216 @@ --- -## 📰 أحدث الأخبار +## 📰 الأخبار -- **2026-05-14** 🧠 **واجهة CLI للذاكرة الدائمة**: تمت إضافة `vibe-trading memory list/show/search/forget` حتى يستطيع المستخدمون فحص الذاكرة الدائمة والبحث فيها وتنظيفها دون فتح `~/.vibe-trading/memory/` يدوياً. يحافظ التنفيذ على سرعة بدء أوامر CLI غير المتعلقة بالذاكرة عبر lazy imports، ويعزز فحص memory frontmatter بتحويل قيم metadata المفسّرة إلى strings قبل Rich rendering أو recall scoring ([#102](https://github.com/HKUDS/Vibe-Trading/pull/102)، شكراً @Teerapat-Vatpitak). -- **2026-05-13** 🧭 **Swarm grounding بأسعار حقيقية + تنظيف worker events**: أصبحت Swarm runs تجلب بيانات السوق مسبقاً قبل بدء المحللين وتؤسس worker prompts على أسعار حقيقية، مع توحيد lookup للرموز عبر `_detect_market(code)` وتقوية تمرير grounding payload بين الخيوط بأمان ([#93](https://github.com/HKUDS/Vibe-Trading/pull/93)). كما تُحفظ worker reports الآن داخل مسارات swarm-run المسموح بها، مع استخراج أفضل لملخص `report.md`، وزيادة timeouts للإعدادات المسبقة، وتنقيح/تعقيم event previews لجعل streaming updates أنظف ([#84](https://github.com/HKUDS/Vibe-Trading/pull/84)). -- **2026-05-12** 🧾 **Trust Layer run cards**: أصبحت الاختبارات الخلفية تنشئ الآن `run_card.json` و`run_card.md` قابلين لإعادة الإنتاج بجانب artifacts، مع تسجيل hashes للإعدادات وكود الاستراتيجية، ومصادر البيانات، والمقاييس scalar، ونتائج validation، والتحذيرات، وchecksums للـ artifacts. كما يعيد Backtest tool مسارات run-card حتى تستطيع CLI/API عرض حزمة الأدلة مباشرة. +- **2026-05-14** 🧠 أصبحت الذاكرة الدائمة قابلة للفحص من سطر الأوامر عبر `vibe-trading memory list/show/search/forget` ([#102](https://github.com/HKUDS/Vibe-Trading/pull/102)، شكراً @Teerapat-Vatpitak). +- **2026-05-13** 🧭 أصبحت تشغيلات السرب تؤسس عمل الوكلاء على بيانات سوق مجلوبة مسبقاً، مع تقارير محفوظة أنظف ([#93](https://github.com/HKUDS/Vibe-Trading/pull/93)، [#84](https://github.com/HKUDS/Vibe-Trading/pull/84)). +- **2026-05-12** 🧾 أصبحت الاختبارات الرجعية تنتج `run_card.json` و`run_card.md` إلى جانب المخرجات لدعم تشغيلات بحثية قابلة لإعادة الإنتاج.

أخبار سابقة -- **2026-05-11** 🧭 **Memory slugs وswarm accounting وCLI preflight**: يحافظ توليد slugs لملفات الذاكرة الدائمة الآن على أحرف CJK، ما يمنع اصطدامات أسماء الملفات الصامتة لملاحظات الصينية/اليابانية/الكورية ([#95](https://github.com/HKUDS/Vibe-Trading/pull/95)، شكراً @voidborne-d). تستخدم مجاميع Swarm run الآن token usage المبلّغ من provider أولاً مع الإبقاء على fallback التقديري الحالي ([#94](https://github.com/HKUDS/Vibe-Trading/pull/94)، شكراً @Teerapat-Vatpitak)، كما حصلت واجهة CLI run على فحص preflight عند البدء لاكتشاف مشكلات البيئة الشائعة مبكراً ([#96](https://github.com/HKUDS/Vibe-Trading/pull/96)، شكراً @ykykj). -- **2026-05-10** 🧱 **حواجز انحدار + بيانات run الوصفية**: أصبح Memory recall يتعامل مع الشرطات السفلية كحدود token، لذلك تطابق الذكريات المحفوظة بصيغة snake_case مثل `mcp_wiring_test` استعلامات اللغة الطبيعية مثل "mcp wiring" ([#87](https://github.com/HKUDS/Vibe-Trading/pull/87)، شكراً @hp083625). تمت إضافة اختبار smoke للـ MCP server عبر subprocess يغطي initialize → `tools/list` → `tools/call` لحماية مسار deadlock في أول استدعاء ([#86](https://github.com/HKUDS/Vibe-Trading/pull/86)). كما دخلت تحسينات منخفضة المخاطر لتوافق اختبارات مسارات Windows، وتضييق معالجة استثناءات API best-effort، والتحقق من allowed roots لمسار backtest `run_dir`، وبيانات provider/model الوصفية في SwarmRun ([#88](https://github.com/HKUDS/Vibe-Trading/pull/88)، [#90](https://github.com/HKUDS/Vibe-Trading/pull/90)، [#91](https://github.com/HKUDS/Vibe-Trading/pull/91)، [#92](https://github.com/HKUDS/Vibe-Trading/pull/92)، شكراً @Teerapat-Vatpitak). -- **2026-05-09** 🛡️ **تعزيز مسارات API + استقرار MCP server**: تتحقق مسارات run/session في API الآن من معرفات المسار قبل البحث، وترفض المعاملات المشوهة التي تحتوي على أسطر جديدة، مع تثبيت السلوك في اختبارات الانحدار auth/security ([#80](https://github.com/HKUDS/Vibe-Trading/pull/80)، شكراً @SJoon99). يقوم MCP server الآن بتسخين سجل الأدوات مسبقاً على الخيط الرئيسي قبل خدمة `tools/call`، لتجنب deadlock في أول استدعاء أثناء lazy tool discovery ([#85](https://github.com/HKUDS/Vibe-Trading/pull/85)، شكراً @Teerapat-Vatpitak). كما يحترم Vite dev proxy المتغير `VITE_API_URL` للأهداف الخلفية غير الافتراضية ([#82](https://github.com/HKUDS/Vibe-Trading/pull/82)، شكراً @voidborne-d). -- **2026-05-08** 🧾 **حقول القوائم المالية من Tushare داخل المرشحات**: يمكن لاختبارات A-share اليومية الآن طلب حقول قوائم مالية آمنة زمنياً عبر `fundamental_fields`، بحيث تستطيع SignalEngine الفرز باستخدام أعمدة مثل `income_total_revenue` و`income_n_income` و`balancesheet_total_hldr_eqy_exc_min_int` و`fina_indicator_roe` بعد تواريخ الإعلان/الإفصاح ([#76](https://github.com/HKUDS/Vibe-Trading/pull/76)، شكراً @mrbob-git). ويجعل التعزيز اللاحق طلبات حقول القوائم المالية الصريحة تفشل فوراً إذا تعذر تشغيل Tushare enrichment، بدلاً من الرجوع بصمت إلى بيانات الأسعار فقط ([#77](https://github.com/HKUDS/Vibe-Trading/pull/77)). -- **2026-05-07** 📈 **أساسيات Tushare + فرز المجتمع**: تمت إضافة عقد `TushareFundamentalProvider` بنمط point-in-time لتدفقات البحث الأساسي، مع تغطية انحدار لمسار متغير البيئة `TUSHARE_TOKEN` في المشروع ([#74](https://github.com/HKUDS/Vibe-Trading/pull/74)). كما أوضح فرز المجتمع أن Vibe-Trading يركز حالياً على لغة واجهة واحدة لتسريع التكرار، ولا يضيف تبعيات بحث مكررة ما دام `web_search` المبني على DuckDuckGo مضمناً بالفعل، ويتعامل مع عمليات النشر المستضافة غير الرسمية كأماكن غير موثوقة لإدخال API keys أو data-source tokens. -- **2026-05-06** 🚀 **إصدار v0.1.7** ([Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7)، `pip install -U vibe-trading-ai`): تم نشر إصدار تعزيز الحدود الأمنية على PyPI وClawHub، مع افتراضات أكثر أماناً لـ API/القراءة/الرفع/الملفات/URL/الكود المولّد/أدوات shell/Docker مع الحفاظ على تدفقات CLI وWeb UI المحلية منخفضة الاحتكاك. يتضمن هذا الإصدار أيضاً Web UI Settings، وخريطة الارتباط الحرارية، وOpenAI Codex OAuth، ومرشح pre-ST لأسهم A، وتحسين تجربة CLI التفاعلية، وفحص swarm presets، وتحليل التوزيعات، وتحسين سير التطوير، ورفع حدود أمان تبعيات بناء الواجهة. شكراً لمساهمي 0.1.7 ولـ lemi9090 (S2W) على التحقق الأمني المنسق. -- **2026-05-05** 🛡️ **متابعة لتعزيز الحدود الأمنية**: يستكمل تعزيز الحدود الأمنية حول origins الصريحة في CORS، ومؤشرات بيانات الاعتماد في Settings، وقراءة عناوين URL على الويب، وتوليد كود Shadow Account، مع إضافة اختبارات انحدار لكل مسار. تبقى تدفقات CLI وWeb UI على localhost كما هي؛ ويجب أن تستمر عمليات النشر البعيدة في استخدام `API_AUTH_KEY` وorigins موثوقة صريحة. -- **2026-05-04** 🖥️ **تحسين تجربة CLI التفاعلية + تنظيف CI**: أصبح الوضع التفاعلي يعرض شريط حالة سفلياً مباشراً يوضح provider/model ومدة الجلسة ووقت آخر تشغيل وإحصاءات استدعاءات الأدوات التراكمية، مع دعم تصفح السجل وتحرير المؤشر بأسهم لوحة المفاتيح عبر `prompt_toolkit` ([#69](https://github.com/HKUDS/Vibe-Trading/pull/69)). وعند غياب `prompt_toolkit` أو TTY، يعود CLI إلى Rich prompts. كما تمت مواءمة توقعات مسارات CI مع صندوق استيراد الملفات المعزز وحل `/tmp` عبر المنصات، فعاد main إلى الحالة الخضراء ([`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)). -- **2026-05-03** 🛡️ **تصحيح لتعزيز الأمان**: يشدد المصادقة الافتراضية للـ API في النشر غير المحلي، ويحمي قراءات run/session/swarm الحساسة، ويقيّد حدود الرفع وقراءة الملفات المحلية، ويتحكم في أدوات shell بحسب نقطة الدخول، ويتحقق من الاستراتيجيات المولدة قبل الاستيراد، ويجعل صورة Docker تعمل افتراضياً كمستخدم غير root وبمنفذ منشور على localhost فقط. تبقى تجربة CLI وWeb UI المحلي منخفضة الاحتكاك؛ ويجب على نشر API/Web البعيد ضبط `API_AUTH_KEY`. -- **2026-05-02** 🧭 **تحليل التوزيعات + خارطة طريق أوضح**: تمت إضافة مهارة `dividend-analysis` لأسهم الدخل، واستدامة التوزيعات، ونمو التوزيعات، وعائد المساهمين، وآليات تاريخ الاستحقاق السابق، وفحص فخاخ العائد المرتفع، مع تثبيتها باختبارات انحدار للمهارات المضمنة. تركز خارطة الطريق العامة الآن على Research Autopilot وData Bridge وOptions Lab وPortfolio Studio وAlpha Zoo وResearch Delivery وTrust Layer ومشاركة Community. -- **2026-05-01** 🔥 **خريطة ارتباط حرارية + OpenAI Codex OAuth + مرشح pre-ST لأسهم A**: لوحة/API ارتباط جديدة تحسب ارتباطات العوائد المتحركة وتعرضها كخريطة حرارية ECharts لتحليل المحافظ والرموز ([#64](https://github.com/HKUDS/Vibe-Trading/pull/64)). مزود OpenAI Codex يدعم الآن ChatGPT OAuth عبر `vibe-trading provider login openai-codex`، مع بيانات Settings واختبارات انحدار للمحوّل ([#65](https://github.com/HKUDS/Vibe-Trading/pull/65)). تمت إضافة وتعزيز مهارة `ashare-pre-st-filter` لفحص مخاطر ST/*ST في أسهم A، مع فلترة صلة عقوبات Sina حتى لا تضخم إشارات قوائم حسابات الأوراق المالية عدّادات E2 ([#63](https://github.com/HKUDS/Vibe-Trading/pull/63)). -- **2026-04-30** ⚙️ **إعدادات Web UI + تعزيز validation CLI**: تمت إضافة صفحة Settings لإعداد LLM provider/model وBase URL وreasoning effort وبيانات اعتماد مصادر البيانات محلياً. واجهات settings API محمية الآن عبر local/auth، كما أصبحت بيانات مزودي النماذج إعدادات مدفوعة بالبيانات ([#57](https://github.com/HKUDS/Vibe-Trading/pull/57)). كذلك تم تعزيز `python -m backtest.validation ` لرفض غياب الوسيط، والمسار الفارغ، والمسار غير الصالح، والمسار غير الموجود، والمسار الذي ليس دليلاً برسائل واضحة قبل بدء التحقق ([#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 مصادر بيانات مع بديل تلقائي. +- **2026-05-11** 🧭 **Memory slugs، ومحاسبة السرب، وفحص CLI المسبق**: أصبحت الذاكرة الدائمة تحفظ أحرف CJK عند توليد slugs للملفات، مما يمنع اصطدامات أسماء صامتة لملاحظات الصينية/اليابانية/الكورية ([#95](https://github.com/HKUDS/Vibe-Trading/pull/95)، شكراً @voidborne-d). تفضل مجاميع تشغيل السرب الآن استخدام استهلاك الرموز المبلغ من المزود مع الإبقاء على التقدير الاحتياطي الحالي ([#94](https://github.com/HKUDS/Vibe-Trading/pull/94)، شكراً @Teerapat-Vatpitak)، كما حصلت واجهة تشغيل CLI على فحص بدء مبكر للمشكلات البيئية الشائعة ([#96](https://github.com/HKUDS/Vibe-Trading/pull/96)، شكراً @ykykj). +- **2026-05-10** 🧱 **حواجز انحدار وبيانات تشغيل وصفية**: أصبح استدعاء الذاكرة يتعامل مع الشرطات السفلية كحدود رموز، لذلك تطابق ذكريات `snake_case` مثل `mcp_wiring_test` استعلامات طبيعية مثل "mcp wiring" ([#87](https://github.com/HKUDS/Vibe-Trading/pull/87)، شكراً @hp083625). يملك خادم MCP الآن اختبار smoke عبر subprocess يغطي initialize → `tools/list` → `tools/call` لحماية مسار التعطل في أول استدعاء ([#86](https://github.com/HKUDS/Vibe-Trading/pull/86))، كما وصلت تحسينات منخفضة المخاطر لاختبارات مسارات Windows، ومعالجة استثناءات API best-effort، والتحقق من allowed-root في `run_dir` للاختبار الرجعي، وبيانات provider/model في SwarmRun ([#88](https://github.com/HKUDS/Vibe-Trading/pull/88)، [#90](https://github.com/HKUDS/Vibe-Trading/pull/90)، [#91](https://github.com/HKUDS/Vibe-Trading/pull/91)، [#92](https://github.com/HKUDS/Vibe-Trading/pull/92)، شكراً @Teerapat-Vatpitak). +- **2026-05-09** 🛡️ **تعزيز مسارات API واستقرار خادم MCP**: تتحقق مسارات run/session في API الآن من معرفات المسار قبل البحث، وترفض المعاملات المشوهة التي تحتوي على أسطر جديدة مع تثبيت السلوك في مجموعة اختبارات auth/security ([#80](https://github.com/HKUDS/Vibe-Trading/pull/80)، شكراً @SJoon99). يسخن خادم MCP سجل الأدوات على الخيط الرئيسي قبل خدمة `tools/call` لتجنب تعطل أول استدعاء في اكتشاف الأدوات الكسول ([#85](https://github.com/HKUDS/Vibe-Trading/pull/85)، شكراً @Teerapat-Vatpitak). كما يحترم Vite dev proxy المتغير `VITE_API_URL` لأهداف الخلفية غير الافتراضية ([#82](https://github.com/HKUDS/Vibe-Trading/pull/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](https://github.com/HKUDS/Vibe-Trading/pull/76)، شكراً @mrbob-git). ويجعل التعزيز اللاحق طلب حقول القوائم الصريح يفشل سريعاً إذا تعذر تشغيل إثراء Tushare، بدلاً من الرجوع بصمت إلى أشرطة الأسعار الخام ([#77](https://github.com/HKUDS/Vibe-Trading/pull/77)). +- **2026-05-07** 📈 **أساسيات Tushare وفرز المجتمع**: أضيف عقد `TushareFundamentalProvider` بنمط point-in-time لتدفقات البحث الأساسي، مع تغطية انحدار لمسار متغير البيئة `TUSHARE_TOKEN` في المشروع ([#74](https://github.com/HKUDS/Vibe-Trading/pull/74)). كما أوضح فرز المجتمع أن Vibe-Trading يركز حالياً على لغة واجهة واحدة لتسريع التكرار، ويتجنب تبعيات بحث زائدة ما دام `web_search` المدعوم من DuckDuckGo مضمناً، ويتعامل مع النشر المستضاف غير الرسمي كمكان غير موثوق لمفاتيح API أو رموز مصادر البيانات. +- **2026-05-06** 🚀 **إصدار v0.1.7** ([Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7)، `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](https://github.com/HKUDS/Vibe-Trading/pull/69)). يعود CLI إلى Rich prompts عند غياب `prompt_toolkit` أو TTY. كما وُئمت توقعات مسارات CI مع صندوق استيراد الملفات المعزز وحل `/tmp` عبر المنصات، فعاد main إلى الأخضر ([`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)). +- **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](https://github.com/HKUDS/Vibe-Trading/pull/64)). يدعم مزود OpenAI Codex الآن ChatGPT OAuth عبر `vibe-trading provider login openai-codex` مع بيانات Settings واختبارات انحدار للمحول ([#65](https://github.com/HKUDS/Vibe-Trading/pull/65)). أضيفت وعُززت مهارة `ashare-pre-st-filter` لفحص مخاطر ST/*ST في أسهم A، مع فلترة صلة عقوبات Sina حتى لا تضخم إشارات حسابات الأوراق المالية عدادات E2 ([#63](https://github.com/HKUDS/Vibe-Trading/pull/63)). +- **2026-04-30** ⚙️ **Web UI Settings وتعزيز validation CLI**: صفحة Settings جديدة لمزود/نموذج LLM، وbase URL، وreasoning effort، وبيانات اعتماد مصادر البيانات، مدعومة بواجهات settings API محلية/محمية وببيانات مزودين قابلة للتكوين ([#57](https://github.com/HKUDS/Vibe-Trading/pull/57)). كما تعزز `python -m backtest.validation ` حتى تفشل المدخلات الناقصة أو الفارغة أو المشوهة أو غير الموجودة أو غير الدليل برسائل واضحة قبل بدء التحقق ([#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))، حيث أصبحت ملفات 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](https://github.com/HKUDS/Vibe-Trading/issues/48)). كما تبث `/upload` جسم الطلب في أجزاء 1 MB وتتوقف بعد `MAX_UPLOAD_SIZE`، مما يحد الذاكرة تحت العملاء الضخمين/المشوهين ([#53](https://github.com/HKUDS/Vibe-Trading/pull/53))، ومثبتة بأربعة اختبارات انحدار. +- **2026-04-22** 🛡️ **تعزيز وتكاملات جديدة**: فرض احتواء المسارات في `safe_path` وصندوق أدوات journal/shadow، وإرسال `.env.example` / الاختبارات / ملفات Docker في sdist عبر `MANIFEST.in`، وتصغير الحزمة الأولية للواجهة من 688KB إلى 262KB عبر التحميل الكسول على مستوى المسارات. إضافة محمل Futu لأسهم HK وA-share ([#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** 🔌 **Reasoning وSwarm**: الحفاظ على `reasoning_content` عبر جميع مسارات `ChatOpenAI`، لتعمل أفكار Kimi / DeepSeek / Qwen من البداية للنهاية ([#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 أدوات 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](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 + crypto) بمجمع رأس مال مشترك وقواعد لكل سوق. كما أصلح fallback لمتغيرات قالب السرب ومهلة الواجهة. +- **2026-04-12** 🌍 **تصدير متعدد المنصات**: يصدر `/pine` الاستراتيجيات إلى TradingView (Pine Script v6)، وTDX (通达信/同花顺/东方财富)، وMetaTrader 5 (MQL5) بأمر واحد. +- **2026-04-11** 🛡️ **الموثوقية وتجربة المطور**: إعداد `.env` عبر `vibe-trading init` ([#19](https://github.com/HKUDS/Vibe-Trading/pull/19))، وفحوصات مسبقة، وfallback لمصادر البيانات وقت التشغيل، ومحرك اختبار رجعي معزز. 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. تحقق Monte Carlo وBootstrap CI وWalk-Forward. +- **2026-04-08** 🔧 **اختبار رجعي متعدد الأسواق** مع قواعد لكل سوق، وتصدير Pine Script v6، و5 مصادر بيانات مع fallback تلقائي.
--- -## 💡 ما هو Vibe-Trading؟ - -Vibe-Trading هو مساحة عمل مالية متعددة الوكلاء مدعومة بالذكاء الاصطناعي تحول الطلبات بلغة طبيعية إلى استراتيجيات تداول قابلة للتنفيذ ورؤى بحثية وتحليل محافظ عبر الأسواق العالمية. - -### القدرات الرئيسية: -• **لغة طبيعية → استراتيجية** — صِف فكرتك؛ الوكيل يكتب الكود ويختبره ويصدّره
-• **6 مصادر بيانات، بدون إعداد** — أسهم A، HK/US، العملات المشفرة، العقود الآجلة، الفوركس مع بديل تلقائي
-• **29 فريق خبراء** — سير عمل سرب متعدد الوكلاء للاستثمار والتداول وإدارة المخاطر
-• **ذاكرة عبر الجلسات** — يتذكر التفضيلات والرؤى؛ ينشئ ويطور المهارات القابلة لإعادة الاستخدام
-• **7 محركات اختبار رجعي** — اختبار مركب عبر الأسواق + تحقق إحصائي + 4 محسّنات
-• **تصدير متعدد المنصات** — نقرة واحدة إلى TradingView وTDX وMetaTrader 5 - ---- - ## ✨ الميزات الرئيسية - +
+
- - - + + -
- البحث
-

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

- المهارات

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

🔍 وكيل تداول ذاتي التحسن

+
+ • بحث سوقي باللغة الطبيعية
+ • مسودات استراتيجيات وتحليل ملفات/ويب
+ • تدفقات عمل مدعومة بالذاكرة
- السرب
-

🐝 ذكاء السرب

- السرب

+ 		+ فرق تداول متعددة الوكلاء
+

🐝 فرق تداول متعددة الوكلاء

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

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

- الاختبار الرجعي

+
+ بيانات واختبارات رجعية عبر الأسواق
+

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

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

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

- الكمي

+ 		+ Shadow Account
+

👥 Shadow Account

- • تحليل العامل IC/IR والاختبار الرجعي للشرائح
- • تسعير Black-Scholes وحساب كامل للمتغيرات اليونانية
- • التعرف على الأنماط الفنية واكتشافها
- • تحسين المحافظ عبر MVO/Risk Parity/BL + • تشخيص سلوكي لسجلات الوسطاء
+ • مقارنات Shadow Account قائمة على القواعد
+ • تقارير تدقيق وكود استراتيجية قابلان للتصدير
+ -## 74 مهارة عبر 8 فئات +## 💡 ما هو Vibe-Trading؟ + +Vibe-Trading مساحة عمل بحثية مفتوحة المصدر تحول الأسئلة المالية إلى تحليل قابل للتشغيل. يربط المطالبات باللغة الطبيعية بمحملات بيانات السوق، وتوليد الاستراتيجيات، ومحركات الاختبار الرجعي، والتقارير، والتصدير، وذاكرة البحث الدائمة. + +صُمم للبحث والمحاكاة والاختبار الرجعي. لا ينفذ صفقات حية. + +--- + +## ✨ ما الذي يمكنك فعله؟ + +| المهمة | الناتج | +|------|--------| +| **طرح سؤال تداول** | بحث سوقي باستخدام الأدوات والبيانات والمستندات وسياق جلسة قابل لإعادة الاستخدام. | +| **اختبار فكرة استراتيجية رجعياً** | كود استراتيجية، ومقاييس، وسياق معياري، ومخرجات تحقق، وبطاقات تشغيل. | +| **مراجعة صفقاتك الخاصة** | قراءة سجلات الوسطاء، وتشخيص السلوك، واستخراج القواعد، ومقارنات Shadow Account. | +| **تحسين الأبحاث المتكررة** | الذاكرة الدائمة والمهارات القابلة للتحرير تحول الروتينات المفيدة إلى تدفقات قابلة لإعادة الاستخدام. | +| **تشغيل فرق محللين** | مراجعات بحث متعددة الوكلاء لتدفقات الاستثمار والكم والكريبتو والماكرو والمخاطر. | +| **إنتاج مخرجات قابلة للاستخدام** | تقارير، وTradingView Pine Script، وTDX، وMetaTrader 5، وأدوات MCP، وجلسات بحث لاحقة. | + +--- + +## ⚡ مثال سريع + +```bash +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" +``` + +```bash +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 يمكن فحصه أو أرشفته أو تحسينه في جلسة لاحقة. | + +```bash +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 سهل القراءة. افتحها عندما تريد فحص اللبنات المتاحة. + +
+مكتبة المهارات المالية 74 مهارة عبر 8 فئات - 📊 74 مهارة مالية متخصصة منظمة في 8 فئات -- 🌐 تغطية شاملة من الأسواق التقليدية إلى العملات المشفرة وDeFi -- 🔬 قدرات شاملة تمتد من مصادر البيانات إلى البحث الكمي +- 🌐 تغطية كاملة من الأسواق التقليدية إلى الكريبتو و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` | -| التحليل | 17 | `factor-research`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-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` | -| الأدوات | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export` | +| 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 | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export` | | Risk Analysis | 1 | `ashare-pre-st-filter` | -## 29 إعداد مسبق لفرق وكلاء السرب +
-- 🏢 29 فرق وكلاء جاهزة للاستخدام -- ⚡ سير عمل مالية مُعدة مسبقاً -- 🎯 إعدادات مسبقة للاستثمار والتداول وإدارة المخاطر +
+فرق تداول جاهزة 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 ← تخصيص عبر الأسواق | +| `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 لاستكشافها جميعاً. +بالإضافة إلى أكثر من 20 إعداداً متخصصاً آخر — شغل vibe-trading --swarm-presets لاستكشافها كلها. -### 🎬 عرض توضيحي +
+ +## 🎬 العرض التوضيحي
@@ -213,7 +268,7 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 - +
☝️ اختبار رجعي بلغة طبيعية ومناظرة سرب متعدد الوكلاء — واجهة ويب + CLI☝️ اختبار رجعي باللغة الطبيعية ومناظرة سرب متعدد الوكلاء — Web UI + CLI
@@ -228,53 +283,61 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 pip install vibe-trading-ai ``` -> **اسم الحزمة مقابل الأوامر:** حزمة PyPI هي `vibe-trading-ai`. بعد التثبيت، ستحصل على ثلاثة أوامر: +ثم شغل أول مهمة بحثية: + +```bash +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` | CLI / TUI تفاعلي | > | `vibe-trading serve` | تشغيل خادم ويب FastAPI | -> | `vibe-trading-mcp` | بدء خادم MCP (لـ Claude Desktop, OpenClaw, Cursor, إلخ) | +> | `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) +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** | ربطه بوكيلك الحالي | 3 دقائق | -| **D. ClawHub** | أمر واحد، بدون استنساخ | دقيقة واحدة | +| **A. Docker** | التجربة الآن، دون إعداد محلي | دقيقتان | +| **B. تثبيت محلي** | التطوير والوصول الكامل إلى CLI | 5 دقائق | +| **C. MCP plugin** | وصله بوكيلك الحالي | 3 دقائق | +| **D. ClawHub** | أمر واحد دون استنساخ | دقيقة واحدة | ### المتطلبات المسبقة -- **مفتاح API لنموذج لغة** من أي مزود مدعوم — أو التشغيل محلياً مع **Ollama** (بدون مفتاح) +- **مفتاح 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`. -> **مزودو نماذج اللغة المدعومون:** OpenRouter, OpenAI, DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, Xiaomi MIMO, Z.ai, Ollama (محلي). راجع `.env.example` للإعدادات. +> **مزودو LLM المدعومون:** OpenRouter, OpenAI, DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, Xiaomi MIMO, Z.ai, Ollama (local). راجع `.env.example` للإعداد. -> **نصيحة:** جميع الأسواق تعمل بدون أي مفاتيح API بفضل البديل التلقائي. yfinance (HK/US) و OKX (العملات المشفرة) و AKShare (أسهم A، US، HK، العقود الآجلة، الفوركس) جميعها مجانية. رمز Tushare اختياري — AKShare يغطي أسهم A كبديل مجاني. +> **نصيحة:** تعمل كل الأسواق دون مفاتيح API بفضل fallback التلقائي. yfinance (HK/US)، وOKX (crypto)، وAKShare (A-shares, US, HK, futures, forex) مجانية. رمز Tushare اختياري، إذ يغطي AKShare أسهم A كبديل مجاني. -### المسار A: Docker (بدون إعداد) +### المسار A: Docker (دون إعداد) ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading cp agent/.env.example agent/.env -# عدّل agent/.env — أزل التعليق عن مزود نموذج اللغة وحدد مفتاح API +# Edit agent/.env — uncomment your LLM provider and set API key docker compose up --build ``` -افتح `http://localhost:8899`. الخلفية + الواجهة الأمامية في حاوية واحدة. +افتح `http://localhost:8899`. الخلفية والواجهة الأمامية داخل حاوية واحدة. -ينشر Docker الخلفية افتراضياً على `127.0.0.1:8899` فقط، ويشغل التطبيق كمستخدم حاوية غير root. إذا كنت تنوي تعريض الـ API خارج جهازك، فاضبط `API_AUTH_KEY` قوياً وأرسل `Authorization: Bearer ` من العملاء. +ينشر Docker الخلفية على `127.0.0.1:8899` افتراضياً ويشغل التطبيق كمستخدم حاوية غير root. إذا كنت تقصد تعريض API خارج جهازك، فاضبط `API_AUTH_KEY` قوياً وأرسل `Authorization: Bearer ` من العملاء. ### المسار B: التثبيت المحلي @@ -283,40 +346,40 @@ 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 # عدّل — حدد مفتاح API لمزود نموذج اللغة -vibe-trading # تشغيل TUI التفاعلي +cp agent/.env.example agent/.env # Edit — set your LLM provider API key +vibe-trading # Launch interactive TUI ```
تشغيل واجهة الويب (اختياري) ```bash -# الطرفية 1: خادم API +# Terminal 1: API server vibe-trading serve --port 8899 -# الطرفية 2: خادم تطوير الواجهة الأمامية +# Terminal 2: Frontend dev server cd frontend && npm install && npm run dev ``` -افتح `http://localhost:5899`. تعيد الواجهة الأمامية توجيه استدعاءات API إلى `localhost:8899`. +افتح `http://localhost:5899`. تمرر الواجهة الأمامية استدعاءات API إلى `localhost:8899`. **وضع الإنتاج (خادم واحد):** ```bash cd frontend && npm run build && cd .. -vibe-trading serve --port 8899 # يخدم FastAPI مجلد dist/ كملفات ثابتة +vibe-trading serve --port 8899 # FastAPI serves dist/ as static files ```
-### المسار C: إضافة MCP +### المسار C: MCP plugin -راجع قسم [إضافة MCP](#-إضافة-mcp) أدناه. +راجع قسم [MCP Plugin](#-mcp-plugin) أدناه. ### المسار D: ClawHub (أمر واحد) @@ -324,51 +387,51 @@ vibe-trading serve --port 8899 # يخدم FastAPI مجلد dist/ كملفا npx clawhub@latest install vibe-trading --force ``` -يتم تنزيل المهارة + إعدادات MCP إلى مجلد مهارات وكيلك. راجع [تثبيت ClawHub](#-إضافة-mcp) للتفاصيل. +تُنزل المهارة وإعداد MCP إلى مجلد مهارات وكيلك. راجع [تثبيت ClawHub](#-mcp-plugin) للتفاصيل. --- ## 🧠 متغيرات البيئة -انسخ `agent/.env.example` إلى `agent/.env` وأزل التعليق عن كتلة المزود التي تريدها. كل مزود يحتاج إلى 3-4 متغيرات: +انسخ `agent/.env.example` إلى `agent/.env` وأزل التعليق عن كتلة المزود التي تريدها. يحتاج كل مزود إلى 3-4 متغيرات: | المتغير | مطلوب | الوصف | |----------|:--------:|-------------| -| `LANGCHAIN_PROVIDER` | نعم | اسم المزود (`openrouter`, `deepseek`, `groq`, `z.ai`, `ollama`, إلخ) | +| `LANGCHAIN_PROVIDER` | نعم | اسم المزود (`openrouter`, `deepseek`, `groq`, `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 ثانية | -| `API_AUTH_KEY` | موصى به للنشر الشبكي | Bearer token مطلوب عندما يكون الـ API قابلاً للوصول من عملاء غير محليين | -| `VIBE_TRADING_ENABLE_SHELL_TOOLS` | لا | تفعيل صريح لأدوات shell في نشر API / MCP-SSE البعيد | +| `_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. +* لا يحتاج Ollama إلى مفتاح API. يستخدم OpenAI Codex ChatGPT OAuth ويخزن الرموز عبر `oauth-cli-kit`، لا داخل `agent/.env`. -**بيانات مجانية (بدون مفتاح):** أسهم A عبر AKShare، أسهم HK/US عبر yfinance، العملات المشفرة عبر OKX، 100+ بورصة عملات مشفرة عبر CCXT. يختار النظام تلقائياً أفضل مصدر متاح لكل سوق. +**بيانات مجانية (دون مفتاح):** أسهم A عبر AKShare، وأسهم HK/US عبر yfinance، والكريبتو عبر OKX، وأكثر من 100 بورصة كريبتو عبر CCXT. يختار النظام تلقائياً أفضل مصدر متاح لكل سوق. ### 🎯 النماذج الموصى بها -Vibe-Trading وكيل يعتمد بكثافة على استدعاءات الأدوات — المهارات والاختبار الخلفي والذاكرة و swarm كلها تعمل عبر tool calls. اختيار النموذج يحدد مباشرة ما إذا كان الوكيل **يستخدم أدواته فعلاً** أو يلفّق الإجابات من بيانات التدريب. +Vibe-Trading وكيل كثيف الأدوات؛ المهارات والاختبارات الرجعية والذاكرة والأسراب كلها تمر عبر استدعاءات أدوات. اختيار النموذج يحدد مباشرة هل سيستخدم الوكيل أدواته أم سيصطنع إجابات من بيانات التدريب. -| المستوى | أمثلة | متى يُستخدم | -|---------|-------|-------------| -| **الأفضل** | `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 غير موثوق — سيبدو الوكيل وكأنه "يجيب من الذاكرة" بدلاً من تحميل المهارات أو تشغيل الاختبار الخلفي | +| المستوى | أمثلة | متى تستخدمه | +|------|----------|-------------| +| **الأفضل** | `anthropic/claude-opus-4.7`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.4`, `google/gemini-3.1-pro-preview` | أسراب معقدة (3+ وكلاء)، جلسات بحث طويلة، تحليل بمستوى ورقة علمية | +| **النقطة المثلى** (افتراضي) | `deepseek-v4-pro`, `deepseek/deepseek-v4-pro`, `x-ai/grok-4.20`, `z-ai/glm-5.1`, `moonshotai/kimi-k2.5`, `qwen/qwen3-max-thinking` | الاستخدام اليومي، tool-calling موثوق بنحو عُشر التكلفة | +| **تجنبها لاستخدام الوكيل** | `*-nano`, `*-flash-lite`, `*-coder-next`, small / distilled variants | tool-calling غير موثوق؛ سيبدو الوكيل وكأنه "يجيب من الذاكرة" بدلاً من تحميل المهارات أو تشغيل الاختبارات الرجعية | -يأتي `agent/.env.example` الافتراضي مع `deepseek/deepseek-v3.2` — الخيار الأرخص في مستوى النقطة المثلى. +يأتي `agent/.env.example` افتراضياً مع DeepSeek official API + `deepseek-v4-pro`; ويمكن لمستخدمي OpenRouter استخدام `deepseek/deepseek-v4-pro`. --- -## 🖥 مرجع سطر الأوامر +## 🖥 مرجع CLI ```bash -vibe-trading # TUI تفاعلي -vibe-trading run -p "..." # تشغيل واحد -vibe-trading serve # خادم API +vibe-trading # interactive TUI +vibe-trading run -p "..." # single run +vibe-trading serve # API server ```
@@ -376,8 +439,8 @@ vibe-trading serve # خادم API | الأمر | الوصف | |---------|-------------| -| `/help` | عرض جميع الأوامر | -| `/skills` | عرض جميع مهارات التداول الـ 74 | +| `/help` | عرض كل الأوامر | +| `/skills` | عرض كل المهارات المالية الـ 74 | | `/swarm` | عرض إعدادات فرق السرب الـ 29 | | `/swarm run [vars_json]` | تشغيل فريق سرب مع بث مباشر | | `/swarm list` | سجل تشغيلات السرب | @@ -385,38 +448,38 @@ vibe-trading serve # خادم API | `/swarm cancel ` | إلغاء سرب قيد التشغيل | | `/list` | التشغيلات الأخيرة | | `/show ` | تفاصيل التشغيل + المقاييس | -| `/code ` | كود الاستراتيجية المولّدة | -| `/pine ` | Pine Script لـ TradingView | -| `/trace ` | إعادة تشغيل التنفيذ الكاملة | +| `/code ` | كود الاستراتيجية المولدة | +| `/pine ` | تصدير المؤشرات (TradingView + TDX + MT5) | +| `/trace ` | إعادة تشغيل التنفيذ كاملة | | `/continue ` | متابعة تشغيل بتعليمات جديدة | | `/sessions` | عرض جلسات الدردشة | | `/settings` | عرض إعدادات التشغيل | | `/clear` | مسح الشاشة | -| `/quit` | الخروج | +| `/quit` | خروج |
-التشغيل الفردي والعلامات +تشغيل واحد والخيارات ```bash -vibe-trading run -p "اختبر استراتيجية BTC-USDT MACD رجعياً، آخر 30 يوماً" -vibe-trading run -p "حلل زخم AAPL" --json +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 "اختبر 000001.SZ RSI رجعياً" | vibe-trading run +echo "Backtest 000001.SZ RSI" | vibe-trading run ``` ```bash -vibe-trading -p "طلبك" +vibe-trading -p "your prompt" vibe-trading --skills vibe-trading --swarm-presets -vibe-trading --swarm-run investment_committee '{"topic":"توقعات BTC"}' +vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}' vibe-trading --list vibe-trading --show vibe-trading --code -vibe-trading --pine # Pine Script لـ TradingView +vibe-trading --pine # Export indicators (TradingView + TDX + MT5) vibe-trading --trace -vibe-trading --continue "حسّن الاستراتيجية" +vibe-trading --continue "refine the strategy" vibe-trading --upload report.pdf ``` @@ -424,6 +487,76 @@ vibe-trading --upload report.pdf --- +## 💡 أمثلة + +### الاستراتيجيات والاختبار الرجعي + +```bash +# 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 +``` + +### بحث السوق + +```bash +# 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" +``` + +### تدفقات السرب + +```bash +# 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"}' +``` + +### ذاكرة عبر الجلسات + +```bash +# 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" +``` + +### رفع المستندات وتحليلها + +```bash +# 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 ```bash @@ -434,7 +567,7 @@ vibe-trading serve --port 8899 |--------|----------|-------------| | `GET` | `/runs` | عرض التشغيلات | | `GET` | `/runs/{run_id}` | تفاصيل التشغيل | -| `GET` | `/runs/{run_id}/pine` | تصدير Pine Script | +| `GET` | `/runs/{run_id}/pine` | تصدير مؤشرات متعدد المنصات | | `POST` | `/sessions` | إنشاء جلسة | | `POST` | `/sessions/{id}/messages` | إرسال رسالة | | `GET` | `/sessions/{id}/events` | بث أحداث SSE | @@ -442,7 +575,7 @@ vibe-trading serve --port 8899 | `GET` | `/swarm/presets` | عرض إعدادات السرب | | `POST` | `/swarm/runs` | بدء تشغيل سرب | | `GET` | `/swarm/runs/{id}/events` | بث SSE للسرب | -| `GET` | `/settings/llm` | قراءة إعدادات LLM في واجهة الويب | +| `GET` | `/settings/llm` | قراءة إعدادات LLM في Web UI | | `PUT` | `/settings/llm` | تحديث إعدادات LLM المحلية | | `GET` | `/settings/data-sources` | قراءة إعدادات مصادر البيانات المحلية | | `PUT` | `/settings/data-sources` | تحديث إعدادات مصادر البيانات المحلية | @@ -451,21 +584,21 @@ vibe-trading serve --port 8899 ### الإعدادات الأمنية الافتراضية -في التطوير المحلي، يحافظ `vibe-trading serve` على بساطة سير عمل المتصفح. أي عميل غير محلي يصل إلى واجهات API الحساسة يحتاج إلى `API_AUTH_KEY`؛ استخدم `Authorization: Bearer ` لطلبات JSON والرفع. يتعامل Web UI مع بث EventSource بعد إدخال المفتاح نفسه مرة واحدة في Settings. +للتطوير على localhost، يبقي `vibe-trading serve` سير المتصفح بسيطاً. لأي عميل غير محلي، تتطلب نقاط API الحساسة `API_AUTH_KEY`؛ استخدم `Authorization: Bearer ` لطلبات 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`. +تتوفر الأدوات القادرة على 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 في واجهة الويب للمستخدمين المحليين تحديث LLM provider/model وBase URL ومعلمات التوليد وreasoning effort وبيانات اعتماد مصادر السوق الاختيارية مثل رمز Tushare. تُحفظ الإعدادات في `agent/.env`، وتُحمّل القيم الافتراضية للمزودين من `agent/src/providers/llm_providers.json`. +تتيح صفحة 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 المحليين. +قراءات Settings بلا آثار جانبية: لا تنشئ `GET /settings/llm` ولا `GET /settings/data-sources` ملف `agent/.env`، ولا تعيدان إلا مسارات نسبية للمشروع. قد تكشف قراءات وكتابات Settings حالة بيانات الاعتماد أو تحدث بيانات الاعتماد/بيئة التشغيل، لذلك تتطلب `API_AUTH_KEY` عند ضبطه. إذا كان `API_AUTH_KEY` غير مضبوط في وضع التطوير، فلا يقبل الوصول إلى Settings إلا من عملاء loopback. --- -## 🔌 إضافة MCP +## 🔌 MCP Plugin -يقدم Vibe-Trading 22 أداة MCP لأي عميل متوافق مع MCP. يعمل كعملية فرعية stdio — بدون إعداد خادم. **21 من 22 أداة تعمل بدون مفاتيح API** (HK/US/العملات المشفرة). فقط `run_swarm` يحتاج إلى مفتاح نموذج لغة. +يعرض Vibe-Trading 22 أداة MCP لأي عميل متوافق مع MCP. يعمل كعملية stdio فرعية، دون إعداد خادم. **21 من أصل 22 أداة تعمل دون أي مفاتيح API** (HK/US/crypto). يحتاج `run_swarm` وحده إلى مفتاح LLM.
Claude Desktop @@ -498,16 +631,16 @@ skills:
-Cursor / Windsurf / عملاء MCP الآخرين +Cursor / Windsurf / عملاء MCP آخرون ```bash -vibe-trading-mcp # stdio (الافتراضي) -vibe-trading-mcp --transport sse # SSE لعملاء الويب +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`. +**أدوات 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 (أمر واحد) @@ -516,9 +649,9 @@ vibe-trading-mcp --transport sse # SSE لعملاء الويب npx clawhub@latest install vibe-trading --force ``` -> `--force` مطلوب لأن المهارة تشير إلى واجهات برمجية خارجية، مما يؤدي إلى فحص تلقائي من VirusTotal. الكود مفتوح المصدر بالكامل وآمن للفحص. +> `--force` مطلوب لأن المهارة تشير إلى واجهات API خارجية، مما يطلق فحص VirusTotal الآلي. الكود مفتوح المصدر بالكامل وآمن للفحص. -هذا ينزّل المهارة + إعدادات MCP إلى مجلد مهارات وكيلك. بدون الحاجة للاستنساخ. +ينزل هذا المهارة وإعداد MCP إلى مجلد مهارات وكيلك. لا حاجة للاستنساخ. تصفح على ClawHub: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading) @@ -527,9 +660,9 @@ npx clawhub@latest install vibe-trading --force
OpenSpace — مهارات ذاتية التطور -جميع مهارات التداول الـ 74 منشورة على [open-space.cloud](https://open-space.cloud) وتتطور بشكل مستقل عبر محرك التطور الذاتي من OpenSpace. +كل المهارات المالية الـ 74 منشورة على [open-space.cloud](https://open-space.cloud) وتتطور ذاتياً عبر محرك التطور الذاتي في OpenSpace. -للاستخدام مع OpenSpace، أضف خادمي MCP إلى إعدادات وكيلك: +للاستخدام مع OpenSpace، أضف خادمي MCP إلى إعداد وكيلك: ```json { @@ -549,7 +682,7 @@ npx clawhub@latest install vibe-trading --force } ``` -سيكتشف OpenSpace تلقائياً جميع المهارات الـ 74، مما يتيح الإصلاح التلقائي والتحسين التلقائي والمشاركة المجتمعية. ابحث عن مهارات Vibe-Trading عبر `search_skills("finance backtest")` في أي وكيل متصل بـ OpenSpace. +سيكتشف OpenSpace كل المهارات الـ 74 تلقائياً، مما يتيح auto-fix وauto-improve والمشاركة المجتمعية. ابحث عن مهارات Vibe-Trading عبر `search_skills("finance backtest")` في أي وكيل متصل بـ OpenSpace.
@@ -562,55 +695,55 @@ npx clawhub@latest install vibe-trading --force ``` Vibe-Trading/ -├── agent/ # الخلفية (Python) -│ ├── cli.py # نقطة دخول CLI — TUI تفاعلي + أوامر فرعية -│ ├── api_server.py # خادم FastAPI — تشغيلات، جلسات، رفع، سرب، SSE -│ ├── mcp_server.py # خادم MCP — 22 أداة لـ OpenClaw / Claude Desktop +├── agent/ # Backend (Python) +│ ├── cli.py # CLI entrypoint — 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 -│ │ │ ├── loop.py # ضغط 5 طبقات + معالجة أدوات القراءة/الكتابة دفعة واحدة -│ │ │ ├── context.py # موجه النظام + استرجاع تلقائي من الذاكرة الدائمة -│ │ │ ├── skills.py # محمل المهارات (74 مدمجة + إنشاء CRUD من المستخدم) -│ │ │ ├── tools.py # فئة الأدوات الأساسية + السجل -│ │ │ ├── memory.py # حالة مساحة عمل خفيفة لكل تشغيل -│ │ │ ├── frontmatter.py # محلل YAML frontmatter مشترك -│ │ │ └── trace.py # كاتب أثر التنفيذ +│ │ ├── 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 (74 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/ # ذاكرة دائمة عبر الجلسات -│ │ │ └── persistent.py # ذاكرة قائمة على الملفات (~/.vibe-trading/memory/) +│ │ ├── memory/ # Cross-session persistent memory +│ │ │ └── persistent.py # file-based memory (~/.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، إدخال/إخراج ملف، تحليل العوامل، الخيارات، إلخ +│ │ ├── tools/ # 27 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, etc. │ │ │ -│ │ ├── skills/ # 74 مهارة مالية في 8 فئات (SKILL.md لكل منها) -│ │ ├── swarm/ # محرك تنفيذ DAG للسرب -│ │ │ └── presets/ # 29 تعريف YAML للإعدادات المسبقة للسرب -│ │ ├── session/ # دردشة متعددة الأدوار + بحث FTS5 عبر الجلسات -│ │ └── providers/ # تجريد مزود نموذج اللغة +│ │ ├── skills/ # 74 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/ # محركات الاختبار الرجعي -│ ├── engines/ # 7 محركات + محرك مركب عبر الأسواق + options_portfolio -│ ├── loaders/ # 6 مصادر: tushare, okx, yfinance, akshare, ccxt, futu -│ │ ├── base.py # بروتوكول DataLoader -│ │ └── registry.py # السجل + سلاسل البديل التلقائي -│ └── optimizers/ # MVO، تساوي التقلب، أقصى تنويع، تكافؤ المخاطر +│ └── 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/ # واجهة الويب (React 19 + Vite + TypeScript) +├── frontend/ # Web UI (React 19 + Vite + TypeScript) │ └── src/ -│ ├── pages/ # الرئيسية، الوكيل، تفاصيل التشغيل، المقارنة -│ ├── components/ # دردشة، رسوم بيانية، تخطيط -│ └── stores/ # إدارة حالة Zustand +│ ├── pages/ # Home, Agent, RunDetail, Compare +│ ├── components/ # chat, charts, layout +│ └── stores/ # Zustand state management │ -├── Dockerfile # بناء متعدد المراحل -├── docker-compose.yml # نشر بأمر واحد -├── pyproject.toml # إعدادات الحزمة + نقطة دخول CLI +├── Dockerfile # Multi-stage build +├── docker-compose.yml # One-command deploy +├── pyproject.toml # Package config + CLI entrypoint └── LICENSE # MIT ``` @@ -620,25 +753,25 @@ Vibe-Trading/ ## 🏛 النظام البيئي -Vibe-Trading هو جزء من النظام البيئي للوكلاء **[HKUDS](https://github.com/HKUDS)**: +Vibe-Trading جزء من نظام وكلاء **[HKUDS](https://github.com/HKUDS)**:
ClawTeam
- ذكاء سرب الوكلاء + Agent Swarm Intelligence 		NanoBot
- مساعد ذكاء اصطناعي شخصي فائق الخفة + Ultra-Lightweight Personal AI Assistant 		CLI-Anything
- جعل جميع البرامج أصلية للوكلاء + Making All Software Agent-Native 		OpenSpace
- مهارات وكلاء ذكاء اصطناعي ذاتية التطور + Self-Evolving AI Agent Skills
@@ -647,18 +780,18 @@ Vibe-Trading هو جزء من النظام البيئي للوكلاء **[HKUDS] ## 🗺 خارطة الطريق -> نشحن على مراحل. تنتقل العناصر إلى [المشكلات](https://github.com/HKUDS/Vibe-Trading/issues) عند بدء العمل. +> نشحن على مراحل. تنتقل العناصر إلى [Issues](https://github.com/HKUDS/Vibe-Trading/issues) عندما يبدأ العمل. | المرحلة | الميزة | الحالة | |-------|---------|--------| | **Research Autopilot** | حلقة بحث ليلية: فرضية → جلب بيانات → اختبار رجعي → تقرير أدلة | قيد التنفيذ | | **Data Bridge** | أحضر بياناتك: موصلات CSV/Parquet/SQL محلية مع schema mapping | مخطط | -| **Options Lab** | سطح تقلب، لوحة Greeks، ومستكشف العوائد/السيناريوهات | مخطط | -| **Portfolio Studio** | أشعة مخاطر، قيود، محسّن يراعي الدوران، وملاحظات إعادة التوازن | مخطط | -| **Alpha Zoo** | مكتبات عوامل Alpha101 / Alpha158 / Alpha191 مع فحص واختبارات IC | مخطط | +| **Options Lab** | سطح تقلب، ولوحة Greeks، ومستكشف payoff/scenario | مخطط | +| **Portfolio Studio** | أشعة مخاطر، وقيود، ومحسن يراعي الدوران، وملاحظات إعادة توازن | مخطط | +| **Alpha Zoo** | مكتبات عوامل Alpha101 / Alpha158 / Alpha191 مع فرز واختبارات IC | مخطط | | **Research Delivery** | موجزات مجدولة إلى Slack / Telegram / قنوات شبيهة بالبريد | مخطط | -| **Trust Layer** | بطاقات تشغيل قابلة للإعادة: أثر الأدوات، مصادر البيانات، الافتراضات، الاستشهادات | قيد التنفيذ | -| **Community** | skills وpresets وstrategy cards قابلة للمشاركة | قيد الاستكشاف | +| **Trust Layer** | بطاقات تشغيل قابلة لإعادة الإنتاج: أثر الأدوات، ومصادر البيانات، والافتراضات، والاستشهادات | قيد التنفيذ | +| **Community** | مهارات وإعدادات مسبقة وبطاقات استراتيجية قابلة للمشاركة | قيد الاستكشاف | --- @@ -666,9 +799,9 @@ Vibe-Trading هو جزء من النظام البيئي للوكلاء **[HKUDS] نرحب بالمساهمات! راجع [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) — اختر واحدة وابدأ. +**المشكلات الجيدة للمبتدئين** موسومة بـ [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) — اختر واحدة وابدأ. -ترغب في المساهمة بشيء أكبر؟ راجع [خارطة الطريق](#-خارطة-الطريق) أعلاه وافتح مشكلة للمناقشة قبل البدء. +هل تريد المساهمة بشيء أكبر؟ راجع [خارطة الطريق](#-خارطة-الطريق) أعلاه وافتح issue للنقاش قبل البدء. --- @@ -679,14 +812,14 @@ Vibe-Trading هو جزء من النظام البيئي للوكلاء **[HKUDS] مساهمو واعتمادات دورة v0.1.7 الأخيرة: - @GTC2080 / TaoMu — Web UI Settings وواجهات إعداد provider/data-source (#57) -- @BigNounce90 — تعزيز validation CLI لمسار backtest `run_dir` (#60) -- @shadowinlife — مهارة مرشح pre-ST لأسهم A (#63) +- @BigNounce90 — تعزيز validation CLI لمدخل `run_dir` في الاختبار الرجعي (#60) +- @shadowinlife — مهارة A-share pre-ST filter (#63) - @MB-Ndhlovu — لوحة خريطة الارتباط الحرارية وإصلاحات المراجعة (#64, #66) -- @ykykj — خيار OpenAI Codex OAuth provider (#65) +- @ykykj — خيار مزود OpenAI Codex OAuth (#65) - @RuifengFu — شريط حالة CLI التفاعلي وتحرير prompt (#69) -- @SiMinus — أمر swarm preset inspection (#73) -- @warren618 / Haozhe Wu — تعزيز الأمان، تكامل الإصدار، الوثائق، Docker، التغليف، وسير التطوير المحلي -- lemi9090 (S2W) — بحث أمني منسق، تحقق، ودعم الإفصاح +- @SiMinus — أمر فحص swarm preset (#73) +- @warren618 / Haozhe Wu — تعزيز الأمان، وتكامل الإصدار، والوثائق، وDocker، والتغليف، وسير التطوير المحلي +- lemi9090 (S2W) — بحث أمني منسق، وتحقق، ودعم الإفصاح @@ -696,7 +829,7 @@ Vibe-Trading هو جزء من النظام البيئي للوكلاء **[HKUDS] ## إخلاء المسؤولية -Vibe-Trading مخصص للبحث والمحاكاة والاختبار الرجعي فقط. وهو ليس نصيحة استثمارية ولا ينفذ صفقات حية. الأداء السابق لا يضمن النتائج المستقبلية. +Vibe-Trading مخصص للبحث والمحاكاة والاختبار الرجعي فقط. ليس نصيحة استثمارية ولا ينفذ صفقات حية. الأداء السابق لا يضمن النتائج المستقبلية. ## الرخصة @@ -711,8 +844,8 @@ Vibe-Trading مخصص للبحث والمحاكاة والاختبار الرج ---

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

- الزوار + visitors

diff --git a/README_ja.md b/README_ja.md index 145e5793..6b2c8910 100644 --- a/README_ja.md +++ b/README_ja.md @@ -6,10 +6,10 @@ Vibe-Trading Logo

-

Vibe-Trading: あなたのパーソナルトレーディングエージェント

+

Vibe-Trading: あなた専用のトレーディングエージェント

- たった1コマンドで、包括的なトレーディング機能を備えたエージェントを起動 + 1つのコマンドで、包括的なトレーディング能力をエージェントに付与

@@ -19,28 +19,21 @@ PyPI License
- Skills - Swarm - Tools - Data Sources -
Feishu WeChat Discord

+ ニュース  ·  機能  ·  + Shadow Account  ·  デモ  ·  - 概要  ·  - 始め方  ·  - CLI  ·  - API  ·  - MCP  ·  - 構成  ·  + クイックスタート  ·  + 例  ·  + API / MCP  ·  ロードマップ  ·  - 貢献  ·  - コントリビューター + Contributing

@@ -51,117 +44,174 @@ ## 📰 ニュース -- **2026-05-14** 🧠 **永続メモリ CLI**: `vibe-trading memory list/show/search/forget` を追加し、`~/.vibe-trading/memory/` を手で開かなくても永続メモリを確認・検索・削除できるようにしました。non-memory CLI の起動速度を落とさないよう lazy imports を維持し、memory frontmatter の走査では解析されたメタデータ値を文字列へ戻すことで、Rich rendering や recall scoring の境界ケースを堅牢化しました（[#102](https://github.com/HKUDS/Vibe-Trading/pull/102)、@Teerapat-Vatpitak に感謝）。 -- **2026-05-13** 🧭 **Real-price swarm grounding + worker event hygiene**: Swarm run は analyst 起動前に市場データを pre-fetch し、実価格で worker prompt を grounding します。銘柄 lookup は `_detect_market(code)` 経由に統一され、grounding payload の thread-safe な受け渡しも強化されました（[#93](https://github.com/HKUDS/Vibe-Trading/pull/93)）。Worker report は許可済み swarm-run パスに永続化され、`report.md` summary extraction、長めの preset timeout、redacted/sanitized event previews により、streaming updates がよりクリーンになりました（[#84](https://github.com/HKUDS/Vibe-Trading/pull/84)）。 -- **2026-05-12** 🧾 **Trust Layer run cards**: バックテストは artifacts と並んで再現可能な `run_card.json` と `run_card.md` を出力するようになりました。config と戦略コードの hash、データソース、scalar metrics、validation payload、warnings、artifact checksum を記録します。Backtest ツールも run-card のパスを返すため、CLI/API から evidence package を直接表示できます。 +- **2026-05-14** 🧠 永続メモリを CLI から `vibe-trading memory list/show/search/forget` で確認できるようになりました（[#102](https://github.com/HKUDS/Vibe-Trading/pull/102)、@Teerapat-Vatpitak に感謝）。 +- **2026-05-13** 🧭 Swarm 実行では、取得済みの市場データでワーカーを grounding し、永続化レポートもより整理されました（[#93](https://github.com/HKUDS/Vibe-Trading/pull/93)、[#84](https://github.com/HKUDS/Vibe-Trading/pull/84)）。 +- **2026-05-12** 🧾 バックテストは、再現可能なリサーチ実行のために artifacts と並んで `run_card.json` と `run_card.md` を出力するようになりました。

過去のニュース -- **2026-05-11** 🧭 **Memory slug、swarm集計、CLIプリフライト**: 永続メモリのファイル slug 生成で CJK 文字を保持するようになり、中国語/日本語/韓国語ノートの静かなファイル名衝突を防ぎます（[#95](https://github.com/HKUDS/Vibe-Trading/pull/95)、@voidborne-d に感謝）。Swarm run の合計は provider が返す token usage を優先し、従来の推定フォールバックも維持します（[#94](https://github.com/HKUDS/Vibe-Trading/pull/94)、@Teerapat-Vatpitak に感謝）。CLI run UI には一般的な環境問題を早めに見つける起動時プリフライトチェックも入りました（[#96](https://github.com/HKUDS/Vibe-Trading/pull/96)、@ykykj に感謝）。 -- **2026-05-10** 🧱 **回帰ガードレール + runメタデータ**: Memory recall はアンダースコアを token 境界として扱うようになり、`mcp_wiring_test` のような snake_case の保存メモリが "mcp wiring" のような自然言語クエリに一致します（[#87](https://github.com/HKUDS/Vibe-Trading/pull/87)、@hp083625 に感謝）。MCP server には initialize → `tools/list` → `tools/call` を通す subprocess smoke test を追加し、初回呼び出し deadlock 経路の回帰を防ぎます（[#86](https://github.com/HKUDS/Vibe-Trading/pull/86)）。さらに Windows のパス依存テスト互換、API の best-effort 例外処理の絞り込み、backtest `run_dir` の allowed-root 検証、SwarmRun の provider/model メタデータという低リスク強化も入りました（[#88](https://github.com/HKUDS/Vibe-Trading/pull/88)、[#90](https://github.com/HKUDS/Vibe-Trading/pull/90)、[#91](https://github.com/HKUDS/Vibe-Trading/pull/91)、[#92](https://github.com/HKUDS/Vibe-Trading/pull/92)、@Teerapat-Vatpitak に感謝）。 -- **2026-05-09** 🛡️ **APIパス強化 + MCP server安定化**: API の run/session ルートは参照前にパスIDを検証し、改行を含む不正なパラメータを拒否し、その挙動を auth/security 回帰テストで固定しました（[#80](https://github.com/HKUDS/Vibe-Trading/pull/80)、@SJoon99 に感謝）。MCP server は `tools/call` を処理する前にメインスレッドでツールレジストリを事前ウォームアップし、lazy tool discovery の初回呼び出しデッドロックを回避します（[#85](https://github.com/HKUDS/Vibe-Trading/pull/85)、@Teerapat-Vatpitak に感謝）。Vite dev proxy も `VITE_API_URL` を尊重し、非デフォルトのバックエンドターゲットを使えるようになりました（[#82](https://github.com/HKUDS/Vibe-Trading/pull/82)、@voidborne-d に感謝）。 -- **2026-05-08** 🧾 **Tushare財務諸表フィールドをフィルターへ**: A株の日次バックテストで `fundamental_fields` から point-in-time 安全な財務諸表フィールドを要求できるようになり、SignalEngine は公告/開示日以降に `income_total_revenue`、`income_n_income`、`balancesheet_total_hldr_eqy_exc_min_int`、`fina_indicator_roe` など表名プレフィックス付き列でスクリーニングできます（[#76](https://github.com/HKUDS/Vibe-Trading/pull/76)、@mrbob-git に感謝）。後続の強化により、明示的な財務諸表フィールド要求で Tushare enrichment が失敗した場合は、価格バーだけに静かに戻るのではなく即時失敗します（[#77](https://github.com/HKUDS/Vibe-Trading/pull/77)）。 -- **2026-05-07** 📈 **Tushare fundamentals + コミュニティ整理**: ファンダメンタル調査ワークフロー向けに、時点ベースの `TushareFundamentalProvider` 契約を追加し、プロジェクトの `TUSHARE_TOKEN` 環境変数パスを回帰テストでカバーしました（[#74](https://github.com/HKUDS/Vibe-Trading/pull/74)）。コミュニティ整理では、迅速な反復のため当面 UI は単一言語に集中すること、DuckDuckGo ベースの `web_search` が既に同梱されているため重複する検索依存は追加しないこと、非公式ホスト先は API key やデータソース token を入力する信頼済み入口として扱わないことも明確にしました。 -- **2026-05-06** 🚀 **v0.1.7 リリース**（[Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7)、`pip install -U vibe-trading-ai`）: セキュリティ境界強化版を PyPI と ClawHub に公開しました。API/読み取り/アップロード/ファイル/URL/生成コード/shell ツール/Docker の既定境界をより安全にしつつ、localhost の CLI/Web UI ワークフローは低摩擦のままです。このサイクルには Web UI Settings、相関ヒートマップ、OpenAI Codex OAuth、A株 pre-ST フィルター、対話型 CLI UX、swarm preset inspection、配当分析、開発ワークフロー改善、フロントエンド build dependency の安全下限更新も含まれます。0.1.7 のコントリビューターと、協調的なセキュリティ検証を行った lemi9090 (S2W) に感謝します。 -- **2026-05-05** 🛡️ **セキュリティ境界の追加強化**: 明示的な CORS origin、Settings の認証情報ステータス表示、Web URL 読み取り、Shadow Account コード生成まわりの残りのセキュリティ境界を補強し、それぞれに回帰テストを追加しました。localhost の CLI/Web UI ワークフローは従来どおりです。リモートデプロイでは引き続き `API_AUTH_KEY` と明示的な信頼済み origin を設定してください。 -- **2026-05-04** 🖥️ **インタラクティブCLI UX + CI整理**: インタラクティブモードに、provider/model、セッション時間、直近実行時間、累計ツール呼び出し統計を表示するライブ下部ステータスバーを追加。さらに `prompt_toolkit` により上下キーの履歴移動と左右キーのカーソル編集に対応しました（[#69](https://github.com/HKUDS/Vibe-Trading/pull/69)）。`prompt_toolkit` またはTTYが利用できない場合は、従来どおりRich promptにフォールバックします。CIのパス期待値も強化済みファイルimportサンドボックスとクロスプラットフォームな `/tmp` 解決に合わせ、mainはグリーンに戻りました（[`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)）。 -- **2026-05-03** 🛡️ **セキュリティハードニングパッチ**: 非ローカルデプロイ向けの既定API認証を強化し、機密性の高いrun/session/swarm読み取りを保護、アップロードとローカルファイル読み取り境界を制限、shell系ツールをエントリーポイント別に制御、生成戦略をimport前に検証し、Dockerイメージは既定で非rootユーザーかつlocalhost限定ポート公開で動作します。CLIとlocalhost Web UIは低摩擦のままです。リモートAPI/Webデプロイでは`API_AUTH_KEY`を設定してください。 -- **2026-05-02** 🧭 **配当分析 + ロードマップ刷新**: インカム株、配当の持続性、増配、株主還元利回り、権利落ちメカニクス、利回りの罠チェックに対応する `dividend-analysis` スキルを追加し、バンドルスキル回帰テストで固定しました。公開ロードマップは Research Autopilot、Data Bridge、Options Lab、Portfolio Studio、Alpha Zoo、Research Delivery、Trust Layer、Community 共有に絞りました。 -- **2026-05-01** 🔥 **相関ヒートマップ + OpenAI Codex OAuth + A株 pre-ST フィルター**: 新しい相関ダッシュボード/APIでローリングリターン相関を計算し、ポートフォリオや銘柄分析向けに ECharts ヒートマップで可視化します（[#64](https://github.com/HKUDS/Vibe-Trading/pull/64)）。OpenAI Codex provider は `vibe-trading provider login openai-codex` による ChatGPT OAuth に対応し、Settings メタデータとアダプター回帰テストも追加（[#65](https://github.com/HKUDS/Vibe-Trading/pull/65)）。A株の ST/*ST リスクスクリーニング用 `ashare-pre-st-filter` スキルを追加・強化し、Sina 処分公告の関連性フィルターにより証券口座リスト内の言及が E2 回数を水増ししないようにしました（[#63](https://github.com/HKUDS/Vibe-Trading/pull/63)）。 -- **2026-04-30** ⚙️ **Web UI設定 + validation CLI強化**: LLM provider/model、Base URL、reasoning effort、データソース認証情報をローカルで設定できる Settings ページを追加。settings API は local/auth で保護され、provider メタデータもデータ駆動設定に移行（[#57](https://github.com/HKUDS/Vibe-Trading/pull/57)）。さらに `python -m backtest.validation ` を強化し、引数なし・空パス・不正パス・存在しないパス・ディレクトリでないパスを検証開始前に分かりやすく失敗させます（[#60](https://github.com/HKUDS/Vibe-Trading/pull/60)）。 -- **2026-04-28** 🚀 **v0.1.6 リリース**（`pip install -U vibe-trading-ai`）: `pip install` / `uv tool install` 後に `vibe-trading --swarm-presets` が空を返す問題を修正（[#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` を 1MB チャンクのストリーミングに変更し、`MAX_UPLOAD_SIZE` を超えた時点で中断 + 部分ファイルをクリーンアップ。50MB 上限が悪意/巨大リクエスト下でも実効化（[#53](https://github.com/HKUDS/Vibe-Trading/pull/53)）—— 4 件の回帰テストでピン留め。 -- **2026-04-22** 🛡️ **ハードニング + 新規連携**: `safe_path` でパス封じ込めを強制 + 取引明細/シャドウアカウント系ツールをサンドボックス化、`MANIFEST.in` を追加して sdist に `.env.example` / テスト / Docker ファイルを同梱、フロントエンドのルート単位遅延ロードで初期バンドル 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` をアクティブな run ディレクトリに正規化（[#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 下限バンプ、新規 MCP ツール5つ接続（`analyze_trade_journal` + シャドウアカウント系4つ）、`pattern_recognition` → `pattern` レジストリ名の不一致を修正、Docker 依存を本体に合わせる、SKILL マニフェスト同期（22 MCP ツール / 71 スキル）。 -- **2026-04-18** 👥 **シャドウアカウント Shadow Account**: ブローカーの取引明細から自分の戦略ルールを抽出 → マーケット横断でシャドウをバックテスト → 8セクションのHTML/PDFレポートが、どこでいくら取りこぼしたか（ルール違反・早すぎる利確・見逃したシグナル・逆張り）を正確に可視化。新規ツール4つ、新スキル1つ、合計32ツール。Trade Journal / Shadow Accountのサンプル例文がWeb UIウェルカム画面に追加。 -- **2026-04-17** 📊 **取引明細アナライザー + ユニバーサルファイルリーダー**: ブローカーの取引明細（同花順/東方財富/富途/汎用CSV）をアップロード → 取引プロフィール（保有日数、勝率、損益比、最大ドローダウン）+ 4つの行動バイアス診断（処分効果、過剰取引、追随買い、アンカリング）を自動生成。`read_document`はPDF、Word、Excel、PowerPoint、画像（OCR）、40+テキスト形式を1回の呼び出しで統一処理。 -- **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)）、MiniMax temperature修正+モデル更新（[#33](https://github.com/HKUDS/Vibe-Trading/pull/33)）。13プロバイダー対応。 -- **2026-04-14** 🔧 **MCP安定性**: バックテストツールのstdioトランスポートにおける`Connection closed`エラーを修正（[#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**: `vibe-trading init` .envブートストラップ（[#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)）、`web_search` MCPツール、12 LLMプロバイダー、`akshare`/`ccxt`依存追加。PyPIとClawHubに公開。 -- **2026-04-09** 📊 **Backtest Wave 2**: ChinaFutures、GlobalFutures、Forex、Options v2エンジン追加。モンテカルロ、Bootstrap CI、ウォークフォワード検証。 -- **2026-04-08** 🔧 **マルチマーケットバックテスト**: 市場別ルール、Pine Script v6エクスポート、自動フォールバック付き5データソース。 +- **2026-05-11** 🧭 **メモリ slug、swarm 集計、CLI プリフライト**: 永続メモリのファイル slug 生成で CJK 文字を保持するようになり、中国語/日本語/韓国語ノートの静かなファイル名衝突を防ぎます（[#95](https://github.com/HKUDS/Vibe-Trading/pull/95)、@voidborne-d に感謝）。Swarm run の合計は provider が返す token usage を優先し、従来の推定フォールバックも維持します（[#94](https://github.com/HKUDS/Vibe-Trading/pull/94)、@Teerapat-Vatpitak に感謝）。CLI run UI には一般的な環境問題を早めに見つける起動時プリフライトチェックも入りました（[#96](https://github.com/HKUDS/Vibe-Trading/pull/96)、@ykykj に感謝）。 +- **2026-05-10** 🧱 **回帰ガードレール + run メタデータ**: Memory recall はアンダースコアを token 境界として扱うようになり、`mcp_wiring_test` のような snake_case の保存メモリが "mcp wiring" のような自然言語クエリに一致します（[#87](https://github.com/HKUDS/Vibe-Trading/pull/87)、@hp083625 に感謝）。MCP server には initialize → `tools/list` → `tools/call` を通す subprocess smoke test を追加し、初回呼び出し deadlock 経路の回帰を防ぎます（[#86](https://github.com/HKUDS/Vibe-Trading/pull/86)）。さらに Windows のパス依存テスト、API の best-effort 例外処理、backtest `run_dir` allowed-root 検証、SwarmRun provider/model メタデータの低リスク強化も入りました（[#88](https://github.com/HKUDS/Vibe-Trading/pull/88)、[#90](https://github.com/HKUDS/Vibe-Trading/pull/90)、[#91](https://github.com/HKUDS/Vibe-Trading/pull/91)、[#92](https://github.com/HKUDS/Vibe-Trading/pull/92)、@Teerapat-Vatpitak に感謝）。 +- **2026-05-09** 🛡️ **API パス強化 + MCP server 安定化**: API の run/session ルートは参照前にパス ID を検証し、改行を含む不正なパラメータを拒否し、その挙動を auth/security 回帰テストで固定しました（[#80](https://github.com/HKUDS/Vibe-Trading/pull/80)、@SJoon99 に感謝）。MCP server は `tools/call` を処理する前にメインスレッドでツールレジストリを事前ウォームアップし、lazy tool discovery の初回呼び出しデッドロックを回避します（[#85](https://github.com/HKUDS/Vibe-Trading/pull/85)、@Teerapat-Vatpitak に感謝）。Vite dev proxy も `VITE_API_URL` を尊重し、非デフォルトのバックエンドターゲットを使えるようになりました（[#82](https://github.com/HKUDS/Vibe-Trading/pull/82)、@voidborne-d に感謝）。 +- **2026-05-08** 🧾 **Tushare 財務諸表フィールドをフィルターへ**: A 株の日次バックテストで `fundamental_fields` から PIT-safe な財務諸表フィールドを要求できるようになり、signal engine は公告/開示日以降に `income_total_revenue`、`income_n_income`、`balancesheet_total_hldr_eqy_exc_min_int`、`fina_indicator_roe` など表名プレフィックス付き列でスクリーニングできます（[#76](https://github.com/HKUDS/Vibe-Trading/pull/76)、@mrbob-git に感謝）。後続の強化により、明示的な財務諸表フィールド要求で Tushare enrichment が失敗した場合は、価格バーだけに静かに戻るのではなく即時失敗します（[#77](https://github.com/HKUDS/Vibe-Trading/pull/77)）。 +- **2026-05-07** 📈 **Tushare fundamentals + コミュニティ整理**: ファンダメンタル調査ワークフロー向けに point-in-time の `TushareFundamentalProvider` 契約を追加し、プロジェクトの `TUSHARE_TOKEN` 環境変数パスを回帰テストでカバーしました（[#74](https://github.com/HKUDS/Vibe-Trading/pull/74)）。コミュニティ整理では、Vibe-Trading は当面 UI を単一言語に絞って高速反復すること、DuckDuckGo ベースの `web_search` が既に同梱されているため重複する検索依存を追加しないこと、非公式ホスト先は API key やデータソース token を入力する信頼済み場所として扱わないことも明確にしました。 +- **2026-05-06** 🚀 **v0.1.7 リリース**（[Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7)、`pip install -U vibe-trading-ai`）: セキュリティ境界強化版を PyPI と ClawHub に公開しました。API/読み取り/アップロード/ファイル/URL/生成コード/shell ツール/Docker の既定境界をより安全にしつつ、localhost の CLI/Web UI ワークフローは低摩擦のままです。このサイクルには Web UI Settings、相関ヒートマップ、OpenAI Codex OAuth、A 株 pre-ST フィルター、対話型 CLI UX、swarm preset inspection、配当分析、開発ワークフロー改善、frontend build-dependency floor の監査も含まれます。0.1.7 のコントリビューターと、協調的なセキュリティ検証を行った lemi9090 (S2W) に感謝します。 +- **2026-05-05** 🛡️ **セキュリティ境界の追加強化**: 明示的な CORS origins、Settings の認証情報表示、Web URL 読み取り、Shadow Account コード生成まわりの残りのセキュリティ境界を補強し、それぞれに回帰テストを追加しました。通常の localhost CLI/Web UI ワークフローは従来どおりです。リモートデプロイでは引き続き `API_AUTH_KEY` と明示的な信頼済み origins を設定してください。 +- **2026-05-04** 🖥️ **インタラクティブ CLI UX + CI 整理**: インタラクティブモードに、provider/model、セッション時間、直近実行時間、累計ツール呼び出し統計を表示するライブ下部ステータスバーを追加。さらに `prompt_toolkit` により上下キーの履歴移動と左右キーのカーソル編集に対応しました（[#69](https://github.com/HKUDS/Vibe-Trading/pull/69)）。`prompt_toolkit` または TTY が利用できない場合は、従来どおり Rich prompt にフォールバックします。CI のパス期待値も強化済みファイル import サンドボックスとクロスプラットフォームな `/tmp` 解決に合わせ、main はグリーンに戻りました（[`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)）。 +- **2026-05-03** 🛡️ **セキュリティハードニングパッチ**: 非ローカルデプロイ向けの既定 API 認証を強化し、機密性の高い run/session/swarm 読み取りを保護、アップロードとローカルファイル読み取り境界を制限、shell 系ツールをエントリーポイント別に制御、生成戦略を import 前に検証し、Docker イメージは既定で非 root ユーザーかつ localhost 限定ポート公開で動作します。ローカル CLI と localhost Web UI は低摩擦のままです。リモート API/Web デプロイでは `API_AUTH_KEY` を設定してください。 +- **2026-05-02** 🧭 **配当分析 + ロードマップ刷新**: インカム株、配当の持続性、増配、株主還元利回り、権利落ちメカニクス、利回りの罠チェックに対応する `dividend-analysis` skill を追加し、bundled-skill 回帰テストで固定しました。公開ロードマップは Research Autopilot、Data Bridge、Options Lab、Portfolio Studio、Alpha Zoo、Research Delivery、Trust Layer、Community 共有に絞りました。 +- **2026-05-01** 🔥 **相関ヒートマップ + OpenAI Codex OAuth + A 株 pre-ST フィルター**: 新しい相関ダッシュボード/APIでローリングリターン相関を計算し、ポートフォリオや銘柄分析向けに ECharts ヒートマップで可視化します（[#64](https://github.com/HKUDS/Vibe-Trading/pull/64)）。OpenAI Codex provider は `vibe-trading provider login openai-codex` による ChatGPT OAuth に対応し、Settings メタデータとアダプター回帰テストも追加（[#65](https://github.com/HKUDS/Vibe-Trading/pull/65)）。A 株の ST/*ST リスクスクリーニング用 `ashare-pre-st-filter` skill を追加・強化し、Sina 処分公告の関連性フィルターにより証券口座リスト内の言及が E2 回数を水増ししないようにしました（[#63](https://github.com/HKUDS/Vibe-Trading/pull/63)）。 +- **2026-04-30** ⚙️ **Web UI Settings + validation CLI 強化**: LLM provider/model、Base URL、reasoning effort、データソース認証情報をローカルで設定できる Settings ページを追加。settings API は local/auth で保護され、provider メタデータもデータ駆動設定に移行しました（[#57](https://github.com/HKUDS/Vibe-Trading/pull/57)）。さらに `python -m backtest.validation ` を強化し、引数なし・空パス・不正パス・存在しないパス・ディレクトリでないパスを検証開始前に分かりやすく失敗させます（[#60](https://github.com/HKUDS/Vibe-Trading/pull/60)）。 +- **2026-04-28** 🚀 **v0.1.6 リリース**（`pip install -U vibe-trading-ai`）: `pip install` / `uv tool install` 後に `vibe-trading --swarm-presets` が空を返す問題を修正（[#55](https://github.com/HKUDS/Vibe-Trading/issues/55)）。プリセット YAML は `src.swarm` パッケージ内に同梱され、6 件の回帰テストで固定されています。加えて AKShare loader が ETF（`510300.SH`）と forex（`USDCNH`）を正しい endpoint にルーティングし、registry fallback も強化しました。v0.1.5 以降の更新を集約: benchmark comparison panel、`/upload` streaming + size limits、Futu loader（HK + A 株）、vnpy export skill、security hardening、frontend lazy loading（688KB → 262KB）。 +- **2026-04-27** 📊 **ベンチマーク比較パネル + アップロード安全性**: バックテスト出力に benchmark comparison panel（ticker / benchmark return / excess return / information ratio）を追加し、yfinance 経由で SPY、CSI 300 などを解決します（[#48](https://github.com/HKUDS/Vibe-Trading/issues/48)）。加えて `/upload` は request body を 1 MB chunks で stream し、`MAX_UPLOAD_SIZE` 超過時に中断するため、過大/不正な client の下でもメモリを抑えます（[#53](https://github.com/HKUDS/Vibe-Trading/pull/53)）。4 ケースの回帰テストで固定されています。 +- **2026-04-22** 🛡️ **ハードニング + 新規連携**: `safe_path` でパス封じ込めを強制し、journal/shadow tool sandbox、`MANIFEST.in` による `.env.example` / tests / Docker files の sdist 同梱、route-level lazy loading による frontend 初期 bundle 688KB → 262KB を実施。さらに Futu data loader for HK & A-share equities（[#47](https://github.com/HKUDS/Vibe-Trading/pull/47)）と vnpy CtaTemplate export skill（[#46](https://github.com/HKUDS/Vibe-Trading/pull/46)）も追加しました。 +- **2026-04-21** 🛡️ **Workspace + docs**: 相対 `run_dir` を active run dir に正規化しました（[#43](https://github.com/HKUDS/Vibe-Trading/pull/43)）。README usage examples も追加しました（[#45](https://github.com/HKUDS/Vibe-Trading/pull/45)）。 +- **2026-04-20** 🔌 **Reasoning + Swarm**: `reasoning_content` をすべての `ChatOpenAI` path で保持し、Kimi / DeepSeek / Qwen thinking が end-to-end で動作します（[#39](https://github.com/HKUDS/Vibe-Trading/issues/39)）。Swarm streaming と clean Ctrl+C も入りました（[#42](https://github.com/HKUDS/Vibe-Trading/issues/42)）。 +- **2026-04-19** 📦 **v0.1.5**: PyPI と ClawHub に公開。`python-multipart` CVE floor bump、新規 MCP tools 5 つ接続（`analyze_trade_journal` + shadow-account tools 4 つ）、`pattern_recognition` → `pattern` registry fix、Docker dep parity、SKILL manifest sync（22 MCP tools / 71 skills）。 +- **2026-04-18** 👥 **Shadow Account**: broker journal から strategy rules を抽出 → market 横断で shadow を backtest → 8-section HTML/PDF report で取りこぼし（rule violations、early exits、missed signals、counterfactual trades）を正確に可視化。新規 tools 4 つ、skill 1 つ、合計 32 tools。Trade Journal + Shadow Account samples も Web UI welcome screen に追加されました。 +- **2026-04-17** 📊 **Trade Journal Analyzer + Universal File Reader**: broker exports（同花順/東財/富途/generic CSV）を upload → auto trading profile（holding days、win rate、PnL ratio、drawdown）+ 4 bias diagnostics（disposition effect、overtrading、chasing momentum、anchoring）。`read_document` は PDF、Word、Excel、PowerPoint、images（OCR）、40+ text formats を 1 つの unified call に dispatch します。 +- **2026-04-16** 🧠 **Agent Harness**: Persistent cross-session memory、FTS5 session search、self-evolving skills（full CRUD）、5-layer context compression、read/write tool batching。27 tools、107 new tests。 +- **2026-04-15** 🤖 **Z.ai + MiniMax**: Z.ai provider（[#35](https://github.com/HKUDS/Vibe-Trading/pull/35)）、MiniMax temperature fix + model update（[#33](https://github.com/HKUDS/Vibe-Trading/pull/33)）。13 providers。 +- **2026-04-14** 🔧 **MCP Stability**: stdio transport 上の backtest tool `Connection closed` error を修正しました（[#32](https://github.com/HKUDS/Vibe-Trading/pull/32)）。 +- **2026-04-13** 🌐 **Cross-Market Composite Backtest**: 新しい `CompositeEngine` が mixed-market portfolios（例: A-shares + crypto）を shared capital pool と per-market rules で backtest します。swarm template variable fallback と frontend timeout も修正しました。 +- **2026-04-12** 🌍 **Multi-Platform Export**: `/pine` が strategies を TradingView（Pine Script v6）、TDX（通达信/同花顺/东方财富）、MetaTrader 5（MQL5）へ 1 コマンドで export します。 +- **2026-04-11** 🛡️ **Reliability & DX**: `vibe-trading init` .env bootstrap（[#19](https://github.com/HKUDS/Vibe-Trading/pull/19)）、preflight checks、runtime data-source fallback、hardened backtest engine。Multi-language README（[#21](https://github.com/HKUDS/Vibe-Trading/pull/21)）。 +- **2026-04-10** 📦 **v0.1.4**: Docker fix（[#8](https://github.com/HKUDS/Vibe-Trading/issues/8)）、`web_search` MCP tool、12 LLM providers、`akshare`/`ccxt` deps。PyPI と ClawHub に公開。 +- **2026-04-09** 📊 **Backtest Wave 2**: ChinaFutures、GlobalFutures、Forex、Options v2 engines。Monte Carlo、Bootstrap CI、Walk-Forward validation。 +- **2026-04-08** 🔧 **Multi-market backtest** with per-market rules、Pine Script v6 export、5 data sources with auto-fallback。
--- -## 💡 Vibe-Tradingとは？ - -Vibe-Tradingは、自然言語リクエストをグローバル市場向けの実行可能なトレーディング戦略、リサーチ洞察、ポートフォリオ分析へと変換する、AI駆動のマルチエージェント金融ワークスペースです。 - -### 主な能力: -• **自然言語 → 戦略** — アイデアを記述するだけ、エージェントがコードの作成・テスト・エクスポートを実行
-• **6データソース、ゼロ設定** — A株、HK/US、暗号、先物、FX対応、自動フォールバック
-• **29の専門チーム** — 投資・トレーディング・リスク向けマルチエージェントスウォームワークフロー
-• **クロスセッションメモリ** — ユーザーの好みやインサイトを記憶し、再利用可能なスキルを自動生成・進化
-• **7つのバックテストエンジン** — クロスマーケット複合テスト + 統計検証 + 4種オプティマイザー
-• **マルチプラットフォームエクスポート** — ワンクリックでTradingView、TDX、MetaTrader 5へ - ---- - ## ✨ 主な機能 - +
+
- - - + + -
- Research
-

🔍 トレーディング向けDeepResearch

- Skills

-
- • 74の専門スキル + クロスセッション永続メモリ
- • 自己進化: エージェントが経験からワークフローを構築・改善
- • 5層コンテキスト圧縮 — 長い会話でも情報損失なし
- • 全金融ドメインにわたる自然言語タスクルーティング +
+ Self-improving trading agent
+

🔍 自己改善型トレーディングエージェント

+
+ • 自然言語による市場リサーチ
+ • 戦略ドラフトとファイル/Web 分析
+ • メモリに支えられたワークフロー
- Swarm
-

🐝 スウォームインテリジェンス

- Swarm

+ 		+ Multi-agent trading teams
+

🐝 マルチエージェント・トレーディングチーム

- • 即戦力の29種トレーディングチームプリセット
- • DAGベースのマルチエージェントオーケストレーション
- • リアルタイムストリーミングダッシュボード（エージェントステータス表示）
- • FTS5クロスセッション検索で過去の全会話を横断検索 + • 投資、クオンツ、暗号資産、リスクの各チーム
+ • 進捗ストリーミングと永続化レポート
+ • 取得済み市場データで grounding されたワーカー
- Backtest
-

📊 クロスマーケットバックテスト

- Backtest

+
+ Cross-market data and backtesting
+

📊 クロスマーケットデータ & バックテスト

- • A株、HK/US株式、暗号資産、先物、FXに対応
- • 7つの市場エンジン + クロスマーケット複合エンジン（共有資金プール）
- • 統計的検証: モンテカルロ、ブートストラップCI、ウォークフォワード
- • 15以上のパフォーマンス指標と4種類のオプティマイザー + • A/HK/US 株式、暗号資産、先物、FX
+ • データフォールバックと複合バックテスト
+ • PIT データ、検証、run cards
- Quant
-

🧮 クオンツ分析ツールキット

- Quant

+ 		+ Shadow Account
+

👥 Shadow Account

- • ファクターIC/IR分析と分位バックテスト
- • ブラック–ショールズ価格と完全なギリシャ計算
- • テクニカルパターンの認識と検出
- • MVO/リスクパリティ/BLによるポートフォリオ最適化 + • ブローカー取引日誌の行動診断
+ • ルールベースの Shadow Account 比較
+ • エクスポート可能な監査レポートと戦略コード
+ -## 8カテゴリにわたる74スキル +## 💡 Vibe-Trading とは？ -- 📊 74の金融特化スキルを8カテゴリに整理 -- 🌐 伝統的市場から暗号・DeFiまで完全カバー -- 🔬 データ取得からクオンツリサーチまでの包括的能力 +Vibe-Trading は、金融に関する問いを実行可能な分析へ変換するためのオープンソースのリサーチワークスペースです。自然言語プロンプトを、市場データ loader、戦略生成、バックテストエンジン、レポート、エクスポート、永続リサーチメモリへ接続します。 + +研究、シミュレーション、バックテストのために設計されています。ライブ取引は実行しません。 + +--- + +## ✨ できること + +| タスク | 出力 | +|------|--------| +| **トレーディングの問いを投げる** | ツール、データ、ドキュメント、再利用可能なセッション文脈を使った市場リサーチ。 | +| **戦略アイデアをバックテストする** | 戦略コード、指標、ベンチマーク文脈、検証 artifacts、run cards。 | +| **自分の取引をレビューする** | ブローカー取引日誌の解析、行動診断、ルール抽出、Shadow Account 比較。 | +| **反復リサーチを改善する** | 永続メモリと編集可能な skills により、有用な手順を再利用可能なワークフローへ変換。 | +| **アナリストチームを走らせる** | 投資、クオンツ、暗号資産、マクロ、リスクのワークフロー向けマルチエージェント・リサーチレビュー。 | +| **使える artifacts を出力する** | レポート、TradingView Pine Script、TDX、MetaTrader 5、MCP tools、後続リサーチセッション。 | + +--- + +## ⚡ クイック例 + +```bash +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" +``` + +```bash +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 + +Shadow Account は、汎用的な戦略テンプレートではなく、あなた自身の取引記録から始めます。 + +ブローカー export をアップロードし、エージェントに行動を要約させたうえで、実際の取引経路をルールベースの shadow strategy と比較します。 + +| ステップ | エージェントの出力 | +|------|--------------| +| **1. 取引日誌を読む** | 同花順、东方财富、富途、generic CSV 形式のブローカー export を解析します。 | +| **2. 行動をプロファイルする** | 保有日数、勝率、PnL ratio、drawdown、disposition effect、overtrading、momentum chasing、anchoring checks。 | +| **3. ルールを抽出する** | 繰り返し現れる entries/exits を、曖昧な要約ではなく明示的な strategy profile に変換します。 | +| **4. shadow を実行する** | 抽出したルールをバックテストし、rule breaks、early exits、missed signals、alternative trade paths を強調します。 | +| **5. レポートを届ける** | 後から確認、アーカイブ、または次回セッションで改善できる HTML/PDF report を生成します。 | + +```bash +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" +``` + +--- + +## 🧪 リサーチワークフロー + +多くの実行は、同じ evidence path をたどります。リクエストを routing し、適切な市場文脈を読み込み、ツールを実行し、出力を検証し、artifacts を確認可能な形で残します。 + +| レイヤー | 何が起きるか | +|-------|--------------| +| **Plan** | 必要な finance skills、tools、data sources、必要に応じて swarm preset を選びます。 | +| **Ground** | A 株、HK/US 株式、暗号資産、先物、FX、documents、Web context を利用可能な loaders から取得します。 | +| **Execute** | テスト可能な strategy code を生成し、tools を実行し、対応する backtest engine または analysis workflow を使います。 | +| **Validate** | metrics、benchmark comparison、Monte Carlo、Bootstrap、Walk-Forward、run cards、必要な warnings を追加します。 | +| **Deliver** | TradingView、TDX、MetaTrader 5、MCP clients、後続セッション向けの reports、artifacts、tool traces、exports を返します。 | + +--- + +## 🔩 詳細な機能 + +メイン README を読みやすく保つため、詳細な一覧は以下に折りたたんでいます。利用できる構成要素を確認したいときに開いてください。 + +
+Finance Skill Library 8カテゴリにわたる74 skills + +- 📊 74 の金融特化 skills を 8 カテゴリに整理 +- 🌐 伝統的市場から crypto & DeFi まで完全カバー +- 🔬 データ取得からクオンツリサーチまでを横断する包括的能力 | Category | Skills | Examples | |----------|--------|----------| @@ -174,27 +224,34 @@ Vibe-Tradingは、自然言語リクエストをグローバル市場向けの | Tool | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export` | | Risk Analysis | 1 | `ashare-pre-st-filter` | -## 29種のエージェントスウォームチームプリセット +
-- 🏢 即利用できる29種のエージェントチーム -- ⚡ 事前構成された金融ワークフロー -- 🎯 投資・トレーディング・リスク管理のプリセット +
+Preset Trading Teams 29 swarm presets + +- 🏢 すぐ使える 29 の agent teams +- ⚡ 事前構成済みの finance workflows +- 🎯 投資、トレーディング、リスク管理向け presets | Preset | Workflow | |--------|----------| -| `investment_committee` | 強気/弱気ディベート → リスクレビュー → PM最終判断 | -| `global_equities_desk` | A株 + HK/US + 暗号研究者 → グローバルストラテジスト | -| `crypto_trading_desk` | ファンディング/ベーシス + 清算 + フロー → リスクマネージャー | -| `earnings_research_desk` | ファンダメンタル + リビジョン + オプション → 決算ストラテジスト | -| `macro_rates_fx_desk` | 金利 + FX + コモディティ → マクロPM | -| `quant_strategy_desk` | スクリーニング + ファクターリサーチ → バックテスト → リスク監査 | -| `technical_analysis_panel` | クラシックTA + 一目均衡表 + ハーモニック + エリオット + SMC → コンセンサス | -| `risk_committee` | ドローダウン + テイルリスク + レジームレビュー → サインオフ | -| `global_allocation_committee` | A株 + 暗号 + HK/US → クロスマーケット配分 | +| `investment_committee` | Bull/bear debate → risk review → PM final call | +| `global_equities_desk` | A-share + HK/US + crypto researcher → global strategist | +| `crypto_trading_desk` | Funding/basis + liquidation + flow → risk manager | +| `earnings_research_desk` | Fundamental + revision + options → earnings strategist | +| `macro_rates_fx_desk` | Rates + FX + commodity → macro PM | +| `quant_strategy_desk` | Screening + factor research → backtest → risk audit | +| `technical_analysis_panel` | Classic TA + Ichimoku + harmonic + Elliott + SMC → consensus | +| `risk_committee` | Drawdown + tail risk + regime review → sign-off | +| `global_allocation_committee` | A-shares + crypto + HK/US → cross-market allocation | -さらに20以上の専門プリセット — `vibe-trading --swarm-presets`で全プリセットを確認できます。 +さらに 20 以上の specialist presets があります。すべて確認するには vibe-trading --swarm-presets を実行してください。 -### 🎬 デモ + + +
+ +## 🎬 デモ
@@ -211,7 +268,7 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 - +
☝️ 自然言語バックテスト＆マルチエージェントスウォームディベート — Web UI + CLI☝️ 自然言語バックテスト & マルチエージェント swarm debate — Web UI + CLI
@@ -220,61 +277,69 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 ## 🚀 クイックスタート -### ワンラインインストール（PyPI） +### 1行インストール（PyPI） ```bash pip install vibe-trading-ai ``` -> **パッケージ名とコマンド:** PyPIパッケージは`vibe-trading-ai`。インストール後に3つのコマンドが使えます: +最初のリサーチタスクを実行します。 + +```bash +vibe-trading init +vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024 and summarize return and drawdown" +``` + +> **Package name vs commands:** PyPI package は `vibe-trading-ai` です。インストール後、3 つのコマンドが使えます。 > > | Command | Purpose | > |---------|---------| -> | `vibe-trading` | 対話型CLI / TUI | -> | `vibe-trading serve` | FastAPIウェブサーバー起動 | -> | `vibe-trading-mcp` | MCPサーバー起動（Claude Desktop, OpenClaw, Cursorなど） | +> | `vibe-trading` | Interactive CLI / TUI | +> | `vibe-trading serve` | FastAPI web server を起動 | +> | `vibe-trading-mcp` | MCP server を起動（Claude Desktop、OpenClaw、Cursor など向け） | ```bash -vibe-trading init # 対話的な.envセットアップ -vibe-trading # CLI起動 -vibe-trading serve --port 8899 # Web UI起動 -vibe-trading-mcp # MCPサーバー（stdio）起動 +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) ``` -### 使い方を選ぶ +### または利用経路を選ぶ | Path | Best for | Time | |------|----------|------| -| **A. Docker** | 今すぐ試す、ローカル設定ゼロ | 2分 | -| **B. Local install** | 開発、フルCLIアクセス | 5分 | -| **C. MCP plugin** | 既存エージェントへ組み込み | 3分 | -| **D. ClawHub** | クローン不要のワンコマンド | 1分 | +| **A. Docker** | すぐ試す、ローカル設定ゼロ | 2 min | +| **B. Local install** | 開発、CLI へのフルアクセス | 5 min | +| **C. MCP plugin** | 既存 agent へ接続 | 3 min | +| **D. ClawHub** | clone 不要、1 コマンド | 1 min | ### 前提条件 -- サポートされる任意のプロバイダーの**LLM APIキー** — もしくは**Ollama**でローカル実行（キー不要） -- Path Bでは**Python 3.11+** -- Path Aでは**Docker** +- 対応 provider の **LLM API key**、または **Ollama** によるローカル実行（key 不要） +- Path B では **Python 3.11+** +- Path A では **Docker** +- 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（ローカル）。設定は`.env.example`を参照。 +> **Supported LLM providers:** OpenRouter、OpenAI、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、Xiaomi MIMO、Z.ai、Ollama（local）。設定は `.env.example` を参照してください。 -> **Tip:** すべての市場でAPIキーなしでも動作（自動フォールバック）。yfinance（HK/US）、OKX（暗号）、AKShare（A株・US・HK・先物・FX）は無料。Tushareトークンは任意 — A株はAKShareで無料フォールバック。 +> **Tip:** 自動フォールバックにより、すべての市場は API key なしで利用できます。yfinance（HK/US）、OKX（crypto）、AKShare（A-shares、US、HK、futures、forex）はすべて無料です。Tushare token は任意で、A-shares は AKShare が無料 fallback としてカバーします。 -### Path A: Docker（セットアップ不要） +### Path A: Docker（設定ゼロ） ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading cp agent/.env.example agent/.env -# agent/.envを編集 — 利用するLLMプロバイダーのキーを設定 +# Edit agent/.env — uncomment your LLM provider and set API key docker compose up --build ``` -`http://localhost:8899`を開きます。バックエンドとフロントエンドを1コンテナで提供。 +`http://localhost:8899` を開きます。Backend + frontend が 1 つの container で動作します。 -Dockerは既定でバックエンドを`127.0.0.1:8899`にのみ公開し、非rootコンテナユーザーでアプリを実行します。APIを自分のマシン外へ意図的に公開する場合は、強い`API_AUTH_KEY`を設定し、クライアントから`Authorization: Bearer `を送ってください。 +Docker は既定で backend を `127.0.0.1:8899` に公開し、app を non-root container user として実行します。意図して API を自分の machine 外へ公開する場合は、強い `API_AUTH_KEY` を設定し、client から `Authorization: Bearer ` を送ってください。 -### Path B: ローカルインストール +### Path B: Local install ```bash git clone https://github.com/HKUDS/Vibe-Trading.git @@ -286,115 +351,116 @@ source .venv/bin/activate # Linux / macOS # .venv\Scripts\Activate.ps1 # Windows PowerShell pip install -e . -cp agent/.env.example agent/.env # 編集 — LLMプロバイダーのAPIキーを設定 -vibe-trading # 対話型TUIを起動 +cp agent/.env.example agent/.env # Edit — set your LLM provider API key +vibe-trading # Launch interactive TUI ```
-Web UIを起動（任意） +Web UI を起動（任意） ```bash -# Terminal 1: APIサーバー +# Terminal 1: API server vibe-trading serve --port 8899 -# Terminal 2: フロントエンド開発サーバー +# Terminal 2: Frontend dev server cd frontend && npm install && npm run dev ``` -`http://localhost:5899`を開きます。フロントエンドは`localhost:8899`へAPIプロキシします。 +`http://localhost:5899` を開きます。frontend は API calls を `localhost:8899` へ proxy します。 -**本番モード（単一サーバー）:** +**Production mode（single server）:** ```bash cd frontend && npm run build && cd .. -vibe-trading serve --port 8899 # FastAPIがdist/を静的配信 +vibe-trading serve --port 8899 # FastAPI serves dist/ as static files ```
-### Path C: MCP プラグイン +### Path C: MCP plugin -下記の[MCP プラグイン](#-mcp-プラグイン)セクションを参照。 +下の [MCP Plugin](#-mcp-plugin) セクションを参照してください。 -### Path D: ClawHub（ワンコマンド） +### Path D: ClawHub（1 コマンド） ```bash npx clawhub@latest install vibe-trading --force ``` -スキル＋MCP設定がエージェントのskillsディレクトリにダウンロードされます。詳細は[MCP プラグイン](#-mcp-プラグイン)を参照。 +skill + MCP config が agent の skills directory にダウンロードされます。詳細は [ClawHub install](#-mcp-plugin) を参照してください。 --- ## 🧠 環境変数 -`agent/.env.example`を`agent/.env`へコピーし、使いたいプロバイダーのブロックをアンコメント。各プロバイダーは3〜4変数を使用: +`agent/.env.example` を `agent/.env` にコピーし、使いたい provider block のコメントを外してください。各 provider には 3-4 個の変数が必要です。 | Variable | Required | Description | |----------|:--------:|-------------| -| `LANGCHAIN_PROVIDER` | Yes | プロバイダー名（`openrouter`, `deepseek`, `groq`, `ollama` など） | -| `_API_KEY` | Yes* | APIキー（`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` など） | -| `_BASE_URL` | Yes | APIエンドポイントURL | -| `LANGCHAIN_MODEL_NAME` | Yes | モデル名（例: `deepseek/deepseek-v3.2`） | -| `TUSHARE_TOKEN` | No | A株データ用Tushare Proトークン（AKShareにフォールバック） | -| `TIMEOUT_SECONDS` | No | LLM呼び出しタイムアウト（既定120s） | -| `API_AUTH_KEY` | ネットワークデプロイでは推奨 | APIが非ローカルクライアントから到達可能な場合に必要なBearer token | -| `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | リモートAPI / MCP-SSE系デプロイでshell系ツールを明示的に有効化 | -| `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | 文書・ブローカー取引明細インポート用の追加ルート（カンマ区切り） | -| `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | 生成コードrunディレクトリ用の追加ルート（カンマ区切り） | +| `LANGCHAIN_PROVIDER` | Yes | Provider name（`openrouter`, `deepseek`, `groq`, `ollama` など） | +| `_API_KEY` | Yes* | API key（`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` など） | +| `_BASE_URL` | Yes | API endpoint URL | +| `LANGCHAIN_MODEL_NAME` | Yes | Model name（例: `deepseek-v4-pro`） | +| `TUSHARE_TOKEN` | No | A-share data 用 Tushare Pro token（AKShare に fallback） | +| `TIMEOUT_SECONDS` | No | LLM call timeout、既定 120s | +| `API_AUTH_KEY` | Recommended for network deployments | API が非ローカル client から到達可能な場合に必要な Bearer token | +| `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | remote API/MCP-SSE style deployments で shell-capable tools を明示 opt-in | +| `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | document と broker-journal imports 用の追加 comma-separated roots | +| `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | generated-code run directories 用の追加 comma-separated roots | -* OllamaはAPIキー不要。 +* Ollama は API key 不要です。OpenAI Codex は ChatGPT OAuth を使い、tokens は `agent/.env` ではなく `oauth-cli-kit` 経由で保存します。 -**無料データ（キー不要）:** AKShare経由のA株、yfinance経由のHK/US株式、OKX経由の暗号、CCXT経由の100+暗号取引所。市場ごとに最適なソースを自動選択。 +**無料データ（key 不要）:** AKShare による A-shares、yfinance による HK/US equities、OKX による crypto、CCXT による 100+ crypto exchanges。システムは各市場に最適な利用可能 source を自動選択します。 ### 🎯 推奨モデル -Vibe-Tradingはツール呼び出しに大きく依存するエージェントです — skill・バックテスト・メモリ・swarmはすべてtool callで動作します。モデル選択が、エージェントが**実際にツールを使う**か、訓練データから答えを捏造するかを直接決定します。 +Vibe-Trading は tool-heavy agent です。skills、backtests、memory、swarms はすべて tool calls を通じて流れます。モデル選択は、agent が実際に *tools を使う* か、training data から作り話をするかを直接左右します。 -| 層 | 例 | 用途 | -|----|-----|------| -| **ベスト** | `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が不安定 — skillのロードやbacktest実行をせず「記憶で回答」してしまう | +| Tier | Examples | When to use | +|------|----------|-------------| +| **Best** | `anthropic/claude-opus-4.7`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.4`, `google/gemini-3.1-pro-preview` | 複雑な swarms（3+ agents）、長い research sessions、paper-grade analysis | +| **Sweet spot** (default) | `deepseek-v4-pro`, `deepseek/deepseek-v4-pro`, `x-ai/grok-4.20`, `z-ai/glm-5.1`, `moonshotai/kimi-k2.5`, `qwen/qwen3-max-thinking` | 日常使い。信頼できる tool-calling を約 1/10 の cost で | +| **Avoid for agent use** | `*-nano`, `*-flash-lite`, `*-coder-next`, small / distilled variants | Tool-calling が不安定です。agent は skills 読み込みや backtests 実行ではなく「記憶から答えている」ように見えます | -デフォルトの `agent/.env.example` は `deepseek/deepseek-v3.2` — コスパ層の最安オプション。 +既定の `agent/.env.example` は DeepSeek official API + `deepseek-v4-pro` で出荷されています。OpenRouter users は `deepseek/deepseek-v4-pro` を利用できます。 --- ## 🖥 CLI リファレンス ```bash -vibe-trading # 対話型TUI -vibe-trading run -p "..." # シングル実行 -vibe-trading serve # APIサーバー +vibe-trading # interactive TUI +vibe-trading run -p "..." # single run +vibe-trading serve # API server ```
-TUI内スラッシュコマンド +TUI 内の slash commands | Command | Description | |---------|-------------| -| `/help` | すべてのコマンドを表示 | -| `/skills` | 74の金融スキルを一覧表示 | -| `/swarm` | 29のスウォームチームプリセットを一覧表示 | -| `/swarm run [vars_json]` | スウォームチームをライブストリーミングで実行 | -| `/swarm list` | スウォーム実行履歴 | -| `/swarm show ` | スウォーム実行の詳細 | -| `/swarm cancel ` | 実行中スウォームをキャンセル | -| `/list` | 直近の実行 | -| `/show ` | 実行詳細と指標 | -| `/code ` | 生成された戦略コード | -| `/pine ` | インジケーターエクスポート（TradingView + TDX + MT5）| -| `/trace ` | 実行リプレイ | -| `/continue ` | 実行を新指示で継続 | -| `/sessions` | チャットセッション一覧 | -| `/settings` | 実行時設定を表示 | -| `/clear` | 画面クリア | +| `/help` | 全コマンドを表示 | +| `/skills` | 74 finance skills を一覧表示 | +| `/swarm` | 29 swarm team presets を一覧表示 | +| `/swarm run [vars_json]` | live streaming で swarm team を実行 | +| `/swarm list` | Swarm run history | +| `/swarm show ` | Swarm run details | +| `/swarm cancel ` | 実行中の swarm をキャンセル | +| `/list` | Recent runs | +| `/show ` | Run details + metrics | +| `/code ` | 生成された strategy code | +| `/pine ` | indicators を export（TradingView + TDX + MT5） | +| `/trace ` | Full execution replay | +| `/continue ` | 新しい指示で run を継続 | +| `/sessions` | Chat sessions を一覧表示 | +| `/settings` | Runtime config を表示 | +| `/clear` | 画面をクリア | | `/quit` | 終了 | +
-単発実行とフラグ +Single run & flags ```bash vibe-trading run -p "Backtest BTC-USDT MACD strategy, last 30 days" @@ -411,7 +477,7 @@ vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}' vibe-trading --list vibe-trading --show vibe-trading --code -vibe-trading --pine # インジケーターエクスポート（TradingView + TDX + MT5） +vibe-trading --pine # Export indicators (TradingView + TDX + MT5) vibe-trading --trace vibe-trading --continue "refine the strategy" vibe-trading --upload report.pdf @@ -421,6 +487,76 @@ vibe-trading --upload report.pdf --- +## 💡 例 + +### Strategy & Backtesting + +```bash +# 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 +``` + +### Market Research + +```bash +# 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" +``` + +### Swarm Workflows + +```bash +# 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"}' +``` + +### Cross-Session Memory + +```bash +# 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" +``` + +### Upload & Analyze Documents + +```bash +# 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 サーバー ```bash @@ -429,45 +565,45 @@ vibe-trading serve --port 8899 | Method | Endpoint | Description | |--------|----------|-------------| -| `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` | `/settings/llm` | Web UIのLLM設定を読み取り | -| `PUT` | `/settings/llm` | ローカルLLM設定を更新 | -| `GET` | `/settings/data-sources` | ローカルデータソース設定を読み取り | -| `PUT` | `/settings/data-sources` | ローカルデータソース設定を更新 | +| `GET` | `/runs` | runs を一覧表示 | +| `GET` | `/runs/{run_id}` | run details | +| `GET` | `/runs/{run_id}/pine` | Multi-platform indicator export | +| `POST` | `/sessions` | session を作成 | +| `POST` | `/sessions/{id}/messages` | message を送信 | +| `GET` | `/sessions/{id}/events` | SSE event stream | +| `POST` | `/upload` | PDF/file をアップロード | +| `GET` | `/swarm/presets` | swarm presets を一覧表示 | +| `POST` | `/swarm/runs` | swarm run を開始 | +| `GET` | `/swarm/runs/{id}/events` | Swarm SSE stream | +| `GET` | `/settings/llm` | Web UI LLM settings を読み取り | +| `PUT` | `/settings/llm` | local LLM settings を更新 | +| `GET` | `/settings/data-sources` | local data source settings を読み取り | +| `PUT` | `/settings/data-sources` | local data source settings を更新 | -インタラクティブドキュメント: `http://localhost:8899/docs` +Interactive docs: `http://localhost:8899/docs` -### セキュリティ既定値 +### Security defaults -localhost開発では、`vibe-trading serve`はブラウザワークフローをシンプルに保ちます。非ローカルクライアントから機密APIへアクセスする場合は`API_AUTH_KEY`が必要です。JSON/アップロードリクエストでは`Authorization: Bearer `を使ってください。ブラウザEventSourceストリームは、Web UIのSettingsで同じキーを一度入力すると処理されます。 +localhost 開発では、`vibe-trading serve` は browser workflow を簡単に保ちます。非ローカル client では、sensitive API endpoints に `API_AUTH_KEY` が必要です。JSON/upload requests には `Authorization: Bearer ` を使ってください。Browser EventSource streams は、Settings で同じ key を一度入力した後、Web UI が処理します。 -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`で専用ディレクトリを追加してください。 +Shell-capable tools は local CLI と trusted localhost workflows で利用できますが、`VIBE_TRADING_ENABLE_SHELL_TOOLS=1` を明示的に設定しない限り remote API sessions には公開されません。Document と journal readers は既定で upload/import roots に制限されます。ファイルは `agent/uploads`、`agent/runs`、`./uploads`、`./data`、`~/.vibe-trading/uploads`、`~/.vibe-trading/imports` の下に置くか、`VIBE_TRADING_ALLOWED_FILE_ROOTS` で専用 directory を追加してください。 ### Web UI Settings -Web UI Settingsページでは、ローカルユーザーがLLM provider/model、Base URL、生成パラメータ、reasoning effort、Tushare tokenなどの任意の市場データ認証情報を更新できます。設定は`agent/.env`に保存され、providerのデフォルト値は`agent/src/providers/llm_providers.json`から読み込まれます。 +Web UI Settings page では、local users が LLM provider/model、base URL、generation parameters、reasoning effort、Tushare token など任意の market data credentials を更新できます。Settings は `agent/.env` に永続化され、provider defaults は `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ローカルクライアントのみに許可されます。 +Settings reads は side-effect free です。`GET /settings/llm` と `GET /settings/data-sources` は `agent/.env` を作成せず、project-relative paths だけを返します。Settings の読み書きは credential state の公開や credentials/runtime environment の更新を伴うため、設定済みの場合は `API_AUTH_KEY` が必要です。dev mode で `API_AUTH_KEY` が未設定の場合、settings access は loopback clients からのみ受け付けます。 --- -## 🔌 MCP プラグイン +## 🔌 MCP Plugin -Vibe-Tradingは、あらゆるMCP互換クライアント向けに22のMCPツールを提供します。stdioサブプロセスとして実行 — サーバーセットアップ不要。**22中21ツールはAPIキー不要**（HK/US/暗号）。`run_swarm`のみLLMキーが必要。 +Vibe-Trading は MCP-compatible client 向けに 22 MCP tools を公開します。stdio subprocess として動作し、server setup は不要です。**22 tools のうち 21 tools は API key なしで動作します**（HK/US/crypto）。LLM key が必要なのは `run_swarm` のみです。
Claude Desktop -`claude_desktop_config.json`に追加: +`claude_desktop_config.json` に追加: ```json { @@ -484,7 +620,7 @@ Vibe-Tradingは、あらゆるMCP互換クライアント向けに22のMCPツー
OpenClaw -`~/.openclaw/config.yaml`に追加: +`~/.openclaw/config.yaml` に追加: ```yaml skills: @@ -495,38 +631,38 @@ skills:
-Cursor / Windsurf / 他MCPクライアント +Cursor / Windsurf / other MCP clients ```bash -vibe-trading-mcp # stdio（デフォルト） -vibe-trading-mcp --transport sse # Webクライアント向けSSE +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`。 +**公開される MCP tools（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からインストール（ワンコマンド） +ClawHub からインストール（1 コマンド） ```bash npx clawhub@latest install vibe-trading --force ``` -> 外部APIを参照するためVirusTotalの自動スキャンが走るので`--force`が必要。コードは完全オープンソースで検証可能。 +> `--force` が必要なのは、skill が external APIs を参照し、VirusTotal の automated scan が起動するためです。コードは完全に open-source で、自由に確認できます。 -スキル＋MCP設定がエージェントのskillsディレクトリにダウンロードされます。クローン不要。 +これにより skill + MCP config が agent の skills directory にダウンロードされます。clone は不要です。 -ClawHubで閲覧: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading) +ClawHub で見る: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading)
-OpenSpace — 自己進化スキル +OpenSpace — self-evolving skills -全74金融スキルは[open-space.cloud](https://open-space.cloud)に公開され、OpenSpaceの自己進化エンジンで自律的に進化します。 +74 の finance skills はすべて [open-space.cloud](https://open-space.cloud) に公開され、OpenSpace の self-evolution engine を通じて自律的に進化します。 -OpenSpaceで使うには、両方のMCPサーバーをエージェント設定に追加: +OpenSpace と使うには、agent config に両方の MCP servers を追加してください。 ```json { @@ -546,7 +682,7 @@ OpenSpaceで使うには、両方のMCPサーバーをエージェント設定 } ``` -OpenSpaceが全74スキルを自動検出し、auto-fix/auto-improve/コミュニティ共有を有効化。`search_skills("finance backtest")`でVibe-Tradingスキルを検索可能。 +OpenSpace は 74 skills を自動検出し、auto-fix、auto-improve、community sharing を可能にします。OpenSpace-connected agent では `search_skills("finance backtest")` から Vibe-Trading skills を検索できます。
@@ -559,55 +695,55 @@ OpenSpaceが全74スキルを自動検出し、auto-fix/auto-improve/コミュ ``` Vibe-Trading/ -├── agent/ # バックエンド (Python) -│ ├── cli.py # CLIエントリーポイント — 対話型TUI + サブコマンド -│ ├── api_server.py # FastAPIサーバー — runs, sessions, upload, swarm, SSE -│ ├── mcp_server.py # MCPサーバー — OpenClaw / Claude Desktop向け22ツール +├── agent/ # Backend (Python) +│ ├── cli.py # CLI entrypoint — 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エージェントコア -│ │ │ ├── loop.py # 5層圧縮 + 読み書きツールバッチ処理 -│ │ │ ├── context.py # システムプロンプト + 永続メモリからの自動リコール -│ │ │ ├── skills.py # スキルローダー（74バンドル + ユーザーCRUD作成） -│ │ │ ├── tools.py # ツール基底クラス + レジストリ -│ │ │ ├── memory.py # 実行ごとの軽量ワークスペースステート -│ │ │ ├── frontmatter.py # 共有YAMLフロントマターパーサー -│ │ │ └── trace.py # 実行トレースライター +│ │ ├── 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 (74 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/ # クロスセッション永続メモリ -│ │ │ └── persistent.py # ファイルベースメモリ (~/.vibe-trading/memory/) +│ │ ├── memory/ # Cross-session persistent memory +│ │ │ └── persistent.py # file-based memory (~/.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, ファイルI/O, ファクター分析, オプション等 +│ │ ├── tools/ # 27 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, etc. │ │ │ -│ │ ├── skills/ # 8カテゴリに渡る74金融スキル (各SKILL.md) -│ │ ├── swarm/ # スウォームDAG実行エンジン -│ │ │ └── presets/ # 29のスウォームプリセットYAML定義 -│ │ ├── session/ # マルチターンチャット + FTS5セッション検索 -│ │ └── providers/ # LLMプロバイダー抽象化 +│ │ ├── skills/ # 74 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/ # バックテストエンジン -│ ├── engines/ # 7エンジン + クロスマーケット複合エンジン + options_portfolio -│ ├── loaders/ # 6ソース: tushare, okx, yfinance, akshare, ccxt, futu +│ └── 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.py # Registry + auto-fallback chains │ └── optimizers/ # MVO, equal vol, max div, risk parity │ ├── frontend/ # Web UI (React 19 + Vite + TypeScript) │ └── src/ │ ├── pages/ # Home, Agent, RunDetail, Compare │ ├── components/ # chat, charts, layout -│ └── stores/ # Zustandステート管理 +│ └── stores/ # Zustand state management │ -├── Dockerfile # マルチステージビルド -├── docker-compose.yml # ワンコマンドデプロイ -├── pyproject.toml # パッケージ設定 + CLIエントリーポイント +├── Dockerfile # Multi-stage build +├── docker-compose.yml # One-command deploy +├── pyproject.toml # Package config + CLI entrypoint └── LICENSE # MIT ``` @@ -617,25 +753,25 @@ Vibe-Trading/ ## 🏛 エコシステム -Vibe-Tradingは**[HKUDS](https://github.com/HKUDS)**エージェントエコシステムの一部です: +Vibe-Trading は **[HKUDS](https://github.com/HKUDS)** agent ecosystem の一部です。
ClawTeam
- エージェントスウォームインテリジェンス + Agent Swarm Intelligence 		NanoBot
- 超軽量パーソナルAIアシスタント + Ultra-Lightweight Personal AI Assistant 		CLI-Anything
- すべてのソフトウェアをエージェントネイティブに + Making All Software Agent-Native 		OpenSpace
- 自己進化型AIエージェントスキル + Self-Evolving AI Agent Skills
@@ -644,46 +780,46 @@ Vibe-Tradingは**[HKUDS](https://github.com/HKUDS)**エージェントエコシ ## 🗺 ロードマップ -> 段階的にリリースします。作業開始時に[Issues](https://github.com/HKUDS/Vibe-Trading/issues)へ移動します。 +> 段階的に出荷します。作業が始まった項目は [Issues](https://github.com/HKUDS/Vibe-Trading/issues) に移動します。 | Phase | Feature | Status | |-------|---------|--------| -| **Research Autopilot** | 夜間リサーチループ: 仮説 → データ取得 → バックテスト → 証拠レポート | In Progress | -| **Data Bridge** | 持ち込みデータ: ローカル CSV/Parquet/SQL コネクタ + schema mapping | Planned | -| **Options Lab** | ボラティリティサーフェス、Greeks ダッシュボード、損益/シナリオ探索 | Planned | -| **Portfolio Studio** | リスクX線、制約、回転率考慮オプティマイザー、リバランスノート | Planned | -| **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 因子ライブラリ、スクリーニング + IC テスト | Planned | -| **Research Delivery** | Slack / Telegram / メール型チャネルへの定期ブリーフ配信 | Planned | -| **Trust Layer** | 再現可能な run card: ツール履歴、データソース、仮定、引用 | In Progress | -| **Community** | 共有可能な skills、presets、strategy cards | Exploring | +| **Research Autopilot** | Overnight research loop: hypothesis → data pull → backtest → evidence report | In Progress | +| **Data Bridge** | Bring-your-own data: local CSV/Parquet/SQL connectors with schema mapping | Planned | +| **Options Lab** | Vol surface, Greeks dashboard, payoff/scenario explorer | Planned | +| **Portfolio Studio** | Risk x-ray, constraints, turnover-aware optimizer, rebalance notes | Planned | +| **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 factor libraries with screening + IC tests | Planned | +| **Research Delivery** | Scheduled briefs to Slack / Telegram / email-style channels | Planned | +| **Trust Layer** | Reproducible run cards: tool trace, data sources, assumptions, citations | In Progress | +| **Community** | Shareable skills, presets, and strategy cards | Exploring | --- -## 貢献 +## Contributing -貢献を歓迎します！ガイドラインは[CONTRIBUTING.md](CONTRIBUTING.md)を参照してください。 +Contributions を歓迎します。ガイドラインは [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。 -**Good first issues**は[`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)タグ付き — どれか選んで始めてください。 +**Good first issues** は [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) でタグ付けされています。気になるものから始めてください。 -より大きな貢献を検討中ですか？上記[ロードマップ](#-ロードマップ)を確認し、着手前にIssueで相談してください。 +より大きな貢献を検討している場合は、上の [Roadmap](#-ロードマップ) を確認し、着手前に issue を開いて相談してください。 --- -## コントリビューター +## Contributors -Vibe-Tradingに貢献してくださった皆さんに感謝します！ +Vibe-Trading に貢献してくださった皆さまに感謝します。 -最近の v0.1.7 サイクルのコントリビューターとクレジット: +最近の v0.1.7 cycle contributors and credits: -- @GTC2080 / TaoMu — Web UI Settings と provider/data-source 設定 API (#57) -- @BigNounce90 — backtest `run_dir` validation CLI の強化 (#60) -- @shadowinlife — A株 pre-ST フィルタースキル (#63) -- @MB-Ndhlovu — 相関ヒートマップダッシュボードとレビュー修正 (#64, #66) -- @ykykj — OpenAI Codex OAuth provider オプション (#65) -- @RuifengFu — 対話型 CLI ステータスバーと prompt 編集 (#69) -- @SiMinus — swarm preset inspection コマンド (#73) -- @warren618 / Haozhe Wu — セキュリティ強化、リリース統合、ドキュメント、Docker、パッケージング、ローカル開発ワークフロー -- lemi9090 (S2W) — 協調的なセキュリティ研究、検証、開示サポート +- @GTC2080 / TaoMu — Web UI Settings and provider/data-source configuration APIs (#57) +- @BigNounce90 — validation CLI hardening for backtest `run_dir` input (#60) +- @shadowinlife — A-share pre-ST filter skill (#63) +- @MB-Ndhlovu — correlation heatmap dashboard and review fixes (#64, #66) +- @ykykj — OpenAI Codex OAuth provider option (#65) +- @RuifengFu — interactive CLI live status bar and prompt editing (#69) +- @SiMinus — swarm preset inspection command (#73) +- @warren618 / Haozhe Wu — security hardening, release integration, docs, Docker, packaging, and local dev workflow +- lemi9090 (S2W) — coordinated security research, validation, and disclosure support @@ -691,24 +827,24 @@ Vibe-Tradingに貢献してくださった皆さんに感謝します！ --- -## 免責事項 +## Disclaimer -Vibe-Tradingはリサーチ・シミュレーション・バックテスト用途のみです。投資助言ではなく、リアルトレードを実行しません。過去の実績は将来の結果を保証しません。 +Vibe-Trading は研究、シミュレーション、バックテスト専用です。投資助言ではなく、ライブ取引も実行しません。過去の成績は将来の結果を保証しません。 -## ライセンス +## License -MIT License — [LICENSE](LICENSE)を参照 +MIT License — see [LICENSE](LICENSE) --- -## スター履歴 +## Star History [![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への訪問に感謝 ✨ + Vibe-Trading をご覧いただきありがとうございます ✨

visitors diff --git a/README_ko.md b/README_ko.md index 92704bf1..5354276f 100644 --- a/README_ko.md +++ b/README_ko.md @@ -9,7 +9,7 @@

Vibe-Trading: 당신의 개인 트레이딩 에이전트

- 한 번의 명령으로 에이전트를 종합 트레이딩 기능으로 강화 + 한 번의 명령으로 에이전트에 종합적인 트레이딩 역량을 더하세요

@@ -19,28 +19,21 @@ PyPI License
- Skills - Swarm - Tools - Data Sources -
Feishu WeChat Discord

+ 뉴스  ·  기능  ·  + 섀도우 계정  ·  데모  ·  - 개요  ·  - 시작하기  ·  - CLI  ·  - API  ·  - MCP  ·  - 구조  ·  + 빠른 시작  ·  + 예제  ·  + API / MCP  ·  로드맵  ·  - 기여  ·  - 기여자 + 기여하기

@@ -51,117 +44,174 @@ ## 📰 뉴스 -- **2026-05-14** 🧠 **영구 메모리 CLI**: `vibe-trading memory list/show/search/forget`을 추가해 `~/.vibe-trading/memory/`를 직접 열지 않고도 영구 메모리를 확인, 검색, 정리할 수 있습니다. non-memory CLI 시작 속도를 유지하기 위해 lazy import를 사용하고, memory frontmatter 스캔 시 파싱된 메타데이터 값을 다시 문자열로 강제 변환해 Rich 렌더링이나 recall scoring의 경계 입력을 더 안전하게 처리합니다([#102](https://github.com/HKUDS/Vibe-Trading/pull/102), @Teerapat-Vatpitak 감사합니다). -- **2026-05-13** 🧭 **실가격 swarm grounding + worker event hygiene**: Swarm run이 analyst 시작 전에 시장 데이터를 pre-fetch하고 실제 가격으로 worker prompt를 grounding합니다. 심볼 조회는 `_detect_market(code)` 경로로 통일되고 grounding payload의 thread-safe 전달도 강화되었습니다([#93](https://github.com/HKUDS/Vibe-Trading/pull/93)). Worker report는 허용된 swarm-run 경로에 영구 저장되며, `report.md` summary extraction, 더 긴 preset timeout, redacted/sanitized event preview로 streaming update가 더 깔끔해졌습니다([#84](https://github.com/HKUDS/Vibe-Trading/pull/84)). -- **2026-05-12** 🧾 **Trust Layer run cards**: 백테스트가 이제 artifacts와 함께 재현 가능한 `run_card.json` 및 `run_card.md`를 생성합니다. config와 전략 코드 해시, 데이터 소스, scalar metrics, validation payload, warnings, artifact checksum을 기록합니다. Backtest 도구도 run-card 경로를 반환하므로 CLI/API가 evidence package를 바로 보여줄 수 있습니다. +- **2026-05-14** 🧠 이제 `vibe-trading memory list/show/search/forget`으로 CLI에서 영구 메모리를 확인할 수 있습니다([#102](https://github.com/HKUDS/Vibe-Trading/pull/102), @Teerapat-Vatpitak 감사합니다). +- **2026-05-13** 🧭 Swarm 실행은 이제 가져온 시장 데이터로 worker를 grounding하고, 더 깔끔한 영구 리포트를 남깁니다([#93](https://github.com/HKUDS/Vibe-Trading/pull/93), [#84](https://github.com/HKUDS/Vibe-Trading/pull/84)). +- **2026-05-12** 🧾 백테스트는 이제 재현 가능한 리서치 실행을 위해 artifacts와 함께 `run_card.json` 및 `run_card.md`를 생성합니다.

이전 뉴스 -- **2026-05-11** 🧭 **Memory slug, swarm 집계, CLI 프리플라이트**: 영구 메모리 파일 slug 생성 시 CJK 문자를 보존해 중국어/일본어/한국어 노트의 조용한 파일명 충돌을 막습니다([#95](https://github.com/HKUDS/Vibe-Trading/pull/95), @voidborne-d 감사합니다). Swarm run 합계는 provider가 반환한 token usage를 우선 사용하고 기존 추정 fallback도 유지합니다([#94](https://github.com/HKUDS/Vibe-Trading/pull/94), @Teerapat-Vatpitak 감사합니다). CLI run UI에는 일반적인 환경 문제를 더 일찍 드러내는 시작 프리플라이트 체크도 추가되었습니다([#96](https://github.com/HKUDS/Vibe-Trading/pull/96), @ykykj 감사합니다). -- **2026-05-10** 🧱 **회귀 가드레일 + run 메타데이터**: Memory recall이 이제 밑줄을 token 경계로 처리하므로 `mcp_wiring_test` 같은 snake_case 저장 메모리가 "mcp wiring" 같은 자연어 쿼리에 매칭됩니다([#87](https://github.com/HKUDS/Vibe-Trading/pull/87), @hp083625 감사합니다). MCP server에는 initialize → `tools/list` → `tools/call` 경로를 실제 subprocess로 검증하는 smoke test를 추가해 첫 호출 deadlock 회귀를 막습니다([#86](https://github.com/HKUDS/Vibe-Trading/pull/86)). 또한 Windows 경로 민감 테스트 호환성, API best-effort 예외 처리 축소, backtest `run_dir` allowed-root 검증, SwarmRun provider/model 메타데이터 같은 저위험 강화도 반영했습니다([#88](https://github.com/HKUDS/Vibe-Trading/pull/88), [#90](https://github.com/HKUDS/Vibe-Trading/pull/90), [#91](https://github.com/HKUDS/Vibe-Trading/pull/91), [#92](https://github.com/HKUDS/Vibe-Trading/pull/92), @Teerapat-Vatpitak 감사합니다). -- **2026-05-09** 🛡️ **API 경로 강화 + MCP server 안정성**: API run/session 라우트는 조회 전에 path ID를 검증하여 개행이 포함된 비정상 파라미터를 거부하고, 해당 동작을 auth/security 회귀 테스트로 고정했습니다([#80](https://github.com/HKUDS/Vibe-Trading/pull/80), @SJoon99 감사합니다). MCP server는 `tools/call` 처리 전에 메인 스레드에서 도구 레지스트리를 미리 워밍업해 lazy tool discovery의 첫 호출 deadlock을 피합니다([#85](https://github.com/HKUDS/Vibe-Trading/pull/85), @Teerapat-Vatpitak 감사합니다). Vite dev proxy도 `VITE_API_URL`을 존중해 기본값이 아닌 백엔드 타깃을 사용할 수 있게 했습니다([#82](https://github.com/HKUDS/Vibe-Trading/pull/82), @voidborne-d 감사합니다). -- **2026-05-08** 🧾 **Tushare 재무제표 필드를 필터에 연결**: A주 일간 백테스트에서 `fundamental_fields`로 시점 안전한 재무제표 필드를 요청할 수 있습니다. 이제 SignalEngine은 공시/발표일 이후 `income_total_revenue`, `income_n_income`, `balancesheet_total_hldr_eqy_exc_min_int`, `fina_indicator_roe` 같은 테이블 접두사 컬럼으로 사전 필터링할 수 있습니다([#76](https://github.com/HKUDS/Vibe-Trading/pull/76), @mrbob-git 감사합니다). 후속 강화로 명시적으로 재무제표 필드를 요청했는데 Tushare enrichment가 실패하면 원시 가격 데이터로 조용히 돌아가지 않고 즉시 실패합니다([#77](https://github.com/HKUDS/Vibe-Trading/pull/77)). -- **2026-05-07** 📈 **Tushare fundamentals + 커뮤니티 정리**: 펀더멘털 리서치 워크플로를 위한 시점 기준 `TushareFundamentalProvider` 계약을 추가하고, 프로젝트 `TUSHARE_TOKEN` 환경 변수 경로를 회귀 테스트로 고정했습니다([#74](https://github.com/HKUDS/Vibe-Trading/pull/74)). 커뮤니티 정리에서는 빠른 반복을 위해 당분간 UI를 단일 언어에 집중하고, DuckDuckGo 기반 `web_search`가 이미 번들되어 있으므로 중복 검색 의존성을 추가하지 않으며, 비공식 호스팅 배포를 API key나 데이터 소스 token 입력용 신뢰 진입점으로 보지 않는다는 점도 명확히 했습니다. -- **2026-05-06** 🚀 **v0.1.7 릴리스**([Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7), `pip install -U vibe-trading-ai`): 보안 경계 강화 버전이 PyPI와 ClawHub에 게시되었습니다. API/읽기/업로드/파일/URL/생성 코드/shell 도구/Docker 기본 경계를 더 안전하게 만들면서 localhost CLI/Web UI 흐름은 낮은 마찰을 유지합니다. 이번 사이클에는 Web UI Settings, 상관관계 히트맵, OpenAI Codex OAuth, A주 pre-ST 필터, 대화형 CLI UX, swarm preset inspection, 배당 분석, 개발 워크플로 개선, 프론트엔드 build dependency 보안 하한 업데이트도 포함됩니다. 0.1.7 기여자들과 조율된 보안 검증을 도와준 lemi9090 (S2W)에게 감사드립니다. -- **2026-05-05** 🛡️ **보안 경계 후속 강화**: 명시적 CORS origin, Settings 자격 증명 상태 표시, 웹 URL 읽기, Shadow Account 코드 생성 주변의 남은 보안 경계를 보강하고 각 경로에 회귀 테스트를 추가했습니다. localhost CLI/Web UI 흐름은 그대로 유지됩니다. 원격 배포에서는 계속 `API_AUTH_KEY`와 명시적인 신뢰 origin을 사용하세요. -- **2026-05-04** 🖥️ **대화형 CLI UX + CI 정리**: 대화형 모드에 provider/model, 세션 시간, 직전 실행 시간, 누적 도구 호출 통계를 보여주는 실시간 하단 상태 표시줄이 추가되었습니다. 또한 `prompt_toolkit`을 통해 위/아래 방향키 히스토리 탐색과 좌/우 방향키 커서 편집을 지원합니다([#69](https://github.com/HKUDS/Vibe-Trading/pull/69)). `prompt_toolkit` 또는 TTY를 사용할 수 없으면 기존 Rich prompt로 자동 폴백합니다. CI 경로 기대값도 강화된 파일 import 샌드박스와 크로스플랫폼 `/tmp` 해석에 맞춰 정리되어 main이 다시 green 상태가 되었습니다([`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)). -- **2026-05-03** 🛡️ **보안 강화 패치**: 비로컬 배포의 기본 API 인증을 강화하고, 민감한 run/session/swarm 읽기 API를 보호하며, 업로드와 로컬 파일 읽기 경계를 제한하고, shell 가능 도구를 진입점별로 제어합니다. 생성된 전략은 import 전에 검증되며 Docker 이미지는 기본적으로 비root 사용자와 localhost 전용 포트 공개로 실행됩니다. CLI와 localhost Web UI 흐름은 낮은 마찰을 유지합니다. 원격 API/Web 배포에서는 `API_AUTH_KEY`를 설정하세요. -- **2026-05-02** 🧭 **배당 분석 + 더 선명한 로드맵**: 인컴 주식, 배당 지속 가능성, 배당 성장, 주주환원 수익률, 배당락 메커니즘, 고배당 함정 점검을 다루는 `dividend-analysis` 스킬을 추가하고 bundled skill 회귀 테스트로 고정했습니다. 공개 로드맵은 Research Autopilot, Data Bridge, Options Lab, Portfolio Studio, Alpha Zoo, Research Delivery, Trust Layer, Community 공유에 집중하도록 정리했습니다. -- **2026-05-01** 🔥 **상관관계 히트맵 + OpenAI Codex OAuth + A주 pre-ST 필터**: 새 상관관계 대시보드/API가 롤링 수익률 상관관계를 계산하고, 포트폴리오 및 종목 분석용 ECharts 히트맵으로 렌더링합니다([#64](https://github.com/HKUDS/Vibe-Trading/pull/64)). OpenAI Codex provider는 이제 `vibe-trading provider login openai-codex`로 ChatGPT OAuth를 사용할 수 있으며, Settings 메타데이터와 어댑터 회귀 테스트도 추가되었습니다([#65](https://github.com/HKUDS/Vibe-Trading/pull/65)). A주 ST/*ST 리스크 스크리닝을 위한 `ashare-pre-st-filter` 스킬을 추가하고 강화했으며, Sina 제재 공시 관련성 필터링으로 증권 계좌 목록 언급이 E2 횟수를 부풀리지 않도록 했습니다([#63](https://github.com/HKUDS/Vibe-Trading/pull/63)). -- **2026-04-30** ⚙️ **Web UI 설정 + validation CLI 강화**: LLM provider/model, Base URL, reasoning effort, 데이터 소스 자격 증명을 로컬에서 설정할 수 있는 Settings 페이지를 추가했습니다. settings API는 local/auth로 보호되며 provider 메타데이터도 데이터 기반 설정으로 분리되었습니다([#57](https://github.com/HKUDS/Vibe-Trading/pull/57)). 또한 `python -m backtest.validation `가 인자 없음, 빈 경로, 잘못된 경로, 존재하지 않는 경로, 디렉터리가 아닌 경로를 검증 시작 전에 명확한 메시지로 실패하도록 강화했습니다([#60](https://github.com/HKUDS/Vibe-Trading/pull/60)). -- **2026-04-28** 🚀 **v0.1.6 릴리스**（`pip install -U vibe-trading-ai`）: `pip install` / `uv tool install` 설치 후 `vibe-trading --swarm-presets`가 비어 있는 문제 수정([#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` 엔드포인트를 1MB 청크 스트리밍으로 전환, `MAX_UPLOAD_SIZE` 초과 시 즉시 중단 + 부분 파일 정리. 50MB 상한이 악성/초대형 요청에도 실효화([#53](https://github.com/HKUDS/Vibe-Trading/pull/53)) — 4개 회귀 테스트로 고정. -- **2026-04-22** 🛡️ **하드닝 + 신규 연동**: `safe_path`에 경로 컨테인먼트 강제 + 거래 명세서/섀도우 계정 도구 샌드박스화, `MANIFEST.in` 추가로 sdist에 `.env.example` / 테스트 / Docker 파일 포함, 프론트엔드 라우트 단위 지연 로딩으로 초기 번들 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`을 활성 run 디렉토리로 정규화([#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**: 증권사 거래 명세서에서 자신의 전략 규칙을 추출 → 여러 시장에서 섀도우 백테스트 실행 → 8개 섹션 HTML/PDF 리포트가 어디에서 얼마를 놓쳤는지(규칙 위반, 조기 익절, 놓친 시그널, 역방향 거래) 정확히 보여줌. 신규 도구 4개, 신규 스킬 1개, 총 32개 도구. Trade Journal / Shadow Account 샘플 프롬프트가 Web UI 웰컴 화면에 추가. -- **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)), MiniMax temperature 수정 + 모델 업데이트([#33](https://github.com/HKUDS/Vibe-Trading/pull/33)). 13개 제공자. -- **2026-04-14** 🔧 **MCP 안정성**: 백테스트 도구의 stdio 전송에서 `Connection closed` 오류 수정([#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**: `vibe-trading init` .env 부트스트랩([#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)), `web_search` MCP 도구, 12개 LLM 제공자, `akshare`/`ccxt` 의존성. PyPI와 ClawHub에 게시. -- **2026-04-09** 📊 **Backtest Wave 2**: ChinaFutures, GlobalFutures, Forex, Options v2 엔진. 몬테카를로, Bootstrap CI, 워크포워드 검증. -- **2026-04-08** 🔧 **다중 시장 백테스트**: 시장별 규칙, Pine Script v6 내보내기, 자동 폴백 5개 데이터 소스. +- **2026-05-11** 🧭 **Memory slug, swarm 집계, CLI 프리플라이트**: 영구 메모리는 파일 slug를 생성할 때 CJK 문자를 보존하여 중국어/일본어/한국어 노트에서 조용한 파일명 충돌이 발생하지 않도록 합니다([#95](https://github.com/HKUDS/Vibe-Trading/pull/95), @voidborne-d 감사합니다). Swarm 실행 합계는 이제 provider가 보고한 token usage를 우선 사용하고 기존 추정 fallback도 유지합니다([#94](https://github.com/HKUDS/Vibe-Trading/pull/94), @Teerapat-Vatpitak 감사합니다). CLI 실행 UI에는 일반적인 환경 문제를 확인하는 시작 프리플라이트 체크도 추가되었습니다([#96](https://github.com/HKUDS/Vibe-Trading/pull/96), @ykykj 감사합니다). +- **2026-05-10** 🧱 **회귀 가드레일 + run 메타데이터**: Memory recall은 이제 밑줄을 token 경계로 취급하므로 `mcp_wiring_test` 같은 snake_case 저장 메모리가 "mcp wiring" 같은 자연어 쿼리와 매칭됩니다([#87](https://github.com/HKUDS/Vibe-Trading/pull/87), @hp083625 감사합니다). MCP server에는 initialize → `tools/list` → `tools/call` 경로를 실제 subprocess로 검증하는 smoke test가 추가되어 첫 호출 deadlock 경로를 방지합니다([#86](https://github.com/HKUDS/Vibe-Trading/pull/86)). Windows 경로 민감 테스트, API best-effort 예외 처리, backtest `run_dir` 허용 루트 검증, SwarmRun provider/model 메타데이터에 대한 저위험 강화도 반영되었습니다([#88](https://github.com/HKUDS/Vibe-Trading/pull/88), [#90](https://github.com/HKUDS/Vibe-Trading/pull/90), [#91](https://github.com/HKUDS/Vibe-Trading/pull/91), [#92](https://github.com/HKUDS/Vibe-Trading/pull/92), @Teerapat-Vatpitak 감사합니다). +- **2026-05-09** 🛡️ **API 경로 강화 + MCP server 안정성**: API run/session 라우트는 조회 전에 path ID를 검증하여 개행이 포함된 잘못된 파라미터를 거부하고, 이 동작을 auth/security 회귀 테스트에 고정했습니다([#80](https://github.com/HKUDS/Vibe-Trading/pull/80), @SJoon99 감사합니다). MCP server는 `tools/call`을 제공하기 전에 메인 스레드에서 도구 레지스트리를 미리 워밍업하여 lazy tool discovery의 첫 호출 deadlock을 피합니다([#85](https://github.com/HKUDS/Vibe-Trading/pull/85), @Teerapat-Vatpitak 감사합니다). Vite dev proxy도 기본값이 아닌 백엔드 타깃을 위해 `VITE_API_URL`을 존중합니다([#82](https://github.com/HKUDS/Vibe-Trading/pull/82), @voidborne-d 감사합니다). +- **2026-05-08** 🧾 **Tushare 재무제표 필드를 필터에 연결**: A주 일간 백테스트에서 `fundamental_fields`를 통해 PIT-safe 재무제표 필드를 요청할 수 있으므로 signal engine은 공시/공개일 이후 `income_total_revenue`, `income_n_income`, `balancesheet_total_hldr_eqy_exc_min_int`, `fina_indicator_roe` 등 테이블 접두사 컬럼으로 선별할 수 있습니다([#76](https://github.com/HKUDS/Vibe-Trading/pull/76), @mrbob-git 감사합니다). 후속 강화로 명시적 재무제표 필드 요청 시 Tushare enrichment가 실행되지 않으면 원시 가격 bar로 조용히 fallback하지 않고 즉시 실패합니다([#77](https://github.com/HKUDS/Vibe-Trading/pull/77)). +- **2026-05-07** 📈 **Tushare fundamentals + 커뮤니티 정리**: 펀더멘털 리서치 워크플로를 위해 point-in-time `TushareFundamentalProvider` 계약을 추가하고, 프로젝트 `TUSHARE_TOKEN` 환경 경로를 회귀 테스트로 고정했습니다([#74](https://github.com/HKUDS/Vibe-Trading/pull/74)). 커뮤니티 정리에서는 Vibe-Trading이 당분간 빠른 반복을 위해 하나의 UI 언어에 집중하고, DuckDuckGo 기반 `web_search`가 이미 번들되어 있으므로 중복 검색 의존성을 추가하지 않으며, 비공식 호스팅 배포를 API 키나 데이터 소스 토큰을 입력할 수 있는 신뢰 지점으로 보지 않는다는 점도 명확히 했습니다. +- **2026-05-06** 🚀 **v0.1.7 릴리스**([Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7), `pip install -U vibe-trading-ai`): 보안 경계 강화가 PyPI와 ClawHub에 게시되었습니다. API/read/upload/file/URL/generated-code/shell-tool/Docker 기본값을 더 안전하게 하면서 localhost CLI/Web UI 워크플로는 낮은 마찰을 유지합니다. 이번 사이클에는 Web UI Settings, 상관관계 히트맵, OpenAI Codex OAuth, A주 pre-ST 필터, 대화형 CLI UX, swarm preset inspection, 배당 분석, 개발 워크플로 개선, 감사된 frontend build dependency 하한도 포함됩니다. 0.1.7 기여자들과 조율된 보안 검증을 도와준 lemi9090 (S2W)에게 감사드립니다. +- **2026-05-05** 🛡️ **보안 경계 후속 조치**: 명시적 CORS origin, Settings credential indicator, web URL reading, Shadow Account code generation 주변의 남은 보안 경계 강화를 완료하고 각 경로에 회귀 테스트를 추가했습니다. 일반적인 localhost CLI/Web UI 워크플로는 그대로 유지되며, 원격 배포는 계속 `API_AUTH_KEY`와 명시적인 trusted origin을 사용해야 합니다. +- **2026-05-04** 🖥️ **대화형 CLI UX + CI 정리**: 대화형 모드에 provider/model, 세션 시간, 직전 실행 latency, 누적 tool-call 통계를 보여주는 live bottom status bar가 추가되었고, `prompt_toolkit`을 통해 방향키 기반 prompt history 탐색과 cursor editing을 지원합니다([#69](https://github.com/HKUDS/Vibe-Trading/pull/69)). `prompt_toolkit` 또는 TTY를 사용할 수 없으면 CLI는 여전히 Rich prompt로 fallback합니다. 강화된 file-import sandbox와 cross-platform `/tmp` 해석에 맞춰 CI path expectation도 정렬되어 main이 다시 green 상태가 되었습니다([`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)). +- **2026-05-03** 🛡️ **보안 강화 패치**: 비로컬 배포의 기본 API 인증을 강화하고, 민감한 run/session/swarm read를 보호하며, upload와 local file-reading 경계를 제한하고, shell-capable tool을 entry point별로 제어하며, 생성 전략을 import 전에 검증하고, Docker image를 기본적으로 non-root 사용자와 localhost-only published port로 실행합니다. Local CLI와 localhost Web UI 워크플로는 낮은 마찰을 유지하며, 원격 API/Web 배포는 `API_AUTH_KEY`를 설정해야 합니다. +- **2026-05-02** 🧭 **배당 분석 + 더 선명한 로드맵**: income stock, payout sustainability, dividend growth, shareholder yield, ex-dividend mechanics, yield-trap check를 위한 `dividend-analysis` 스킬을 추가하고 bundled-skill 회귀 테스트로 고정했습니다. 공개 로드맵은 Research Autopilot, Data Bridge, Options Lab, Portfolio Studio, Alpha Zoo, Research Delivery, Trust Layer, Community sharing에 집중하도록 정리되었습니다. +- **2026-05-01** 🔥 **상관관계 히트맵 + OpenAI Codex OAuth + A주 pre-ST 필터**: 새 correlation dashboard/API가 rolling return correlation을 계산하고 포트폴리오 및 종목 분석용 ECharts heatmap을 렌더링합니다([#64](https://github.com/HKUDS/Vibe-Trading/pull/64)). OpenAI Codex provider support는 이제 `vibe-trading provider login openai-codex`를 통해 ChatGPT OAuth를 사용하며, Settings metadata와 adapter regression test가 포함됩니다([#65](https://github.com/HKUDS/Vibe-Trading/pull/65)). A주 ST/*ST 리스크 스크리닝용 `ashare-pre-st-filter` 스킬도 추가 및 강화되었고, Sina penalty relevance filtering으로 securities-account 언급이 E2 count를 부풀리지 않도록 했습니다([#63](https://github.com/HKUDS/Vibe-Trading/pull/63)). +- **2026-04-30** ⚙️ **Web UI Settings + validation CLI 강화**: LLM provider/model, base URL, reasoning effort, data source credential을 위한 새 Settings page가 추가되었고, local/auth-protected settings API와 data-driven provider metadata가 이를 뒷받침합니다([#57](https://github.com/HKUDS/Vibe-Trading/pull/57)). 또한 `python -m backtest.validation `가 missing, blank, malformed, non-existent, non-directory input을 validation 시작 전에 operator-facing message로 명확히 실패하도록 강화했습니다([#60](https://github.com/HKUDS/Vibe-Trading/pull/60)). +- **2026-04-28** 🚀 **v0.1.6 릴리스**(`pip install -U vibe-trading-ai`): `pip install` / `uv tool install` 이후 `vibe-trading --swarm-presets`가 비어 있던 문제를 수정했습니다([#55](https://github.com/HKUDS/Vibe-Trading/issues/55)). preset YAML은 이제 `src.swarm` 패키지 내부에 번들되며 6개 테스트 회귀 suite로 고정됩니다. AKShare loader도 ETF(`510300.SH`)와 forex(`USDCNH`)를 올바른 endpoint로 routing하고 registry fallback을 강화했습니다. v0.1.5 이후의 benchmark comparison panel, `/upload` streaming + size limit, Futu loader(HK + A주), vnpy export skill, security hardening, frontend lazy loading(688KB → 262KB)을 모두 포함합니다. +- **2026-04-27** 📊 **벤치마크 패널 + 업로드 안전성**: 백테스트 출력에 yfinance 기반 SPY, CSI 300 등 resolution을 사용하는 benchmark comparison panel(ticker / benchmark return / excess return / information ratio)이 포함됩니다([#48](https://github.com/HKUDS/Vibe-Trading/issues/48)). 또한 `/upload`는 request body를 1MB chunk로 streaming하고 `MAX_UPLOAD_SIZE` 초과 시 중단하여 oversized/malformed client에서도 메모리를 제한합니다([#53](https://github.com/HKUDS/Vibe-Trading/pull/53)). 4-case regression suite로 고정되었습니다. +- **2026-04-22** 🛡️ **하드닝 + 신규 통합**: `safe_path`와 journal/shadow tool sandbox에서 path containment를 강제하고, `MANIFEST.in`이 sdist에 `.env.example` / tests / Docker files를 포함하며, route-level lazy loading으로 frontend initial bundle을 688KB → 262KB로 줄였습니다. Futu data loader for HK & A-share equities([#47](https://github.com/HKUDS/Vibe-Trading/pull/47))와 vnpy CtaTemplate export skill([#46](https://github.com/HKUDS/Vibe-Trading/pull/46))도 추가되었습니다. +- **2026-04-21** 🛡️ **워크스페이스 + 문서**: 상대 `run_dir`이 active run dir로 정규화되었습니다([#43](https://github.com/HKUDS/Vibe-Trading/pull/43)). README usage example도 추가되었습니다([#45](https://github.com/HKUDS/Vibe-Trading/pull/45)). +- **2026-04-20** 🔌 **Reasoning + Swarm**: 모든 `ChatOpenAI` 경로에서 `reasoning_content`가 보존되어 Kimi / DeepSeek / Qwen thinking이 end-to-end로 작동합니다([#39](https://github.com/HKUDS/Vibe-Trading/issues/39)). Swarm streaming과 깔끔한 Ctrl+C 처리도 반영되었습니다([#42](https://github.com/HKUDS/Vibe-Trading/issues/42)). +- **2026-04-19** 📦 **v0.1.5**: PyPI와 ClawHub에 게시되었습니다. `python-multipart` CVE floor bump, 신규 MCP tools 5개 연결(`analyze_trade_journal` + 4 shadow-account tools), `pattern_recognition` → `pattern` registry fix, Docker dependency parity, SKILL manifest sync(22 MCP tools / 71 skills)가 포함됩니다. +- **2026-04-18** 👥 **Shadow Account**: broker journal에서 전략 규칙 추출 → 여러 시장에서 shadow backtest → 규칙 위반, 조기 청산, 놓친 signal, counterfactual trade를 통해 정확히 얼마를 놓치는지 보여주는 8-section HTML/PDF report. 신규 tools 4개, skill 1개, 총 tools 32개. Trade Journal + Shadow Account sample은 이제 web UI welcome screen에 있습니다. +- **2026-04-17** 📊 **Trade Journal Analyzer + Universal File Reader**: broker export(同花顺/东财/富途/generic CSV) 업로드 → auto trading profile(holding days, win rate, PnL ratio, drawdown) + 4가지 bias diagnostics(disposition effect, overtrading, chasing momentum, anchoring). `read_document`는 이제 PDF, Word, Excel, PowerPoint, image(OCR), 40+ text format을 하나의 unified call로 dispatch합니다. +- **2026-04-16** 🧠 **Agent Harness**: persistent cross-session memory, FTS5 session search, self-evolving skills(full CRUD), 5-layer context compression, read/write tool batching. tools 27개, 신규 tests 107개. +- **2026-04-15** 🤖 **Z.ai + MiniMax**: Z.ai provider([#35](https://github.com/HKUDS/Vibe-Trading/pull/35)), MiniMax temperature fix + model update([#33](https://github.com/HKUDS/Vibe-Trading/pull/33)). providers 13개. +- **2026-04-14** 🔧 **MCP 안정성**: stdio transport에서 backtest tool `Connection closed` error를 수정했습니다([#32](https://github.com/HKUDS/Vibe-Trading/pull/32)). +- **2026-04-13** 🌐 **Cross-Market Composite Backtest**: 새 `CompositeEngine`이 A주 + crypto 같은 mixed-market portfolio를 shared capital pool과 per-market rule로 backtest합니다. swarm template variable fallback과 frontend timeout도 수정되었습니다. +- **2026-04-12** 🌍 **Multi-Platform Export**: `/pine`은 TradingView(Pine Script v6), TDX(通达信/同花顺/东方财富), MetaTrader 5(MQL5)로 전략을 한 번에 내보냅니다. +- **2026-04-11** 🛡️ **Reliability & DX**: `vibe-trading init` .env bootstrap([#19](https://github.com/HKUDS/Vibe-Trading/pull/19)), preflight checks, runtime data-source fallback, hardened backtest engine. Multi-language README([#21](https://github.com/HKUDS/Vibe-Trading/pull/21)). +- **2026-04-10** 📦 **v0.1.4**: Docker fix([#8](https://github.com/HKUDS/Vibe-Trading/issues/8)), `web_search` MCP tool, LLM providers 12개, `akshare`/`ccxt` dependencies. PyPI와 ClawHub에 게시되었습니다. +- **2026-04-09** 📊 **Backtest Wave 2**: ChinaFutures, GlobalFutures, Forex, Options v2 engines. Monte Carlo, Bootstrap CI, Walk-Forward validation. +- **2026-04-08** 🔧 **Multi-market backtest** with per-market rules, Pine Script v6 export, 5 data sources with auto-fallback.
--- -## 💡 Vibe-Trading이란? - -Vibe-Trading은 AI 기반 멀티 에이전트 금융 워크스페이스로, 자연어 요청을 전 세계 시장의 실행 가능한 트레이딩 전략, 리서치 인사이트, 포트폴리오 분석으로 전환합니다. - -### 핵심 역량: -• **자연어 → 전략** — 아이디어를 설명하면 에이전트가 코드 작성, 테스트, 내보내기까지 실행
-• **6개 데이터 소스, 무설정** — A주, HK/US, 크립토, 선물, FX 자동 폴백
-• **29개 전문 팀** — 투자, 트레이딩, 리스크를 위한 멀티 에이전트 스웜 워크플로우
-• **크로스세션 메모리** — 선호도와 인사이트를 기억하고 재사용 가능한 스킬을 자동 생성·진화
-• **7개 백테스트 엔진** — 크로스마켓 복합 테스트 + 통계 검증 + 4개 옵티마이저
-• **멀티 플랫폼 내보내기** — 클릭 한 번으로 TradingView, TDX(통달신/동화순), MetaTrader 5 - ---- - ## ✨ 주요 기능 - +
+
- - - + + -
- Research
-

🔍 트레이딩용 DeepResearch

- Skills

-
- • 74개 전문 스킬 + 크로스세션 영구 메모리
- • 자가 진화: 에이전트가 경험으로부터 워크플로우를 생성·개선
- • 5계층 컨텍스트 압축 — 긴 대화에서도 정보 손실 없음
- • 전 금융 도메인에 걸친 자연어 태스크 라우팅 +
+ 자가 개선 트레이딩 에이전트
+

🔍 자가 개선 트레이딩 에이전트

+
+ • 자연어 기반 시장 리서치
+ • 전략 초안 작성 및 파일/웹 분석
+ • 메모리 기반 워크플로
- Swarm
-

🐝 스웜 인텔리전스

- Swarm

+ 		+ 멀티 에이전트 트레이딩 팀
+

🐝 멀티 에이전트 트레이딩 팀

- • 29개 즉시 사용 가능한 트레이딩 팀 프리셋
- • DAG 기반 멀티 에이전트 오케스트레이션
- • 실시간 스트리밍 대시보드(에이전트 상태 표시)
- • FTS5 크로스세션 검색으로 모든 과거 대화 검색 + • 투자, 퀀트, 크립토, 리스크 팀
+ • 스트리밍 진행 상황과 영구 저장 리포트
+ • 가져온 시장 데이터로 grounding된 worker
- Backtest
-

📊 크로스마켓 백테스트

- Backtest

+
+ 크로스마켓 데이터와 백테스팅
+

📊 크로스마켓 데이터 & 백테스팅

- • A주, 홍콩/미국 주식, 크립토, 선물 및 FX
- • 7개 시장 엔진 + 크로스마켓 복합 엔진(공유 자금 풀)
- • 통계 검증: 몬테카를로, Bootstrap CI, 워크포워드
- • 15+ 성과 지표 및 4개 옵티마이저 + • A/HK/US 주식, 크립토, 선물, 외환
+ • 데이터 fallback과 composite backtest
+ • PIT 데이터, 검증, run card
- Quant
-

🧮 퀀트 분석 툴킷

- Quant

+ 		+ Shadow Account
+

👥 Shadow Account

- • 팩터 IC/IR 분석 및 분위 백테스트
- • 블랙-숄즈 가격 산출 및 풀 그릭스 계산
- • 기술적 패턴 인식 및 감지
- • MVO/리스크 패리티/BL 기반 포트폴리오 최적화 + • 브로커 거래 일지 행동 진단
+ • 규칙 기반 Shadow Account 비교
+ • 내보낼 수 있는 감사 리포트와 전략 코드
+ -## 8개 카테고리에 걸친 74개 스킬 +## 💡 Vibe-Trading이란? -- 📊 8개 카테고리에 조직된 74개 금융 스킬 -- 🌐 전통 시장부터 크립토·DeFi까지 완전 커버리지 -- 🔬 데이터 소싱부터 정량 리서치까지 포괄적 기능 +Vibe-Trading은 금융 질문을 실행 가능한 분석으로 바꾸는 오픈소스 리서치 워크스페이스입니다. 자연어 프롬프트를 시장 데이터 로더, 전략 생성, 백테스트 엔진, 리포트, 내보내기, 영구 리서치 메모리와 연결합니다. + +리서치, 시뮬레이션, 백테스팅을 위해 설계되었습니다. 실거래는 실행하지 않습니다. + +--- + +## ✨ 무엇을 할 수 있나요? + +| 작업 | 출력 | +|------|------| +| **트레이딩 질문하기** | 도구, 데이터, 문서, 재사용 가능한 세션 컨텍스트를 활용한 시장 리서치. | +| **전략 아이디어 백테스트** | 전략 코드, 지표, 벤치마크 컨텍스트, 검증 artifacts, run cards. | +| **내 거래 검토하기** | 브로커 일지 파싱, 행동 진단, 규칙 추출, Shadow Account 비교. | +| **반복 리서치 개선하기** | 영구 메모리와 편집 가능한 스킬로 유용한 루틴을 재사용 가능한 워크플로로 전환. | +| **애널리스트 팀 실행하기** | 투자, 퀀트, 크립토, 매크로, 리스크 워크플로를 위한 멀티 에이전트 리서치 리뷰. | +| **사용 가능한 artifacts 만들기** | 리포트, TradingView Pine Script, TDX, MetaTrader 5, MCP tools, 이후 리서치 세션. | + +--- + +## ⚡ 빠른 예제 + +```bash +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" +``` + +```bash +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는 일반적인 전략 템플릿이 아니라 사용자의 실제 거래 기록에서 시작합니다. + +브로커 export를 업로드하고 에이전트가 행동을 요약하게 한 뒤, 실제 거래 경로를 규칙 기반 shadow strategy와 비교합니다. + +| 단계 | 에이전트 출력 | +|------|--------------| +| **1. 일지 읽기** | 同花顺, 东方财富, 富途, generic CSV 형식의 브로커 export를 파싱합니다. | +| **2. 행동 프로파일링** | 보유 일수, 승률, 손익비, drawdown, disposition effect, overtrading, momentum chasing, anchoring 점검. | +| **3. 규칙 추출** | 반복되는 진입/청산을 모호한 요약이 아닌 명시적인 strategy profile로 변환합니다. | +| **4. Shadow 실행** | 추출된 규칙을 백테스트하고 규칙 위반, 조기 청산, 놓친 signal, 대안 거래 경로를 강조합니다. | +| **5. 리포트 제공** | 나중에 점검, 보관, 개선할 수 있는 HTML/PDF 리포트를 생성합니다. | + +```bash +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" +``` + +--- + +## 🧪 리서치 워크플로 + +대부분의 실행은 같은 evidence path를 따릅니다. 요청을 라우팅하고, 적절한 시장 컨텍스트를 로드하고, 도구를 실행하고, 출력을 검증하며, artifacts를 점검 가능한 상태로 유지합니다. + +| 계층 | 수행 내용 | +|------|-----------| +| **Plan** | 유용한 경우 관련 finance skills, tools, data sources, swarm preset을 선택합니다. | +| **Ground** | 사용 가능한 loader로 A주, HK/US 주식, 크립토, 선물, 외환, 문서, 웹 컨텍스트를 가져옵니다. | +| **Execute** | 테스트 가능한 전략 코드를 생성하고, 도구를 실행하며, 적절한 backtest engine 또는 analysis workflow를 사용합니다. | +| **Validate** | 지표, benchmark comparison, Monte Carlo, Bootstrap, Walk-Forward, run cards, 관련 warning을 추가합니다. | +| **Deliver** | TradingView, TDX, MetaTrader 5, MCP client, 이후 세션을 위한 리포트, artifacts, tool traces, exports를 반환합니다. | + +--- + +## 🔩 상세 기능 + +메인 README를 읽기 쉽게 유지하기 위해 상세 목록은 아래에 접어 두었습니다. 사용 가능한 구성 요소를 확인하고 싶을 때 열어보세요. + +
+금융 스킬 라이브러리 8개 카테고리 74개 스킬 + +- 📊 8개 카테고리로 구성된 74개 전문 금융 스킬 +- 🌐 전통 시장부터 크립토 & DeFi까지 완전한 커버리지 +- 🔬 데이터 sourcing부터 정량 리서치까지 포괄하는 기능 | 카테고리 | 스킬 | 예시 | |----------|------|------| @@ -174,27 +224,34 @@ Vibe-Trading은 AI 기반 멀티 에이전트 금융 워크스페이스로, 자 | Tool | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export` | | Risk Analysis | 1 | `ashare-pre-st-filter` | -## 29개 에이전트 스웜 팀 프리셋 +
-- 🏢 29개 즉시 사용 가능한 에이전트 팀 -- ⚡ 사전 구성된 금융 워크플로우 -- 🎯 투자, 트레이딩 및 리스크 관리 프리셋 +
+프리셋 트레이딩 팀 29개 swarm preset -| 프리셋 | 워크플로우 | -|--------|------------| -| `investment_committee` | 불/베어 토론 → 리스크 리뷰 → PM 최종 결정 | +- 🏢 바로 사용할 수 있는 29개 에이전트 팀 +- ⚡ 사전 구성된 금융 워크플로 +- 🎯 투자, 트레이딩, 리스크 관리 preset + +| 프리셋 | 워크플로 | +|--------|----------| +| `investment_committee` | bull/bear 토론 → 리스크 리뷰 → PM 최종 판단 | | `global_equities_desk` | A주 + HK/US + 크립토 리서처 → 글로벌 전략가 | -| `crypto_trading_desk` | 펀딩/베이시스 + 청산 + 플로우 → 리스크 매니저 | -| `earnings_research_desk` | 펀더멘털 + 리비전 + 옵션 → 실적 전략가 | -| `macro_rates_fx_desk` | 금리 + FX + 원자재 → 매크로 PM | -| `quant_strategy_desk` | 스크리닝 + 팩터 리서치 → 백테스트 → 리스크 감사 | -| `technical_analysis_panel` | 클래식 TA + 일목균형표 + 하모닉 + 엘리엇 + SMC → 컨센서스 | -| `risk_committee` | 드로다운 + 테일 리스크 + 레짐 리뷰 → 승인 | -| `global_allocation_committee` | A주 + 크립토 + HK/US → 크로스마켓 배분 | +| `crypto_trading_desk` | funding/basis + liquidation + flow → 리스크 매니저 | +| `earnings_research_desk` | 펀더멘털 + revision + options → 실적 전략가 | +| `macro_rates_fx_desk` | rates + FX + commodity → macro PM | +| `quant_strategy_desk` | screening + factor research → backtest → risk audit | +| `technical_analysis_panel` | classic TA + Ichimoku + harmonic + Elliott + SMC → consensus | +| `risk_committee` | drawdown + tail risk + regime review → sign-off | +| `global_allocation_committee` | A주 + 크립토 + HK/US → cross-market allocation | -추가로 20+ 특화 프리셋 — 모든 항목은 vibe-trading --swarm-presets로 확인. +추가로 20개 이상의 전문 preset이 있습니다. 전체 목록은 vibe-trading --swarm-presets로 확인하세요. -### 🎬 데모 + + +
+ +## 🎬 데모
@@ -211,7 +268,7 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 - +
☝️ 자연어 백테스트 & 멀티 에이전트 스웜 토론 — Web UI + CLI☝️ 자연어 백테스트 & 멀티 에이전트 swarm 토론 — Web UI + CLI
@@ -226,39 +283,47 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 pip install vibe-trading-ai ``` -> **패키지 이름 vs 명령:** PyPI 패키지는 `vibe-trading-ai`입니다. 설치하면 세 가지 명령을 얻습니다: +첫 리서치 작업을 실행하세요: + +```bash +vibe-trading init +vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024 and summarize return and drawdown" +``` + +> **패키지 이름 vs 명령:** PyPI 패키지는 `vibe-trading-ai`입니다. 설치하면 세 가지 명령을 사용할 수 있습니다: > > | Command | Purpose | > |---------|---------| -> | `vibe-trading` | 인터랙티브 CLI / TUI | +> | `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 # 웹 UI 실행 -vibe-trading-mcp # MCP 서버 시작(stdio) +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) ``` ### 또는 경로 선택 -| Path | 최적 용도 | 소요 시간 | -|------|-----------|-----------| +| 경로 | 적합한 용도 | 시간 | +|------|-------------|------| | **A. Docker** | 즉시 체험, 로컬 설정 없음 | 2분 | | **B. Local install** | 개발, 전체 CLI 접근 | 5분 | -| **C. MCP plugin** | 기존 에이전트에 플러그인 | 3분 | -| **D. ClawHub** | 한 줄 설치, 클론 불필요 | 1분 | +| **C. MCP plugin** | 기존 에이전트에 연결 | 3분 | +| **D. ClawHub** | 한 번의 명령, clone 불필요 | 1분 | ### 사전 요구사항 -- 지원 제공자의 **LLM API 키** — 또는 **Ollama** 로컬 실행(키 불필요) +- 지원 provider 중 하나의 **LLM API key** 또는 **Ollama** 로컬 실행(key 불필요) - 경로 B용 **Python 3.11+** - 경로 A용 **Docker** +- 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(로컬). 설정은 `.env.example` 참고. +> **지원 LLM provider:** OpenRouter, OpenAI, DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, Xiaomi MIMO, Z.ai, Ollama(local). 설정은 `.env.example`을 참고하세요. -> **팁:** 모든 시장은 자동 폴백 덕분에 API 키 없이도 작동합니다. yfinance(HK/US), OKX(크립토), AKShare(A주, 미국, HK, 선물, FX)는 모두 무료입니다. Tushare 토큰은 선택 사항 — AKShare가 A주 무료 폴백을 제공합니다. +> **팁:** 자동 fallback 덕분에 모든 시장은 API key 없이도 작동합니다. yfinance(HK/US), OKX(crypto), AKShare(A주, US, HK, futures, forex)는 모두 무료입니다. Tushare token은 선택 사항이며 AKShare가 A주 무료 fallback을 제공합니다. ### 경로 A: Docker (설정 불필요) @@ -266,136 +331,136 @@ vibe-trading-mcp # MCP 서버 시작(stdio) git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading cp agent/.env.example agent/.env -# agent/.env 수정 — 사용할 LLM 제공자를 주석 해제하고 API 키 설정 +# Edit agent/.env — uncomment your LLM provider and set API key docker compose up --build ``` -`http://localhost:8899`를 엽니다. 백엔드 + 프런트엔드가 하나의 컨테이너에 있습니다. +`http://localhost:8899`를 여세요. Backend + frontend가 하나의 container에 들어 있습니다. -Docker는 기본적으로 백엔드를 `127.0.0.1:8899`에만 게시하고, 비root 컨테이너 사용자로 앱을 실행합니다. API를 자신의 머신 밖으로 의도적으로 노출하는 경우 강한 `API_AUTH_KEY`를 설정하고 클라이언트에서 `Authorization: Bearer `를 보내세요. +Docker는 기본적으로 backend를 `127.0.0.1:8899`에 게시하고 앱을 non-root container user로 실행합니다. API를 자신의 머신 밖으로 의도적으로 노출하는 경우 강력한 `API_AUTH_KEY`를 설정하고 client에서 `Authorization: Bearer `를 보내세요. -### 경로 B: 로컬 설치 +### 경로 B: Local install ```bash 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 # 편집 — LLM 제공자 API 키 설정 -vibe-trading # 인터랙티브 TUI 실행 +cp agent/.env.example agent/.env # Edit — set your LLM provider API key +vibe-trading # Launch interactive TUI ```
웹 UI 시작(선택 사항) ```bash -# 터미널 1: API 서버 +# Terminal 1: API server vibe-trading serve --port 8899 -# 터미널 2: 프런트엔드 개발 서버 +# Terminal 2: Frontend dev server cd frontend && npm install && npm run dev ``` -`http://localhost:5899`를 엽니다. 프런트엔드는 `localhost:8899`로 API를 프록시합니다. +`http://localhost:5899`를 여세요. Frontend는 API 호출을 `localhost:8899`로 proxy합니다. -**프로덕션 모드(단일 서버):** +**Production mode(single server):** ```bash cd frontend && npm run build && cd .. -vibe-trading serve --port 8899 # FastAPI가 dist/를 정적 파일로 서빙 +vibe-trading serve --port 8899 # FastAPI serves dist/ as static files ```
-### 경로 C: MCP 플러그인 +### 경로 C: MCP plugin -아래 [MCP 플러그인](#-mcp-플러그인) 섹션을 참조하세요. +아래 [MCP Plugin](#-mcp-plugin) 섹션을 참고하세요. -### 경로 D: ClawHub (한 줄) +### 경로 D: ClawHub (한 번의 명령) ```bash npx clawhub@latest install vibe-trading --force ``` -스킬과 MCP 설정이 에이전트의 스킬 디렉터리에 다운로드됩니다. 자세한 내용은 [ClawHub 설치](#-mcp-플러그인)를 참고하세요. +skill + MCP config가 agent의 skills directory에 다운로드됩니다. 자세한 내용은 [ClawHub install](#-mcp-plugin)을 참고하세요. --- ## 🧠 환경 변수 -`agent/.env.example`을 `agent/.env`로 복사하고 원하는 제공자 블록의 주석을 해제하세요. 각 제공자에 3~4개의 변수가 필요합니다: +`agent/.env.example`을 `agent/.env`로 복사하고 사용할 provider block의 주석을 해제하세요. 각 provider에는 3~4개의 변수가 필요합니다: -| Variable | Required | Description | -|----------|:--------:|-------------| -| `LANGCHAIN_PROVIDER` | Yes | 제공자 이름(`openrouter`, `deepseek`, `groq`, `z.ai`, `ollama` 등) | -| `_API_KEY` | Yes* | API 키(`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` 등) | -| `_BASE_URL` | Yes | API 엔드포인트 URL | -| `LANGCHAIN_MODEL_NAME` | Yes | 모델 이름(예: `deepseek/deepseek-v3.2`) | -| `TUSHARE_TOKEN` | No | A주 데이터용 Tushare Pro 토큰(AKShare 폴백) | -| `TIMEOUT_SECONDS` | No | LLM 호출 타임아웃, 기본 120초 | -| `API_AUTH_KEY` | 네트워크 배포 권장 | API가 비로컬 클라이언트에서 접근 가능한 경우 필요한 Bearer token | -| `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | 원격 API / MCP-SSE 유형 배포에서 shell 가능 도구를 명시적으로 활성화 | -| `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | 문서와 브로커 거래 명세서 import용 추가 루트(쉼표 구분) | -| `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | 생성 코드 run 디렉터리용 추가 루트(쉼표 구분) | +| 변수 | 필수 | 설명 | +|------|:----:|------| +| `LANGCHAIN_PROVIDER` | Yes | Provider name(`openrouter`, `deepseek`, `groq`, `ollama` 등) | +| `_API_KEY` | Yes* | API key(`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` 등) | +| `_BASE_URL` | Yes | API endpoint URL | +| `LANGCHAIN_MODEL_NAME` | Yes | Model name(예: `deepseek-v4-pro`) | +| `TUSHARE_TOKEN` | No | A주 data용 Tushare Pro token(AKShare로 fallback) | +| `TIMEOUT_SECONDS` | No | LLM call timeout, 기본 120s | +| `API_AUTH_KEY` | 네트워크 배포 권장 | API가 non-local client에서 접근 가능할 때 필요한 Bearer token | +| `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | remote API/MCP-SSE 형태 배포에서 shell-capable tools 명시적 opt-in | +| `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | document와 broker-journal import용 추가 comma-separated roots | +| `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | generated-code run directory용 추가 comma-separated roots | -* Ollama는 API 키가 필요 없습니다. +* Ollama는 API key가 필요 없습니다. OpenAI Codex는 ChatGPT OAuth를 사용하며 token을 `agent/.env`가 아니라 `oauth-cli-kit`을 통해 저장합니다. -**무료 데이터(키 불필요):** AKShare의 A주, yfinance의 HK/US 주식, OKX의 크립토, CCXT의 100+ 크립토 거래소. 시스템이 시장별로 최적 소스를 자동 선택합니다. +**무료 데이터(key 불필요):** AKShare를 통한 A주, yfinance를 통한 HK/US equities, OKX를 통한 crypto, CCXT를 통한 100개 이상 crypto exchanges. 시스템은 시장별로 가장 적합한 source를 자동 선택합니다. ### 🎯 권장 모델 -Vibe-Trading은 툴 호출에 크게 의존하는 에이전트입니다 — skill, 백테스트, 메모리, swarm이 모두 tool call을 통해 실행됩니다. 모델 선택이 에이전트가 **실제로 툴을 사용하는지**, 아니면 학습 데이터에서 답을 꾸며내는지를 결정합니다. +Vibe-Trading은 tool-heavy agent입니다. skills, backtests, memory, swarms가 모두 tool call을 통해 흐릅니다. 모델 선택은 에이전트가 실제로 *도구를 사용하는지*, 아니면 학습 데이터에서 답을 만들어내는지를 직접 결정합니다. -| 등급 | 예시 | 용도 | -|------|------|------| -| **최상** | `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 불안정 — skill 로드나 backtest 실행 대신 "기억으로 답변" | +| 등급 | 예시 | 사용 시점 | +|------|------|-----------| +| **Best** | `anthropic/claude-opus-4.7`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.4`, `google/gemini-3.1-pro-preview` | 복잡한 swarms(3+ agents), 긴 리서치 세션, 논문급 분석 | +| **Sweet spot**(기본값) | `deepseek-v4-pro`, `deepseek/deepseek-v4-pro`, `x-ai/grok-4.20`, `z-ai/glm-5.1`, `moonshotai/kimi-k2.5`, `qwen/qwen3-max-thinking` | Daily driver — 약 1/10 비용으로 안정적인 tool-calling | +| **Agent 사용 시 피할 것** | `*-nano`, `*-flash-lite`, `*-coder-next`, small / distilled variants | tool-calling이 불안정합니다. agent가 skills를 로드하거나 backtest를 실행하는 대신 "기억에서 답하는" 것처럼 보일 수 있습니다. | -기본 `agent/.env.example`은 `deepseek/deepseek-v3.2` 사용 — 가성비 등급에서 가장 저렴한 옵션. +기본 `agent/.env.example`은 DeepSeek official API + `deepseek-v4-pro`를 포함합니다. OpenRouter 사용자는 `deepseek/deepseek-v4-pro`를 사용할 수 있습니다. --- ## 🖥 CLI 참조 ```bash -vibe-trading # 인터랙티브 TUI -vibe-trading run -p "..." # 단일 실행 -vibe-trading serve # API 서버 +vibe-trading # interactive TUI +vibe-trading run -p "..." # single run +vibe-trading serve # API server ```
-TUI 내 슬래시 명령 +TUI 내 slash commands | Command | Description | |---------|-------------| | `/help` | 모든 명령 표시 | -| `/skills` | 74개 금융 스킬 목록 | -| `/swarm` | 29개 스웜 팀 프리셋 목록 | -| `/swarm run [vars_json]` | 라이브 스트리밍으로 스웜 팀 실행 | -| `/swarm list` | 스웜 실행 이력 | -| `/swarm show ` | 스웜 실행 상세 | -| `/swarm cancel ` | 실행 중인 스웜 취소 | -| `/list` | 최근 실행 | -| `/show ` | 실행 상세 + 지표 | -| `/code ` | 생성된 전략 코드 | -| `/pine ` | 인디케이터 내보내기 (TradingView + TDX + MT5) | -| `/trace ` | 전체 실행 리플레이 | -| `/continue ` | 새 지시로 실행 계속 | -| `/sessions` | 채팅 세션 목록 | -| `/settings` | 런타임 설정 표시 | +| `/skills` | 74개 finance skills 목록 | +| `/swarm` | 29개 swarm team presets 목록 | +| `/swarm run [vars_json]` | live streaming으로 swarm team 실행 | +| `/swarm list` | Swarm run history | +| `/swarm show ` | Swarm run details | +| `/swarm cancel ` | 실행 중인 swarm 취소 | +| `/list` | Recent runs | +| `/show ` | Run details + metrics | +| `/code ` | Generated strategy code | +| `/pine ` | indicators export(TradingView + TDX + MT5) | +| `/trace ` | Full execution replay | +| `/continue ` | 새 instruction으로 run 계속 | +| `/sessions` | Chat sessions 목록 | +| `/settings` | Runtime config 표시 | | `/clear` | 화면 지우기 | | `/quit` | 종료 |
-단일 실행 & 플래그 +Single run & flags ```bash vibe-trading run -p "Backtest BTC-USDT MACD strategy, last 30 days" @@ -412,7 +477,7 @@ vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}' vibe-trading --list vibe-trading --show vibe-trading --code -vibe-trading --pine # 인디케이터 내보내기 (TradingView + TDX + MT5) +vibe-trading --pine # Export indicators (TradingView + TDX + MT5) vibe-trading --trace vibe-trading --continue "refine the strategy" vibe-trading --upload report.pdf @@ -422,6 +487,76 @@ vibe-trading --upload report.pdf --- +## 💡 예제 + +### 전략 & 백테스팅 + +```bash +# 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 +``` + +### 시장 리서치 + +```bash +# 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" +``` + +### Swarm 워크플로 + +```bash +# 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"}' +``` + +### 크로스세션 메모리 + +```bash +# 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" +``` + +### 문서 업로드 & 분석 + +```bash +# 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 서버 ```bash @@ -430,40 +565,40 @@ vibe-trading serve --port 8899 | Method | Endpoint | Description | |--------|----------|-------------| -| `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` | `/settings/llm` | Web UI LLM 설정 읽기 | -| `PUT` | `/settings/llm` | 로컬 LLM 설정 업데이트 | -| `GET` | `/settings/data-sources` | 로컬 데이터 소스 설정 읽기 | -| `PUT` | `/settings/data-sources` | 로컬 데이터 소스 설정 업데이트 | +| `GET` | `/runs` | runs 목록 | +| `GET` | `/runs/{run_id}` | run details | +| `GET` | `/runs/{run_id}/pine` | multi-platform indicator export | +| `POST` | `/sessions` | session 생성 | +| `POST` | `/sessions/{id}/messages` | message 전송 | +| `GET` | `/sessions/{id}/events` | SSE event stream | +| `POST` | `/upload` | PDF/file 업로드 | +| `GET` | `/swarm/presets` | swarm presets 목록 | +| `POST` | `/swarm/runs` | swarm run 시작 | +| `GET` | `/swarm/runs/{id}/events` | Swarm SSE stream | +| `GET` | `/settings/llm` | Web UI LLM settings 읽기 | +| `PUT` | `/settings/llm` | local LLM settings 업데이트 | +| `GET` | `/settings/data-sources` | local data source settings 읽기 | +| `PUT` | `/settings/data-sources` | local data source settings 업데이트 | -인터랙티브 문서: `http://localhost:8899/docs` +Interactive docs: `http://localhost:8899/docs` ### 보안 기본값 -localhost 개발에서는 `vibe-trading serve`가 브라우저 워크플로를 단순하게 유지합니다. 비로컬 클라이언트가 민감한 API에 접근하려면 `API_AUTH_KEY`가 필요합니다. JSON/업로드 요청에는 `Authorization: Bearer `를 사용하세요. 브라우저 EventSource 스트림은 Web UI Settings에 같은 키를 한 번 입력하면 처리됩니다. +localhost 개발에서 `vibe-trading serve`는 browser workflow를 단순하게 유지합니다. non-local client에서는 민감한 API endpoint에 `API_AUTH_KEY`가 필요합니다. JSON/upload request에는 `Authorization: Bearer `를 사용하세요. Browser EventSource stream은 Web UI Settings에 같은 key를 한 번 입력하면 Web UI가 처리합니다. -shell 가능 도구는 로컬 CLI와 신뢰된 localhost 워크플로에서 사용할 수 있지만, 원격 API 세션에는 기본적으로 노출되지 않습니다. 필요한 경우에만 `VIBE_TRADING_ENABLE_SHELL_TOOLS=1`을 명시적으로 설정하세요. 문서와 거래 명세서 리더는 기본적으로 업로드/import 루트로 제한됩니다. 파일은 `agent/uploads`, `agent/runs`, `./uploads`, `./data`, `~/.vibe-trading/uploads`, `~/.vibe-trading/imports`에 두거나, `VIBE_TRADING_ALLOWED_FILE_ROOTS`로 전용 디렉터리를 추가하세요. +Shell-capable tools는 local CLI와 trusted localhost workflow에서 사용할 수 있지만, `VIBE_TRADING_ENABLE_SHELL_TOOLS=1`을 명시적으로 설정하지 않는 한 remote API session에는 노출되지 않습니다. Document와 journal reader는 기본적으로 upload/import roots로 제한됩니다. 파일은 `agent/uploads`, `agent/runs`, `./uploads`, `./data`, `~/.vibe-trading/uploads`, `~/.vibe-trading/imports` 아래에 두거나, `VIBE_TRADING_ALLOWED_FILE_ROOTS`로 전용 directory를 추가하세요. ### Web UI Settings -Web UI Settings 페이지에서는 로컬 사용자가 LLM provider/model, Base URL, 생성 파라미터, reasoning effort, Tushare token 같은 선택적 시장 데이터 자격 증명을 업데이트할 수 있습니다. 설정은 `agent/.env`에 저장되며 provider 기본값은 `agent/src/providers/llm_providers.json`에서 로드됩니다. +Web UI Settings page에서는 local user가 LLM provider/model, base URL, generation parameters, reasoning effort, Tushare token 같은 선택적 market data credentials를 업데이트할 수 있습니다. Settings는 `agent/.env`에 저장되며 provider defaults는 `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 로컬 클라이언트에만 허용됩니다. +Settings read는 side effect가 없습니다. `GET /settings/llm`과 `GET /settings/data-sources`는 `agent/.env`를 만들지 않으며 project-relative path만 반환합니다. Settings read/write는 credential state를 노출하거나 credential/runtime environment를 업데이트할 수 있으므로 `API_AUTH_KEY`가 설정되어 있으면 인증이 필요합니다. dev mode에서 `API_AUTH_KEY`가 설정되지 않은 경우 settings access는 loopback client에서만 허용됩니다. --- -## 🔌 MCP 플러그인 +## 🔌 MCP Plugin -Vibe-Trading은 MCP 호환 클라이언트용 22개 MCP 도구를 제공합니다. stdio 서브프로세스로 실행 — 서버 설정 불필요. **22개 중 21개 도구는 API 키 없이 작동**(HK/US/크립토). `run_swarm`만 LLM 키가 필요합니다. +Vibe-Trading은 모든 MCP-compatible client를 위해 22개 MCP tools를 제공합니다. stdio subprocess로 실행되므로 server setup이 필요 없습니다. **22개 중 21개 tools는 API key 없이 작동합니다**(HK/US/crypto). `run_swarm`만 LLM key가 필요합니다.
Claude Desktop @@ -496,27 +631,27 @@ skills:
-Cursor / Windsurf / 기타 MCP 클라이언트 +Cursor / Windsurf / 기타 MCP clients ```bash vibe-trading-mcp # stdio (default) -vibe-trading-mcp --transport sse # 웹 클라이언트용 SSE +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`. +**노출되는 MCP tools(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에서 설치(한 줄) +ClawHub에서 설치(한 번의 명령) ```bash npx clawhub@latest install vibe-trading --force ``` -> 외부 API를 참조하는 스킬이 있어 VirusTotal 자동 스캔이 트리거되므로 `--force`가 필요합니다. 코드는 완전 오픈소스이며 검토 가능합니다. +> skill이 외부 API를 참조하여 VirusTotal 자동 스캔이 트리거되므로 `--force`가 필요합니다. 코드는 완전한 오픈소스이며 검토할 수 있습니다. -이 명령은 스킬과 MCP 설정을 에이전트의 스킬 디렉터리에 다운로드합니다. 클론이 필요 없습니다. +이 명령은 skill + MCP config를 agent의 skills directory에 다운로드합니다. clone은 필요 없습니다. ClawHub에서 보기: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading) @@ -525,9 +660,9 @@ ClawHub에서 보기: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills
OpenSpace — 자가 진화 스킬 -모든 74개 금융 스킬은 [open-space.cloud](https://open-space.cloud)에 게시되어 OpenSpace의 자가 진화 엔진을 통해 스스로 발전합니다. +74개 finance skills는 모두 [open-space.cloud](https://open-space.cloud)에 게시되어 있으며 OpenSpace의 self-evolution engine을 통해 자율적으로 발전합니다. -OpenSpace와 함께 사용하려면 두 MCP 서버를 에이전트 설정에 추가하세요: +OpenSpace와 함께 사용하려면 두 MCP server를 agent config에 추가하세요: ```json { @@ -547,7 +682,7 @@ OpenSpace와 함께 사용하려면 두 MCP 서버를 에이전트 설정에 추 } ``` -OpenSpace는 모든 74개 스킬을 자동으로 탐지하여 자동 수정, 자동 개선, 커뮤니티 공유를 활성화합니다. OpenSpace 연결 에이전트에서 `search_skills("finance backtest")`로 Vibe-Trading 스킬을 검색하세요. +OpenSpace는 74개 skills를 모두 자동 발견하여 auto-fix, auto-improve, community sharing을 활성화합니다. OpenSpace-connected agent에서 `search_skills("finance backtest")`로 Vibe-Trading skills를 검색하세요.
@@ -556,59 +691,59 @@ OpenSpace는 모든 74개 스킬을 자동으로 탐지하여 자동 수정, 자 ## 📁 프로젝트 구조
-클릭하여 펼치기 +펼쳐 보기 ``` Vibe-Trading/ ├── agent/ # Backend (Python) -│ ├── cli.py # CLI 엔트리포인트 — 인터랙티브 TUI + 서브커맨드 -│ ├── api_server.py # FastAPI 서버 — 실행, 세션, 업로드, 스웜, SSE -│ ├── mcp_server.py # MCP 서버 — OpenClaw / Claude Desktop용 22개 도구 +│ ├── cli.py # CLI entrypoint — 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 에이전트 코어 -│ │ │ ├── loop.py # 5계층 압축 + 읽기/쓰기 도구 배치 처리 -│ │ │ ├── context.py # 시스템 프롬프트 + 영구 메모리 자동 리콜 -│ │ │ ├── skills.py # 스킬 로더(74 번들 + 사용자 CRUD 생성) -│ │ │ ├── tools.py # 도구 기본 클래스 + 레지스트리 -│ │ │ ├── memory.py # 실행별 경량 워크스페이스 상태 -│ │ │ ├── frontmatter.py # 공유 YAML frontmatter 파서 -│ │ │ └── trace.py # 실행 트레이스 기록기 +│ │ ├── 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 (74 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/ # 크로스세션 영구 메모리 -│ │ │ └── persistent.py # 파일 기반 메모리 (~/.vibe-trading/memory/) +│ │ ├── memory/ # Cross-session persistent memory +│ │ │ └── persistent.py # file-based memory (~/.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, 파일 I/O, 팩터 분석, 옵션 등 +│ │ ├── tools/ # 27 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, etc. │ │ │ -│ │ ├── skills/ # 8개 카테고리의 74개 금융 스킬(SKILL.md 각각) -│ │ ├── swarm/ # 스웜 DAG 실행 엔진 -│ │ │ └── presets/ # 29개 스웜 프리셋 YAML 정의 -│ │ ├── session/ # 멀티턴 채팅 + FTS5 세션 검색 -│ │ └── providers/ # LLM 제공자 추상화 +│ │ ├── skills/ # 74 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/ # 백테스트 엔진 -│ ├── engines/ # 7개 엔진 + 크로스마켓 복합 엔진 + options_portfolio -│ ├── loaders/ # 6개 소스: tushare, okx, yfinance, akshare, ccxt, futu +│ └── 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.py # Registry + auto-fallback chains │ └── optimizers/ # MVO, equal vol, max div, risk parity │ ├── frontend/ # Web UI (React 19 + Vite + TypeScript) │ └── src/ │ ├── pages/ # Home, Agent, RunDetail, Compare │ ├── components/ # chat, charts, layout -│ └── stores/ # Zustand 상태 관리 +│ └── stores/ # Zustand state management │ -├── Dockerfile # 멀티 스테이지 빌드 -├── docker-compose.yml # 원커맨드 배포 -├── pyproject.toml # 패키지 설정 + CLI 엔트리포인트 +├── Dockerfile # Multi-stage build +├── docker-compose.yml # One-command deploy +├── pyproject.toml # Package config + CLI entrypoint └── LICENSE # MIT ``` @@ -618,13 +753,13 @@ Vibe-Trading/ ## 🏛 생태계 -Vibe-Trading은 **[HKUDS](https://github.com/HKUDS)** 에이전트 생태계의 일부입니다: +Vibe-Trading은 **[HKUDS](https://github.com/HKUDS)** agent ecosystem의 일부입니다:
ClawTeam
- 에이전트 스웜 인텔리전스 + Agent Swarm Intelligence 		NanoBot
@@ -632,11 +767,11 @@ Vibe-Trading은 **[HKUDS](https://github.com/HKUDS)** 에이전트 생태계의 		CLI-Anything
- 모든 소프트웨어를 에이전트 네이티브로 + 모든 소프트웨어를 agent-native로 		OpenSpace
- 자가 진화 AI 에이전트 스킬 + 자가 진화 AI agent skills
@@ -645,17 +780,17 @@ Vibe-Trading은 **[HKUDS](https://github.com/HKUDS)** 에이전트 생태계의 ## 🗺 로드맵 -> 단계적으로 배포합니다. 작업이 시작되면 항목이 [Issues](https://github.com/HKUDS/Vibe-Trading/issues)로 이동합니다. +> 단계적으로 배포합니다. 작업이 시작되면 항목은 [Issues](https://github.com/HKUDS/Vibe-Trading/issues)로 이동합니다. | Phase | Feature | Status | |-------|---------|--------| -| **Research Autopilot** | 야간 리서치 루프: 가설 → 데이터 수집 → 백테스트 → 근거 리포트 | In Progress | -| **Data Bridge** | 사용자 데이터 연결: 로컬 CSV/Parquet/SQL 커넥터 + schema mapping | Planned | -| **Options Lab** | 변동성 서피스, 그릭스 대시보드, 페이오프/시나리오 탐색기 | Planned | -| **Portfolio Studio** | 리스크 엑스레이, 제약 조건, 턴오버 고려 옵티마이저, 리밸런싱 노트 | Planned | -| **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 팩터 라이브러리와 스크리닝 + IC 테스트 | Planned | -| **Research Delivery** | Slack / Telegram / 이메일형 채널로 예약 브리프 전달 | Planned | -| **Trust Layer** | 재현 가능한 run card: 도구 추적, 데이터 소스, 가정, 인용 | In Progress | +| **Research Autopilot** | 야간 리서치 루프: hypothesis → data pull → backtest → evidence report | In Progress | +| **Data Bridge** | Bring-your-own data: local CSV/Parquet/SQL connectors with schema mapping | Planned | +| **Options Lab** | Vol surface, Greeks dashboard, payoff/scenario explorer | Planned | +| **Portfolio Studio** | Risk x-ray, constraints, turnover-aware optimizer, rebalance notes | Planned | +| **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 factor libraries with screening + IC tests | Planned | +| **Research Delivery** | Slack / Telegram / email-style channels로 예약 brief 전달 | Planned | +| **Trust Layer** | 재현 가능한 run cards: tool trace, data sources, assumptions, citations | In Progress | | **Community** | 공유 가능한 skills, presets, strategy cards | Exploring | --- @@ -664,27 +799,27 @@ Vibe-Trading은 **[HKUDS](https://github.com/HKUDS)** 에이전트 생태계의 기여를 환영합니다! 가이드는 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요. -**Good first issues**는 [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 라벨로 표시되어 있습니다 — 선택해 바로 시작해 보세요. +**Good first issues**는 [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 라벨이 붙어 있습니다. 하나를 골라 시작해 보세요. -더 큰 기여를 원하나요? 위 [로드맵](#-로드맵)을 확인하고 시작 전에 이슈를 열어 논의해주세요. +더 큰 기여를 하고 싶나요? 위 [로드맵](#-로드맵)을 확인하고 시작 전에 issue를 열어 논의해 주세요. --- ## 기여자 -Vibe-Trading에 기여해 주신 모든 분들께 감사드립니다! +Vibe-Trading에 기여해 주신 모든 분께 감사드립니다! -최근 v0.1.7 사이클 기여자와 크레딧: +최근 v0.1.7 cycle contributors and credits: -- @GTC2080 / TaoMu — Web UI Settings 및 provider/data-source 설정 API (#57) -- @BigNounce90 — backtest `run_dir` validation CLI 강화 (#60) -- @shadowinlife — A주 pre-ST 필터 스킬 (#63) -- @MB-Ndhlovu — 상관관계 히트맵 대시보드와 리뷰 수정 (#64, #66) -- @ykykj — OpenAI Codex OAuth provider 옵션 (#65) -- @RuifengFu — 대화형 CLI 상태 표시줄과 prompt 편집 (#69) -- @SiMinus — swarm preset inspection 명령 (#73) -- @warren618 / Haozhe Wu — 보안 강화, 릴리스 통합, 문서, Docker, 패키징, 로컬 개발 워크플로 -- lemi9090 (S2W) — 조율된 보안 연구, 검증, 공개 지원 +- @GTC2080 / TaoMu — Web UI Settings and provider/data-source configuration APIs (#57) +- @BigNounce90 — validation CLI hardening for backtest `run_dir` input (#60) +- @shadowinlife — A-share pre-ST filter skill (#63) +- @MB-Ndhlovu — correlation heatmap dashboard and review fixes (#64, #66) +- @ykykj — OpenAI Codex OAuth provider option (#65) +- @RuifengFu — interactive CLI live status bar and prompt editing (#69) +- @SiMinus — swarm preset inspection command (#73) +- @warren618 / Haozhe Wu — security hardening, release integration, docs, Docker, packaging, and local dev workflow +- lemi9090 (S2W) — coordinated security research, validation, and disclosure support @@ -694,7 +829,7 @@ Vibe-Trading에 기여해 주신 모든 분들께 감사드립니다! ## 면책조항 -Vibe-Trading은 리서치, 시뮬레이션, 백테스트 용도입니다. 투자 조언이 아니며 실거래를 실행하지 않습니다. 과거 성과는 미래 수익을 보장하지 않습니다. +Vibe-Trading은 리서치, 시뮬레이션, 백테스팅 전용입니다. 투자 조언이 아니며 실거래를 실행하지 않습니다. 과거 성과가 미래 수익을 보장하지 않습니다. ## 라이선스 @@ -702,14 +837,14 @@ MIT License — [LICENSE](LICENSE) 참조 --- -## 스타 히스토리 +## Star History [![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 ✨ + Vibe-Trading에 방문해 주셔서 감사합니다 ✨

visitors diff --git a/README_zh.md b/README_zh.md index 353b31af..a8fe9b8b 100644 --- a/README_zh.md +++ b/README_zh.md @@ -6,10 +6,10 @@ Vibe-Trading Logo

-

Vibe-Trading：你的个人交易代理

+

Vibe-Trading：你的个人交易智能体

- 一条命令，为你的代理赋予全栈交易能力 + 一条命令，让你的智能体具备完整交易研究能力

@@ -19,152 +19,202 @@ PyPI License
- Skills - Swarm - Tools - Data Sources -
Feishu WeChat Discord

- 核心功能  ·  - 演示  ·  - 产品介绍  ·  - 快速开始  ·  - CLI  ·  - API  ·  - MCP  ·  - 项目结构  ·  - 路线图  ·  - 贡献  ·  - 贡献者 + News  ·  + Features  ·  + Shadow Account  ·  + Demo  ·  + Quick Start  ·  + Examples  ·  + API / MCP  ·  + Roadmap  ·  + Contributing

- pip install vibe-trading-ai + pip install vibe-trading-ai

--- -## 📰 新闻 +## 📰 News -- **2026-05-14** 🧠 **持久记忆 CLI**：新增 `vibe-trading memory list/show/search/forget`，用户无需手动打开 `~/.vibe-trading/memory/` 就能查看、搜索和清理持久记忆。实现通过 lazy imports 保持非 memory CLI 命令启动速度，并在扫描 memory frontmatter 时把解析出的元数据值重新转成字符串，避免 Rich 渲染或 recall scoring 在边界输入上崩溃（[#102](https://github.com/HKUDS/Vibe-Trading/pull/102)，感谢 @Teerapat-Vatpitak）。 -- **2026-05-13** 🧭 **Swarm 真实价格 grounding + worker 事件清理**：Swarm run 现在会在分析员启动前预抓取市场数据，并把真实价格注入 worker prompts；标的查询统一走 `_detect_market(code)`，grounding payload 在线程间传递也更安全（[#93](https://github.com/HKUDS/Vibe-Trading/pull/93)）。Worker reports 会持久化到允许的 swarm-run 路径，`report.md` 摘要抽取更稳，preset timeout 已整体拉长，事件预览也会做 redact/sanitize，让流式更新更干净（[#84](https://github.com/HKUDS/Vibe-Trading/pull/84)）。 -- **2026-05-12** 🧾 **Trust Layer run cards**：回测现在会在 artifacts 旁边生成可复现的 `run_card.json` 与 `run_card.md`，记录 config 与策略代码 hash、数据来源、标量指标、validation 结果、warnings 和 artifact 校验和。Backtest 工具也会返回 run-card 路径，便于 CLI/API 直接展示证据包。 +- **2026-05-14** 🧠 现在可以通过 CLI 使用 `vibe-trading memory list/show/search/forget` 检查持久记忆（[#102](https://github.com/HKUDS/Vibe-Trading/pull/102)，感谢 @Teerapat-Vatpitak）。 +- **2026-05-13** 🧭 Swarm 运行现在会用已获取的市场数据为 worker 提供依据，并生成更清晰的持久化报告（[#93](https://github.com/HKUDS/Vibe-Trading/pull/93)，[#84](https://github.com/HKUDS/Vibe-Trading/pull/84)）。 +- **2026-05-12** 🧾 回测现在会随 artifacts 一起输出 `run_card.json` 和 `run_card.md`，便于复现实验研究。
-更早的新闻 +更早的更新 -- **2026-05-11** 🧭 **Memory slug、swarm 统计与 CLI 预检**：持久记忆生成文件 slug 时现在会保留 CJK 字符，避免中文/日文/韩文笔记发生静默文件名碰撞（[#95](https://github.com/HKUDS/Vibe-Trading/pull/95)，感谢 @voidborne-d）。Swarm run 总量会优先使用 provider 返回的 token usage，并保留原有估算回退（[#94](https://github.com/HKUDS/Vibe-Trading/pull/94)，感谢 @Teerapat-Vatpitak）；CLI run UI 也新增启动预检，用于提前暴露常见环境问题（[#96](https://github.com/HKUDS/Vibe-Trading/pull/96)，感谢 @ykykj）。 -- **2026-05-10** 🧱 **回归护栏 + run 元数据**：Memory recall 现在会把下划线当作 token 边界，因此 `mcp_wiring_test` 这类 snake_case 记忆可以被 "mcp wiring" 这类自然语言查询命中（[#87](https://github.com/HKUDS/Vibe-Trading/pull/87)，感谢 @hp083625）。MCP server 新增 subprocess smoke test，覆盖 initialize → `tools/list` → `tools/call`，防止首次调用死锁路径回归（[#86](https://github.com/HKUDS/Vibe-Trading/pull/86)）。同时合入低风险加固：Windows 路径敏感测试兼容、API best-effort 异常处理收窄、backtest `run_dir` allowed-root 校验，以及 SwarmRun provider/model 元数据（[#88](https://github.com/HKUDS/Vibe-Trading/pull/88)、[#90](https://github.com/HKUDS/Vibe-Trading/pull/90)、[#91](https://github.com/HKUDS/Vibe-Trading/pull/91)、[#92](https://github.com/HKUDS/Vibe-Trading/pull/92)，感谢 @Teerapat-Vatpitak）。 -- **2026-05-09** 🛡️ **API 路径加固 + MCP server 稳定性**：API run/session 路由现在会先校验路径 ID 再查询，拒绝带换行等畸形参数，并在 auth/security 回归测试中固定行为（[#80](https://github.com/HKUDS/Vibe-Trading/pull/80)，感谢 @SJoon99）。MCP server 在处理 `tools/call` 前会在主线程预热工具注册表，避免 lazy tool discovery 的首次调用死锁（[#85](https://github.com/HKUDS/Vibe-Trading/pull/85)，感谢 @Teerapat-Vatpitak）。Vite 开发代理也会遵守 `VITE_API_URL`，方便连接非默认后端地址（[#82](https://github.com/HKUDS/Vibe-Trading/pull/82)，感谢 @voidborne-d）。 -- **2026-05-08** 🧾 **Tushare 财报字段进入选股过滤**：A 股日频回测现在可以通过 `fundamental_fields` 请求按时间点安全的财务报表字段，让 SignalEngine 在公告/披露日期之后使用 `income_total_revenue`、`income_n_income`、`balancesheet_total_hldr_eqy_exc_min_int`、`fina_indicator_roe` 等带表名前缀的列做预筛选（[#76](https://github.com/HKUDS/Vibe-Trading/pull/76)，感谢 @mrbob-git）。后续加固让显式请求财报字段时如果 Tushare enrichment 失败会直接报错，而不是静默退回到纯行情数据（[#77](https://github.com/HKUDS/Vibe-Trading/pull/77)）。 -- **2026-05-07** 📈 **Tushare 基本面 + 社区维护**：新增面向基本面研究流程的按时间点 `TushareFundamentalProvider` 契约，并用回归测试覆盖项目 `TUSHARE_TOKEN` 环境变量路径（[#74](https://github.com/HKUDS/Vibe-Trading/pull/74)）。社区维护也明确了几个边界：快速迭代阶段 UI 暂时保持单语言；项目已内置 DuckDuckGo 支持的 `web_search`，不再增加重复搜索依赖；非官方托管部署不应被视为填写 API key 或数据源 token 的可信入口。 -- **2026-05-06** 🚀 **v0.1.7 发布**（[Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7)，`pip install -U vibe-trading-ai`）：安全边界加固版已发布到 PyPI 与 ClawHub，覆盖更安全的 API/读取/上传/文件/URL/生成代码/shell 工具/Docker 默认边界，同时保持本机 CLI/Web UI 低摩擦使用。本轮还包含 Web UI Settings、相关性热力图、OpenAI Codex OAuth、A 股 pre-ST 过滤、交互式 CLI 体验、swarm preset inspect、分红分析、开发工作流优化和前端构建依赖安全下限更新。感谢 0.1.7 周期的贡献者，以及 lemi9090 (S2W) 的协调披露和验证。 -- **2026-05-05** 🛡️ **安全边界补充加固**：补齐显式 CORS origin、Settings 凭据状态提示、网页 URL 读取与 Shadow Account 代码生成相关的安全边界，并为这些路径加入回归测试。本机 CLI/Web UI 使用方式不变；远程部署仍应使用 `API_AUTH_KEY` 和显式可信 origin。 -- **2026-05-04** 🖥️ **交互式 CLI 体验 + CI 清理**：交互模式新增实时底部状态栏，可显示 provider/model、会话时长、上次运行耗时和累计工具调用统计；同时通过 `prompt_toolkit` 支持方向键历史浏览与光标编辑（[#69](https://github.com/HKUDS/Vibe-Trading/pull/69)）。当 `prompt_toolkit` 或 TTY 不可用时，CLI 仍会回退到 Rich prompt。CI 路径断言也已对齐新的文件导入沙箱和跨平台 `/tmp` 解析，main 已恢复绿色（[`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)）。 -- **2026-05-03** 🛡️ **安全加固补丁**：收紧非本地部署的默认 API 鉴权，保护敏感的 run/session/swarm 读取接口，限制上传与本地文件读取边界，按入口类型控制 shell 能力工具，在导入前校验生成策略，并让 Docker 镜像默认以非 root 用户运行且只发布到 localhost。CLI 与本机 Web UI 仍保持低摩擦；远程 API/Web 部署应配置 `API_AUTH_KEY`。 -- **2026-05-02** 🧭 **分红分析 + 更清晰的路线图**：新增 `dividend-analysis` 技能，覆盖收益型股票、分红可持续性、股息增长、股东回报率、除息机制与高息陷阱检查，并用 bundled skill 回归测试固定。公开路线图现在聚焦未来工作：Research Autopilot、Data Bridge、Options Lab、Portfolio Studio、Alpha Zoo、Research Delivery、Trust Layer 和 Community 分享。 -- **2026-05-01** 🔥 **相关性热力图 + OpenAI Codex OAuth + A 股 pre-ST 过滤器**：新增相关性仪表盘/API，可计算滚动收益相关性，并用 ECharts 热力图展示组合与标的相关结构（[#64](https://github.com/HKUDS/Vibe-Trading/pull/64)）。OpenAI Codex provider 现支持通过 `vibe-trading provider login openai-codex` 使用 ChatGPT OAuth，并补齐 Settings 元数据与适配器回归测试（[#65](https://github.com/HKUDS/Vibe-Trading/pull/65)）。新增并加固 `ashare-pre-st-filter` 技能，用于 A 股 ST/*ST 风险筛查；Sina 处罚公告相关性过滤会避免证券账户名单提及误计入 E2 频次（[#63](https://github.com/HKUDS/Vibe-Trading/pull/63)）。 -- **2026-04-30** ⚙️ **Web UI 设置页 + validation CLI 加固**：新增 Settings 页面，可在本地配置 LLM provider/model、Base URL、reasoning effort 以及数据源凭据；对应 settings API 已加本地/鉴权保护，并把 provider 元数据改为数据驱动配置（[#57](https://github.com/HKUDS/Vibe-Trading/pull/57)）。同时加固 `python -m backtest.validation `：缺参、空路径、非法路径、不存在路径、非目录路径都会在验证开始前给出明确错误（[#60](https://github.com/HKUDS/Vibe-Trading/pull/60)）。 -- **2026-04-28** 🚀 **v0.1.6 发布**（`pip install -U vibe-trading-ai`）：修复 `pip install` / `uv tool install` 安装后 `vibe-trading --swarm-presets` 返回空的问题（[#55](https://github.com/HKUDS/Vibe-Trading/issues/55)）—— 预设 YAML 现已打包进 `src.swarm` 包内，配套 6 个回归测试。同时 AKShare 加载器正确路由 ETF（`510300.SH`）和外汇（`USDCNH`）到对应端点，并加固注册表回退链。汇总自 v0.1.5 以来全部更新：基准对比面板、`/upload` 流式上传 + 大小限制、富途数据源（港股/A 股）、vnpy 导出技能、安全加固、前端懒加载（688KB → 262KB）。 -- **2026-04-27** 📊 **基准对比面板 + 上传安全**：回测输出新增基准对比面板（标的 / 基准收益 / 超额收益 / 信息比率），通过 yfinance 解析 SPY、沪深 300 等基准（[#48](https://github.com/HKUDS/Vibe-Trading/issues/48)）。同时 `/upload` 端点改为 1MB 分块流式落盘，超过 `MAX_UPLOAD_SIZE` 立即中断并清理半截文件，让 50MB 上限在恶意/超大请求下真正生效（[#53](https://github.com/HKUDS/Vibe-Trading/pull/53)）—— 配套 4 个回归测试。 -- **2026-04-22** 🛡️ **加固 + 新接入**：`safe_path` 强制路径包含校验 + 交割单/影子账户工具沙箱化，新增 `MANIFEST.in` 让 sdist 打包 `.env.example` / 测试 / Docker 文件，前端按路由懒加载把首屏包从 688KB 压到 262KB。同时新增富途港股/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` 归一化到当前 run 目录（[#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**：从券商交割单提取你自己的策略规则 → 跨市场回测这个"影子" → 8 节 HTML/PDF 报告精确告诉你每一块钱是怎么错过的（规则违反、过早止盈、漏掉信号、反向操作）。4 个新工具、1 个新技能、共 32 工具。Trade Journal / Shadow Account 例句已进 Web UI 欢迎屏。 -- **2026-04-17** 📊 **交割单分析器 + 通用文件阅读器**：上传券商交割单（同花顺/东财/富途/通用 CSV）→ 自动生成交易画像（持仓天数、胜率、盈亏比、最大回撤）+ 4 项行为偏差诊断（处置效应、过度交易、追涨杀跌、锚定效应）。`read_document` 现统一分发 PDF、Word、Excel、PowerPoint、图片（OCR）及 40+ 文本格式，一个调用走全部类型。 -- **2026-04-16** 🧠 **Agent Harness**：跨会话持久记忆、FTS5 会话搜索、自进化技能（完整 CRUD）、5 层上下文压缩、读写工具批处理。27 工具，107 新测试。 -- **2026-04-15** 🤖 **Z.ai + MiniMax**：新增 Z.ai 提供商（[#35](https://github.com/HKUDS/Vibe-Trading/pull/35)），修复 MiniMax temperature 及模型更新（[#33](https://github.com/HKUDS/Vibe-Trading/pull/33)）。共 13 家提供商。 -- **2026-04-14** 🔧 **MCP 稳定性**：修复回测工具在 stdio 传输中的 `Connection closed` 错误（[#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**：`vibe-trading init` .env 引导（[#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)），`web_search` MCP 工具，12 家 LLM 提供商，`akshare`/`ccxt` 依赖。已发布至 PyPI 和 ClawHub。 -- **2026-04-09** 📊 **回测 Wave 2**：新增 ChinaFutures、GlobalFutures、Forex、Options v2 引擎。蒙特卡洛、Bootstrap CI、Walk-Forward 统计验证。 -- **2026-04-08** 🔧 **多市场回测**：分市场规则，Pine Script v6 导出，5 数据源自动回退。 +- **2026-05-11** 🧭 **记忆 slug、swarm 统计与 CLI 预检**：持久记忆在生成文件 slug 时会保留 CJK 字符，避免中文/日文/韩文笔记发生静默文件名冲突（[#95](https://github.com/HKUDS/Vibe-Trading/pull/95)，感谢 @voidborne-d）。Swarm 运行总量现在优先采用 provider 返回的 token 用量，并保留原有估算作为 fallback（[#94](https://github.com/HKUDS/Vibe-Trading/pull/94)，感谢 @Teerapat-Vatpitak）。CLI 运行界面也新增了启动预检，用于发现常见环境问题（[#96](https://github.com/HKUDS/Vibe-Trading/pull/96)，感谢 @ykykj）。 +- **2026-05-10** 🧱 **回归护栏与运行元数据**：记忆召回现在将下划线视为 token 边界，因此 `mcp_wiring_test` 这类 snake_case 记忆可以匹配 "mcp wiring" 等自然语言查询（[#87](https://github.com/HKUDS/Vibe-Trading/pull/87)，感谢 @hp083625）。MCP server 增加了覆盖 initialize → `tools/list` → `tools/call` 的 subprocess smoke test，以防止首次调用死锁路径回归（[#86](https://github.com/HKUDS/Vibe-Trading/pull/86)）。同时还完成了多项低风险加固：Windows 路径敏感测试、API best-effort 异常处理、backtest `run_dir` allowed-root 校验，以及 SwarmRun provider/model 元数据（[#88](https://github.com/HKUDS/Vibe-Trading/pull/88)，[#90](https://github.com/HKUDS/Vibe-Trading/pull/90)，[#91](https://github.com/HKUDS/Vibe-Trading/pull/91)，[#92](https://github.com/HKUDS/Vibe-Trading/pull/92)，感谢 @Teerapat-Vatpitak）。 +- **2026-05-09** 🛡️ **API 路径加固与 MCP server 稳定性**：API run/session 路由现在会在查询前校验 path ID，拒绝包含换行等异常字符的参数，并将该行为纳入 auth/security 回归测试（[#80](https://github.com/HKUDS/Vibe-Trading/pull/80)，感谢 @SJoon99）。MCP server 现在会在主线程预热工具注册表再处理 `tools/call`，避免懒加载工具发现中的首次调用死锁（[#85](https://github.com/HKUDS/Vibe-Trading/pull/85)，感谢 @Teerapat-Vatpitak）。Vite dev proxy 也会为非默认后端目标遵循 `VITE_API_URL`（[#82](https://github.com/HKUDS/Vibe-Trading/pull/82)，感谢 @voidborne-d）。 +- **2026-05-08** 🧾 **筛选器支持 Tushare 财报字段**：A 股日线回测现在可以通过 `fundamental_fields` 请求 PIT-safe 财务报表字段，使信号引擎能够在公告/披露日之后筛选 `income_total_revenue`、`income_n_income`、`balancesheet_total_hldr_eqy_exc_min_int`、`fina_indicator_roe` 等带表名前缀的字段（[#76](https://github.com/HKUDS/Vibe-Trading/pull/76)，感谢 @mrbob-git）。后续加固让显式财报字段请求在 Tushare enrich 无法运行时快速失败，而不是静默回退到原始价格 bar（[#77](https://github.com/HKUDS/Vibe-Trading/pull/77)）。 +- **2026-05-07** 📈 **Tushare fundamentals 与社区 triage**：新增面向基本面研究工作流的 point-in-time `TushareFundamentalProvider` contract，并为项目 `TUSHARE_TOKEN` 环境路径加入回归覆盖（[#74](https://github.com/HKUDS/Vibe-Trading/pull/74)）。社区 triage 也明确了：Vibe-Trading 目前会将快速迭代聚焦在单一 UI 语言；在已内置 DuckDuckGo 支持的 `web_search` 时避免添加冗余搜索依赖；非官方托管部署不应被视为 API key 或数据源 token 的可信存放位置。 +- **2026-05-06** 🚀 **v0.1.7 发布**（[Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.7)，`pip install -U vibe-trading-ai`）：安全边界加固已发布到 PyPI 和 ClawHub，覆盖更安全的 API/read/upload/file/URL/generated-code/shell-tool/Docker 默认行为，同时保持 localhost CLI/Web UI 工作流低摩擦。本周期还包含 Web UI Settings、相关性热力图、OpenAI Codex OAuth、A 股 pre-ST 筛选、交互式 CLI UX、swarm preset 检查、股息分析、开发工作流打磨，以及经审计的前端构建依赖下限。感谢 0.1.7 贡献者，也感谢 lemi9090 (S2W) 的协同安全验证。 +- **2026-05-05** 🛡️ **安全边界后续加固**：完成围绕显式 CORS origins、Settings 凭据指示、Web URL 读取和 Shadow Account 代码生成的剩余安全边界加固，并为每条路径加入回归测试。普通 localhost CLI/Web UI 工作流保持不变；远程部署应继续使用 `API_AUTH_KEY` 和显式可信 origins。 +- **2026-05-04** 🖥️ **交互式 CLI UX 与 CI 清理**：交互模式现在拥有实时底部状态栏，可显示 provider/model、session 时长、最近一次运行延迟和累计工具调用统计；并通过 `prompt_toolkit` 支持 prompt 历史导航和方向键光标编辑（[#69](https://github.com/HKUDS/Vibe-Trading/pull/69)）。当 `prompt_toolkit` 或 TTY 不可用时，CLI 仍会回退到 Rich prompts。CI 路径期望也已与加固后的 file-import sandbox 和跨平台 `/tmp` 解析对齐，使 main 恢复绿色（[`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)）。 +- **2026-05-03** 🛡️ **安全加固补丁**：收紧非本地部署的默认 API 认证，保护敏感 run/session/swarm 读取，限制上传与本地文件读取边界，按入口限制 shell-capable 工具，导入前校验生成策略加载，并让 Docker 镜像默认以非 root 用户和 localhost-only 端口发布运行。本地 CLI 和 localhost Web UI 工作流仍保持低摩擦；远程 API/Web 部署应设置 `API_AUTH_KEY`。 +- **2026-05-02** 🧭 **股息分析与更清晰路线图**：新增 `dividend-analysis` skill，用于收入型股票、派息可持续性、股息增长、股东收益、除息机制和收益率陷阱检查，并由 bundled-skill 回归测试固定。公开路线图现在聚焦即将开展的工作：Research Autopilot、Data Bridge、Options Lab、Portfolio Studio、Alpha Zoo、Research Delivery、Trust Layer 和 Community sharing。 +- **2026-05-01** 🔥 **相关性热力图、OpenAI Codex OAuth 与 A 股 pre-ST 筛选**：新的相关性 dashboard/API 会计算滚动收益相关性，并为组合与标的分析渲染 ECharts 热力图（[#64](https://github.com/HKUDS/Vibe-Trading/pull/64)）。OpenAI Codex provider 现在通过 `vibe-trading provider login openai-codex` 使用 ChatGPT OAuth，并加入 Settings 元数据和 adapter 回归测试（[#65](https://github.com/HKUDS/Vibe-Trading/pull/65)）。新增并加固 `ashare-pre-st-filter` skill，用于 A 股 ST/*ST 风险筛查，包括 Sina 处罚相关性过滤，避免证券账户提及错误抬高 E2 计数（[#63](https://github.com/HKUDS/Vibe-Trading/pull/63)）。 +- **2026-04-30** ⚙️ **Web UI Settings 与 validation CLI 加固**：新增 Settings 页面，用于配置 LLM provider/model、base URL、reasoning effort 和数据源凭据，由本地/认证保护的 settings API 与数据驱动的 provider metadata 支撑（[#57](https://github.com/HKUDS/Vibe-Trading/pull/57)）。同时加固 `python -m backtest.validation `，让缺失、空白、格式错误、不存在和非目录输入在 validation 开始前以清晰的面向操作者的信息失败（[#60](https://github.com/HKUDS/Vibe-Trading/pull/60)）。 +- **2026-04-28** 🚀 **v0.1.6 发布**（`pip install -U vibe-trading-ai`）：修复 `pip install` / `uv tool install` 后 `vibe-trading --swarm-presets` 返回空的问题（[#55](https://github.com/HKUDS/Vibe-Trading/issues/55)）—— preset YAML 现在打包在 `src.swarm` 包内，并由 6 个回归测试固定。同时 AKShare loader 会将 ETF（`510300.SH`）和外汇（`USDCNH`）正确路由到对应 endpoint，并强化 registry fallback。汇总 v0.1.5 以来的所有内容：benchmark comparison panel、`/upload` streaming + size limits、Futu loader（港股 + A 股）、vnpy export skill、安全加固、前端懒加载（688KB → 262KB）。 +- **2026-04-27** 📊 **Benchmark panel 与上传安全**：回测输出现在包含 benchmark comparison panel（ticker / benchmark return / excess return / information ratio），并通过 yfinance 支持 SPY、沪深 300 等解析（[#48](https://github.com/HKUDS/Vibe-Trading/issues/48)）。此外 `/upload` 会以 1 MB chunk 流式读取请求体，并在超过 `MAX_UPLOAD_SIZE` 时中止，在超大/畸形客户端场景下限制内存使用（[#53](https://github.com/HKUDS/Vibe-Trading/pull/53)）——由 4 个回归用例固定。 +- **2026-04-22** 🛡️ **加固与新集成**：`safe_path` + journal/shadow tool sandbox 强制路径 containment，`MANIFEST.in` 在 sdist 中包含 `.env.example` / tests / Docker files，route-level lazy loading 将前端初始 bundle 从 688KB 降到 262KB。另有面向港股与 A 股 equities 的 Futu data loader（[#47](https://github.com/HKUDS/Vibe-Trading/pull/47)）和 vnpy CtaTemplate export skill（[#46](https://github.com/HKUDS/Vibe-Trading/pull/46)）。 +- **2026-04-21** 🛡️ **Workspace 与文档**：相对 `run_dir` 会规范化到 active run dir（[#43](https://github.com/HKUDS/Vibe-Trading/pull/43)）。README 使用示例（[#45](https://github.com/HKUDS/Vibe-Trading/pull/45)）。 +- **2026-04-20** 🔌 **Reasoning 与 Swarm**：所有 `ChatOpenAI` 路径都会保留 `reasoning_content`，Kimi / DeepSeek / Qwen thinking 全链路可用（[#39](https://github.com/HKUDS/Vibe-Trading/issues/39)）。Swarm streaming 与干净的 Ctrl+C（[#42](https://github.com/HKUDS/Vibe-Trading/issues/42)）。 +- **2026-04-19** 📦 **v0.1.5**：发布到 PyPI 与 ClawHub。`python-multipart` CVE 下限升级，接入 5 个新 MCP tools（`analyze_trade_journal` + 4 个 shadow-account tools），修复 `pattern_recognition` → `pattern` registry，Docker 依赖对齐，SKILL manifest 同步（22 MCP tools / 71 skills）。 +- **2026-04-18** 👥 **Shadow Account**：从券商流水中提取你的策略规则 → 跨市场回测 shadow → 生成 8 节 HTML/PDF 报告，明确展示你错过了多少机会（规则违背、过早离场、错过信号、反事实交易）。新增 4 个工具、1 个 skill，总计 32 tools。Trade Journal + Shadow Account 示例现在已在 Web UI 欢迎页中提供。 +- **2026-04-17** 📊 **Trade Journal Analyzer 与 Universal File Reader**：上传券商导出（同花顺/东财/富途/generic CSV）→ 自动生成交易画像（持仓天数、胜率、盈亏比、回撤）+ 4 类行为偏差诊断（处置效应、过度交易、追涨、锚定）。`read_document` 现在以统一调用分发 PDF、Word、Excel、PowerPoint、图片（OCR）和 40+ 文本格式。 +- **2026-04-16** 🧠 **Agent Harness**：跨 session 持久记忆、FTS5 session search、自进化 skills（完整 CRUD）、5 层上下文压缩、read/write tool batching。27 tools，107 个新增测试。 +- **2026-04-15** 🤖 **Z.ai 与 MiniMax**：Z.ai provider（[#35](https://github.com/HKUDS/Vibe-Trading/pull/35)），MiniMax temperature 修复与模型更新（[#33](https://github.com/HKUDS/Vibe-Trading/pull/33)）。13 个 providers。 +- **2026-04-14** 🔧 **MCP 稳定性**：修复 stdio transport 下 backtest tool 的 `Connection closed` 错误（[#32](https://github.com/HKUDS/Vibe-Trading/pull/32)）。 +- **2026-04-13** 🌐 **跨市场组合回测**：新的 `CompositeEngine` 可用共享资金池和分市场规则回测混合市场组合（例如 A 股 + crypto）。同时修复 swarm template variable fallback 和前端 timeout。 +- **2026-04-12** 🌍 **多平台导出**：`/pine` 可一条命令将策略导出到 TradingView（Pine Script v6）、TDX（通达信/同花顺/东方财富）和 MetaTrader 5（MQL5）。 +- **2026-04-11** 🛡️ **可靠性与 DX**：`vibe-trading init` .env bootstrap（[#19](https://github.com/HKUDS/Vibe-Trading/pull/19)）、预检、运行时数据源 fallback、加固的回测引擎。多语言 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)）、`web_search` MCP tool、12 个 LLM providers、`akshare`/`ccxt` 依赖。发布到 PyPI 与 ClawHub。 +- **2026-04-09** 📊 **Backtest Wave 2**：ChinaFutures、GlobalFutures、Forex、Options v2 engines。Monte Carlo、Bootstrap CI、Walk-Forward validation。 +- **2026-04-08** 🔧 **多市场回测**，支持分市场规则、Pine Script v6 导出、5 个数据源自动 fallback。
--- -## 💡 Vibe-Trading 是什么？ +## ✨ Key Features -Vibe-Trading 是一个由 AI 驱动的多代理金融工作台，将自然语言请求转化为可执行的交易策略、研究洞见和跨全球市场的投资组合分析。 - -### 核心能力： -• **自然语言 → 策略** —— 描述想法，代理自动编写、测试、导出交易代码
-• **6 大数据源，零配置** —— A 股、港美股、加密、期货、外汇自动回退
-• **29 支专家团队** —— 预构建的多代理 swarm 工作流，覆盖投资、交易与风控
-• **跨会话记忆** —— 记住偏好与洞察；自动创建、进化可复用技能
-• **7 大回测引擎** —— 跨市场复合测试 + 统计验证 + 4 种优化器
-• **多平台导出** —— 一键到 TradingView、TDX（通达信/同花顺）和 MetaTrader 5 - ---- - -## ✨ 核心功能 - - +
+
- - - + + -
- Research
-

🔍 面向交易的深度研究

- Skills

-
- • 74 个专长技能 + 跨会话持久记忆
- • 自进化：代理从经验中创建并优化工作流
- • 5 层上下文压缩——长对话不丢失信息
- • 覆盖全金融领域的自然语言任务路由 +
+ Self-improving trading agent
+

🔍 自我改进的交易智能体

+
+ • 自然语言市场研究
+ • 策略草稿与文件/网页分析
+ • 由记忆驱动的研究工作流
- Swarm
-

🐝 群体智能

- Swarm

+ 		+ Multi-agent trading teams
+

🐝 多智能体交易团队

- • 29 个开箱即用的交易团队预设
- • 基于 DAG 的多代理编排
- • 实时流式仪表盘，显示代理运行状态
- • FTS5 跨会话搜索全部历史对话 + • 投资、量化、加密与风控团队
+ • 流式进度与持久化报告
+ • Worker 基于已获取的市场数据展开分析
- Backtest
-

📊 跨市场回测

- Backtest

+
+ Cross-market data and backtesting
+

📊 跨市场数据与回测

- • A 股、港美股、加密、期货与外汇
- • 7 个市场引擎 + 跨市场复合引擎（共享资金池）
- • 统计验证：蒙特卡洛、Bootstrap 置信区间、Walk-Forward
- • 15+ 绩效指标与 4 种优化器 + • A 股、港股、美股、加密、期货与外汇
+ • 数据 fallback 与组合回测
+ • PIT 数据、验证与 run cards
- Quant
-

🧮 量化分析工具箱

- Quant

+ 		+ Shadow Account
+

👥 Shadow Account

- • 因子 IC/IR 分析与分位回测
- • Black-Scholes 定价与全套 Greeks 计算
- • 技术形态识别与检测
- • 投资组合优化：MVO/风险平价/BL + • 券商交易日志行为诊断
+ • 基于规则的 Shadow Account 对比
+ • 可导出的审计报告与策略代码
+ -## 8 大类别中的 74 个技能 +## 💡 What Is Vibe-Trading? -- 📊 74 个金融专长技能，划分 8 大类 -- 🌐 覆盖传统市场到加密与 DeFi -- 🔬 覆盖数据获取到量化研究的全链路能力 +Vibe-Trading 是一个开源研究工作台，用于把金融问题转化为可运行的分析。它将自然语言提示连接到市场数据加载器、策略生成、回测引擎、报告、导出和持久研究记忆。 -| Category | Skills | Examples | -|----------|--------|----------| +它面向研究、模拟和回测，不执行实盘交易。 + +--- + +## ✨ What You Can Do + +| 任务 | 输出 | +|------|------| +| **提出交易问题** | 结合工具、数据、文档和可复用 session 上下文的市场研究。 | +| **回测策略想法** | 策略代码、指标、benchmark 上下文、验证 artifacts 和 run cards。 | +| **复盘自己的交易** | 券商日志解析、行为诊断、规则提取和 Shadow Account 对比。 | +| **改进重复研究** | 持久记忆和可编辑 skills 将有用流程变成可复用工作流。 | +| **运行分析师团队** | 面向投资、量化、加密、宏观和风控工作流的多智能体研究评审。 | +| **交付可用成果** | 报告、TradingView Pine Script、TDX、MetaTrader 5、MCP tools，以及可延续的研究 sessions。 | + +--- + +## ⚡ Quick Example + +```bash +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" +``` + +```bash +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 + +Shadow Account 从你自己的交易记录出发，而不是从通用策略模板出发。 + +上传券商导出，让智能体总结你的交易行为，然后将真实交易路径与基于规则的 shadow strategy 进行对比。 + +| 步骤 | 智能体输出 | +|------|------------| +| **1. 读取交易日志** | 解析来自同花顺、东方财富、富途和 generic CSV 格式的券商导出。 | +| **2. 生成行为画像** | 持仓天数、胜率、盈亏比、回撤、处置效应、过度交易、追涨和锚定检查。 | +| **3. 提取你的规则** | 将反复出现的入场/出场行为转化为明确策略画像，而不是空泛总结。 | +| **4. 运行 shadow** | 回测提取出的规则，并高亮规则违背、过早离场、错过信号和替代交易路径。 | +| **5. 交付报告** | 生成可检查、可归档或在后续 session 中继续精修的 HTML/PDF 报告。 | + +```bash +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" +``` + +--- + +## 🧪 Research Workflow + +多数运行都会遵循同一条证据路径：路由请求、加载正确的市场上下文、执行工具、验证输出，并保持 artifacts 可检查。 + +| 层 | 发生什么 | +|----|----------| +| **Plan** | 选择相关金融 skills、tools、数据源，以及在有帮助时选择 swarm preset。 | +| **Ground** | 通过可用 loader 拉取 A 股、港股/美股、加密、期货、外汇、文档或网页上下文。 | +| **Execute** | 生成可测试的策略代码，运行工具，并使用匹配的回测引擎或分析工作流。 | +| **Validate** | 在适用时加入指标、benchmark comparison、Monte Carlo、Bootstrap、Walk-Forward、run cards 和 warnings。 | +| **Deliver** | 返回报告、artifacts、tool traces，以及面向 TradingView、TDX、MetaTrader 5、MCP clients 或后续 sessions 的导出。 | + +--- + +## 🔩 Detailed Capabilities + +为保持主 README 易读，详细清单折叠在下方。需要检查可用构件时可展开查看。 + +
+Finance Skill Library 8 个类别中的 74 个 skills + +- 📊 74 个专业金融 skills，分布在 8 个类别中 +- 🌐 覆盖传统市场、加密与 DeFi +- 🔬 从数据源到量化研究的完整能力链路 + +| 类别 | Skills | 示例 | +|------|--------|------| | 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` | @@ -174,27 +224,34 @@ Vibe-Trading 是一个由 AI 驱动的多代理金融工作台，将自然语言 | Tool | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export` | | Risk Analysis | 1 | `ashare-pre-st-filter` | -## 29 个 Agent Swarm 团队预设 +
-- 🏢 29 组可即用的代理团队 -- ⚡ 预配置的金融工作流 -- 🎯 投资、交易与风险管理场景预设 +
+Preset Trading Teams 29 个 swarm presets -| Preset | Workflow | -|--------|----------| -| `investment_committee` | 多空辩论 → 风险复核 → PM 最终决策 | -| `global_equities_desk` | A 股 + 港美股 + 加密研究员 → 全球策略师 | -| `crypto_trading_desk` | 资金费/基差 + 清算 + 资金流 → 风险经理 | -| `earnings_research_desk` | 基本面 + 修正 + 期权 → 财报策略师 | +- 🏢 29 个开箱即用的智能体团队 +- ⚡ 预配置金融工作流 +- 🎯 投资、交易与风险管理 presets + +| Preset | 工作流 | +|--------|--------| +| `investment_committee` | 多空辩论 → 风险审查 → PM 最终决策 | +| `global_equities_desk` | A 股 + 港/美股 + 加密研究员 → 全球策略师 | +| `crypto_trading_desk` | Funding/basis + liquidation + flow → 风险经理 | +| `earnings_research_desk` | 基本面 + 预期修正 + options → 财报策略师 | | `macro_rates_fx_desk` | 利率 + 外汇 + 商品 → 宏观 PM | | `quant_strategy_desk` | 筛选 + 因子研究 → 回测 → 风险审计 | -| `technical_analysis_panel` | 经典 TA + 一目均衡 + 谐波 + 艾略特 + SMC → 共识 | -| `risk_committee` | 回撤 + 尾部风险 + Regime 评审 → 签核 | -| `global_allocation_committee` | A 股 + 加密 + 港美股 → 跨市场配置 | +| `technical_analysis_panel` | 经典 TA + Ichimoku + harmonic + Elliott + SMC → 共识 | +| `risk_committee` | 回撤 + 尾部风险 + regime review → 审批 | +| `global_allocation_committee` | A 股 + 加密 + 港/美股 → 跨市场配置 | -另有 20+ 专项预设 —— 运行 vibe-trading --swarm-presets 查看全部。 +另有 20+ 专业 presets，可运行 vibe-trading --swarm-presets 查看全部。 -### 🎬 演示 + + +
+ +## 🎬 Demo
@@ -211,14 +268,14 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 - +
☝️ 自然语言回测与多代理 swarm 辩论 —— Web UI + CLI☝️ 自然语言回测与多智能体 swarm 辩论 — Web UI + CLI
--- -## 🚀 快速开始 +## 🚀 Quick Start ### 一行安装（PyPI） @@ -226,39 +283,47 @@ https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30 pip install vibe-trading-ai ``` -> **包名与命令：** PyPI 包名是 `vibe-trading-ai`。安装后会获得三个命令： -> -> | Command | Purpose | -> |---------|---------| -> | `vibe-trading` | 交互式 CLI / TUI | -> | `vibe-trading serve` | 启动 FastAPI Web 服务器 | -> | `vibe-trading-mcp` | 启动 MCP 服务器（Claude Desktop、OpenClaw、Cursor 等） | +然后运行第一个研究任务： ```bash -vibe-trading init # 交互式 .env 配置 -vibe-trading # 启动 CLI -vibe-trading serve --port 8899 # 启动 Web UI -vibe-trading-mcp # 启动 MCP 服务器（stdio） +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 web server | +> | `vibe-trading-mcp` | 启动 MCP server（用于 Claude Desktop、OpenClaw、Cursor 等） | -| Path | Best for | Time | -|------|----------|------| -| **A. Docker** | 立即体验，零本地配置 | 2 min | -| **B. Local install** | 开发、完整 CLI 访问 | 5 min | -| **C. MCP plugin** | 接入你现有的代理 | 3 min | -| **D. ClawHub** | 一条命令，无需克隆 | 1 min | +```bash +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** | 立即试用，零本地配置 | 2 min | +| **B. Local install** | 开发，完整 CLI 访问 | 5 min | +| **C. MCP plugin** | 接入你现有的智能体 | 3 min | +| **D. ClawHub** | 一条命令，无需 clone | 1 min | ### 前置条件 -- 任一支持提供商的 **LLM API key**——或使用 **Ollama** 本地运行（无需 key） -- Path B 需 **Python 3.11+** -- Path A 需 **Docker** +- 任意受支持 provider 的 **LLM API key**，或使用 **Ollama** 本地运行（无需 key） +- 路径 B 需要 **Python 3.11+** +- 路径 A 需要 **Docker** +- 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、智谱、Moonshot/Kimi、MiniMax、小米 MIMO、Z.ai、Ollama（本地）。参见 `.env.example` 配置。 +> **支持的 LLM providers：** OpenRouter、OpenAI、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、Xiaomi MIMO、Z.ai、Ollama（本地）。配置见 `.env.example`。 -> **提示：** 所有市场都可在无 API key 情况下运行，因自动回退。yfinance（港美股）、OKX（加密）、AKShare（A 股、美股、港股、期货、外汇）均免费。Tushare token 可选——A 股可回退到 AKShare 免费获取。 +> **提示：** 由于自动 fallback，所有市场都可以在没有任何 API key 的情况下工作。yfinance（港/美股）、OKX（加密）和 AKShare（A 股、美股、港股、期货、外汇）都是免费的。Tushare token 是可选项，AKShare 可作为 A 股免费 fallback。 ### Path A: Docker（零配置） @@ -266,55 +331,55 @@ vibe-trading-mcp # 启动 MCP 服务器（stdio） git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading cp agent/.env.example agent/.env -# 编辑 agent/.env —— 取消注释你的 LLM 提供商并填写 API key +# Edit agent/.env — uncomment your LLM provider and set API key docker compose up --build ``` -打开 `http://localhost:8899`。后端与前端同一容器。 +打开 `http://localhost:8899`。后端 + 前端在同一个容器中运行。 -Docker 默认只把后端发布到 `127.0.0.1:8899`，并以非 root 容器用户运行应用。如果你有意把 API 暴露到本机之外，请设置强 `API_AUTH_KEY`，客户端通过 `Authorization: Bearer ` 调用。 +Docker 默认将后端发布在 `127.0.0.1:8899`，并以非 root 容器用户运行应用。如果你有意将 API 暴露到本机之外，请设置强 `API_AUTH_KEY`，并让客户端发送 `Authorization: Bearer `。 -### Path B: 本地安装 +### Path B: Local install ```bash 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 # 编辑 —— 设置你的 LLM 提供商 API key -vibe-trading # 启动交互式 TUI +cp agent/.env.example agent/.env # Edit — set your LLM provider API key +vibe-trading # Launch interactive TUI ```
启动 Web UI（可选） ```bash -# 终端 1：API 服务器 +# Terminal 1: API server vibe-trading serve --port 8899 -# 终端 2：前端开发服务器 +# Terminal 2: Frontend dev server cd frontend && npm install && npm run dev ``` -打开 `http://localhost:5899`。前端会代理到 `localhost:8899`。 +打开 `http://localhost:5899`。前端会将 API 调用代理到 `localhost:8899`。 -**生产模式（单服务器）：** +**生产模式（单 server）：** ```bash cd frontend && npm run build && cd .. -vibe-trading serve --port 8899 # FastAPI 同时提供 dist/ 静态文件 +vibe-trading serve --port 8899 # FastAPI serves dist/ as static files ```
-### Path C: MCP 插件 +### Path C: MCP plugin -见下方 [MCP 插件](#-mcp-插件) 章节。 +见下方 [MCP Plugin](#-mcp-plugin) 章节。 ### Path D: ClawHub（一条命令） @@ -322,79 +387,80 @@ vibe-trading serve --port 8899 # FastAPI 同时提供 dist/ 静态文件 npx clawhub@latest install vibe-trading --force ``` -技能与 MCP 配置会下载到你代理的技能目录。详情见 [ClawHub 安装](#-mcp-插件)。 +skill + MCP config 会下载到你的智能体 skills 目录。详情见 [ClawHub install](#-mcp-plugin)。 --- -## 🧠 环境变量 +## 🧠 Environment Variables -复制 `agent/.env.example` 到 `agent/.env`，取消注释你需要的提供商块。每个提供商需 3-4 个变量： +将 `agent/.env.example` 复制为 `agent/.env`，并取消注释你想使用的 provider block。每个 provider 需要 3-4 个变量： -| Variable | Required | Description | -|----------|:--------:|-------------| -| `LANGCHAIN_PROVIDER` | Yes | 提供商名称（`openrouter`、`deepseek`、`groq`、`z.ai`、`ollama` 等） | -| `_API_KEY` | Yes* | API key（`OPENROUTER_API_KEY`、`DEEPSEEK_API_KEY` 等） | -| `_BASE_URL` | Yes | API 端点 URL | -| `LANGCHAIN_MODEL_NAME` | Yes | 模型名（如 `deepseek/deepseek-v3.2`） | -| `TUSHARE_TOKEN` | No | A 股数据的 Tushare Pro token（可回退 AKShare） | +| 变量 | 必需 | 说明 | +|------|:----:|------| +| `LANGCHAIN_PROVIDER` | Yes | Provider 名称（`openrouter`, `deepseek`, `groq`, `ollama` 等） | +| `_API_KEY` | Yes* | API key（`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` 等） | +| `_BASE_URL` | Yes | API endpoint URL | +| `LANGCHAIN_MODEL_NAME` | Yes | 模型名称（例如 `deepseek-v4-pro`） | +| `TUSHARE_TOKEN` | No | A 股数据的 Tushare Pro token（会 fallback 到 AKShare） | | `TIMEOUT_SECONDS` | No | LLM 调用超时，默认 120s | -| `API_AUTH_KEY` | 网络部署建议设置 | API 可被非本地客户端访问时所需的 Bearer token | -| `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | 远程 API / MCP-SSE 类部署显式启用 shell 能力工具 | -| `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | 文档和券商交割单导入的额外逗号分隔目录 | -| `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | 生成代码 run 目录的额外逗号分隔目录 | +| `API_AUTH_KEY` | 网络部署推荐 | API 可被非本地客户端访问时要求的 Bearer token | +| `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | 在远程 API/MCP-SSE 风格部署中显式启用 shell-capable tools | +| `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | 文档和券商日志导入额外允许的逗号分隔 roots | +| `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | 生成代码 run directories 额外允许的逗号分隔 roots | -* Ollama 不需要 API key。 +* Ollama 不需要 API key。OpenAI Codex 使用 ChatGPT OAuth，并通过 `oauth-cli-kit` 存储 token，不写入 `agent/.env`。 -**免费数据（无需 key）：** A 股经 AKShare，港美股经 yfinance，加密经 OKX，100+ 加密交易所经 CCXT。系统会为每个市场自动选择最佳可用数据源。 +**免费数据（无需 key）：** A 股通过 AKShare，港/美股通过 yfinance，加密通过 OKX，100+ 加密交易所通过 CCXT。系统会为每个市场自动选择最佳可用数据源。 -### 🎯 推荐模型 +### 🎯 Recommended Models -Vibe-Trading 是重度依赖工具调用的 agent — skills、回测、记忆、swarm 全部通过 tool call 完成。模型选择直接决定 agent 是**真的在用工具**，还是从训练数据里编答案。 +Vibe-Trading 是高度依赖工具的智能体：skills、backtests、memory 和 swarms 都会通过工具调用流转。模型选择会直接决定智能体是实际使用工具，还是从训练数据中编造答案。 -| 等级 | 示例 | 适用场景 | -|------|------|---------| -| **最佳** | `anthropic/claude-opus-4.7`、`anthropic/claude-sonnet-4.6`、`openai/gpt-5.4`、`google/gemini-3.1-pro-preview` | 复杂 swarm（3+ agent）、长研究会话、论文级分析 | -| **性价比**（默认） | `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 | -| **不建议用于 agent** | `*-nano`、`*-flash-lite`、`*-coder-next`、小参数 / 蒸馏版 | tool-calling 不可靠 — agent 会"凭记忆回答"而不加载 skill 或跑回测 | +| 档位 | 示例 | 使用场景 | +|------|------|----------| +| **Best** | `anthropic/claude-opus-4.7`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.4`, `google/gemini-3.1-pro-preview` | 复杂 swarms（3+ agents）、长研究 sessions、论文级分析 | +| **Sweet spot**（默认） | `deepseek-v4-pro`, `deepseek/deepseek-v4-pro`, `x-ai/grok-4.20`, `z-ai/glm-5.1`, `moonshotai/kimi-k2.5`, `qwen/qwen3-max-thinking` | 日常主力，约 1/10 成本下具备可靠工具调用 | +| **避免用于 agent** | `*-nano`, `*-flash-lite`, `*-coder-next`, 小型 / 蒸馏变体 | 工具调用不可靠，智能体会看起来像是在“凭记忆回答”，而不是加载 skills 或运行回测 | -默认 `agent/.env.example` 使用 `deepseek/deepseek-v3.2` — 性价比档里最便宜的选项。 +默认 `agent/.env.example` 使用 DeepSeek 官方 API + `deepseek-v4-pro`；OpenRouter 用户可以使用 `deepseek/deepseek-v4-pro`。 --- -## 🖥 CLI 参考 +## 🖥 CLI Reference ```bash -vibe-trading # 交互式 TUI -vibe-trading run -p "..." # 单次运行 -vibe-trading serve # API 服务器 +vibe-trading # interactive TUI +vibe-trading run -p "..." # single run +vibe-trading serve # API server ```
-TUI 内斜杠命令 +TUI 内 slash commands -| Command | Description | -|---------|-------------| -| `/help` | 显示全部命令 | -| `/skills` | 列出 74 个金融技能 | -| `/swarm` | 列出 29 个 swarm 团队预设 | -| `/swarm run [vars_json]` | 以流式输出运行一个 swarm 团队 | +| 命令 | 说明 | +|------|------| +| `/help` | 显示所有命令 | +| `/skills` | 列出全部 74 个 finance skills | +| `/swarm` | 列出 29 个 swarm team presets | +| `/swarm run [vars_json]` | 运行一个 swarm team，并实时流式展示 | | `/swarm list` | Swarm 运行历史 | | `/swarm show ` | Swarm 运行详情 | | `/swarm cancel ` | 取消运行中的 swarm | -| `/list` | 最近的运行 | -| `/show ` | 运行详情与指标 | +| `/list` | 最近 runs | +| `/show ` | Run 详情 + 指标 | | `/code ` | 生成的策略代码 | -| `/pine ` | 导出指标代码（TradingView + TDX + MT5）| +| `/pine ` | 导出指标（TradingView + TDX + MT5） | | `/trace ` | 完整执行回放 | -| `/continue ` | 带新指令继续运行 | -| `/sessions` | 列出聊天会话 | +| `/continue ` | 用新指令继续一个 run | +| `/sessions` | 列出 chat sessions | | `/settings` | 显示运行时配置 | | `/clear` | 清屏 | | `/quit` | 退出 | +
-单次运行与参数 +Single run 与 flags ```bash vibe-trading run -p "Backtest BTC-USDT MACD strategy, last 30 days" @@ -411,7 +477,7 @@ vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}' vibe-trading --list vibe-trading --show vibe-trading --code -vibe-trading --pine # 导出指标代码（TradingView + TDX + MT5） +vibe-trading --pine # Export indicators (TradingView + TDX + MT5) vibe-trading --trace vibe-trading --continue "refine the strategy" vibe-trading --upload report.pdf @@ -421,48 +487,118 @@ vibe-trading --upload report.pdf --- -## 🌐 API 服务 +## 💡 Examples + +### Strategy & Backtesting + +```bash +# 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 +``` + +### Market Research + +```bash +# 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" +``` + +### Swarm Workflows + +```bash +# 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"}' +``` + +### Cross-Session Memory + +```bash +# 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" +``` + +### Upload & Analyze Documents + +```bash +# 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 Server ```bash vibe-trading serve --port 8899 ``` -| Method | Endpoint | Description | -|--------|----------|-------------| -| `GET` | `/runs` | 列出运行 | -| `GET` | `/runs/{run_id}` | 运行详情 | +| Method | Endpoint | 说明 | +|--------|----------|------| +| `GET` | `/runs` | 列出 runs | +| `GET` | `/runs/{run_id}` | Run 详情 | | `GET` | `/runs/{run_id}/pine` | 多平台指标导出 | -| `POST` | `/sessions` | 创建会话 | +| `POST` | `/sessions` | 创建 session | | `POST` | `/sessions/{id}/messages` | 发送消息 | -| `GET` | `/sessions/{id}/events` | SSE 事件流 | -| `POST` | `/upload` | 上传 PDF/文件 | -| `GET` | `/swarm/presets` | 列出 swarm 预设 | -| `POST` | `/swarm/runs` | 启动 swarm 运行 | -| `GET` | `/swarm/runs/{id}/events` | Swarm SSE 流 | -| `GET` | `/settings/llm` | 读取 Web UI LLM 设置 | -| `PUT` | `/settings/llm` | 更新本地 LLM 设置 | -| `GET` | `/settings/data-sources` | 读取本地数据源设置 | -| `PUT` | `/settings/data-sources` | 更新本地数据源设置 | +| `GET` | `/sessions/{id}/events` | SSE event stream | +| `POST` | `/upload` | 上传 PDF/file | +| `GET` | `/swarm/presets` | 列出 swarm presets | +| `POST` | `/swarm/runs` | 启动 swarm run | +| `GET` | `/swarm/runs/{id}/events` | Swarm SSE stream | +| `GET` | `/settings/llm` | 读取 Web UI LLM settings | +| `PUT` | `/settings/llm` | 更新本地 LLM settings | +| `GET` | `/settings/data-sources` | 读取本地数据源 settings | +| `PUT` | `/settings/data-sources` | 更新本地数据源 settings | 交互式文档：`http://localhost:8899/docs` -### 安全默认值 +### Security defaults -本机开发时，`vibe-trading serve` 会尽量保持浏览器工作流简单。任何非本地客户端访问敏感 API 时都需要 `API_AUTH_KEY`；JSON/上传请求请使用 `Authorization: Bearer `。浏览器 EventSource 流由 Web UI 在 Settings 中保存同一个 key 后处理。 +对于 localhost 开发，`vibe-trading serve` 会保持浏览器工作流简单。对任何非本地客户端，敏感 API endpoints 都要求 `API_AUTH_KEY`；JSON/upload 请求请使用 `Authorization: Bearer `。浏览器 EventSource streams 会在你于 Settings 中输入同一个 key 后由 Web UI 处理。 -Shell 能力工具对本地 CLI 和可信 localhost 工作流可用，但远程 API session 默认不会暴露，除非显式设置 `VIBE_TRADING_ENABLE_SHELL_TOOLS=1`。文档和交割单读取默认限制在上传/导入目录中；请把文件放到 `agent/uploads`、`agent/runs`、`./uploads`、`./data`、`~/.vibe-trading/uploads` 或 `~/.vibe-trading/imports`，也可以通过 `VIBE_TRADING_ALLOWED_FILE_ROOTS` 添加专用目录。 +Shell-capable tools 可用于本地 CLI 与可信 localhost 工作流，但不会暴露给远程 API sessions，除非你显式设置 `VIBE_TRADING_ENABLE_SHELL_TOOLS=1`。文档和日志读取器默认限制在 upload/import roots 内；请将文件放在 `agent/uploads`、`agent/runs`、`./uploads`、`./data`、`~/.vibe-trading/uploads` 或 `~/.vibe-trading/imports` 下，或通过 `VIBE_TRADING_ALLOWED_FILE_ROOTS` 添加专用目录。 -### Web UI 设置 +### Web UI Settings -Web UI Settings 页面允许本地用户更新 LLM provider/model、Base URL、生成参数、reasoning effort，以及 Tushare token 等可选市场数据凭据。设置会保存到 `agent/.env`；provider 默认值来自 `agent/src/providers/llm_providers.json`。 +Web UI Settings 页面允许本地用户更新 LLM provider/model、base URL、generation parameters、reasoning effort，以及 Tushare token 等可选市场数据凭据。Settings 会持久化到 `agent/.env`；provider defaults 从 `agent/src/providers/llm_providers.json` 加载。 -Settings 读取是无副作用的：`GET /settings/llm` 和 `GET /settings/data-sources` 不会创建 `agent/.env`，并且只返回项目相对路径。Settings 读取和写入可能暴露凭据状态或更新凭据/运行时环境，因此配置 `API_AUTH_KEY` 时必须携带认证；开发模式未配置 `API_AUTH_KEY` 时，仅允许 loopback 本地客户端访问。 +Settings 读取无副作用：`GET /settings/llm` 和 `GET /settings/data-sources` 永远不会创建 `agent/.env`，并且只返回项目相对路径。Settings 读写可能暴露凭据状态或更新凭据/运行时环境，因此在配置了 `API_AUTH_KEY` 时会要求认证。如果 dev mode 下未设置 `API_AUTH_KEY`，settings 访问只接受 loopback clients。 --- -## 🔌 MCP 插件 +## 🔌 MCP Plugin -Vibe-Trading 为任意 MCP 兼容客户端提供 22 个 MCP 工具。以 stdio 子进程运行——无需服务器部署。**22 个工具中有 21 个无需任何 API key**（港美股/加密）。仅 `run_swarm` 需要 LLM key。 +Vibe-Trading 为任何 MCP-compatible client 暴露 22 个 MCP tools。它作为 stdio subprocess 运行，无需 server setup。**22 个工具中有 21 个零 API key 可用**（港/美股/加密）。只有 `run_swarm` 需要 LLM key。
Claude Desktop @@ -495,38 +631,38 @@ skills:
-Cursor / Windsurf / 其他 MCP 客户端 +Cursor / Windsurf / other MCP clients ```bash -vibe-trading-mcp # stdio（默认） -vibe-trading-mcp --transport sse # 供 Web 客户端的 SSE +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`。 +**暴露的 MCP tools（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 一键安装 +从 ClawHub 安装（一条命令） ```bash npx clawhub@latest install vibe-trading --force ``` -> 需要 `--force`，因为该技能引用外部 API，会触发 VirusTotal 自动扫描。代码完全开源，可自行审阅。 +> 由于该 skill 引用了外部 API，会触发 VirusTotal 自动扫描，因此需要 `--force`。代码完全开源，可自行检查。 -这会将技能与 MCP 配置下载到你的代理技能目录。无需克隆。 +这会将 skill + MCP config 下载到你的智能体 skills 目录。无需 clone。 -浏览 ClawHub： [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading) +在 ClawHub 浏览：[clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading)
-OpenSpace — 自进化技能 +OpenSpace — 自进化 skills -全部 74 个金融技能已发布在 [open-space.cloud](https://open-space.cloud)，并通过 OpenSpace 的自进化引擎自动演进。 +全部 74 个 finance skills 都发布在 [open-space.cloud](https://open-space.cloud)，并通过 OpenSpace 的自进化引擎自主演进。 -要在 OpenSpace 中使用，在代理配置中添加两个 MCP 服务器： +要配合 OpenSpace 使用，请将两个 MCP servers 都加入你的 agent config： ```json { @@ -546,68 +682,68 @@ npx clawhub@latest install vibe-trading --force } ``` -OpenSpace 会自动发现全部 74 个技能，支持自动修复、自动改进与社区共享。在任意连接 OpenSpace 的代理中通过 `search_skills("finance backtest")` 搜索 Vibe-Trading 技能。 +OpenSpace 会自动发现全部 74 个 skills，启用 auto-fix、auto-improve 和社区分享。在任意已连接 OpenSpace 的智能体中，可通过 `search_skills("finance backtest")` 搜索 Vibe-Trading skills。
--- -## 📁 项目结构 +## 📁 Project Structure
-展开查看 +点击展开 ``` Vibe-Trading/ -├── agent/ # 后端（Python） -│ ├── cli.py # CLI 入口——交互式 TUI + 子命令 -│ ├── api_server.py # FastAPI 服务器——运行、会话、上传、swarm、SSE -│ ├── mcp_server.py # MCP 服务器——为 OpenClaw / Claude Desktop 提供 22 个工具 +├── agent/ # Backend (Python) +│ ├── cli.py # CLI entrypoint — 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 代理核心 -│ │ │ ├── loop.py # 5 层压缩 + 读写工具批处理 -│ │ │ ├── context.py # 系统提示 + 持久记忆自动召回 -│ │ │ ├── skills.py # 技能加载器（74 内置 + 用户 CRUD 创建） -│ │ │ ├── tools.py # 工具基类 + 注册表 -│ │ │ ├── memory.py # 单次运行轻量工作区状态 -│ │ │ ├── frontmatter.py # 共享 YAML frontmatter 解析器 -│ │ │ └── trace.py # 执行轨迹写入 +│ │ ├── 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 (74 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/ # 跨会话持久记忆 -│ │ │ └── persistent.py # 基于文件的记忆（~/.vibe-trading/memory/） +│ │ ├── memory/ # Cross-session persistent memory +│ │ │ └── persistent.py # file-based memory (~/.vibe-trading/memory/) │ │ │ -│ │ ├── tools/ # 27 个自动发现的代理工具 -│ │ │ ├── backtest_tool.py # 运行回测 -│ │ │ ├── remember_tool.py # 跨会话记忆（保存/召回/遗忘） -│ │ │ ├── skill_writer_tool.py # 技能 CRUD（保存/修补/删除/文件） -│ │ │ ├── session_search_tool.py # FTS5 跨会话搜索 -│ │ │ ├── swarm_tool.py # 启动 swarm 团队 -│ │ │ ├── web_search_tool.py # DuckDuckGo 搜索 -│ │ │ └── ... # bash、文件 I/O、因子分析、期权等 +│ │ ├── tools/ # 27 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, etc. │ │ │ -│ │ ├── skills/ # 74 个金融技能（8 类，每个 SKILL.md） -│ │ ├── swarm/ # Swarm DAG 执行引擎 -│ │ │ └── presets/ # 29 个 swarm 预设 YAML 定义 -│ │ ├── session/ # 多轮对话 + FTS5 会话搜索 -│ │ └── providers/ # LLM 提供商抽象 +│ │ ├── skills/ # 74 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/ # 回测引擎 -│ ├── engines/ # 7 个引擎 + 跨市场复合引擎 + options_portfolio -│ ├── loaders/ # 6 个数据源：tushare、okx、yfinance、akshare、ccxt、futu +│ └── 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 # 注册表 + 自动回退链 -│ └── optimizers/ # MVO、等波动、最大分散、风险平价 +│ │ └── registry.py # Registry + auto-fallback chains +│ └── optimizers/ # MVO, equal vol, max div, risk parity │ -├── frontend/ # Web UI（React 19 + Vite + TypeScript） +├── frontend/ # Web UI (React 19 + Vite + TypeScript) │ └── src/ -│ ├── pages/ # Home、Agent、RunDetail、Compare -│ ├── components/ # chat、charts、layout -│ └── stores/ # Zustand 状态管理 +│ ├── pages/ # Home, Agent, RunDetail, Compare +│ ├── components/ # chat, charts, layout +│ └── stores/ # Zustand state management │ -├── Dockerfile # 多阶段构建 -├── docker-compose.yml # 一键部署 -├── pyproject.toml # 包配置 + CLI 入口 +├── Dockerfile # Multi-stage build +├── docker-compose.yml # One-command deploy +├── pyproject.toml # Package config + CLI entrypoint └── LICENSE # MIT ``` @@ -615,75 +751,75 @@ Vibe-Trading/ --- -## 🏛 生态 +## 🏛 Ecosystem -Vibe-Trading 属于 **[HKUDS](https://github.com/HKUDS)** 代理生态的一部分： +Vibe-Trading 是 **[HKUDS](https://github.com/HKUDS)** 智能体生态的一部分：
ClawTeam
- 代理 swarm 智能 + Agent Swarm Intelligence 		NanoBot
- 超轻量个人 AI 助手 + Ultra-Lightweight Personal AI Assistant 		CLI-Anything
- 让所有软件都可被代理驱动 + Making All Software Agent-Native 		OpenSpace
- 自进化 AI 代理技能 + Self-Evolving AI Agent Skills
--- -## 🗺 路线图 +## 🗺 Roadmap -> 我们分阶段发布。工作开始后会移至 [Issues](https://github.com/HKUDS/Vibe-Trading/issues)。 +> 我们按阶段交付。工作开始时，条目会移动到 [Issues](https://github.com/HKUDS/Vibe-Trading/issues)。 -| Phase | Feature | Status | -|-------|---------|--------| -| **Research Autopilot** | 通宵研究循环：假设 → 拉取数据 → 回测 → 证据报告 | In Progress | -| **Data Bridge** | 自带数据接入：本地 CSV/Parquet/SQL 连接器 + schema 映射 | Planned | -| **Options Lab** | 波动率曲面、Greeks 仪表盘、收益结构/情景探索器 | Planned | -| **Portfolio Studio** | 风险透视、约束优化、换手感知优化器、调仓说明 | Planned | -| **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 因子库，支持筛选与 IC 测试 | Planned | -| **Research Delivery** | 定时研究简报推送到 Slack / Telegram / 邮件式渠道 | Planned | -| **Trust Layer** | 可复现实验卡片：工具轨迹、数据来源、假设与引用 | In Progress | -| **Community** | 可分享的 skills、presets 与 strategy cards | Exploring | +| 阶段 | 功能 | 状态 | +|------|------|------| +| **Research Autopilot** | 隔夜研究循环：hypothesis → data pull → backtest → evidence report | In Progress | +| **Data Bridge** | 自带数据：本地 CSV/Parquet/SQL connectors 与 schema mapping | Planned | +| **Options Lab** | Vol surface、Greeks dashboard、payoff/scenario explorer | Planned | +| **Portfolio Studio** | Risk x-ray、constraints、turnover-aware optimizer、rebalance notes | Planned | +| **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 factor libraries，支持 screening + IC tests | Planned | +| **Research Delivery** | 定时 briefs 到 Slack / Telegram / email-style channels | Planned | +| **Trust Layer** | 可复现 run cards：tool trace、data sources、assumptions、citations | In Progress | +| **Community** | 可分享的 skills、presets 和 strategy cards | Exploring | --- -## 贡献指南 +## Contributing -欢迎贡献！请参见 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。 +欢迎贡献！请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。 -**Good first issues** 带有 [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 标签——挑一个开始吧。 +**Good first issues** 使用 [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 标记，可选择一个开始。 -想做更大的贡献？查看上方 [路线图](#-路线图)，开始前先开个 issue 讨论。 +想贡献更大的内容？请查看上方 [Roadmap](#-roadmap)，并在开始前先开 issue 讨论。 --- -## 贡献者 +## Contributors 感谢所有为 Vibe-Trading 做出贡献的人！ 近期 v0.1.7 周期贡献者与致谢： -- @GTC2080 / TaoMu — Web UI Settings 与 provider/data-source 配置 API（#57） -- @BigNounce90 — backtest `run_dir` validation CLI 加固（#60） -- @shadowinlife — A 股 pre-ST 过滤技能（#63） -- @MB-Ndhlovu — 相关性热力图仪表盘与 review 修复（#64, #66） -- @ykykj — OpenAI Codex OAuth provider 选项（#65） -- @RuifengFu — 交互式 CLI 状态栏与 prompt 编辑体验（#69） -- @SiMinus — swarm preset inspection 命令（#73） -- @warren618 / Haozhe Wu — 安全加固、发版集成、文档、Docker、打包与本地开发工作流 -- lemi9090 (S2W) — 协调安全研究、验证与披露支持 +- @GTC2080 / TaoMu — Web UI Settings 和 provider/data-source configuration APIs (#57) +- @BigNounce90 — backtest `run_dir` 输入的 validation CLI 加固 (#60) +- @shadowinlife — A 股 pre-ST filter skill (#63) +- @MB-Ndhlovu — correlation heatmap dashboard 和 review fixes (#64, #66) +- @ykykj — OpenAI Codex OAuth provider option (#65) +- @RuifengFu — 交互式 CLI live status bar 和 prompt editing (#69) +- @SiMinus — swarm preset inspection command (#73) +- @warren618 / Haozhe Wu — 安全加固、release integration、文档、Docker、packaging 和本地开发工作流 +- lemi9090 (S2W) — 协同安全研究、验证和披露支持 @@ -691,24 +827,24 @@ Vibe-Trading 属于 **[HKUDS](https://github.com/HKUDS)** 代理生态的一部 --- -## 免责声明 +## Disclaimer -Vibe-Trading 仅用于研究、模拟与回测。它不是投资建议，也不会执行实盘交易。历史表现不代表未来结果。 +Vibe-Trading 仅用于研究、模拟和回测。它不是投资建议，也不会执行实盘交易。历史表现不代表未来结果。 -## 许可证 +## License -MIT 许可证——参见 [LICENSE](LICENSE) +MIT License — see [LICENSE](LICENSE) --- -## Star 历史 +## Star History [![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 ✨ + 感谢访问 Vibe-Trading ✨

visitors diff --git a/assets/scene-backtest.png b/assets/feature-cross-market-data-backtesting.png similarity index 100% rename from assets/scene-backtest.png rename to assets/feature-cross-market-data-backtesting.png diff --git a/assets/scene-swarm.png b/assets/feature-multi-agent-trading-teams.png similarity index 100% rename from assets/scene-swarm.png rename to assets/feature-multi-agent-trading-teams.png diff --git a/assets/scene-research.png b/assets/feature-self-improving-trading-agent.png similarity index 100% rename from assets/scene-research.png rename to assets/feature-self-improving-trading-agent.png diff --git a/assets/scene-quant.png b/assets/feature-shadow-account.png similarity index 100% rename from assets/scene-quant.png rename to assets/feature-shadow-account.png