Vibe-Trading：港大 HKUDS 那个 10k 星的「AI 投研实习生」，把回测这件事变成说人话

发表于 分类于 ， ，
港大 HKUDS 开源的金融研究 Agent，77 个金融 Skill + 7 大回测引擎 + 29 个投研团队预设，一句话跑回测、跑多 Agent 评审，默认不替你下单。

打开 GitHub Trending，一眼就看到了 HKUDS/Vibe-Trading—— 单日涨 197 颗星，总星 10.8k，背后是港大数据智能实验室（就是做 Open-LLM-VTuber、ChatDev 那个组）。

我之所以点进去看，是因为它写的不是又一个 LLM 聊天框，而是一句让我心动的承诺：

“One Command to Empower Your Agent with Comprehensive Trading Capabilities”

更让我安心的是它官网顶上红底白字写的两行：

No live trading. Vibe-Trading is for research, simulation, and backtesting.

翻译成人话：这是个投研工具，不替你下单。这事儿就有意思了 —— 不是又一个鼓吹”AI 帮你炒币” 的项目，是个真正想帮普通人做严肃投研的东西。

Vibe-Trading 工作流

一、它到底解决什么问题

我自己平时也折腾点小投资，但每次想做点正经研究就头大：

  • 想验证一个简单的双均线策略，得先装 pandas、装 backtrader、装 ta-lib，找数据源、写回测代码、调参数、看结果 —— 一上午过去了
  • 想看看”2024 年 BTC 的 20/50 均线策略到底赚没赚钱”，要么自己写 SQL 拉数据，要么用某平台的图形界面但被限制只能选预设
  • 想做个多角度的评估（比如同时看宏观 + 资金流向 + 技术面），得切三四个工具手动拼

Vibe-Trading 干的就是把这一堆动作塞回一句话里。你写一句中文 / 英文，剩下全交给 Agent。

比如它官网那个最直观的 demo：

1
2
3
4
$ vibe-trading run -p "Backtest BTC-USDT 20/50 MA for 2024"

route: crypto data -> strategy -> backtest -> run card
return +18.6%   max drawdown -7.4%

一行命令，连” 数据从哪来、用什么框架跑、报告写在哪” 都帮你想好了。

二、它和普通回测框架的差别

光看” 回测” 两个字，会以为它又是一个 backtrader、zipline、vectorbt 的竞品。其实不是。它的定位是 “投研 Agent”，回测只是其中一个工具。

我用一张表来分一下：

维度 backtrader / vectorbt Vibe-Trading
入口 Python 库，得写代码 自然语言 + Python 双入口
数据源 自己接 Tushare /yfinance 内置 7 个数据源的路由，自动 fallback
策略生成 手动写 LLM 帮你起草 + 预校验
回测引擎 单一 7 个引擎：股票、加密、期货、外汇、组合、期权
多视角评审 自己拉人讨论 29 个预设投研团队（投委会、量化、加密、风控…）
交易日志复盘 自己写 parser Shadow Account—— 把券商流水解析成可审计报告
真实下单 库自己不管 可选 Opt-in（Robinhood / IBKR / 富途 / OKX…），默认关

最让我眼前一亮的是 77 个金融 Skill 和 29 个 Swarm Team。它把” 投资研究” 这件事模块化了 —— 每个 Skill 是一个独立能力（数据路由、策略模板、因子研究、宏观分析…），每个 Swarm Team 是一个预设的多 Agent 协作流（” 投委会” 就是宏观 Agent + 量化 Agent + 风险 Agent + 催化剂 Agent 一起干）。

举个例子，你想做” 美股科技股财报季研究”，直接：

1
vibe-trading --swarm-run earnings_research_desk

四个 Agent 自动开干，输出一份带证据、指标、保留意见的报告，全程可追溯。

三、装起来有多简单

我是用 uv 装的（这个博客之前专门写过 uv vs pip），一行命令搞定：

1
2
3
uv tool install vibe-trading-ai
vibe-trading init
vibe-trading

它会启动一个 TUI 或者 Web UI（看你选哪种），我选了 Web——vibe-trading serve --port 8899 然后浏览器开 localhost:8899。

注意：它要 Python 3.11+。如果你系统 Python 是 3.10，别挣扎，直接上 uv：

1
2
uv python install 3.11
uv tool install --python 3.11 vibe-trading-ai

四、4 个让我觉得” 这帮人懂投研” 的设计

4.1 跑不出结果时，Agent 不会闷头烧 token

vibe-trading 的 Agent loop 有个我特别欣赏的设计 —— 跑到 80% 预算就收尾，最后一轮把工具定义直接丢开，强制 LLM 给出文字总结。

这意味着你永远不会看到一个 Agent 跑了 50 步最后 failed 啥也没说。它要么中间给你可读的中间结果，要么最后一刻给你一段” 我走到哪、卡在哪、还差什么” 的诚实复盘。

我在 Hermes Agent 里实现过类似机制，深知这种” 显式截断 + 强制落地” 是多反直觉但多好用的设计。

4.2 “Shadow Account”—— 把券商流水变成可审计报告

这一条对散户特别有用。

它能解析你的券商（老虎、富途、Robinhood、IBKR…）导出的交易流水，提取你实际的下单行为规则（比如” 你每次亏损超过 5% 就割肉”、” 你周五尾盘总是减仓”），然后用历史数据做反事实回测 —— 告诉你” 如果你当时没割肉，半年后是赚是赔”。

这东西要是做实了，对交易行为矫正比任何” 投资心理学” 课程都直接。

4.3 Alpha Zoo——452 个预置因子的” 擂台”

它内置了一个 Alpha Zoo，452 个经典量化因子（动量、反转、价值、质量…），一行命令跑 IC 评估：

1
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

这等于白嫖一个国泰君安 191 因子库的在线版，不需要自己下数据、自己写回测、自己算 IC。

更狠的是 alpha compare—— 挑几个因子让它们 PK，按 IC、IR、胜率排名。这对因子选股的初学者极其友好。

4.4 Live trading 是” 可选项，且默认关”

这点我必须单独夸。

整个 README 翻一遍，live trading 的描述永远是 “opt-in”, “bounded autonomy”, “read-only by default”, “instant kill switch”。它有完整的审计日志、文件级紧急熔断、用户授权的 mandate（品种 / 仓位 / 杠杆 / 日内上限都你定）、自动到期。

它甚至在 6 月 2 日加了 6 个新券商连接器（老虎 / Longbridge/Alpaca/OKX/Binance/ 富途）后，特意注明 Longbridge 只支持模拟 + 只读 —— 因为 API 没法区分用户当前是 paper 还是 live mode，它宁可不做，也不替你冒险。

这种” 知道自己边界” 的态度，是现在 AI Agent 领域稀缺的品质。

五、它跟”AI 帮你炒股” 类项目的本质区别

我必须把这块单独拎出来说。

过去一年我见过太多”AI Trader” 项目：包装一个 LLM + 一个交易所 API = “AI 帮你炒币”。

Vibe-Trading 反着来：

  1. 它不替你做决策 —— 所有投资判断你写
  2. 它不替你下单 —— 默认关
  3. 它干的是研究员 / 分析师 / 数据工程师的活 —— 把数据拿来、把回测跑起来、把报告写好、把你券商流水解析清楚
  4. 它的价值在” 过程可审计”—— 每个结论都带数据源、回测 ID、保留意见
  5. 它的风险在” 用户自己”—— 开了 live trading 模式，所有责任在你

这不是”AI 炒股”，这是” 给普通投资者配了一个免费的卖方研究团队 “。

后者才是真正能改变散户命运的东西。

六、它适合谁

  • 个人投资者：想自己跑策略但不会写代码（或者懒得每次都写）
  • 量化爱好者：想要一个开箱即用的因子库 + 回测环境
  • 小机构 / 独立 trader：需要一个合规、可审计的研究工作台
  • AI Agent 学习者：想看一个生产级的多 Agent 投研系统怎么搭的（Swarm DAG、Kill Switch、Audit Ledger 都是好教材）
  • 不想被券商”AI 工具” 割韭菜的人：想自己掌握研究流程

不适合：

  • 指望它替你赚钱的（它不做这事）
  • 想要一键躺赚的（醒醒）
  • 不想读英文文档的（README 90% 是英文，社区 Discord 也偏英文）

七、一些要提醒的坑

用了两天，列几个实测踩到的注意事项：

  1. Gemini 2.5/3.0 的 thoughtSignature 还在标 help wanted—— 你用 Gemini 做底座时会丢一些推理痕迹，目前不影响结果但会有 warning
  2. macOS 之外的系统，broker 的 keychain 集成还不算完全验证（Windows/Linux/Docker 都有警告）——CI 环境里老老实实传 GITHUB_COPILOT_TOKEN 之类显式 token
  3. 它的 CLI/UI/MCP 三个入口共用同一份 session—— 别在 CLI 里跑到一半去 Web 端改同一个 goal，会有 race condition（这其实是 GitHub issue 里也有人报的）
  4. 港股和 A 股数据源走的是通达信协议（mootdx），无 token 无 IP 速率限制，但仅限中国大陆 IP 段，海外会连不上 —— 海外用户老老实实用 yfinance 或 CCXT
  5. 券商连接器 6 月 2 日刚加，文档说”Experimental”—— 别拿真钱跑，先 paper

八、写在最后

我写代码、做产品、也炒过币。每次进一个新市场都要重新研究当地的税务、券商、行情软件 —— 这套流程痛苦得让人想吐。

Vibe-Trading 给我的感觉是：第一次有一个开源工具，把” 投研” 和” 交易” 这两件事切得很干净。前者它做透，后者它不碰。

如果你和我一样，是那种” 想自己搞懂市场再下场” 的人 —— 而不是” 听个消息就梭哈” 的人 —— 它值得你花一个下午试试。

装个 1 分钟，跑个 demo 3 分钟，再花 30 分钟读它的 Swarm 架构文档 —— 你会对”AI Agent 在严肃领域怎么落地” 这件事有更具体的体感。

项目地址：github.com/HKUDS/Vibe-Trading
官网：vibetrading.wiki
文档：vibetrading.wiki/docs

免责声明：本文不是投资建议。Vibe-Trading 本身也不提供投资建议。量化投资有风险，过去回测业绩不代表未来表现。亏了别找我。