主题
常见报错与解决方案
按场景速查。仍无法解决时，把完整报错原文（打码账号）发给 AI，并说明已安装 wq-alpha-agent。
一、安装相关
1. 复制后找不到 SKILL.md
原因：只复制了内层文件，或路径多/少了一层。
解决：确保最终路径是：
C:\Users\<你的用户名>\.agents\skills\wq-alpha-agent\SKILL.md资料包来源目录应为：01-Skill主体\wq-alpha-agent\（整个文件夹复制）。
2. Skill 装了但 AI 不按剧本回答
解决：
- 确认路径存在
~\.agents\skills\wq-alpha-agent\SKILL.md - 完全重启 Cursor
- 新开对话，首句写「使用 wq-alpha-agent skill」
- 避免在无关超大项目里被其他规则淹没
3. pip install -e . 失败
常见原因：Python < 3.10；权限；网络。
解决：
bash
python -m pip install -U pip
python -m pip install -e .必要时用管理员/虚拟环境：
bash
python -m venv .venv
# Windows
.venv\Scripts\activate
pip install -e .二、登录 / API
4. 认证失败 / 401 / 登录异常
- 检查邮箱密码是否为 BRAIN 账号
- 环境变量是否在当前终端生效
credential.txtJSON 格式是否为["email","password"]- 平台是否开启额外验证（需先在网页正常登录）
5. 429 Too Many Requests
- 降低频率，间隔 2～5 秒
- 读取
Retry-After，指数退避 - 批量不要高并发
三、模拟失败
6. simulation_error / 秒失败
高概率原因：字段名不存在、算子参数个数错、语法错。
解决：
- 先跑
rank(可疑字段)验证字段 - 用
wq-search-fields --search "关键词"查真实字段名 - 检查括号与
ts_rank(x, N)的 N
7. LOW_SHARPE（最常见）
- 换更强基本面字段（盈利/预期/现金流）
- 加
group_rank(..., subindustry) - 拉长窗口（如 126→252）
- 避免纯噪声量价
8. LOW_FITNESS
- 换手过高：提高 decay
- 用基本面与量价混合
- 使用
ts_decay_linear
9. HIGH_TURNOVER / LOW_TURNOVER
| 问题 | 处理 |
|---|---|
| TO 太高 | decay 10～30；trade_when；混合稳定信号 |
| TO 太低 | 缩短窗口；换更活跃字段 |
10. CONCENTRATED_WEIGHT
- 外层用
rank() - 降低 truncation（如 0.05）
ts_backfill处理稀疏
11. LOW_SUB_UNIVERSE_SHARPE
- 少用小市值偏置写法
- 多用基本面 + SUBINDUSTRY
- 避免明显依赖微盘流动性的信号
12. trade_when 零成交
- 条件过严，放宽或改用
if_else
四、提交相关
13. 返回 201 但不是 ACTIVE
这是正常坑：201 只表示请求接受。
必须轮询到 status == ACTIVE，或使用：
bash
wq-verify <alpha_id>14. SELF_CORRELATION 失败
- 与已有 ACTIVE 日收益相关过高（不要看累计 PnL 相关）
- 换信号族（盈利 → 现金流 → 另类/事件等）
- 不要只改窗口/权重指望降相关
- 冲突时保留 Fitness 更高的那只
15. 预检 check 不通过
按 IS 检查表逐项修（Skill 第 4 节）。未过线不要强行 auto_submit。
五、研究策略层
16. 为什么一直刷不过？
经验分布（Skill 内统计）：
- LOW_SHARPE ≈ 90%+ 失败主因
- 通过率大致：基本面 > 混合 > 纯技术
建议路径：先把 T1/T2/T3 跑通，再做变体与组合。
17. 相关总是很高？
同数据池（价量/基本面/分析师）里「长相不同」的表达式，日收益相关仍可能 0.5～0.8。
真分散要靠不同经济逻辑/数据源，而不是改个参数。
六、使用边界
18. 能不能保证过线 / 赚钱？
不能。本资料是研究方法与工具，不是收益承诺。
19. 要不要把账号密码发给他人？
不要。 安装与使用全程在你本机完成，无需把 BRAIN 账号交给任何人。
20. 虚拟资料可以退吗？
按购买须知，发货后一般不退不换。请确认你有 BRAIN 账号与基础电脑操作能力后再使用。