"Vibe-Trading: Your Personal Trading Agent"
Python ai-agentalgorithmic-tradingbacktestingfintechllmmcpmulti-agentpythonquantitative-financetrading
docs: bring all five READMEs back in line with what the code does
Haozhe Wu99d06ddf791a
diff --git a/README.md b/README.mdindex b4268815e..7989ed7dd 100644--- a/README.md+++ b/README.md@@ -267,6 +267,7 @@ It is designed for research, simulation, and backtesting — and, when you choos| **Backtest a strategy idea** | Strategy code, metrics, benchmark context, validation artifacts, and run cards. || **Review your own trades** | Broker-journal parsing, behavior diagnostics, rule extraction, and Shadow Account comparisons. || **Read documents & charts** | Parse PDF / DOCX / XLSX / PPTX / images with pluggable OCR (`read_document`), and read chart screenshots semantically with a vision model (`analyze_image`). |+| **Read institutional filings & fund books** | SEC 13F manager books with quarter-over-quarter position diffs, ETF constituents across markets, event-contract implied probability, and arXiv / OpenAlex factor extraction — all read-only, on free public sources. || **Improve repeated research** | Persistent memory and editable skills turn useful routines into reusable workflows. || **Run analyst teams** | Multi-agent research reviews for investment, quant, crypto, macro, and risk workflows. || **Put research into IM channels** | Run the same session runtime through WebSocket, Telegram, Slack, Discord, Matrix, WhatsApp, Signal, QQ/NapCat, WeChat/WeCom, Feishu/Lark, DingTalk, Teams, email, and Mochat with CLI, REST, and Web UI controls. |@@ -392,7 +393,7 @@ For a backtest, set `source` in `config.json`:In an Agent conversation, ask explicitly: **"Use Longbridge to fetch QQQ.US historical data."** The explicit source request is separate from `source: "auto"`; `auto` keeps the normal per-market fallback chain.-Beyond OHLCV, **18 read-only data tools** reach into fundamentals & flow — fund flow, dragon-tiger, northbound, margin, block trades, shareholder count, lockup, sector, research reports, news, SEC filings, financial statements, options chains, institutional holdings, market screening, symbol search, and macro — all exposed over MCP. An explicit `local:` symbol never silently falls back to a network source.+Beyond OHLCV, **22 read-only data tools** reach into fundamentals & flow — fund flow, dragon-tiger, northbound, margin, block trades, shareholder count, lockup, sector, research reports, news, SEC filings, financial statements, options chains, stock profile, market screening, symbol search, macro, iwencai, institutional holdings (13F), ETF look-through, prediction markets, and research papers — all exposed over MCP. An explicit `local:` symbol never silently falls back to a network source.<!-- QVERIS-START -->### 💎 Optional premium data — QVeris@@ -413,7 +414,7 @@ Detailed inventories are folded below to keep the main README scannable. Open th<details><summary><b>Finance Skill Library</b> <sub>89 skills across 9 categories</sub></summary>-- 📊 88 specialized finance skills organized into 9 categories+- 📊 89 specialized finance skills organized into 9 categories- 🌐 Complete coverage from traditional markets to crypto & DeFi- 🔬 Comprehensive capabilities spanning data sourcing to quantitative research@@ -421,7 +422,7 @@ Detailed inventories are folded below to keep the main README scannable. Open th|----------|--------|----------|| Data Source | 10 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `mootdx`, `ccxt`, `eastmoney`, `sec-edgar`, `qveris` || Strategy | 19 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` |-| Analysis | 22 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-analysis` |+| Analysis | 23 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `investor-lenses`, `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 | 8 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` |@@ -480,7 +481,7 @@ run from a clone (`pip install -e .`).<details><summary><b>Broker Connectors</b> <sub>12 brokers — read + paper, bounded-live where supported</sub></summary>-Connector-first profiles. Each does read + paper-account order placement; live order placement is bounded by a user-defined mandate (symbol allowlist, order-size / exposure caps, daily trade cap, instant kill switch) and never holds funds — the broker executes. Order-placing tools stay off MCP (agent + CLI only). Research / backtest paths are structurally barred from any live endpoint.+Connector-first profiles. Most do read + paper-account order placement — IBKR is read-only, Robinhood is live-only (no paper account), and Trading 212 refuses order placement entirely, paper included; live order placement is bounded by a user-defined mandate (symbol allowlist, order-size / exposure caps, daily trade cap, instant kill switch) and never holds funds — the broker executes. Order-placing tools stay off MCP (agent + CLI only). Research / backtest paths are structurally barred from any live endpoint.| Broker | Markets | Capabilities ||--------|---------|--------------|@@ -766,6 +767,7 @@ vibe-trading # interactive TUIvibe-trading run -p "..." # single runvibe-trading serve # API servervibe-trading alpha list # browse 462 pre-built alphas; show / bench / compare / export-manifest sub-commands available+vibe-trading playbook list # five scheduled-research templates; show / create sub-commands availablevibe-trading channels status --local # inspect IM channel config and install hintsvibe-trading provider doctor # print redacted provider/proxy/package diagnostics```@@ -775,23 +777,33 @@ vibe-trading provider doctor # print redacted provider/proxy/package diagnostic| Command | Description ||---------|-------------|-| `/help` | Show all commands |-| `/skills` | List all 88 finance skills |-| `/swarm` | List 30 swarm team presets |-| `/swarm run <preset> [vars_json]` | Run a swarm team with live streaming |-| `/swarm list` | Swarm run history |-| `/swarm show <run_id>` | Swarm run details |-| `/swarm cancel <run_id>` | Cancel a running swarm |-| `/list` | Recent runs |-| `/show <run_id>` | Run details + metrics |-| `/code <run_id>` | Generated strategy code |-| `/pine <run_id>` | Export indicators (TradingView + TDX + MT5) |-| `/trace <run_id>` | Full execution replay |-| `/continue <run_id> <prompt>` | Continue a run with new instructions |-| `/sessions` | List chat sessions |-| `/settings` | Show runtime config |-| `/clear` | Clear screen |-| `/quit` | Exit |+| `/help` | Show keyboard shortcuts and command list |+| `/model` | Switch LLM provider and model |+| `/memory` | Show / manage persistent memory |+| `/history` | Browse and resume prior sessions |+| `/goal` | Start / inspect a finance research goal |+| `/search` | Full-text search across all sessions |+| `/swarm` | Multi-agent presets (committee / quant / risk) |+| `/skill` | List / load / unload skills |+| `/show` | Show prior run by id |+| `/clear` | Clear current conversation |+| `/pine` | Export current strategy as Pine Script |+| `/journal` | Analyze trade journal CSV |+| `/shadow` | Train / view shadow account |+| `/export` | Export current session (md / json) |+| `/debug` | Toggle debug panel (token usage / latency) |+| `/comps` | Comparable company analysis (peer multiples -> implied range) |+| `/dcf` | Discounted cash flow valuation with sensitivity grid |+| `/attrib` | Brinson-Fachler attribution (allocation vs selection) |+| `/memo` | Investment memo — thesis, variant view, scenarios, kill criteria |+| `/earnings` | Earnings review — surprise bridge from revenue to EPS |+| `/screen` | Systematic idea screen — hypothesis, funnel, survivor queue |+| `/playbook` | Scheduled research templates (list / run / schedule) |+| `/connector` | Trading connector profiles (status / start / halt) |+| `/halt` | Kill switch — halt ALL live trading now |+| `/resume` | Clear the kill switch (re-enable live trading) |+| `/data` | Data routing mode |+| `/quit` | Exit (also: q, exit, :q) |</details>@@ -997,6 +1009,9 @@ vibe-trading serve --port 8899| `POST` | `/scheduled-runs` | Create a scheduled research job (interval-ms or cron) || `GET` | `/scheduled-runs` | List scheduled jobs || `DELETE` | `/scheduled-runs/{job_id}` | Cancel a scheduled job |+| `GET` | `/scheduled-runs/playbooks` | List the research templates |+| `GET` | `/scheduled-runs/playbooks/{slug}` | Show one template, with its variables |+| `POST` | `/scheduled-runs/playbooks/{slug}` | Schedule a job from a template || `POST` | `/sessions/{id}/cancel` | Stop the session's in-flight run (recorded as cancelled, not failed) || `POST` | `/sessions/{id}/title/auto` | Summarize the first exchange into a session title (never overwrites a manual rename) || `GET` | `/correlation/regime` | Correlation edge-density regime timeline |@@ -1048,6 +1063,24 @@ curl -X DELETE http://localhost:8899/scheduled-runs/<job_id>Each fire runs the `prompt` through a fresh agent session (optional backtest parameters go in `config`), and jobs persist under `~/.vibe-trading/` so they survive restarts. Without the flag, the `/scheduled-runs` endpoints still record jobs but nothing fires. Add `-H "Authorization: Bearer <key>"` to each call when `API_AUTH_KEY` is set.+**Five ready-to-schedule templates** ship with the scheduler — `premarket-brief`, `earnings-season-tracker`, `portfolio-checkup`, `a-share-money-flow`, `institutional-holdings-diff`. Each states the data a run needs in plain language instead of naming tools, so a template keeps working as the tool surface grows, and each is required to name a missing input rather than fill it from memory. Reach them from the CLI, over REST, or with `/playbook` in the TUI:++```bash+vibe-trading playbook list # the five templates+vibe-trading playbook show premarket-brief # body, declared variables, suggested cadence+vibe-trading playbook create premarket-brief \+ --var home_market="US equities" --var watchlist="AAPL, MSFT, NVDA" \+ --timezone America/New_York++curl http://localhost:8899/scheduled-runs/playbooks+curl http://localhost:8899/scheduled-runs/playbooks/premarket-brief+curl -X POST http://localhost:8899/scheduled-runs/playbooks/premarket-brief \+ -H "Content-Type: application/json" \+ -d '{"variables":{"home_market":"US equities","watchlist":"AAPL, MSFT, NVDA"}}'+```++Posting `{}` schedules a template on its own suggested cadence with its declared defaults. The rendered body becomes the job prompt verbatim, and an undeclared variable is rejected rather than silently ignored.+---## 🔌 MCP Plugin@@ -1145,7 +1178,7 @@ Browse on ClawHub: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vi<details><summary><b>OpenSpace — self-evolving skills</b></summary>-All 88 finance skills are published on [open-space.cloud](https://open-space.cloud) and evolve autonomously through OpenSpace's self-evolution engine.+All 89 finance skills are published on [open-space.cloud](https://open-space.cloud) and evolve autonomously through OpenSpace's self-evolution engine.To use with OpenSpace, add both MCP servers to your agent config:@@ -1167,7 +1200,7 @@ To use with OpenSpace, add both MCP servers to your agent config:}```-OpenSpace will auto-discover all 88 skills, enabling auto-fix, auto-improve, and community sharing. Search for Vibe-Trading skills via `search_skills("finance backtest")` in any OpenSpace-connected agent.+OpenSpace will auto-discover all 89 skills, enabling auto-fix, auto-improve, and community sharing. Search for Vibe-Trading skills via `search_skills("finance backtest")` in any OpenSpace-connected agent.</details>@@ -1418,7 +1451,7 @@ Vibe-Trading/│ │ ├── 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 (88 bundled + user-created via CRUD)+│ │ │ ├── skills.py # skill loader (89 bundled + user-created via CRUD)│ │ │ ├── tools.py # tool base class + registry│ │ │ ├── memory.py # lightweight workspace state per run│ │ │ ├── frontmatter.py # shared YAML frontmatter parser@@ -1445,7 +1478,7 @@ Vibe-Trading/│ │ ├── api/ # FastAPI route modules│ │ │ └── alpha_routes.py # /alpha/list, /alpha/{id}, /alpha/bench, SSE stream│ │ │-│ │ ├── skills/ # 88 finance skills in 9 categories (SKILL.md each)+│ │ ├── skills/ # 89 finance skills in 9 categories (SKILL.md each)│ │ ├── swarm/ # Swarm DAG execution engine│ │ │ └── presets/ # 30 swarm preset YAML definitions│ │ ├── session/ # Multi-turn chat + FTS5 session searchdiff --git a/README_ar.md b/README_ar.mdindex 0ad44f428..eb6d7da1b 100644--- a/README_ar.md+++ b/README_ar.md@@ -268,6 +268,7 @@ Vibe-Trading مساحة عمل بحثية مفتوحة المصدر تحول ا| **اختبار فكرة استراتيجية رجعياً** | كود استراتيجية، ومقاييس، وسياق معياري، ومخرجات تحقق، وبطاقات تشغيل. || **مراجعة صفقاتك الخاصة** | قراءة سجلات الوسطاء، وتشخيص السلوك، واستخراج القواعد، ومقارنات Shadow Account. || **قراءة المستندات والرسوم البيانية** | تحليل ملفات PDF / DOCX / XLSX / PPTX / الصور عبر OCR قابل للتوصيل (`read_document`)، وقراءة لقطات الرسوم البيانية دلالياً بنموذج رؤية (`analyze_image`). |+| **قراءة إفصاحات المؤسسات ومحافظ الصناديق** | حيازات SEC 13F مع فروق المراكز ربعاً بربع، ومكوّنات ETF عبر الأسواق، والاحتمال الضمني لعقود الأحداث، واستخراج العوامل من arXiv / OpenAlex — كلها للقراءة فقط ومن مصادر عامة مجانية. || **تحسين الأبحاث المتكررة** | الذاكرة الدائمة والمهارات القابلة للتحرير تحول الروتينات المفيدة إلى تدفقات قابلة لإعادة الاستخدام. || **تشغيل فرق محللين** | مراجعات بحث متعددة الوكلاء لتدفقات الاستثمار والكم والكريبتو والماكرو والمخاطر. || **وصل الأبحاث بقنوات IM** | إدارة بيئة جلسة واحدة عبر WebSocket وTelegram وSlack وDiscord وMatrix وWhatsApp وSignal وQQ/NapCat وWeChat/WeCom وFeishu/Lark وDingTalk وTeams وemail وMochat من CLI وREST وWeb UI. |@@ -363,7 +364,7 @@ vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, an- **الكريبتو** → `okx` · `ccxt` · `binance` · `yfinance` · `local`- **الفوركس / المعادن** → `mt5` · `yfinance` · `akshare` · `local` · *(العقود الآجلة / الصناديق / الاقتصاد الكلي → `tushare`/`akshare` → `local`)*-إلى جانب OHLCV، تصل **18 أداة بيانات للقراءة فقط** إلى الأساسيات والتدفقات — تدفق الأموال، والتنين والنمر، والتدفق الشمالي، والهامش، والصفقات الكتلية، وعدد المساهمين، وفترة الإغلاق، والقطاعات، وتقارير الأبحاث، والأخبار، وإيداعات SEC، والقوائم المالية، وسلاسل الخيارات، والحيازات المؤسسية، وفحص السوق، والبحث عن الرموز، والاقتصاد الكلي — وكلها مكشوفة عبر MCP. ولا يتراجع رمز `local:` صريح أبداً وبصمت إلى مصدر شبكي.+إلى جانب OHLCV، تصل **22 أداة بيانات للقراءة فقط** إلى الأساسيات والتدفقات — تدفق الأموال، والتنين والنمر، والتدفق الشمالي، والهامش، والصفقات الكتلية، وعدد المساهمين، وفترة الإغلاق، والقطاعات، وتقارير الأبحاث، والأخبار، وإيداعات SEC، والقوائم المالية، وسلاسل الخيارات، وملف الشركة، وفحص السوق، والبحث عن الرموز، والاقتصاد الكلي، وiwencai، والحيازات المؤسسية (13F)، وتفكيك محافظ ETF، وأسواق التنبؤ، والأوراق البحثية — وكلها مكشوفة عبر MCP. ولا يتراجع رمز `local:` صريح أبداً وبصمت إلى مصدر شبكي.<!-- QVERIS-START -->### 💎 بيانات مدفوعة اختيارية — QVeris@@ -384,7 +385,7 @@ vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, an<details><summary><b>مكتبة المهارات المالية</b> <sub>89 مهارة عبر 9 فئات</sub></summary>-- 📊 88 مهارة مالية متخصصة منظمة في 9 فئات+- 📊 89 مهارة مالية متخصصة منظمة في 9 فئات- 🌐 تغطية كاملة من الأسواق التقليدية إلى الكريبتو وDeFi- 🔬 قدرات شاملة من مصادر البيانات إلى البحث الكمي@@ -392,7 +393,7 @@ vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, an|----------|--------|----------|| Data Source | 10 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `mootdx`, `ccxt`, `eastmoney`, `sec-edgar`, `qveris` || Strategy | 19 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` |-| Analysis | 22 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-analysis` |+| Analysis | 23 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `investor-lenses`, `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 | 8 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` |@@ -449,7 +450,7 @@ vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, an<details><summary><b>موصّلات الوسطاء</b> <sub>12 وسيطاً — قراءة + حساب ورقي، وتداول حي محدود حيثما يُدعم</sub></summary>-ملفات تعريف قائمة على الموصّل. يوفّر كل موصّل قراءةً وتنفيذ أوامر على حساب ورقي (paper)؛ أما تنفيذ الأوامر الحية فمحدود بتفويض يحدّده المستخدم (قائمة رموز مسموح بها، وحدود لحجم الأمر / الانكشاف، وحد يومي للصفقات، ومفتاح إيقاف فوري) ولا يحتفظ الموصّل بأي أموال — الوسيط هو من ينفّذ. تبقى أدوات تنفيذ الأوامر خارج MCP (عبر agent + CLI فقط). ومسارات البحث / الاختبار الرجعي محظورة بنيوياً من أي نقطة نهاية حية.+ملفات تعريف قائمة على الموصّل. يوفّر معظم الموصّلات قراءةً وتنفيذ أوامر على حساب ورقي (paper) — أما IBKR فللقراءة فقط، وRobinhood حيّ فقط (بلا حساب ورقي)، وTrading 212 يرفض تنفيذ الأوامر كلياً بما فيها الورقية؛ أما تنفيذ الأوامر الحية فمحدود بتفويض يحدّده المستخدم (قائمة رموز مسموح بها، وحدود لحجم الأمر / الانكشاف، وحد يومي للصفقات، ومفتاح إيقاف فوري) ولا يحتفظ الموصّل بأي أموال — الوسيط هو من ينفّذ. تبقى أدوات تنفيذ الأوامر خارج MCP (عبر agent + CLI فقط). ومسارات البحث / الاختبار الرجعي محظورة بنيوياً من أي نقطة نهاية حية.| الوسيط | الأسواق | القدرات ||--------|---------|---------|@@ -725,7 +726,9 @@ vibe-trading # interactive TUIvibe-trading run -p "..." # single runvibe-trading serve # API servervibe-trading alpha list # استعرض 462 ألفا جاهز؛ متاح show / bench / compare / export-manifest+vibe-trading playbook list # خمسة قوالب بحث مجدولة؛ متاح show / createvibe-trading channels status --local # فحص إعدادات قنوات IM وتلميحات التثبيت+vibe-trading provider doctor # طباعة تشخيصات المزود/الوكيل/الحزم بعد إخفاء الأسرار```<details>@@ -733,23 +736,33 @@ vibe-trading channels status --local # فحص إعدادات قنوات IM وت| الأمر | الوصف ||---------|-------------|-| `/help` | عرض كل الأوامر |-| `/skills` | عرض كل المهارات المالية الـ 88 |-| `/swarm` | عرض إعدادات فرق السرب الـ 30 |-| `/swarm run <preset> [vars_json]` | تشغيل فريق سرب مع بث مباشر |-| `/swarm list` | سجل تشغيلات السرب |-| `/swarm show <run_id>` | تفاصيل تشغيل السرب |-| `/swarm cancel <run_id>` | إلغاء سرب قيد التشغيل |-| `/list` | التشغيلات الأخيرة |-| `/show <run_id>` | تفاصيل التشغيل + المقاييس |-| `/code <run_id>` | كود الاستراتيجية المولدة |-| `/pine <run_id>` | تصدير المؤشرات (TradingView + TDX + MT5) |-| `/trace <run_id>` | إعادة تشغيل التنفيذ كاملة |-| `/continue <run_id> <prompt>` | متابعة تشغيل بتعليمات جديدة |-| `/sessions` | عرض جلسات الدردشة |-| `/settings` | عرض إعدادات التشغيل |-| `/clear` | مسح الشاشة |-| `/quit` | خروج |+| `/help` | عرض اختصارات لوحة المفاتيح وقائمة الأوامر |+| `/model` | تبديل مزوّد LLM والنموذج |+| `/memory` | عرض / إدارة الذاكرة الدائمة |+| `/history` | تصفّح الجلسات السابقة واستئنافها |+| `/goal` | بدء / فحص هدف بحث مالي |+| `/search` | بحث نصي كامل عبر كل الجلسات |+| `/swarm` | إعدادات متعددة الوكلاء (لجنة / كمّي / مخاطر) |+| `/skill` | سرد / تحميل / إلغاء تحميل المهارات |+| `/show` | عرض تشغيل سابق بالمعرّف |+| `/clear` | مسح المحادثة الحالية |+| `/pine` | تصدير الاستراتيجية الحالية كـ Pine Script |+| `/journal` | تحليل ملف CSV لسجل التداول |+| `/shadow` | تدريب / عرض الحساب الظلّي |+| `/export` | تصدير الجلسة الحالية (md / json) |+| `/debug` | تبديل لوحة التشخيص (استهلاك التوكن / زمن الاستجابة) |+| `/comps` | تحليل الشركات المماثلة (مضاعفات النظراء ← نطاق ضمني) |+| `/dcf` | تقييم بالتدفقات النقدية المخصومة مع شبكة حساسية |+| `/attrib` | إسناد Brinson-Fachler (التوزيع مقابل الانتقاء) |+| `/memo` | مذكرة استثمار — الأطروحة، الرأي المخالف، السيناريوهات، معايير الخروج |+| `/earnings` | مراجعة الأرباح — جسر المفاجأة من الإيرادات إلى ربحية السهم |+| `/screen` | فرز منهجي للأفكار — الفرضية، القمع، قائمة الناجين |+| `/playbook` | قوالب البحث المجدولة (سرد / تشغيل / جدولة) |+| `/connector` | ملفات موصّلات التداول (الحالة / التشغيل / الإيقاف) |+| `/halt` | مفتاح الإيقاف — أوقف كل التداول الحي فوراً |+| `/resume` | إلغاء مفتاح الإيقاف (إعادة تفعيل التداول الحي) |+| `/data` | وضع توجيه البيانات |+| `/quit` | خروج (أيضاً q و exit و :q) |</details>@@ -938,6 +951,9 @@ vibe-trading serve --port 8899| `POST` | `/scheduled-runs` | إنشاء مهمة بحث مجدولة (interval-ms أو cron) || `GET` | `/scheduled-runs` | سرد المهام المجدولة || `DELETE` | `/scheduled-runs/{job_id}` | إلغاء مهمة مجدولة |+| `GET` | `/scheduled-runs/playbooks` | سرد قوالب البحث |+| `GET` | `/scheduled-runs/playbooks/{slug}` | عرض قالب واحد ومتغيّراته |+| `POST` | `/scheduled-runs/playbooks/{slug}` | جدولة مهمة من قالب || `POST` | `/sessions/{id}/cancel` | إيقاف التشغيل الجاري للجلسة (يُسجَّل كإلغاء لا كفشل) || `POST` | `/sessions/{id}/title/auto` | توليد عنوان الجلسة من أول تبادل (لا يستبدل تسمية يدوية) || `GET` | `/correlation/regime` | الخط الزمني لنظام كثافة حواف الارتباط |@@ -987,6 +1003,24 @@ curl -X DELETE http://localhost:8899/scheduled-runs/<job_id>كل تشغيل ينفّذ `prompt` في جلسة agent جديدة (تُوضع معلمات backtest الاختيارية في `config`)، وتُحفظ المهام تحت `~/.vibe-trading/` فتبقى بعد إعادة التشغيل. بدون هذه الراية، تسجّل نقاط `/scheduled-runs` المهام لكن لا يُطلق شيء. أضف `-H "Authorization: Bearer <key>"` لكل طلب عند ضبط `API_AUTH_KEY`.+يأتي المجدول ومعه **خمسة قوالب بحث جاهزة للجدولة** — `premarket-brief` و`earnings-season-tracker` و`portfolio-checkup` و`a-share-money-flow` و`institutional-holdings-diff`. يصرّح كل قالب بالبيانات التي يحتاجها بلغة طبيعية بدل تسمية أداة بعينها، فيظل صالحاً مع توسّع مجموعة الأدوات، ويُطلب منه **ذكر أي مُدخل مفقود** بدل ملئه من الذاكرة. يمكن الوصول إليها من CLI أو REST أو عبر `/playbook` داخل واجهة TUI:++```bash+vibe-trading playbook list # القوالب الخمسة+vibe-trading playbook show premarket-brief # النص والمتغيرات المعلنة والوتيرة المقترحة+vibe-trading playbook create premarket-brief \+ --var home_market="US equities" --var watchlist="AAPL, MSFT, NVDA" \+ --timezone America/New_York++curl http://localhost:8899/scheduled-runs/playbooks+curl http://localhost:8899/scheduled-runs/playbooks/premarket-brief+curl -X POST http://localhost:8899/scheduled-runs/playbooks/premarket-brief \+ -H "Content-Type: application/json" \+ -d '{"variables":{"home_market":"US equities","watchlist":"AAPL, MSFT, NVDA"}}'+```++إرسال `{}` يجدول القالب على وتيرته المقترحة بقيمه الافتراضية المعلنة. يصبح النص المُصاغ هو prompt المهمة حرفياً، ويُرفض أي متغير غير معلن بدل تجاهله بصمت.+---## 🔌 MCP Plugin@@ -1067,7 +1101,7 @@ npx clawhub@latest install vibe-trading --force<details><summary><b>OpenSpace — مهارات ذاتية التطور</b></summary>-كل المهارات المالية الـ 88 منشورة على [open-space.cloud](https://open-space.cloud) وتتطور ذاتياً عبر محرك التطور الذاتي في OpenSpace.+كل المهارات المالية الـ 89 منشورة على [open-space.cloud](https://open-space.cloud) وتتطور ذاتياً عبر محرك التطور الذاتي في OpenSpace.للاستخدام مع OpenSpace، أضف خادمي MCP إلى إعداد وكيلك:@@ -1089,7 +1123,7 @@ npx clawhub@latest install vibe-trading --force}```-سيكتشف OpenSpace كل المهارات الـ 88 تلقائياً، مما يتيح auto-fix وauto-improve والمشاركة المجتمعية. ابحث عن مهارات Vibe-Trading عبر `search_skills("finance backtest")` في أي وكيل متصل بـ OpenSpace.+سيكتشف OpenSpace كل المهارات الـ 89 تلقائياً، مما يتيح auto-fix وauto-improve والمشاركة المجتمعية. ابحث عن مهارات Vibe-Trading عبر `search_skills("finance backtest")` في أي وكيل متصل بـ OpenSpace.</details>@@ -1153,7 +1187,7 @@ Vibe-Trading/│ │ ├── 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 (88 bundled + user-created via CRUD)+│ │ │ ├── skills.py # skill loader (89 bundled + user-created via CRUD)│ │ │ ├── tools.py # tool base class + registry│ │ │ ├── memory.py # lightweight workspace state per run│ │ │ ├── frontmatter.py # shared YAML frontmatter parser@@ -1180,7 +1214,7 @@ Vibe-Trading/│ │ ├── api/ # وحدات مسارات FastAPI│ │ │ └── alpha_routes.py # /alpha/list, /alpha/{id}, /alpha/bench, SSE stream│ │ │-│ │ ├── skills/ # 88 finance skills in 9 categories (SKILL.md each)+│ │ ├── skills/ # 89 finance skills in 9 categories (SKILL.md each)│ │ ├── swarm/ # Swarm DAG execution engine│ │ │ └── presets/ # 30 swarm preset YAML definitions│ │ ├── session/ # Multi-turn chat + FTS5 session searchdiff --git a/README_ja.md b/README_ja.mdindex d6750a579..6d6ba5f8b 100644--- a/README_ja.md+++ b/README_ja.md@@ -52,7 +52,7 @@> ⚠️ **セキュリティ警告:** Xアカウント `VibeTrading_HKU`、Virtualsプロジェクト `101845`、およびトークンコントラクト `0x640BDBF77b6447E8b7DB7894cED84BD1c40571f4` は、いずれもVibe-Trading公式のものではありません。Vibe-Tradingはこれまで、いかなるトークンやミームコインも発行・公認していません。購入、ウォレットの接続、署名は行わないでください。[詳細](SECURITY.md#official-channels--impersonation)-- **2026-08-05** 🔭 **機関投資家保有、ETF ルックスルー、予測市場、論文検索**:無料の公開データのみを使う読み取り専用ツールが 4 つ —— SEC 13F 保有(四半期比の増減付き)、市場をまたぐ ETF 構成銘柄(CSI300 連動型は四半期開示の上位 10 ではなく 342 銘柄・純資産の 98.7% を返します)、イベント契約を単位付きの含意確率として提示、arXiv/OpenAlex 検索は原典にない値を推測せず「記載なし」と印を付けます。あわせて、定時リサーチのテンプレート 5 本、機関投資家向けコマンド 6 つ(`/comps` `/dcf` `/attrib` `/memo` `/earnings` `/screen`)、独立した skill としての investor lenses、そしてすべての数値を生成元のツールまで辿れる agent core。+- **2026-08-05** 🔭 **機関投資家保有、ETF ルックスルー、予測市場、論文検索**:無料の公開データのみを使う読み取り専用ツールが 4 つ —— SEC 13F 保有(四半期比の増減付き)、市場をまたぐ ETF 構成銘柄(CSI300 連動型は四半期開示の上位 10 ではなく 342 銘柄・純資産の 98.7% を返します)、イベント契約を単位付きの含意確率として提示、arXiv/OpenAlex 検索は原典にない値を推測せず「記載なし」と印を付けます。あわせて、定期リサーチのテンプレート 5 本、機関投資家向けコマンド 6 つ(`/comps` `/dcf` `/attrib` `/memo` `/earnings` `/screen`)、独立した skill としての investor lenses、そしてすべての数値を生成元のツールまで辿れる agent core。- **2026-08-04** 🔧 **正確性の修正:ファンダメンタルズ、A 株価格、長すぎるツール結果**:SEC の報告期間は `(start, end)` の期間で識別するようになりました。10-Q は同じ期末日・同じ会計四半期の下に真の四半期と年初来フレームの両方を提出するため、`period="annual"` は AAPL の FY2018〜2020 で単一四半期を返しており(4.2 倍の過少計上)、四半期系列の第 4 四半期の枠にはすべて通年の数値が入っていました。`get_fundamentals("AAPL.US")` も `ok:true` と全 null のパネルを返さなくなります。Tushare の A 株価格はファクターベンチとバックテストの両方で権利落ち調整されるようになり(権利落ち日をまたぐ生の終値騰落率は最大 47 パーセントポイントずれていました。300750.SZ、2023-04-26)、CSI300 ベンチは各日付をその時点の指数構成銘柄でマスクします。クロスマーケットのコンポジットバックテストは、CNY・USD・KRW を 1 本の資産曲線に合算する代わりに、通貨が混在する銘柄セットを拒否します。オプションの各レグは建玉時のボラティリティで評価され、プレミアム比 +93% にも達していた初日の架空損益が解消されました。長すぎるツール結果は JSON の途中で切られる代わりに、総数を明示してレコード単位でページングされます。`calc_metrics` はトラッキングエラーとベンチマークベータを返します。- **2026-08-03** ⏰ **タイムゾーン対応のスケジュール実行 + 銘柄スクリーニングのデッドロック解消**:スケジュールジョブに任意の IANA `timezone` を指定でき、cron はそのゾーンの壁時計で評価されるため、夏時間の切替をまたいでも周期が保たれます(春の存在しない時刻はスキップ、秋の重複する時刻は最初の 1 回だけ実行)。cron の各フィールドはカンマ区切りと範囲(`1,3-5`)に対応し、タイムゾーン未設定のジョブは従来どおり UTC で動作、Web UI にも 5 言語対応の **Scheduled** ページが追加されました(従来フロントエンドにはスケジュール画面が存在しませんでした)([#954](https://github.com/HKUDS/Vibe-Trading/pull/954)、closes [#953](https://github.com/HKUDS/Vibe-Trading/issues/953)、[@ngoanpv](https://github.com/ngoanpv) に感謝)。スクリーニング要求が行き止まりにならなくなりました。多数の候補を含む絞り込み結果は「未解決」ではなく「回答」として扱われ、個別銘柄が確定した時点で役目を終えます。価格チェックは銘柄コードの数字・ローカライズされた日付・株数・建玉コストを価格として読まなくなりましたが、記録済み OHLC の範囲外の価格は従来どおり拒否します(closes [#955](https://github.com/HKUDS/Vibe-Trading/issues/955))。Agent メモリのインデックスアンカー厳密一致と件数上限の修正も含みます([#956](https://github.com/HKUDS/Vibe-Trading/pull/956)、[#957](https://github.com/HKUDS/Vibe-Trading/pull/957)、[@santhreal](https://github.com/santhreal) に感謝)。<details>@@ -268,6 +268,7 @@ Vibe-Trading は、金融に関する問いを実行可能な分析へ変換す| **戦略アイデアをバックテストする** | 戦略コード、指標、ベンチマーク文脈、検証 artifacts、run cards。 || **自分の取引をレビューする** | ブローカー取引日誌の解析、行動診断、ルール抽出、Shadow Account 比較。 || **ドキュメントとチャートを読む** | PDF / DOCX / XLSX / PPTX / 画像を pluggable OCR(`read_document`)で解析し、チャートのスクリーンショットを vision モデル(`analyze_image`)で意味的に読み取る。 |+| **機関投資家の届出とファンドの中身を読む** | SEC 13F 保有(四半期比の増減付き)、市場をまたぐ ETF 構成銘柄、イベント契約の含意確率、arXiv / OpenAlex からの factor 抽出 —— すべて読み取り専用、無料の公開データ。 || **反復リサーチを改善する** | 永続メモリと編集可能な skills により、有用な手順を再利用可能なワークフローへ変換。 || **アナリストチームを走らせる** | 投資、クオンツ、暗号資産、マクロ、リスクのワークフロー向けマルチエージェント・リサーチレビュー。 || **リサーチを IM チャンネルへ接続する** | WebSocket、Telegram、Slack、Discord、Matrix、WhatsApp、Signal、QQ/NapCat、WeChat/WeCom、Feishu/Lark、DingTalk、Teams、email、Mochat から同じ session runtime を CLI、REST、Web UI で管理。 |@@ -363,7 +364,7 @@ vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, an- **暗号資産** → `okx` · `ccxt` · `binance` · `yfinance` · `local`- **為替/貴金属** → `mt5` · `yfinance` · `akshare` · `local` · *(先物 / ファンド / マクロ → `tushare`/`akshare` → `local`)*-OHLCV にとどまらず、**18 の読み取り専用データツール**がファンダメンタルズと資金フローまで踏み込みます。資金フロー、龍虎榜、北向資金、信用取引、大口取引、株主数、ロックアップ、セクター、調査レポート、ニュース、SEC filings、財務諸表、オプションチェーン、機関投資家保有、市場スクリーニング、銘柄検索、マクロまで、すべて MCP 経由で公開されます。明示的な `local:` 銘柄が暗黙のうちにネットワークソースへフォールバックすることは決してありません。+OHLCV にとどまらず、**22 の読み取り専用データツール**がファンダメンタルズと資金フローまで踏み込みます。資金フロー、龍虎榜、北向資金、信用取引、大口取引、株主数、ロックアップ、セクター、調査レポート、ニュース、SEC filings、財務諸表、オプションチェーン、銘柄プロファイル、市場スクリーニング、銘柄検索、マクロ、問財、機関投資家保有(13F)、ETF ルックスルー、予測市場、論文検索まで、すべて MCP 経由で公開されます。明示的な `local:` 銘柄が暗黙のうちにネットワークソースへフォールバックすることは決してありません。<!-- QVERIS-START -->### 💎 オプションのプレミアムデータ — QVeris@@ -384,7 +385,7 @@ OHLCV にとどまらず、**18 の読み取り専用データツール**がフ<details><summary><b>Finance Skill Library</b> <sub>9カテゴリにわたる89 skills</sub></summary>-- 📊 88 の金融特化 skills を 9 カテゴリに整理+- 📊 89 の金融特化 skills を 9 カテゴリに整理- 🌐 伝統的市場から crypto & DeFi まで完全カバー- 🔬 データ取得からクオンツリサーチまでを横断する包括的能力@@ -392,7 +393,7 @@ OHLCV にとどまらず、**18 の読み取り専用データツール**がフ|----------|--------|----------|| Data Source | 10 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `mootdx`, `ccxt`, `eastmoney`, `sec-edgar`, `qveris` || Strategy | 19 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` |-| Analysis | 22 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-analysis` |+| Analysis | 23 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `investor-lenses`, `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 | 8 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` |@@ -447,9 +448,9 @@ clone から実行してください(`pip install -e .`)。</details><details>-<summary><b>Broker Connectors</b> <sub>12 brokers — read + paper, bounded-live where supported</sub></summary>+<summary><b>ブローカー connectors</b> <sub>12 ブローカー — read + paper、対応先では bounded-live</sub></summary>-Connector-first profiles. Each does read + paper-account order placement; live order placement is bounded by a user-defined mandate (symbol allowlist, order-size / exposure caps, daily trade cap, instant kill switch) and never holds funds — the broker executes. Order-placing tools stay off MCP (agent + CLI only). Research / backtest paths are structurally barred from any live endpoint.+connector-first のプロファイル。多くは read + ペーパー口座での発注に対応します —— IBKR は読み取り専用、Robinhood はライブのみ(ペーパー口座なし)、Trading 212 はペーパーを含め発注を一切拒否します。ライブ発注はユーザーが定義した mandate(銘柄許可リスト、発注サイズ / エクスポージャー上限、1 日の取引回数上限、即時 kill switch)で制限され、資金を預かることは一切ありません —— 執行するのはブローカーです。発注系ツールは MCP に公開されません(agent + CLI のみ)。リサーチ / バックテスト経路は構造的にあらゆるライブ endpoint から遮断されています。| Broker | Markets | Capabilities ||--------|---------|--------------|@@ -712,7 +713,7 @@ Vibe-Trading は tool-heavy agent です。skills、backtests、memory、swarms|------|----------|-------------|| **Best** | `anthropic/claude-opus-4.7`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.5-pro`, `google/gemini-3.5-flash` | 複雑な 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.6`, `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 用途では避ける** | `*-nano`, `*-flash-lite`, `*-coder-next`, small / distilled variants | Tool-calling が不安定です。agent は skills 読み込みや backtests 実行ではなく「記憶から答えている」ように見えます |既定の `agent/.env.example` は DeepSeek official API + `deepseek-v4-pro` で出荷されています。OpenRouter users は `deepseek/deepseek-v4-pro` を利用できます。@@ -725,7 +726,9 @@ vibe-trading # interactive TUIvibe-trading run -p "..." # single runvibe-trading serve # API servervibe-trading alpha list # 462 個の事前構築 alpha を閲覧;show / bench / compare / export-manifest サブコマンド利用可+vibe-trading playbook list # 定期リサーチのテンプレート 5 本;show / create サブコマンド利用可vibe-trading channels status --local # IM チャンネル設定と install hints を確認+vibe-trading provider doctor # 秘匿処理済みの provider/proxy/package 診断を出力```<details>@@ -733,23 +736,33 @@ vibe-trading channels status --local # IM チャンネル設定と install hint| Command | Description ||---------|-------------|-| `/help` | 全コマンドを表示 |-| `/skills` | 88 finance skills を一覧表示 |-| `/swarm` | 30 swarm team presets を一覧表示 |-| `/swarm run <preset> [vars_json]` | live streaming で swarm team を実行 |-| `/swarm list` | Swarm run history |-| `/swarm show <run_id>` | Swarm run details |-| `/swarm cancel <run_id>` | 実行中の swarm をキャンセル |-| `/list` | Recent runs |-| `/show <run_id>` | Run details + metrics |-| `/code <run_id>` | 生成された strategy code |-| `/pine <run_id>` | indicators を export(TradingView + TDX + MT5) |-| `/trace <run_id>` | Full execution replay |-| `/continue <run_id> <prompt>` | 新しい指示で run を継続 |-| `/sessions` | Chat sessions を一覧表示 |-| `/settings` | Runtime config を表示 |-| `/clear` | 画面をクリア |-| `/quit` | 終了 |+| `/help` | キーボードショートカットとコマンド一覧を表示 |+| `/model` | LLM provider とモデルを切り替え |+| `/memory` | 永続メモリの表示 / 管理 |+| `/history` | 過去セッションの閲覧と再開 |+| `/goal` | 金融リサーチ goal の開始 / 確認 |+| `/search` | 全セッション横断の全文検索 |+| `/swarm` | マルチエージェント preset(委員会 / クオンツ / リスク) |+| `/skill` | skills の一覧 / 読み込み / 解除 |+| `/show` | 過去の run を id で表示 |+| `/clear` | 現在の会話をクリア |+| `/pine` | 現在の戦略を Pine Script として書き出し |+| `/journal` | 取引履歴 CSV を分析 |+| `/shadow` | シャドーアカウントの学習 / 表示 |+| `/export` | 現在のセッションを書き出し(md / json) |+| `/debug` | デバッグパネル切り替え(token 使用量 / レイテンシ) |+| `/comps` | 類似企業分析(ピア倍率 → 含意レンジ) |+| `/dcf` | DCF 評価と感応度グリッド |+| `/attrib` | Brinson-Fachler 要因分解(アロケーション vs 銘柄選択) |+| `/memo` | 投資メモ — 論点、コンセンサスと異なる見立て、シナリオ、撤退条件 |+| `/earnings` | 決算レビュー — 売上から EPS までのサプライズ分解 |+| `/screen` | 体系的アイデアスクリーン — 仮説、ファネル、残存キュー |+| `/playbook` | 定期リサーチのテンプレート(一覧 / 実行 / スケジュール) |+| `/connector` | 取引 connector profile(状態 / 開始 / 停止) |+| `/halt` | キルスイッチ — すべてのライブ取引を即時停止 |+| `/resume` | キルスイッチを解除(ライブ取引を再開) |+| `/data` | データルーティングモード |+| `/quit` | 終了(q、exit、:q も可) |</details>@@ -935,6 +948,9 @@ vibe-trading serve --port 8899| `POST` | `/scheduled-runs` | 定期リサーチジョブを作成(interval-ms または cron) || `GET` | `/scheduled-runs` | スケジュール済みジョブを一覧 || `DELETE` | `/scheduled-runs/{job_id}` | スケジュール済みジョブをキャンセル |+| `GET` | `/scheduled-runs/playbooks` | リサーチテンプレートを一覧 |+| `GET` | `/scheduled-runs/playbooks/{slug}` | テンプレート 1 件と宣言済み変数を表示 |+| `POST` | `/scheduled-runs/playbooks/{slug}` | テンプレートからジョブをスケジュール || `POST` | `/sessions/{id}/cancel` | 進行中の実行を停止(失敗ではなくキャンセルとして記録) || `POST` | `/sessions/{id}/title/auto` | 最初のやり取りからセッション名を生成(手動リネームは上書きしない) || `GET` | `/correlation/regime` | 相関エッジ密度のレジームタイムライン |@@ -984,6 +1000,24 @@ curl -X DELETE http://localhost:8899/scheduled-runs/<job_id>各実行は新しい agent session で `prompt` を実行し(任意の backtest パラメータは `config` に入れます)、ジョブは `~/.vibe-trading/` に永続化されるため再起動後も残ります。このフラグがない場合、`/scheduled-runs` endpoints はジョブを記録しますが実行はされません。`API_AUTH_KEY` を設定している場合は各呼び出しに `-H "Authorization: Bearer <key>"` を付けてください。+スケジューラには**すぐ使えるリサーチテンプレートが 5 本**同梱されています —— `premarket-brief`、`earnings-season-tracker`、`portfolio-checkup`、`a-share-money-flow`、`institutional-holdings-diff`。各テンプレートはツール名を挙げず、必要なデータを自然言語で宣言するため、ツール面が広がってもそのまま機能します。また、欠けている入力は記憶で埋めず**明示する**ことが求められます。CLI、REST、TUI の `/playbook` から利用できます:++```bash+vibe-trading playbook list # 5 本のテンプレート+vibe-trading playbook show premarket-brief # 本文・宣言済み変数・推奨頻度+vibe-trading playbook create premarket-brief \+ --var home_market="US equities" --var watchlist="AAPL, MSFT, NVDA" \+ --timezone America/New_York++curl http://localhost:8899/scheduled-runs/playbooks+curl http://localhost:8899/scheduled-runs/playbooks/premarket-brief+curl -X POST http://localhost:8899/scheduled-runs/playbooks/premarket-brief \+ -H "Content-Type: application/json" \+ -d '{"variables":{"home_market":"US equities","watchlist":"AAPL, MSFT, NVDA"}}'+```++`{}` を POST すると、テンプレート自身の推奨頻度と既定変数でスケジュールされます。描画された本文はそのままジョブの prompt になり、宣言されていない変数は黙って無視されず拒否されます。+---## 🔌 MCP Plugin@@ -1064,7 +1098,7 @@ ClawHub で見る: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vi<details><summary><b>OpenSpace — self-evolving skills</b></summary>-88 の finance skills はすべて [open-space.cloud](https://open-space.cloud) に公開され、OpenSpace の self-evolution engine を通じて自律的に進化します。+89 の finance skills はすべて [open-space.cloud](https://open-space.cloud) に公開され、OpenSpace の self-evolution engine を通じて自律的に進化します。OpenSpace と使うには、agent config に両方の MCP servers を追加してください。@@ -1086,7 +1120,7 @@ OpenSpace と使うには、agent config に両方の MCP servers を追加し}```-OpenSpace は 88 skills を自動検出し、auto-fix、auto-improve、community sharing を可能にします。OpenSpace-connected agent では `search_skills("finance backtest")` から Vibe-Trading skills を検索できます。+OpenSpace は 89 skills を自動検出し、auto-fix、auto-improve、community sharing を可能にします。OpenSpace-connected agent では `search_skills("finance backtest")` から Vibe-Trading skills を検索できます。</details>@@ -1150,7 +1184,7 @@ Vibe-Trading/│ │ ├── agent/ # ReAct エージェントコア│ │ │ ├── loop.py # 5 層コンテキスト圧縮 + read/write ツールバッチング│ │ │ ├── context.py # システムプロンプト + 永続メモリからの自動 recall-│ │ │ ├── skills.py # skill ローダー(88 個同梱 + CRUD でユーザー作成)+│ │ │ ├── skills.py # skill ローダー(89 個同梱 + CRUD でユーザー作成)│ │ │ ├── tools.py # ツール基底クラス + レジストリ│ │ │ ├── memory.py # run ごとの軽量ワークスペース状態│ │ │ ├── frontmatter.py # 共有 YAML frontmatter パーサー@@ -1177,7 +1211,7 @@ Vibe-Trading/│ │ ├── api/ # FastAPI ルートモジュール│ │ │ └── alpha_routes.py # /alpha/list、/alpha/{id}、/alpha/bench、SSE ストリーム│ │ │-│ │ ├── skills/ # 9 カテゴリ 88 個の finance skills(各 SKILL.md)+│ │ ├── skills/ # 9 カテゴリ 89 個の finance skills(各 SKILL.md)│ │ ├── swarm/ # Swarm DAG 実行エンジン│ │ │ └── presets/ # 30 個の swarm preset YAML 定義│ │ ├── session/ # マルチターンチャット + FTS5 セッション検索diff --git a/README_ko.md b/README_ko.mdindex 3b60abafb..6f0dc216c 100644--- a/README_ko.md+++ b/README_ko.md@@ -267,13 +267,14 @@ Vibe-Trading은 금융 질문을 실행 가능한 분석으로 바꾸는 오픈| **트레이딩 질문하기** | 도구, 데이터, 문서, 재사용 가능한 세션 컨텍스트를 활용한 시장 리서치. || **전략 아이디어 백테스트** | 전략 코드, 지표, 벤치마크 컨텍스트, 검증 artifacts, run cards. || **내 거래 검토하기** | 브로커 일지 파싱, 행동 진단, 규칙 추출, Shadow Account 비교. |-| **Read documents & charts** | Parse PDF / DOCX / XLSX / PPTX / images with pluggable OCR (`read_document`), and read chart screenshots semantically with a vision model (`analyze_image`). |+| **문서와 차트 읽기** | 플러그형 OCR로 PDF / DOCX / XLSX / PPTX / 이미지를 파싱하고(`read_document`), 비전 모델로 차트 스크린샷을 의미 단위로 읽습니다(`analyze_image`). |+| **기관 보고서와 펀드 편입종목 읽기** | SEC 13F 보유(분기 대비 증감 포함), 시장을 가로지르는 ETF 구성종목, 이벤트 계약 내재확률, arXiv / OpenAlex 팩터 추출 — 모두 읽기 전용, 무료 공개 데이터. || **반복 리서치 개선하기** | 영구 메모리와 편집 가능한 스킬로 유용한 루틴을 재사용 가능한 워크플로로 전환. || **애널리스트 팀 실행하기** | 투자, 퀀트, 크립토, 매크로, 리스크 워크플로를 위한 멀티 에이전트 리서치 리뷰. || **리서치를 IM 채널에 연결하기** | WebSocket, Telegram, Slack, Discord, Matrix, WhatsApp, Signal, QQ/NapCat, WeChat/WeCom, Feishu/Lark, DingTalk, Teams, email, Mochat에서 같은 session runtime을 CLI, REST, Web UI로 관리. || **사용 가능한 artifacts 만들기** | 리포트, TradingView Pine Script, TDX, MetaTrader 5, MCP tools, 이후 리서치 세션. || **사전 빌드된 alpha zoo 벤치** | 462개의 alpha 인자(Qlib 158 + Kakushadze 101 + GTJA 191 + academic + PIT-safe fundamental)에 대해 한 줄 CLI로 IC + IR + alive/reversed/dead 분류 수행 |-| **Spot correlation regimes** | An edge-density + hysteresis timeline on the `/correlation` surface showing when markets fuse into one bloc — descriptive risk context, not a signal. |+| **상관관계 국면 포착하기** | `/correlation` 화면의 엣지 밀도 + 히스테리시스 타임라인으로 시장이 한 덩어리로 움직이기 시작하는 시점을 보여줍니다 — 시그널이 아니라 서술적 리스크 컨텍스트입니다. |---@@ -363,7 +364,7 @@ vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, an- **크립토** → `okx` · `ccxt` · `binance` · `yfinance` · `local`- **외환/귀금속** → `mt5` · `yfinance` · `akshare` · `local` · *(선물 / 펀드 / 매크로 → `tushare`/`akshare` → `local`)*-OHLCV를 넘어 **18개 읽기 전용 데이터 도구**가 펀더멘털과 자금 흐름까지 닿습니다 — 자금 흐름, 용호방(dragon-tiger), 북향(northbound), 신용거래, 대종거래, 주주 수, 보호예수, 섹터, 리서치 리포트, 뉴스, SEC 공시, 재무제표, 옵션 체인, 기관 보유, 시장 스크리닝, 심볼 검색, 매크로 — 모두 MCP로 노출됩니다. 명시적인 `local:` 심볼은 절대 조용히 네트워크 소스로 폴백하지 않습니다.+OHLCV를 넘어 **22개 읽기 전용 데이터 도구**가 펀더멘털과 자금 흐름까지 닿습니다 — 자금 흐름, 용호방(dragon-tiger), 북향(northbound), 신용거래, 대종거래, 주주 수, 보호예수, 섹터, 리서치 리포트, 뉴스, SEC 공시, 재무제표, 옵션 체인, 종목 프로필, 시장 스크리닝, 심볼 검색, 매크로, 원차이(iwencai), 기관 보유(13F), ETF 룩스루, 예측 시장, 논문 검색 — 모두 MCP로 노출됩니다. 명시적인 `local:` 심볼은 절대 조용히 네트워크 소스로 폴백하지 않습니다.<!-- QVERIS-START -->### 💎 선택형 프리미엄 데이터 — QVeris@@ -384,7 +385,7 @@ OHLCV를 넘어 **18개 읽기 전용 데이터 도구**가 펀더멘털과 자<details><summary><b>금융 스킬 라이브러리</b> <sub>9개 카테고리 89개 스킬</sub></summary>-- 📊 9개 카테고리로 구성된 88개 전문 금융 스킬+- 📊 9개 카테고리로 구성된 89개 전문 금융 스킬- 🌐 전통 시장부터 크립토 & DeFi까지 완전한 커버리지- 🔬 데이터 sourcing부터 정량 리서치까지 포괄하는 기능@@ -392,7 +393,7 @@ OHLCV를 넘어 **18개 읽기 전용 데이터 도구**가 펀더멘털과 자|----------|------|------|| Data Source | 10 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `mootdx`, `ccxt`, `eastmoney`, `sec-edgar`, `qveris` || Strategy | 19 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` |-| Analysis | 22 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-analysis` |+| Analysis | 23 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `investor-lenses`, `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 | 8 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` |@@ -449,7 +450,7 @@ clone에서 실행하세요(`pip install -e .`).<details><summary><b>브로커 커넥터</b> <sub>12개 브로커 — read + paper, 지원 시 bounded-live</sub></summary>-connector-first 프로필. 각 브로커는 read + 페이퍼 계정 주문 실행을 지원하며, 실거래 주문 실행은 사용자 정의 mandate(심볼 허용목록, 주문 크기 / 익스포저 상한, 일일 거래 한도, 즉시 kill switch)로 제한되고 자금을 보관하지 않습니다 — 실행은 브로커가 합니다. 주문 실행 도구는 MCP에 노출되지 않습니다(agent + CLI 전용). 리서치 / 백테스트 경로는 구조적으로 모든 실거래 엔드포인트에서 차단됩니다.+connector-first 프로필. 대부분의 브로커가 read + 페이퍼 계정 주문 실행을 지원하지만 IBKR은 읽기 전용이고, Robinhood는 페이퍼 계정 없이 실거래 전용이며, Trading 212는 페이퍼를 포함해 주문 실행을 모두 거부하고, 실거래 주문 실행은 사용자 정의 mandate(심볼 허용목록, 주문 크기 / 익스포저 상한, 일일 거래 한도, 즉시 kill switch)로 제한되고 자금을 보관하지 않습니다 — 실행은 브로커가 합니다. 주문 실행 도구는 MCP에 노출되지 않습니다(agent + CLI 전용). 리서치 / 백테스트 경로는 구조적으로 모든 실거래 엔드포인트에서 차단됩니다.| Broker | Markets | Capabilities ||--------|---------|--------------|@@ -725,7 +726,9 @@ vibe-trading # interactive TUIvibe-trading run -p "..." # single runvibe-trading serve # API servervibe-trading alpha list # 사전 빌드된 462개 alpha 탐색; show / bench / compare / export-manifest 서브커맨드 사용 가능+vibe-trading playbook list # 예약 리서치 템플릿 5개; show / create 서브커맨드 사용 가능vibe-trading channels status --local # IM 채널 설정과 설치 힌트 확인+vibe-trading provider doctor # 마스킹된 provider/proxy/패키지 진단 출력```<details>@@ -733,23 +736,33 @@ vibe-trading channels status --local # IM 채널 설정과 설치 힌트 확인| Command | Description ||---------|-------------|-| `/help` | 모든 명령 표시 |-| `/skills` | 88개 finance skills 목록 |-| `/swarm` | 30개 swarm team presets 목록 |-| `/swarm run <preset> [vars_json]` | live streaming으로 swarm team 실행 |-| `/swarm list` | Swarm run history |-| `/swarm show <run_id>` | Swarm run details |-| `/swarm cancel <run_id>` | 실행 중인 swarm 취소 |-| `/list` | Recent runs |-| `/show <run_id>` | Run details + metrics |-| `/code <run_id>` | Generated strategy code |-| `/pine <run_id>` | indicators export(TradingView + TDX + MT5) |-| `/trace <run_id>` | Full execution replay |-| `/continue <run_id> <prompt>` | 새 instruction으로 run 계속 |-| `/sessions` | Chat sessions 목록 |-| `/settings` | Runtime config 표시 |-| `/clear` | 화면 지우기 |-| `/quit` | 종료 |+| `/help` | 단축키와 명령 목록 표시 |+| `/model` | LLM 제공자와 모델 전환 |+| `/memory` | 영속 메모리 보기 / 관리 |+| `/history` | 이전 세션 탐색 및 재개 |+| `/goal` | 금융 리서치 goal 시작 / 확인 |+| `/search` | 모든 세션 전문 검색 |+| `/swarm` | 멀티 에이전트 preset(위원회 / 퀀트 / 리스크) |+| `/skill` | skills 목록 / 로드 / 해제 |+| `/show` | 이전 run을 id로 표시 |+| `/clear` | 현재 대화 비우기 |+| `/pine` | 현재 전략을 Pine Script로 내보내기 |+| `/journal` | 매매일지 CSV 분석 |+| `/shadow` | 섀도 계좌 학습 / 조회 |+| `/export` | 현재 세션 내보내기(md / json) |+| `/debug` | 디버그 패널 전환(토큰 사용량 / 지연) |+| `/comps` | 유사기업 분석(피어 멀티플 → 내재 범위) |+| `/dcf` | 현금흐름할인 밸류에이션 + 민감도 그리드 |+| `/attrib` | Brinson-Fachler 성과기여 분석(자산배분 vs 종목선택) |+| `/memo` | 투자 메모 — 논지, 차별적 관점, 시나리오, 철회 기준 |+| `/earnings` | 실적 리뷰 — 매출에서 EPS까지 서프라이즈 브리지 |+| `/screen` | 체계적 아이디어 스크리닝 — 가설, 퍼널, 생존 큐 |+| `/playbook` | 예약 리서치 템플릿(목록 / 실행 / 예약) |+| `/connector` | 트레이딩 커넥터 프로필(상태 / 시작 / 중지) |+| `/halt` | 킬 스위치 — 모든 실거래 즉시 중단 |+| `/resume` | 킬 스위치 해제(실거래 재개) |+| `/data` | 데이터 라우팅 모드 |+| `/quit` | 종료(q, exit, :q 도 가능) |</details>@@ -938,6 +951,9 @@ vibe-trading serve --port 8899| `POST` | `/scheduled-runs` | 예약 리서치 작업 생성 (interval-ms 또는 cron) || `GET` | `/scheduled-runs` | 예약된 작업 목록 || `DELETE` | `/scheduled-runs/{job_id}` | 예약 작업 취소 |+| `GET` | `/scheduled-runs/playbooks` | 리서치 템플릿 목록 |+| `GET` | `/scheduled-runs/playbooks/{slug}` | 템플릿 1개와 선언된 변수 표시 |+| `POST` | `/scheduled-runs/playbooks/{slug}` | 템플릿으로 작업 예약 || `POST` | `/sessions/{id}/cancel` | 진행 중인 실행 중지(실패가 아니라 취소로 기록) || `POST` | `/sessions/{id}/title/auto` | 첫 대화로 세션 제목 생성(수동 이름 변경은 덮어쓰지 않음) || `GET` | `/correlation/regime` | 상관 엣지 밀도 레짐 타임라인 |@@ -987,6 +1003,24 @@ curl -X DELETE http://localhost:8899/scheduled-runs/<job_id>각 실행은 새 agent session에서 `prompt`를 실행하며(선택적 backtest 파라미터는 `config`에 넣습니다), 작업은 `~/.vibe-trading/`에 저장되어 재시작 후에도 유지됩니다. 이 플래그가 없으면 `/scheduled-runs` endpoint는 작업을 기록하지만 실행되지는 않습니다. `API_AUTH_KEY`가 설정된 경우 각 호출에 `-H "Authorization: Bearer <key>"`를 추가하세요.+스케줄러에는 **바로 예약할 수 있는 리서치 템플릿 5개**가 들어 있습니다 — `premarket-brief`, `earnings-season-tracker`, `portfolio-checkup`, `a-share-money-flow`, `institutional-holdings-diff`. 각 템플릿은 도구 이름을 지목하지 않고 필요한 데이터를 자연어로 선언하므로 도구 표면이 늘어나도 그대로 동작하며, 빠진 입력은 기억으로 채우지 말고 **밝히도록** 요구합니다. CLI, REST, TUI의 `/playbook` 어디서든 쓸 수 있습니다:++```bash+vibe-trading playbook list # 템플릿 5개+vibe-trading playbook show premarket-brief # 본문, 선언된 변수, 권장 주기+vibe-trading playbook create premarket-brief \+ --var home_market="US equities" --var watchlist="AAPL, MSFT, NVDA" \+ --timezone America/New_York++curl http://localhost:8899/scheduled-runs/playbooks+curl http://localhost:8899/scheduled-runs/playbooks/premarket-brief+curl -X POST http://localhost:8899/scheduled-runs/playbooks/premarket-brief \+ -H "Content-Type: application/json" \+ -d '{"variables":{"home_market":"US equities","watchlist":"AAPL, MSFT, NVDA"}}'+```++`{}` 를 POST하면 템플릿 자체의 권장 주기와 기본 변수로 예약됩니다. 렌더링된 본문이 그대로 작업 prompt가 되며, 선언되지 않은 변수는 조용히 무시되지 않고 거부됩니다.+---## 🔌 MCP Plugin@@ -1067,7 +1101,7 @@ ClawHub에서 보기: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills<details><summary><b>OpenSpace — 자가 진화 스킬</b></summary>-88개 finance skills는 모두 [open-space.cloud](https://open-space.cloud)에 게시되어 있으며 OpenSpace의 self-evolution engine을 통해 자율적으로 발전합니다.+89개 finance skills는 모두 [open-space.cloud](https://open-space.cloud)에 게시되어 있으며 OpenSpace의 self-evolution engine을 통해 자율적으로 발전합니다.OpenSpace와 함께 사용하려면 두 MCP server를 agent config에 추가하세요:@@ -1089,7 +1123,7 @@ OpenSpace와 함께 사용하려면 두 MCP server를 agent config에 추가하}```-OpenSpace는 88개 skills를 모두 자동 발견하여 auto-fix, auto-improve, community sharing을 활성화합니다. OpenSpace-connected agent에서 `search_skills("finance backtest")`로 Vibe-Trading skills를 검색하세요.+OpenSpace는 89개 skills를 모두 자동 발견하여 auto-fix, auto-improve, community sharing을 활성화합니다. OpenSpace-connected agent에서 `search_skills("finance backtest")`로 Vibe-Trading skills를 검색하세요.</details>@@ -1153,7 +1187,7 @@ Vibe-Trading/│ │ ├── 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 (88 bundled + user-created via CRUD)+│ │ │ ├── skills.py # skill loader (89 bundled + user-created via CRUD)│ │ │ ├── tools.py # tool base class + registry│ │ │ ├── memory.py # lightweight workspace state per run│ │ │ ├── frontmatter.py # shared YAML frontmatter parser@@ -1180,7 +1214,7 @@ Vibe-Trading/│ │ ├── api/ # FastAPI 라우트 모듈│ │ │ └── alpha_routes.py # /alpha/list, /alpha/{id}, /alpha/bench, SSE stream│ │ │-│ │ ├── skills/ # 88 finance skills in 9 categories (SKILL.md each)+│ │ ├── skills/ # 89 finance skills in 9 categories (SKILL.md each)│ │ ├── swarm/ # Swarm DAG execution engine│ │ │ └── presets/ # 30 swarm preset YAML definitions│ │ ├── session/ # Multi-turn chat + FTS5 session searchdiff --git a/README_zh.md b/README_zh.mdindex bd1ccf0ad..8cef1117b 100644--- a/README_zh.md+++ b/README_zh.md@@ -267,6 +267,7 @@ Vibe-Trading 是一个开源研究工作台,用于把金融问题转化为可| **回测策略想法** | 策略代码、指标、benchmark 上下文、验证 artifacts 和 run cards。 || **复盘自己的交易** | 券商日志解析、行为诊断、规则提取和 Shadow Account 对比。 || **读取文档与图表** | 用可插拔 OCR 解析 PDF / DOCX / XLSX / PPTX / 图片(`read_document`),并用视觉模型语义化读取图表截图(`analyze_image`)。 |+| **读取机构持仓与基金底仓** | SEC 13F 持仓(含季度环比变动)、跨市场 ETF 成分穿透、事件合约隐含概率、arXiv / OpenAlex 因子提取 —— 全部只读,基于免费公开数据源。 || **改进重复研究** | 持久记忆和可编辑 skills 将有用流程变成可复用工作流。 || **运行分析师团队** | 面向投资、量化、加密、宏观和风控工作流的多智能体研究评审。 || **把研究接入 IM 通道** | 通过 WebSocket、Telegram、Slack、Discord、Matrix、WhatsApp、Signal、QQ/NapCat、微信/企业微信、飞书/Lark、钉钉、Teams、email、Mochat,在 CLI、REST 和 Web UI 中管理同一套 session runtime。 |@@ -392,7 +393,7 @@ LONGBRIDGE_ACCESS_TOKEN=...与 Agent 对话时可以直接说:**“用长桥获取 QQQ.US 的历史行情。”** 显式指定数据源与 `source: "auto"` 不同;`auto` 仍按正常的同市场 fallback 链选择数据源。-除 OHLCV 外,**18 个只读数据工具**深入基本面与资金面——资金流、龙虎榜、北向、两融、大宗交易、股东户数、解禁、板块、研报、新闻、SEC 文件、财务报表、期权链、机构持仓、全市场筛选、代码搜索、宏观——全部经 MCP 暴露。显式 `local:` 源永不静默 fallback 到网络源。+除 OHLCV 外,**22 个只读数据工具**深入基本面与资金面——资金流、龙虎榜、北向、两融、大宗交易、股东户数、解禁、板块、研报、新闻、SEC 文件、财务报表、期权链、个股档案、全市场筛选、代码搜索、宏观、问财、机构持仓(13F)、ETF 穿透、预测市场、论文检索——全部经 MCP 暴露。显式 `local:` 源永不静默 fallback 到网络源。<!-- QVERIS-START -->### 💎 可选付费数据 — QVeris@@ -413,7 +414,7 @@ LONGBRIDGE_ACCESS_TOKEN=...<details><summary><b>Finance Skill Library</b> <sub>9 个类别中的 89 个 skills</sub></summary>-- 📊 88 个专业金融 skills,分布在 9 个类别中+- 📊 89 个专业金融 skills,分布在 9 个类别中- 🌐 覆盖传统市场、加密与 DeFi- 🔬 从数据源到量化研究的完整能力链路@@ -421,7 +422,7 @@ LONGBRIDGE_ACCESS_TOKEN=...|------|--------|------|| Data Source | 10 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `mootdx`, `ccxt`, `eastmoney`, `sec-edgar`, `qveris` || Strategy | 19 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` |-| Analysis | 22 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `earnings-forecast`, `credit-analysis`, `dividend-analysis` |+| Analysis | 23 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `investor-lenses`, `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 | 8 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` |@@ -476,7 +477,7 @@ LONGBRIDGE_ACCESS_TOKEN=...<details><summary><b>Broker Connectors</b> <sub>12 家券商——读取 + 模拟盘,支持的券商可受约束实盘</sub></summary>-连接器优先(connector-first)的配置档。每个连接器都支持读取 + 模拟盘下单;实盘下单受用户定义的 mandate 约束(标的白名单、下单规模 / 敞口上限、每日交易次数上限、即时 kill switch),且从不托管资金——由券商执行。下单类工具不经 MCP 暴露(仅 agent + CLI)。研究 / 回测路径在结构上被隔离,无法触达任何实盘端点。+连接器优先(connector-first)的配置档。多数连接器支持读取 + 模拟盘下单 —— IBKR 只读,Robinhood 只有实盘(没有模拟盘),Trading 212 连模拟盘下单也一律拒绝;实盘下单受用户定义的 mandate 约束(标的白名单、下单规模 / 敞口上限、每日交易次数上限、即时 kill switch),且从不托管资金——由券商执行。下单类工具不经 MCP 暴露(仅 agent + CLI)。研究 / 回测路径在结构上被隔离,无法触达任何实盘端点。| Broker | 市场 | 能力 ||--------|------|------|@@ -752,7 +753,9 @@ vibe-trading # interactive TUIvibe-trading run -p "..." # single runvibe-trading serve # API servervibe-trading alpha list # 浏览 462 个预置 alpha;支持 show / bench / compare / export-manifest 子命令+vibe-trading playbook list # 五个定时研究模板;支持 show / create 子命令vibe-trading channels status --local # 检查 IM 通道配置和依赖安装提示+vibe-trading provider doctor # 打印脱敏后的 provider/proxy/依赖诊断```<details>@@ -760,23 +763,33 @@ vibe-trading channels status --local # 检查 IM 通道配置和依赖安装提| 命令 | 说明 ||------|------|-| `/help` | 显示所有命令 |-| `/skills` | 列出全部 88 个 finance skills |-| `/swarm` | 列出 30 个 swarm team presets |-| `/swarm run <preset> [vars_json]` | 运行一个 swarm team,并实时流式展示 |-| `/swarm list` | Swarm 运行历史 |-| `/swarm show <run_id>` | Swarm 运行详情 |-| `/swarm cancel <run_id>` | 取消运行中的 swarm |-| `/list` | 最近 runs |-| `/show <run_id>` | Run 详情 + 指标 |-| `/code <run_id>` | 生成的策略代码 |-| `/pine <run_id>` | 导出指标(TradingView + TDX + MT5) |-| `/trace <run_id>` | 完整执行回放 |-| `/continue <run_id> <prompt>` | 用新指令继续一个 run |-| `/sessions` | 列出 chat sessions |-| `/settings` | 显示运行时配置 |-| `/clear` | 清屏 |-| `/quit` | 退出 |+| `/help` | 显示快捷键与命令列表 |+| `/model` | 切换 LLM provider 与模型 |+| `/memory` | 查看 / 管理持久记忆 |+| `/history` | 浏览并恢复历史会话 |+| `/goal` | 启动 / 查看金融研究 goal |+| `/search` | 跨全部会话全文检索 |+| `/swarm` | 多 agent 预设(投委会 / 量化 / 风控) |+| `/skill` | 列出 / 加载 / 卸载 skills |+| `/show` | 按 id 查看历史 run |+| `/clear` | 清空当前对话 |+| `/pine` | 将当前策略导出为 Pine Script |+| `/journal` | 分析交易流水 CSV |+| `/shadow` | 训练 / 查看影子账户 |+| `/export` | 导出当前会话(md / json) |+| `/debug` | 切换调试面板(token 用量 / 延迟) |+| `/comps` | 可比公司分析(同业倍数 → 隐含区间) |+| `/dcf` | 现金流折现估值 + 敏感性网格 |+| `/attrib` | Brinson-Fachler 归因(配置 vs 选股) |+| `/memo` | 投资备忘录 —— 论点、与共识不同的看法、情景、证伪条件 |+| `/earnings` | 财报复盘 —— 从营收到 EPS 的意外拆解 |+| `/screen` | 系统性选股 —— 假设、漏斗、存活队列 |+| `/playbook` | 定时研究模板(列出 / 运行 / 排程) |+| `/connector` | 交易连接器 profile(状态 / 启动 / 停止) |+| `/halt` | kill switch —— 立即停止全部实盘活动 |+| `/resume` | 解除 kill switch(重新允许实盘) |+| `/data` | 数据路由模式 |+| `/quit` | 退出(也可用 q、exit、:q) |</details>@@ -962,6 +975,9 @@ vibe-trading serve --port 8899| `POST` | `/scheduled-runs` | 创建定时研究任务(间隔毫秒或 cron) || `GET` | `/scheduled-runs` | 列出定时任务 || `DELETE` | `/scheduled-runs/{job_id}` | 取消定时任务 |+| `GET` | `/scheduled-runs/playbooks` | 列出研究模板 |+| `GET` | `/scheduled-runs/playbooks/{slug}` | 查看单个模板及其变量 |+| `POST` | `/scheduled-runs/playbooks/{slug}` | 从模板创建定时任务 || `POST` | `/sessions/{id}/cancel` | 停止该会话进行中的运行(记为已取消,而非失败) || `POST` | `/sessions/{id}/title/auto` | 由首轮对话生成会话标题(不会覆盖手动重命名) || `GET` | `/correlation/regime` | 相关性边密度 regime 时间线 |@@ -1011,6 +1027,24 @@ curl -X DELETE http://localhost:8899/scheduled-runs/<job_id>每次触发都会在一个全新的 agent session 中运行该 `prompt`(可选回测参数放在 `config` 里),任务持久化到 `~/.vibe-trading/`,重启后依然保留。不设这个开关时,`/scheduled-runs` 端点仍会记录任务,但不会真正触发。配置了 `API_AUTH_KEY` 时,每次请求需加 `-H "Authorization: Bearer <key>"`。+调度器自带**五个开箱即用的研究模板** —— `premarket-brief`、`earnings-season-tracker`、`portfolio-checkup`、`a-share-money-flow`、`institutional-holdings-diff`。每个模板用自然语言声明它需要什么数据,而不是点名某个工具,因此工具面扩展时模板依然有效;模板也被要求**指出缺失的输入**,而不是凭记忆补上。CLI、REST、TUI 里的 `/playbook` 三个入口都能用:++```bash+vibe-trading playbook list # 列出五个模板+vibe-trading playbook show premarket-brief # 正文、声明的变量、建议节奏+vibe-trading playbook create premarket-brief \+ --var home_market="US equities" --var watchlist="AAPL, MSFT, NVDA" \+ --timezone America/New_York++curl http://localhost:8899/scheduled-runs/playbooks+curl http://localhost:8899/scheduled-runs/playbooks/premarket-brief+curl -X POST http://localhost:8899/scheduled-runs/playbooks/premarket-brief \+ -H "Content-Type: application/json" \+ -d '{"variables":{"home_market":"US equities","watchlist":"AAPL, MSFT, NVDA"}}'+```++POST `{}` 即按模板自身的建议节奏和默认变量排程。渲染后的正文原样成为任务 prompt;传入未声明的变量会被拒绝,而不是被悄悄忽略。+---## 🔌 MCP Plugin@@ -1091,7 +1125,7 @@ npx clawhub@latest install vibe-trading --force<details><summary><b>OpenSpace — 自进化 skills</b></summary>-全部 88 个 finance skills 都发布在 [open-space.cloud](https://open-space.cloud),并通过 OpenSpace 的自进化引擎自主演进。+全部 89 个 finance skills 都发布在 [open-space.cloud](https://open-space.cloud),并通过 OpenSpace 的自进化引擎自主演进。要配合 OpenSpace 使用,请将两个 MCP servers 都加入你的 agent config:@@ -1113,7 +1147,7 @@ npx clawhub@latest install vibe-trading --force}```-OpenSpace 会自动发现全部 88 个 skills,启用 auto-fix、auto-improve 和社区分享。在任意已连接 OpenSpace 的智能体中,可通过 `search_skills("finance backtest")` 搜索 Vibe-Trading skills。+OpenSpace 会自动发现全部 89 个 skills,启用 auto-fix、auto-improve 和社区分享。在任意已连接 OpenSpace 的智能体中,可通过 `search_skills("finance backtest")` 搜索 Vibe-Trading skills。</details>@@ -1177,7 +1211,7 @@ Vibe-Trading/│ │ ├── agent/ # ReAct agent 内核│ │ │ ├── loop.py # 5 层上下文压缩 + 读/写工具批处理│ │ │ ├── context.py # system prompt + 持久记忆自动召回-│ │ │ ├── skills.py # skill loader(88 个内置 + 通过 CRUD 创建的用户 skill)+│ │ │ ├── skills.py # skill loader(89 个内置 + 通过 CRUD 创建的用户 skill)│ │ │ ├── tools.py # tool 基类 + 注册表│ │ │ ├── memory.py # 每个 run 的轻量 workspace 状态│ │ │ ├── frontmatter.py # 共享的 YAML frontmatter 解析器@@ -1204,7 +1238,7 @@ Vibe-Trading/│ │ ├── api/ # FastAPI 路由模块│ │ │ └── alpha_routes.py # /alpha/list、/alpha/{id}、/alpha/bench、SSE 流│ │ │-│ │ ├── skills/ # 9 个类别共 88 个 finance skills(每个一份 SKILL.md)+│ │ ├── skills/ # 9 个类别共 89 个 finance skills(每个一份 SKILL.md)│ │ ├── swarm/ # Swarm DAG 执行引擎│ │ │ └── presets/ # 30 个 swarm preset YAML 定义│ │ ├── session/ # 多轮对话 + FTS5 session 搜索