WQBuddy

你的 WorldQuant BRAIN Alpha 挖掘伙伴（新手版）

WQBuddy 让 AI 成为你挖 Alpha 的搭档——不只是执行回测，而是陪你从模糊想法出发，探索数据、构建表达式、分析结果、优化迭代，直到提交一个经得起检验的 Alpha。不会用代码没关系，记不住运算符也没关系。只需要把skill丢给你的AI伙伴，让他陪你一起成为顾问！

它能做什么

• 🔍 字段搜索 — 关键词搜索 BRAIN 平台数据字段
• 🔬 字段分析 — 6种标准测试摸清数据底细
• 📊 回测验证 — 单条/批量回测，支持 1-3 并发
• 📈 统计分析 — Sharpe/Turnover等5指标分布一目了然
• 📁 导出数据 — Alpha 和字段分析结果导出 CSV
• 🔗 相关性查询 — 自动/手动获取生产相关性数据
• ✅ 提交前检查 — checkSubmission确认所有检查项PASS
• 📝 Alpha提交 — 确认后提交到BRAIN平台（单条）
• 📋 Alpha列表 — 查询平台已有Alpha
• 👤 用户信息 — 查看当前登录账号信息
• 🎯 提交管理 — 5状态流转，闭环追踪
• 🔧 运算符API — 从平台获取完整运算符列表（7大类66个）
• 📚 数据集浏览 — 浏览平台数据集，发现冷门高价值数据
• 🏆 竞赛进度 — 查看竞赛排名、等级和升级进度
• 🤖 Agent 模式 — 作为 OpenClaw 专业 Agent 运行，携带完整领域知识

快速开始

# 方式一：npm安装（推荐）
npm install -g wq-buddy

# 创建配置
cp config.example.json ~/.wq-buddy/config.json   # 填入BRAIN账号密码

# CLI使用
wq backtest "rank(close)"                    # 单条回测
wq backtest "e1" "e2" "e3" --concurrency 3   # 批量并发
wq search "operating cash flow"              # 搜索字段
wq analyze fnd2_ebitdm                       # 字段分析
wq stats                                     # 查看统计
wq export                                    # 导出CSV
wq docs                                      # 运算符文档

# 方式二：从源码
git clone https://github.com/sebrinass/wq-buddy.git
cd wq-buddy
npm install && npm run build

前提：Node.js >= 18

Agent 模式

WQBuddy 可作为 OpenClaw 的专业 Agent 运行（Alpha Miner），携带完整的领域知识：

• 🧠 独立知识库 — 字段分析、策略模式、优化诊断、平台资源四大知识域
• 🔒 安全红线 — 15 条硬规则保护凭据和操作安全
• 📝 经验积累 — 每次回测经验沉淀到 MEMORY.md，越用越懂你
• 🔄 完整闭环 — 从字段勘探到提交追踪，6 阶段 15 工具全覆盖
• 🤝 子 Agent 分工 — 批量回测自动 spawn 子 Agent，不卡主会话

安装方式见 SKILL.md

命令速查

| 命令 | 说明 | |------|------| | wq backtest "expr" | 单条回测 | | wq backtest "e1" "e2" "e3" -c 3 | 批量回测，3并发 | | wq backtest --file ./exprs.txt | 从文件批量回测 | | wq search "关键词" | 搜索字段 | | wq search --dataset pv13 | 浏览数据集 | | wq analyze 字段名 | 字段分析 | | wq stats | 查看统计 | | wq export | 导出Alpha CSV | | wq export field | 导出字段分析CSV | | wq docs | 运算符文档 | | npm run build | 编译 |

文档

Agent 文档体系在 agent/ 目录：

许可

MIT