安装总览（先看这个）

目标：10 分钟内让 Cursor / Claude Code 识别 wq-alpha-agent Skill，并能按剧本帮你写因子。

本资料为独家交付包，请使用资料包内文件安装，不要从其他渠道替换。

---

两条路线（二选一即可）

路线	适合谁	需要什么	能做什么
A. 只装 Skill（推荐新手）	只会聊天、不想碰命令行	Cursor 或 Claude Code	AI 按剧本设计表达式、诊断失败、给改写建议
B. Skill + Python 自动化	想批量模拟/提交	Python 3.10+ + BRAIN 账号	一键批量回测、提交校验、多样性检查

建议：先走 A，跑通后再装 B。

---

路线 A：5 步装好 Skill（Cursor）

1. 解压本资料包，找到 01-Skill主体/wq-alpha-agent/
2. 把整个 wq-alpha-agent 文件夹复制到：

C:\Users\<你的用户名>\.agents\skills\wq-alpha-agent\

确保该目录下有 SKILL.md。

3. 完全退出并重启 Cursor
4. 新开对话，发送：

用 wq-alpha-agent 帮我设计一个 USA TOP3000 delay=1 的基本面质量因子，并给出推荐设置

5. 若 AI 开始按「字段 → 表达式 → 模拟 → 检查」结构回答，说明安装成功

详细图文步骤见：01-Cursor安装Skill.md

---

路线 B：Python 自动化（可选）

cd 01-Skill主体/wq-alpha-agent
pip install -e .

配置账号（任选一种，不要发给任何人）：

# Windows PowerShell
$env:WQ_BRAIN_USERNAME="你的邮箱"
$env:WQ_BRAIN_PASSWORD="你的密码"

或在项目根目录创建本地文件 credential.txt（勿上传网盘二次分享）：

["你的邮箱", "你的密码"]

验证：

wq-batch --config examples/example_quality.json --dry-run --limit 1

详见：03-Python环境与API自动化.md

---

安装成功的标志

• [ ] SKILL.md 已在 skills 目录
• [ ] Cursor 重启后，提到 WorldQuant / Alpha 会按剧本回答
• [ ] （可选）wq-batch --dry-run 能跑通
• [ ] 从未把账号密码发给第三方

---

常见卡点

现象	去哪看
AI 不认 Skill	01-Cursor安装Skill.md 第 4 节
复制后没有 SKILL.md	确认复制的是整个 wq-alpha-agent 文件夹
pip / Python 报错	03-Python环境与API自动化.md
登录 BRAIN 失败	../04-常见报错与解决方案/FAQ.md