一文掌握 worldquant-miner 的 Web 仪表盘：实时监控与手动控制 24/7 Alpha 生成全流程

worldquant-miner是一个基于 WorldQuant API 的 Alpha 信号生成与挖掘工具集。其中最受欢迎的Naive-Ollama方案内置了一个Web 仪表盘：打开浏览器就能实时监控GPU、模型、调度器和 WorldQuant 连接状态，还能手动一键触发Alpha 生成、表达式挖掘与批量提交，让 24/7 自动挖矿流程尽在掌握。

一、这个仪表盘能做什么？

仪表盘的核心文件是 web_dashboard.py，它基于 Flask 运行在5000 端口，页面模板位于 templates/dashboard.html。它把 Alpha 生成全流程的"看"和"管"整合到一个页面里：

💡 项目架构：Web Dashboard（Flask）⇄ Ollama（本地大模型）⇄ WorldQuant API，由 alpha_orchestrator.py 统一调度，详见 generation_one/naive-ollama/README.md。

二、三步快速启动 Web 仪表盘

1️⃣ 准备 WorldQuant 账号凭证

在项目目录下创建credential.txt，格式为一行 JSON：

["your.email@worldquant.com", "your_password"]

2️⃣ 用 Docker Compose 一键拉起全家桶

GPU 版部署文件为 docker-compose.gpu.yml，其中已包含alpha-dashboard服务（挂载results/、logs/目录，暴露 5000 端口）：

cd generation_one/naive-ollama docker-compose -f docker-compose.gpu.yml up -d

Windows 用户也可以直接双击运行 start_dashboard.bat 或start_gpu.bat。

3️⃣ 打开浏览器

• 主仪表盘：http://localhost:5000
• Ollama WebUI：http://localhost:3000
• Ollama API：http://localhost:11434

三、四大状态卡片：一眼看清系统健康度

仪表盘顶部的Status Grid由四张状态卡片组成，每张卡片都有绿/红/黄/灰的指示点：

• GPU Status：调用nvidia-smi读取显卡名称、显存占用、利用率与温度；
• Ollama Status：探测localhost:11434是否在线，并列出已加载的模型；
• Orchestrator Status：读取调度容器日志，判断当前是active、error还是空闲，并显示下次挖掘时间（每 6 小时一次）与下次提交时间（每天 14:00，符合 WorldQuant 每日提交限制）；
• WorldQuant Status：实时向 WorldQuant Brain API 发起认证测试，确认凭证有效。

底部还有统计区：累计生成数、成功数、失败数、最近 24 小时产出，方便评估挖矿效率。

四、手动控制：一键触发生成、挖掘与提交

Manual Controls区域提供了最常用的四个按钮，背后对应 web_dashboard.py 中的三个 POST 接口：

典型工作流：

1. 先点Generate Alpha让本地大模型产出新想法；
2. 观察日志确认 Alpha 通过了 WorldQuant 测试；
3. 点Trigger Mining挖掘高潜表达式的变体；
4. 攒够成果后点Trigger Submission一次性提交。

五、实时日志：最近活动 + 双通道日志

页面下半部分有三个日志区：

• Recent Activity：时间线形式展示最近 10 条关键事件；
• Alpha Generator Logs：过滤出与alpha、prompt、worldquant、submission等关键词相关的日志，只看"挖矿"本身；
• All System Logs：完整的系统日志，用于排错。

日志优先来自 Docker 容器日志，读取失败时会自动回退到本地alpha_orchestrator.log文件，保证任何部署形态下都有内容可看。

六、仪表盘 API 速查表

所有面板功能都对应 REST 接口，方便你用脚本二次集成：

七、常见问题排查

❓ 仪表盘显示 GPU unknown？先确认宿主机驱动正常：nvidia-smi；再验证 Docker GPU 直通：docker run --rm --gpus all nvidia/cuda:11.6.2-base-ubuntu20.04 nvidia-smi。

❓ Ollama 状态显示 not_responding？查看容器日志docker logs naive-ollma-gpu，或用curl http://localhost:11434/api/tags测试 API 连通性。

❓ WorldQuant 认证失败（auth_failed）？检查credential.txt是否为合法 JSON 数组，并确认账号权限；显存吃紧时可减小环境变量BATCH_SIZE（默认 3）或换用更小的MODEL_NAME（如 llama2:7b）。

可调参数一览（环境变量）：OLLAMA_URL、MODEL_NAME、MINING_INTERVAL（默认 6 小时）、BATCH_SIZE（默认 3）。

总结

worldquant-miner 的 Web 仪表盘把24/7 Alpha 生成的"黑盒"变成了"玻璃盒"：📊 四张状态卡片实时监控硬件与链路健康，🎛️ 四个手动按钮随时接管生成、挖掘与提交，📜 双通道日志让每次产出都有迹可循。只需一条docker-compose命令，你就能在浏览器里完成从启动到提交的完整闭环——这正是它作为项目推荐方案的原因。

📁 延伸阅读：generation_one/naive-ollama/README.md（完整特性与部署文档）、generation_one/naive-ollama/README_Docker.md（Docker 深度指南）