第 1 章 · 01 它是什么与如何跑起来

第 1 章 · 01 它是什么与如何跑起来

本节摘要:第一次接触 Vibe-Trading,最容易把它误解成「自动赚钱机器人」。本节先破除这个误解——它是一个面向金融研究的自然语言工作台,你用一句话提出研究问题,项目把问题拆成数据读取、因子计算、策略生成、回测、报告等可运行步骤,核心价值是「让研究能跑、能复查、能沉淀」,而不是替你判断或托管资金。然后带你三步跑通它:安装、初始化、第一条研究提示,并打开本地 Web UI。读完本节,你会对 Vibe-Trading 的定位有准确认知,并亲手完成第一次研究运行。

内容来源:原项目中文入门教程(第 1 章)与英文文档 getting-started/vibe-trading-overview + getting-started/quick-start 合并改写。

学习目标

阅读完本节,你应当能够:

1. 准确说出 Vibe-Trading 的定位(自然语言金融研究工作台)与边界(不托管资金、不是投资建议、默认只读)。
2. 用一句话讲清它解决什么问题(让每个研究步骤可运行、可检查、可重复)。
3. 完成三步上手:安装、初始化、跑通第一条研究提示。
4. 打开本地 Web UI,知道它相比 CLI 多了什么(上传文件、流式进度、Settings、生成产物)。

一、Vibe-Trading 是什么

Vibe-Trading 可以先理解成一个**「交易研究工作台」**。你用自然语言提出问题,项目把问题拆成数据读取、因子计算、策略生成、回测、报告和账户连接等步骤。

它不是券商,也不托管资金;核心价值是让研究步骤能运行、能复查、能沉淀。

一句话提示,就这样在五步之间流转成一个可检查的研究产物。

核心能力

• 自然语言 CLI 与 Web 工作流:用一句话描述研究意图。
• 七大回测引擎:覆盖股票、加密、期货、外汇、组合资产、期权组合。
• 市场数据路由:Tushare、OKX、yfinance、AKShare、CCXT、Futu。
• 交易日志与影子账户(Shadow Account):做行为诊断。
• 多智能体团队预设(Swarm):委员会式研究评审。
• MCP 工具:接入 Claude Desktop、Cursor 等 MCP 客户端。

⚠️ 边界澄清:Vibe-Trading 为研究、模拟、回测与审计而建。任何实盘交易都是 opt-in 且默认只读——只在用户自己授权的券商(如 Robinhood Agentic Trading)内、在用户设定的限额内运行,可随时中止。它不持有资金、不运营交易场所、不提供投资建议。本教程所有内容均不构成投资建议。

二、为什么它的价值是「可复查」而非「替你判断」

很多人第一次用金融工具,期待的是「给我一个稳赚策略」。Vibe-Trading 不做这件事——它做的是另一件同样重要的事:让研究的每一步都能跑、能复查、能沉淀。

一次典型的 Vibe-Trading 研究运行,走的是这样一条流水线(详见第 2 章):

1. 规划(Plan):选择相关技能、工具、数据源、团队预设。
2. 落地(Ground):运行时拉取行情、文档、URL、券商日志或本地文件。
3. 执行(Execute):跑回测、因子分析、期权检查、导出、报告生成。
4. 验证(Validate):附上指标、基准对比、蒙特卡洛、Bootstrap、Walk-Forward、警告、run card。
5. 交付(Deliver):返回答案 + 可检查的产物(artifacts)。

💡 为什么 artifacts 痕迹重要:金融研究常常需要事后复查——三个月后你想知道「当时那个回测到底用了什么参数、跑了哪段时间」,如果没有留痕,就无从复盘。Vibe-Trading 把每个产物都沉淀下来,这正是「研究工作台」区别于「问答机器人」的地方。

三、三步上手

第 1 步:安装

pip install vibe-trading-ai
vibe-trading init
vibe-trading
​

vibe-trading init 会以交互方式引导你完成本地配置(模型、密钥、数据源等),详见第 4 章配置一节。

第 2 步:第一次研究运行

vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024, summarize return and drawdown, then export the report"
​

这条提示会:回测一个 BTC-USDT 的 20/50 均线策略(2024 年)、总结收益与回撤、导出报告。如果 agent 生成了 run dir,最终会调用 backtest 工具,校验 config.json 与 code/signal_engine.py,再运行回测。

💡 第一条命令的安全提示:上面的命令不连券商、不下单,只是用历史数据做模拟。初学阶段请始终从这种「纯研究」命令开始,等第 3 章再考虑账户连接。

第 3 步:打开本地 Web UI

vibe-trading serve --port 8899
​

本地 Web UI 适合你想要这些能力的时候:上传文件、流式查看 swarm 进度、Settings 配置、生成的产物集中管理。日常快速研究,CLI 通常够用。

四、配置要点(先有个概念,细节在第 4 章)

vibe-trading init 之后,你的本地会有一个环境配置文件(如 .env),关键项大致是:

LANGCHAIN_PROVIDER=deepseek          # 模型厂商
LANGCHAIN_MODEL_NAME=deepseek-v4-pro  # 模型名
TUSHARE_TOKEN=your-token              # A 股数据源 token(可选)
TIMEOUT_SECONDS=2400                  # 长研究的超时
​

几个要点先记住:

• 很多工作流不需要付费密钥:港股、美股、加密、文档、日志、静态分析等大量工作流,在没有付费行情 key 时也能跑;A 股基本面富化和某些厂商专属工作流才需要对应凭证。
• 模型选择影响工具调用质量:长研究、swarm、多步回测要优先选工具调用能力强的模型;在「编造答案代价高」的工作流里,避免用小蒸馏模型。
• 非本地部署要鉴权:若做 API 或 Web 部署,配置 API_AUTH_KEY,请求带 Authorization: Bearer <key>。

本节要点回顾

1. 定位:Vibe-Trading 是面向金融研究的自然语言工作台,不是券商、不托管资金、不是投资建议。
2. 核心价值:让研究步骤能运行、能复查、能沉淀——不替你判断,而是让每一步可验证。
3. 五步研究流水线:Plan(规划)→ Ground(落地数据)→ Execute(执行)→ Validate(验证)→ Deliver(交付产物)。
4. 三步上手:pip install vibe-trading-ai → vibe-trading init → vibe-trading run -p "..."。
5. Web UI:vibe-trading serve --port 8899,适合上传文件、看流式进度、管 Settings 与产物。
6. 配置:.env 管厂商/模型/密钥;大量工作流无需付费 key;长研究选工具调用强的模型。
7. 安全起点:第一条命令只做历史模拟,不连券商、不下单;实盘相关内容留到第 3 章。

⚠️ 再次强调:本节及整个教程不构成投资建议。任何真实交易应先经过你自己的判断、券商确认、模拟盘验证和风险控制。

下一节,我们将用一张「项目地图」讲清 Vibe-Trading 的六层结构(数据层/因子层/回测层/券商层/工具层/复盘层),让你看清一句话提示究竟在系统里如何流转。