| name | qa-stockai |
| description | Full QA sweep before pushing StockAI code. Run this after making changes — checks all 8 pages, API endpoints, charts, and common failure modes. |
QA StockAI
Push 前全站检查。覆盖 8 个页面、9 个 API、Canvas 图表、AI 对抗。每项只检查最常见的故障模式。
运行 QA
cd stocks
curl -s http://localhost:3000/api/health || (
cd backend && python -m uvicorn main:app --host 0.0.0.0 --port 3000 &
sleep 3
)
python .Codex/skills/run-stockai/driver.py
python -m pytest tests/ -q
手动检查清单
每一项在浏览器打开，确认没有 "加载中…" 卡住。
1. 量化页 (quant.html)
打开: http://localhost:3000/quant.html
检查:
[ ] 个股透视区: 输 600519 点查看 → K线图清晰(不模糊) → 成交量柱可见
[ ] 悬浮 K线: 显示 开/高/低/收 + 涨跌幅
[ ] 悬浮成交量: 显示 日期 + 手数(如 7.65万手)
[ ] 指标面板: MA/MACD/KDJ/RSI 有数值不是 "--"
[ ] 因子行: PE/ROE/市值/行业 有数据
[ ] 风控 KPI: 没持仓时显示"无持仓数据"，不是 "--"
[ ] 相关性: 没持仓时显示"暂无数据"，不是"加载中…"
2. 持仓页 (index.html)
[ ] 页面加载完成，不卡在骨架屏
[ ] 没持仓时显示空状态引导，不报错
3. 大盘页 (market.html)
[ ] 15 个指数卡片全部渲染
[ ] 至少 7 个有实时价格(不含台湾/韩国/印度/新加坡)
[ ] 30 秒自动刷新不报错
4. 设置页 (settings.html)
[ ] 6 个 AI 供应商配置区全部渲染
[ ] MiniMax / DeepSeek / Codex / OpenAI / 小米 / 自定义
[ ] 填 Key → 保存 → 刷新 → Key 仍然在(脱敏)
5. AI 复盘 (review.html)
[ ] 页面加载，没持仓时显示"数据不足"而非白屏
6. 自选股 (watchlist.html)
[ ] 空列表时显示空状态
7. 交易记录 (transactions.html)
[ ] 空列表时显示空状态
8. AI 对话 (ai-assistant.html)
[ ] 对话界面加载
常见失败及修复
| 症状 | 修复 |
|---|
| Canvas 模糊 | CSS width:100% 和 HTML width="900" 不匹配 → 用 setupCanvas DPI 缩放 |
| Tooltip 在页面顶部 | 父元素缺 position:relative |
| "加载中…" 永远不消失 | 检查 init() 函数的 error 分支是否更新了该 UI 区域 |
| 成交量柱一片空白 | ETF 正常；个股 → 重启服务清缓存 |
| 三个 AI 选同一只 | 正常——人设随机分配，有时会撞。下次开局会换 |
