Vibe Trading

核心用法

Vibe-Trading 是一个面向专业量化研究者与交易员的综合金融分析工具包，通过 MCP 协议与 Claude、Cursor 等 AI 助手深度集成。核心工作流围绕四大模块展开：

1. Shadow Account 复盘闭环 —— 上传券商导出 CSV（同花顺/东财/富途/通用），系统自动完成交易行为画像 → 提取隐性交易规则 → 多市场回测验证 → 生成 HTML/PDF 复盘报告 → 扫描今日匹配信号，量化"如果当初严格执行规则"的潜在收益差（delta-PnL）。

2. 七引擎回测系统 —— 支持中国A股、全球权益、加密货币、中国期货、全球期货、外汇及期权七大市场，数据源覆盖 Tushare/yfinance/OKX/AKShare/CCXT/Futu，A股外数据均零 API 密钥可用。

3. Alpha Zoo（452预构建因子） —— 一键横截面 IC/IR 测试与存活/反转/失效分类，涵盖 Microsoft Qlib 的 Alpha158、Kakushadze 101公式化因子、国泰君安191短周期因子及 Fama-French+Carhart 学术因子，支持 LaTeX 公式元数据与 AST 纯净性校验。

4. 多智能体蜂群（29支专业团队） —— 从投资委员会多空辩论、全球权益 Desk 跨市场策略到加密货币交易 Desk 资金流分析，通过 run_swarm 调用内部 LLM 工作流完成复杂研究任务。

显著优点

• 零门槛启动：港股/美股/加密货币核心功能安装即用，无需任何 API 密钥
• 因子生产级验证：452个预构建 alpha 带 300 行前瞻哨兵测试，防止数据泄漏
• 跨市场统一抽象：同一套策略代码可无缝切换 A股/港股/美股/加密货币回测
• 交易行为科学化：Shadow Account 将主观交易经验转化为可量化验证的规则系统
• 生态开放：支持外接自定义 MCP 服务器，IBKR 官方 MCP 只读探针已集成

潜在局限

• A股数据依赖 Tushare：免费额度有限，高频研究需付费或降级至 AKShare 免费备选
• 蜂群模式消耗 LLM tokens：run_swarm 需 OpenAI 兼容密钥，复杂团队调用成本累积
• 实盘连接器处于早期：IBKR 需本地 TWS/Gateway，Robinhood MCP OAuth 尚未全面开放
• 期货/期权引擎成熟度：权益类回测工具链较完善，衍生品定价与回测功能相对基础
• 实时数据非主打：设计侧重研究复盘而非低延迟交易，行情刷新频率受限于源站

适合人群

• 量化研究员：快速验证 alpha 假设，跨市场因子对比
• 主观交易员：通过 Shadow Account 系统复盘，将直觉转化为可执行规则
• 资产管理机构：投资委员会多智能体模拟，生成可追溯的研究审计链
• 加密货币做市商：资金费率、清算热力图、稳定币流向等专业 Desk 工具
• 金融专业学生：77个内置技能涵盖技术分析、期权定价、行为金融学完整知识库

常规风险

• 回测过拟合：7引擎历史数据驱动，需在样本外与真实滑点环境中验证
• 因子失效：Alpha Zoo 分类中的"存活"标签基于历史 IC，不保证未来有效性
• 数据源质量：yfinance 等免费源存在拆分/分红调整误差，关键研究需交叉验证
• LLM 幻觉传导：蜂群团队输出需人工复核，重大投资决策不应仅依赖自动化结论
• 实盘执行差距：回测假设与券商成交、市场冲击存在固有偏差，Shadow Account 报告仅供研究

核心用法

Vibe-Trading 是一款面向量化研究者与专业交易者的 MCP 金融工具包，通过 35 个 MCP 工具提供完整的投研闭环。核心功能包括：

1. Shadow Account 旗舰闭环：上传券商交易记录 CSV，系统自动分析交易行为特征（持仓周期、处置效应、过度交易等），提取 3-5 条隐式交易规则，跨市场回测并生成 HTML/PDF 诊断报告，最终输出当日匹配信号。

2. 多引擎回测体系：支持 7 类回测引擎（A股/全球股票/加密货币/中国期货/全球期货/外汇/期权），对接 7 大数据源（yfinance、OKX、Tushare、AKShare 等），港股美股加密货币无需 API Key 即可使用。

3. Alpha Zoo 因子库：内置 452 个预置量化因子，覆盖 qlib158、alpha101、gtja191 四大因子体系，支持一键 IC/IR 截面分析、存活/反转/失效分类及跨期比较。

4. 多智能体研究团队：29 组预设智能体团队，包括投资决策委员会、全球股票交易台、加密货币交易台、宏观利率外汇台等，通过 run_swarm 调用 LLM 协作完成复杂研究任务。

5. 77 项金融技能库：涵盖技术分析（蜡烛图、波浪理论、一目均衡）、量化方法（机器学习策略、配对交易、多因子模型）、风险管理（VaR/CVaR、压力测试）、期权定价（Black-Scholes、希腊字母）及行为金融诊断。

显著优点

• 零门槛启动：港股美股加密货币核心功能无需任何 API Key，pip 安装后即可使用
• 多市场覆盖：A股/港股/美股/加密货币/期货/外汇六市场统一接口，自动识别标的类型
• 研究闭环完整：从数据获取→因子分析→策略回测→交易诊断→智能体协作的全链条覆盖
• 452 预置因子：开源合规（Apache-2.0/MIT/学术公开），含 AST 纯净度检测与前瞻数据防护
• Shadow Account 创新：将主观交易记录转化为可量化、可回测、可优化的规则系统
• 文档型安全设计：纯 Markdown 技能（T-MD），无本地可执行代码，功能通过 MCP 工具暴露

潜在缺点与局限性

• A股数据门槛：Tushare Token 为必需，免费额度有限；AKShare 为备用但稳定性存疑
• 多智能体依赖 LLM：run_swarm 需 OpenAI 兼容 API Key，增加使用成本与延迟
• T3 来源风险：个人开发者维护（warren618），非知名机构背书，长期维护可持续性待观察
• 供应链依赖：依赖 PyPI 包 vibe-trading-ai 及 uvx 工具链，存在潜在供应链攻击面
• MCP 外部命令执行：通过 MCP 启动 vibe-trading-mcp 进程，需信任外部代码
• 实盘交易限制：IBKR 等连接器需本地 TWS/Gateway，且写操作需显式工具白名单

适合的目标群体

• 量化研究员：需要快速验证因子有效性、进行多引擎回测的从业者
• 主观交易者：希望通过 Shadow Account 将经验规则化、系统化改进的投资者
• 多资产管理者：覆盖 A/HK/US/加密货币的跨市场投资组合管理者
• 金融教育学习者：通过 77 项技能库学习技术分析、风险管理、期权定价的师生
• 智能体开发者：需要集成金融 MCP 工具构建自动化投研工作流的 Agent 开发者

使用风险

• 性能风险：回测引擎为向量化实现，大规模多因子场景可能内存占用较高；建议分批次运行
• 数据质量风险：免费数据源（yfinance、OKX）存在延迟或停服可能，关键决策需交叉验证
• 配置覆盖风险：write_file 工具可能意外覆盖现有策略文件，建议限定工作目录并备份
• MCP 会话注入风险：虽默认禁用 ALLOW_SESSION_MCP_SERVERS，若手动开启则需防范恶意配置注入
• OAuth 凭据泄露风险：交易连接器配置存储于本地 ~/.vibe-trading/live/，需做好文件权限管理
• 因子误用风险：452 预置因子含历史学术研究因子，部分在现代市场可能失效，需结合 IC/IR 分析谨慎使用