# Vibe-Trading **Repository Path**: lance521/Vibe-Trading ## Basic Information - **Project Name**: Vibe-Trading - **Description**: Vibe-Trading 是一个由 AI 驱动的多代理金融工作台，将自然语言请求转化为可执行的交易策略、研究洞见和跨全球市场的投资组合分析。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 4 - **Forks**: 3 - **Created**: 2026-05-10 - **Last Updated**: 2026-05-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

English | 中文 | 日本語 | 한국어 | العربية

Vibe-Trading Logo

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

一条命令，为你的代理赋予全栈交易能力

Python FastAPI React PyPI License
Skills Swarm Tools Data Sources
Feishu WeChat Discord

核心功能  ·  演示  ·  产品介绍  ·  快速开始  ·  CLI  ·  API  ·  MCP  ·  项目结构  ·  路线图  ·  贡献  ·  贡献者

pip install vibe-trading-ai

--- ## 📰 新闻 - **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 数据源自动回退。
--- ## 💡 Vibe-Trading 是什么？ Vibe-Trading 是一个由 AI 驱动的多代理金融工作台，将自然语言请求转化为可执行的交易策略、研究洞见和跨全球市场的投资组合分析。 ### 核心能力： • **自然语言 → 策略** —— 描述想法，代理自动编写、测试、导出交易代码
• **6 大数据源，零配置** —— A 股、港美股、加密、期货、外汇自动回退
• **29 支专家团队** —— 预构建的多代理 swarm 工作流，覆盖投资、交易与风控
• **跨会话记忆** —— 记住偏好与洞察；自动创建、进化可复用技能
• **7 大回测引擎** —— 跨市场复合测试 + 统计验证 + 4 种优化器
• **多平台导出** —— 一键到 TradingView、TDX（通达信/同花顺）和 MetaTrader 5 --- ## ✨ 核心功能
Research

🔍 面向交易的深度研究

Skills

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

🐝 群体智能

Swarm

• 29 个开箱即用的交易团队预设
• 基于 DAG 的多代理编排
• 实时流式仪表盘，显示代理运行状态
• FTS5 跨会话搜索全部历史对话
Backtest

📊 跨市场回测

Backtest

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

🧮 量化分析工具箱

Quant

• 因子 IC/IR 分析与分位回测
• Black-Scholes 定价与全套 Greeks 计算
• 技术形态识别与检测
• 投资组合优化：MVO/风险平价/BL
## 8 大类别中的 74 个技能 - 📊 74 个金融专长技能，划分 8 大类 - 🌐 覆盖传统市场到加密与 DeFi - 🔬 覆盖数据获取到量化研究的全链路能力 | Category | Skills | Examples | |----------|--------|----------| | 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 个 Agent Swarm 团队预设 - 🏢 29 组可即用的代理团队 - ⚡ 预配置的金融工作流 - 🎯 投资、交易与风险管理场景预设 | Preset | Workflow | |--------|----------| | `investment_committee` | 多空辩论 → 风险复核 → PM 最终决策 | | `global_equities_desk` | A 股 + 港美股 + 加密研究员 → 全球策略师 | | `crypto_trading_desk` | 资金费/基差 + 清算 + 资金流 → 风险经理 | | `earnings_research_desk` | 基本面 + 修正 + 期权 → 财报策略师 | | `macro_rates_fx_desk` | 利率 + 外汇 + 商品 → 宏观 PM | | `quant_strategy_desk` | 筛选 + 因子研究 → 回测 → 风险审计 | | `technical_analysis_panel` | 经典 TA + 一目均衡 + 谐波 + 艾略特 + SMC → 共识 | | `risk_committee` | 回撤 + 尾部风险 + Regime 评审 → 签核 | | `global_allocation_committee` | A 股 + 加密 + 港美股 → 跨市场配置 | 另有 20+ 专项预设 —— 运行 vibe-trading --swarm-presets 查看全部。 ### 🎬 演示
https://github.com/user-attachments/assets/4e4dcb80-7358-4b9a-92f0-1e29612e6e86 https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30
☝️ 自然语言回测与多代理 swarm 辩论 —— Web UI + CLI
--- ## 🚀 快速开始 ### 一行安装（PyPI） ```bash 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） ``` ### 或选择一条路径 | Path | Best for | Time | |------|----------|------| | **A. Docker** | 立即体验，零本地配置 | 2 min | | **B. Local install** | 开发、完整 CLI 访问 | 5 min | | **C. MCP plugin** | 接入你现有的代理 | 3 min | | **D. ClawHub** | 一条命令，无需克隆 | 1 min | ### 前置条件 - 任一支持提供商的 **LLM API key**——或使用 **Ollama** 本地运行（无需 key） - Path B 需 **Python 3.11+** - Path A 需 **Docker** > **支持的 LLM 提供商：** OpenRouter、OpenAI、DeepSeek、Gemini、Groq、DashScope/Qwen、智谱、Moonshot/Kimi、MiniMax、小米 MIMO、Z.ai、Ollama（本地）。参见 `.env.example` 配置。 > **提示：** 所有市场都可在无 API key 情况下运行，因自动回退。yfinance（港美股）、OKX（加密）、AKShare（A 股、美股、港股、期货、外汇）均免费。Tushare token 可选——A 股可回退到 AKShare 免费获取。 ### 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 提供商并填写 API key docker compose up --build ``` 打开 `http://localhost:8899`。后端与前端同一容器。 Docker 默认只把后端发布到 `127.0.0.1:8899`，并以非 root 容器用户运行应用。如果你有意把 API 暴露到本机之外，请设置强 `API_AUTH_KEY`，客户端通过 `Authorization: Bearer ` 调用。 ### Path B: 本地安装 ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading python -m venv .venv # 激活 source .venv/bin/activate # Linux / macOS # .venv\Scripts\Activate.ps1 # Windows PowerShell pip install -e . cp agent/.env.example agent/.env # 编辑 —— 设置你的 LLM 提供商 API key vibe-trading # 启动交互式 TUI ```
启动 Web UI（可选） ```bash # 终端 1：API 服务器 vibe-trading serve --port 8899 # 终端 2：前端开发服务器 cd frontend && npm install && npm run dev ``` 打开 `http://localhost:5899`。前端会代理到 `localhost:8899`。 **生产模式（单服务器）：** ```bash cd frontend && npm run build && cd .. vibe-trading serve --port 8899 # FastAPI 同时提供 dist/ 静态文件 ```
### Path C: MCP 插件 见下方 [MCP 插件](#-mcp-插件) 章节。 ### Path D: ClawHub（一条命令） ```bash npx clawhub@latest install vibe-trading --force ``` 技能与 MCP 配置会下载到你代理的技能目录。详情见 [ClawHub 安装](#-mcp-插件)。 --- ## 🧠 环境变量 复制 `agent/.env.example` 到 `agent/.env`，取消注释你需要的提供商块。每个提供商需 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） | | `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 目录的额外逗号分隔目录 | * Ollama 不需要 API key。 **免费数据（无需 key）：** A 股经 AKShare，港美股经 yfinance，加密经 OKX，100+ 加密交易所经 CCXT。系统会为每个市场自动选择最佳可用数据源。 ### 🎯 推荐模型 Vibe-Trading 是重度依赖工具调用的 agent — skills、回测、记忆、swarm 全部通过 tool call 完成。模型选择直接决定 agent 是**真的在用工具**，还是从训练数据里编答案。 | 等级 | 示例 | 适用场景 | |------|------|---------| | **最佳** | `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 或跑回测 | 默认 `agent/.env.example` 使用 `deepseek/deepseek-v3.2` — 性价比档里最便宜的选项。 --- ## 🖥 CLI 参考 ```bash vibe-trading # 交互式 TUI vibe-trading run -p "..." # 单次运行 vibe-trading serve # API 服务器 ```
TUI 内斜杠命令 | Command | Description | |---------|-------------| | `/help` | 显示全部命令 | | `/skills` | 列出 74 个金融技能 | | `/swarm` | 列出 29 个 swarm 团队预设 | | `/swarm run [vars_json]` | 以流式输出运行一个 swarm 团队 | | `/swarm list` | Swarm 运行历史 | | `/swarm show ` | Swarm 运行详情 | | `/swarm cancel ` | 取消运行中的 swarm | | `/list` | 最近的运行 | | `/show ` | 运行详情与指标 | | `/code ` | 生成的策略代码 | | `/pine ` | 导出指标代码（TradingView + TDX + MT5）| | `/trace ` | 完整执行回放 | | `/continue ` | 带新指令继续运行 | | `/sessions` | 列出聊天会话 | | `/settings` | 显示运行时配置 | | `/clear` | 清屏 | | `/quit` | 退出 |
单次运行与参数 ```bash vibe-trading run -p "Backtest BTC-USDT MACD strategy, last 30 days" vibe-trading run -p "Analyze AAPL momentum" --json vibe-trading run -f strategy.txt echo "Backtest 000001.SZ RSI" | vibe-trading run ``` ```bash vibe-trading -p "your prompt" vibe-trading --skills vibe-trading --swarm-presets vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}' vibe-trading --list vibe-trading --show vibe-trading --code vibe-trading --pine # 导出指标代码（TradingView + TDX + MT5） vibe-trading --trace vibe-trading --continue "refine the strategy" vibe-trading --upload report.pdf ```
--- ## 🌐 API 服务 ```bash 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` | 列出 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` | 更新本地数据源设置 | 交互式文档：`http://localhost:8899/docs` ### 安全默认值 本机开发时，`vibe-trading serve` 会尽量保持浏览器工作流简单。任何非本地客户端访问敏感 API 时都需要 `API_AUTH_KEY`；JSON/上传请求请使用 `Authorization: Bearer `。浏览器 EventSource 流由 Web UI 在 Settings 中保存同一个 key 后处理。 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` 添加专用目录。 ### Web UI 设置 Web UI Settings 页面允许本地用户更新 LLM provider/model、Base URL、生成参数、reasoning effort，以及 Tushare token 等可选市场数据凭据。设置会保存到 `agent/.env`；provider 默认值来自 `agent/src/providers/llm_providers.json`。 Settings 读取是无副作用的：`GET /settings/llm` 和 `GET /settings/data-sources` 不会创建 `agent/.env`，并且只返回项目相对路径。Settings 读取和写入可能暴露凭据状态或更新凭据/运行时环境，因此配置 `API_AUTH_KEY` 时必须携带认证；开发模式未配置 `API_AUTH_KEY` 时，仅允许 loopback 本地客户端访问。 --- ## 🔌 MCP 插件 Vibe-Trading 为任意 MCP 兼容客户端提供 22 个 MCP 工具。以 stdio 子进程运行——无需服务器部署。**22 个工具中有 21 个无需任何 API key**（港美股/加密）。仅 `run_swarm` 需要 LLM key。
Claude Desktop 添加到 `claude_desktop_config.json`： ```json { "mcpServers": { "vibe-trading": { "command": "vibe-trading-mcp" } } } ```
OpenClaw 添加到 `~/.openclaw/config.yaml`： ```yaml skills: - name: vibe-trading command: vibe-trading-mcp ```
Cursor / Windsurf / 其他 MCP 客户端 ```bash vibe-trading-mcp # stdio（默认） vibe-trading-mcp --transport sse # 供 Web 客户端的 SSE ```
**已暴露的 MCP 工具（22）：** `list_skills`, `load_skill`, `backtest`, `factor_analysis`, `analyze_options`, `pattern_recognition`, `get_market_data`, `web_search`, `read_url`, `read_document`, `read_file`, `write_file`, `analyze_trade_journal`, `extract_shadow_strategy`, `run_shadow_backtest`, `render_shadow_report`, `scan_shadow_signals`, `list_swarm_presets`, `run_swarm`, `get_swarm_status`, `get_run_result`, `list_runs`。
ClawHub 一键安装 ```bash npx clawhub@latest install vibe-trading --force ``` > 需要 `--force`，因为该技能引用外部 API，会触发 VirusTotal 自动扫描。代码完全开源，可自行审阅。 这会将技能与 MCP 配置下载到你的代理技能目录。无需克隆。 浏览 ClawHub： [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading)
OpenSpace — 自进化技能 全部 74 个金融技能已发布在 [open-space.cloud](https://open-space.cloud)，并通过 OpenSpace 的自进化引擎自动演进。 要在 OpenSpace 中使用，在代理配置中添加两个 MCP 服务器： ```json { "mcpServers": { "openspace": { "command": "openspace-mcp", "toolTimeout": 600, "env": { "OPENSPACE_HOST_SKILL_DIRS": "/path/to/vibe-trading/agent/src/skills", "OPENSPACE_WORKSPACE": "/path/to/OpenSpace" } }, "vibe-trading": { "command": "vibe-trading-mcp" } } } ``` OpenSpace 会自动发现全部 74 个技能，支持自动修复、自动改进与社区共享。在任意连接 OpenSpace 的代理中通过 `search_skills("finance backtest")` 搜索 Vibe-Trading 技能。
--- ## 📁 项目结构
展开查看 ``` Vibe-Trading/ ├── agent/ # 后端（Python） │ ├── cli.py # CLI 入口——交互式 TUI + 子命令 │ ├── api_server.py # FastAPI 服务器——运行、会话、上传、swarm、SSE │ ├── mcp_server.py # MCP 服务器——为 OpenClaw / Claude Desktop 提供 22 个工具 │ │ │ ├── src/ │ │ ├── agent/ # ReAct 代理核心 │ │ │ ├── loop.py # 5 层压缩 + 读写工具批处理 │ │ │ ├── context.py # 系统提示 + 持久记忆自动召回 │ │ │ ├── skills.py # 技能加载器（74 内置 + 用户 CRUD 创建） │ │ │ ├── tools.py # 工具基类 + 注册表 │ │ │ ├── memory.py # 单次运行轻量工作区状态 │ │ │ ├── frontmatter.py # 共享 YAML frontmatter 解析器 │ │ │ └── trace.py # 执行轨迹写入 │ │ │ │ │ ├── memory/ # 跨会话持久记忆 │ │ │ └── persistent.py # 基于文件的记忆（~/.vibe-trading/memory/） │ │ │ │ │ ├── tools/ # 27 个自动发现的代理工具 │ │ │ ├── backtest_tool.py # 运行回测 │ │ │ ├── remember_tool.py # 跨会话记忆（保存/召回/遗忘） │ │ │ ├── skill_writer_tool.py # 技能 CRUD（保存/修补/删除/文件） │ │ │ ├── session_search_tool.py # FTS5 跨会话搜索 │ │ │ ├── swarm_tool.py # 启动 swarm 团队 │ │ │ ├── web_search_tool.py # DuckDuckGo 搜索 │ │ │ └── ... # bash、文件 I/O、因子分析、期权等 │ │ │ │ │ ├── skills/ # 74 个金融技能（8 类，每个 SKILL.md） │ │ ├── swarm/ # Swarm DAG 执行引擎 │ │ │ └── presets/ # 29 个 swarm 预设 YAML 定义 │ │ ├── session/ # 多轮对话 + FTS5 会话搜索 │ │ └── providers/ # LLM 提供商抽象 │ │ │ └── backtest/ # 回测引擎 │ ├── engines/ # 7 个引擎 + 跨市场复合引擎 + options_portfolio │ ├── loaders/ # 6 个数据源：tushare、okx、yfinance、akshare、ccxt、futu │ │ ├── base.py # DataLoader Protocol │ │ └── registry.py # 注册表 + 自动回退链 │ └── optimizers/ # MVO、等波动、最大分散、风险平价 │ ├── frontend/ # Web UI（React 19 + Vite + TypeScript） │ └── src/ │ ├── pages/ # Home、Agent、RunDetail、Compare │ ├── components/ # chat、charts、layout │ └── stores/ # Zustand 状态管理 │ ├── Dockerfile # 多阶段构建 ├── docker-compose.yml # 一键部署 ├── pyproject.toml # 包配置 + CLI 入口 └── LICENSE # MIT ```
--- ## 🏛 生态 Vibe-Trading 属于 **[HKUDS](https://github.com/HKUDS)** 代理生态的一部分：
ClawTeam
代理 swarm 智能 		NanoBot
超轻量个人 AI 助手 		CLI-Anything
让所有软件都可被代理驱动 		OpenSpace
自进化 AI 代理技能
--- ## 🗺 路线图 > 我们分阶段发布。工作开始后会移至 [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** | 可复现实验卡片：工具轨迹、数据来源、假设与引用 | Planned | | **Community** | 可分享的 skills、presets 与 strategy cards | Exploring | --- ## 贡献指南 欢迎贡献！请参见 [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) 标签——挑一个开始吧。 想做更大的贡献？查看上方 [路线图](#-路线图)，开始前先开个 issue 讨论。 --- ## 贡献者 感谢所有为 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) — 协调安全研究、验证与披露支持 --- ## 免责声明 Vibe-Trading 仅用于研究、模拟与回测。它不是投资建议，也不会执行实盘交易。历史表现不代表未来结果。 ## 许可证 MIT 许可证——参见 [LICENSE](LICENSE) --- ## Star 历史 [![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 ✨

visitors