Python 环境与 API 自动化

用于批量模拟、提交校验、字段搜索、自进化。
账号密码只保存在你本机，切勿发给任何人或上传公开网盘。

---

1. 安装 Python

• 版本：3.10 或以上
• Windows：从 https://www.python.org/downloads/ 安装，勾选 Add Python to PATH
• 验证：

python --version
pip --version

---

2. 安装本框架

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

成功后可用命令：

命令	作用
wq-search-fields	搜索字段
wq-batch	批量模拟/提交编排
wq-evolve	从结果学习
wq-verify	校验提交状态

---

3. 配置 BRAIN 账号

方式 A：环境变量（推荐）

PowerShell（当前窗口有效）：

$env:WQ_BRAIN_USERNAME="your_email@example.com"
$env:WQ_BRAIN_PASSWORD="your_password"

永久用户级（可选）：

[System.Environment]::SetEnvironmentVariable("WQ_BRAIN_USERNAME","your_email@example.com","User")
[System.Environment]::SetEnvironmentVariable("WQ_BRAIN_PASSWORD","your_password","User")

方式 B：本地 credential.txt

在 01-Skill主体/wq-alpha-agent/ 下创建（该文件已被 .gitignore 忽略）：

["your_email@example.com", "your_password"]

安全规则：

• 不要提交到 Git
• 不要放进二次分享的压缩包
• 不要把含密码的截图发给任何人

---

4. 第一次试跑（必须 dry-run）

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

--dry-run 不会真实提交，用来确认配置与表达式格式。

准备好后再去掉 --dry-run。批量配置里默认 auto_submit: false，更安全。

---

5. 用资料包自带的 5 个模板配置

wq-batch --config ../../../03-因子模板/batch_configs/five_templates.json --dry-run --limit 5

（路径按你实际解压位置调整。）

---

6. 常用工作流

# 搜字段
wq-search-fields --search "operating_income" --category fundamental

# 从 BRAIN 拉字段缓存（首次较慢）
wq-search-fields --fetch-all --save references/my_fields.json

# 正式批量（确认配置后再跑）
wq-batch --config my_research_batch.json

# 学习沉淀
wq-evolve
wq-evolve --apply

# 校验是否 ACTIVE（201 ≠ 成功）
wq-verify <alpha_id>

---

7. 速率与风控建议

• 模拟/提交之间间隔 2～5 秒
• 遇到 429：按 Retry-After 退避
• 批量建议单线程或最多 2 并发
• 先保证 IS 指标过线，再开 auto_submit

更完整的剧本见：01-Skill主体/wq-alpha-agent/SKILL.md