Vibe-Trading 使用教程
从入门到精通的完整指南
Vibe-Trading 简介
Vibe-Trading是一款开源的自然语言金融研究智能体，由香港大学HKUDS团队开发。它将自然语言提示连接到市场数据获取、策略回测、群体分析、交易日志诊断和可复现研究报告生成。支持股票、加密货币、期货、外汇等多种市场的七种回测引擎，内置投资委员会、量化分析、风险审查等多种预设研究团队。用户可以用自然语言描述研究问题，Vibe-Trading自动完成数据获取、策略构建、回测验证和报告生成的全流程。
详细功能介绍
【工具简介】Vibe-Trading是一款开源的自然语言金融研究智能体，用自然语言驱动市场数据、回测和研究分析全流程。
【核心功能】
①自然语言研究：用户用自然语言描述金融研究问题，系统自动路由到合适的数据源、工具和分析流程，生成结构化的研究报告。
②多市场回测引擎：提供七种回测引擎，覆盖股票、加密货币、期货、外汇、组合和期权市场，支持策略验证和历史模拟。
③Swarm群体分析：内置投资委员会、量化分析台、风险审查、宏观分析等多种预设研究团队，多智能体协作完成复杂研究任务。
④Shadow Account影子账户：解析券商交易日志，提取隐含交易规则，运行反事实回测，生成审计报告，帮助交易者复盘和优化策略。
⑤可复现研究产出：每次研究生成包含数据来源、方法论、指标和风险提示的完整研究卡片，确保结果可追溯和可复现。
【适用场景】
量化交易者需要快速验证交易策略假设时，可用自然语言描述策略并自动完成回测；金融研究者需要跨市场对比分析时，系统自动获取多市场数据并生成对比报告；个人交易者希望复盘和优化自己的交易记录时，通过Shadow Account功能分析历史交易中的隐含模式。
【快速入门】
①通过pip安装vibe-trading-ai包，运行vibe-trading init完成初始化配置。
②启动vibe-trading服务，通过命令行或Web界面输入研究问题。
③系统自动执行数据获取、策略构建、回测分析等步骤，生成研究卡片。
④查看研究报告，包含收益指标、风险数据、回撤分析和策略建议。
【优缺点分析】
优点：自然语言交互极大降低了量化研究的门槛，非编程背景用户也能使用；多市场多引擎覆盖全面，一个工具满足多种金融研究需求；开源且研究导向，不涉及资金托管和实际交易执行，安全性好。
缺点：实盘交易功能仅支持只读模式，无法直接执行交易；需要用户自行配置数据源和API密钥；金融研究结果仅供参考，模型可能存在过拟合风险。
【适合人群】
量化交易者和金融研究者，需要快速验证策略假设和进行市场分析；个人投资者，希望用AI辅助进行交易复盘和策略优化；金融科技开发者，需要在产品中集成自然语言金融研究能力。
1Vibe-Trading 入门教程：用自然语言做量化金融研究
入门10分钟
Vibe-Trading 是由香港大学 HKUDS 团队开发的开源自然语言金融研究智能体，用户可以用自然语言描述研究问题，系统自动完成数据获取、策略构建、回测验证和报告生成的全流程，支持股票、加密货币、期货、外汇等多种市场。
一、快速开始
1. 确保电脑已安装 Python 3.10 或更高版本，推荐使用 Conda 创建独立的虚拟环境。
2. 从 GitHub 克隆项目仓库：git clone https://github.com/HKUDS/Vibe-Trading.git
3. 进入项目目录，执行 pip install -r requirements.txt 安装所有依赖包。
4. 在项目根目录找到 .env.example 文件，复制为 .env，填入你的 API 密钥。需要的密钥包括 Alpha Vantage（免费获取）和 OpenAI 或其他 LLM 提供商的 API Key。
5. 执行 python main.py 启动 Web 界面，浏览器访问 http://localhost:7860 即可开始使用。
二、核心功能演示
功能1：自然语言策略描述
在输入框中用自然语言描述你想要研究的策略，例如「比较苹果和微软股票过去一年的表现，找出动量策略的最佳参数」。系统会理解你的意图，自动选择合适的数据源获取历史行情数据，构建动量策略的代码，并执行回测。整个过程无需编写任何代码。
功能2：多引擎回测验证
Vibe-Trading 内置七种回测引擎，覆盖不同的交易场景和精度需求。对于简单的策略验证，系统会自动选择轻量级引擎快速返回结果。对于需要精确模拟滑点、手续费和市场冲击的场景，会切换到高精度引擎。回测完成后自动生成收益曲线、最大回撤、夏普比率等关键指标的可视化图表。
功能3：投资委员会模拟
这是 Vibe-Trading 的独特功能。选择「投资委员会」模式后，系统会模拟多位不同风格的投资专家对你的策略进行评估，包括激进型分析师、保守型风控官、量化研究员等角色。每位专家从各自角度提出观点和建议，最终形成综合投资意见，帮助你全面审视策略的优缺点。
三、实际使用案例
案例1：股票策略回测
你想测试一个「当5日均线上穿20日均线时买入、下穿时卖出」的经典均线策略，应用于沪深300成分股。在输入框中描述这个策略和目标股票池，Vibe-Trading 会自动获取数据、编写策略代码、执行回测并生成详细报告，包含胜率、年化收益、最大回撤等核心指标，整个过程不到五分钟。
案例2：加密货币市场分析
你想了解比特币和以太坊在不同宏观环境下的表现差异。输入你的研究问题后，系统会获取两种加密货币的历史数据，结合宏观经济指标进行分析，生成包含相关性分析、波动率对比和情景模拟的综合报告，帮助你做出更理性的投资决策。
四、常见问题
Q1：需要很强的编程能力才能使用吗？
不需要。Vibe-Trading 的核心设计理念就是用自然语言替代编程。你只需要用日常语言描述你的研究问题或交易策略，系统会自动处理所有技术细节。当然，如果你有编程基础，可以直接查看和修改系统生成的策略代码，进行更精细的调整。
Q2：支持哪些市场的数据？
支持美股、A股、港股、加密货币、期货和外汇市场。数据来源包括 Alpha Vantage、Yahoo Finance、Binance 等多个数据提供商。不同市场的数据延迟和覆盖范围有所不同，美股和加密货币的数据最为完整。
Q3：回测结果可靠吗？
回测结果仅供参考，不能直接等同于实际交易表现。系统会尽量模拟真实的交易环境，但历史数据回测无法完全重现市场的真实流动性状况。建议将回测结果作为策略筛选的参考，而非投资决策的唯一依据。
五、小贴士
1. 描述策略时尽量具体，包括明确的买卖条件、持仓比例和止损规则，这样系统生成的策略代码更接近你的预期。
2. 首次使用时，先用简单的策略熟悉流程，再逐步增加复杂度。一上来就描述过于复杂的策略可能导致系统理解偏差。
3. 生成的报告支持导出为 PDF 和 HTML 格式，方便分享给团队成员或作为投资决策的文档记录。