内容
# 智胜 2026 🧠⚽
[](https://github.com/Phemassa/copamind-2026/actions/workflows/ci.yml)
[](https://www.python.org/)
[](https://github.com/astral-sh/ruff)
[](https://mypy-lang.org/)
[](LICENSE)
> **本地**且**开源**的体育智能平台：收集足球数据，训练本地预测模型，模拟2026年世界杯数千次，并通过聊天方式与RAG、MCP和多个本地LLM顺序执行 - 始终保持**透明度和可复制性**。
**注意：** 本项目与FIFA、国家队、联合会或组织者**无关**。概率是**实验性和教育性的**，不代表结果保证，也不鼓励投注。
---
## 资源
- 📊 **预测模型**：Elo、Poisson/Dixon-Coles、集成和等渗校准（Brier/Log-Loss/ECE）
- 🎲 **蒙特卡罗模拟**（按阶段和冠军的概率），可通过种子重复
- 🏆 **本地AI竞猜** - 约30个LM Studio模型预测淘汰赛的每场比赛；比分、获胜者、点球、概率和关键球员；模型优先的运行者，实时进度
- 📐 **FIFA v2分析** - 13个团队衍生指标（攻击、防御、守门员、控制、压迫、转换、波动性、冠军概况、爆冷风险等），通过快照防止数据泄露
- 📰 **上下文笔记** - 手动上下文笔记（伤病、轮换、战术）作为结构化证据注入提示；LLM自动新闻提取器
- 🔍 **RAG**，混合搜索（矢量+词汇）和防止提示注入保护
- 🤖 **本地LLM编排**（LM Studio/Ollama）：顺序、模型优先、重试和按阶段基准测试
- 🔌 **MCP** (`copamind-mcp`)：代理/IDE的只读和写入工具
- 🖥️ **静态门户** (`apps/portal/`)，包含预测摘要表、LLM排名、国家队/球员仪表盘和表格及比赛选项卡
- 🧾 **血统和可复制性**，每个结果（来源、快照、证据）
## 差异化
这不是一个“猜测”冠军的聊天机器人。概率来自**校准的ML模型**（Elo、Poisson、CatBoost、集成、蒙特卡罗）；LLM仅**解释、查询和解释**。每个回答记录了数据来源、计算模型、模型分歧和使用的快照。
查看完整计划，参见 [智胜_2026_总体计划.md](智胜_2026_总体计划.md)、待办事项列表 [TASKS.md](TASKS.md)、决策 [DECISIONS.md](DECISIONS.md) 和路线图 [ROADMAP.md](ROADMAP.md)。
## 演示
冠军机会 + 夺冠路径（蒙特卡罗模拟）：
AI竞猜（排行榜 + 校准曲线）：
## 架构
## 推荐硬件
- Windows 11（也可在Linux上运行），Docker Desktop，VS Code
- Python 3.12
- **8 GB VRAM**的NVIDIA GPU（RTX 5070 Laptop）- 已规划升级到**24 GB**的服务器（硬件配置文件）
- 32 GB RAM
- 本地LLM的LM Studio和/或Ollama
## 安装
### Windows（PowerShell）
```powershell
git clone https://github.com/Phemassa/copamind-2026.git
cd copamind-2026
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[data,dev]"
Copy-Item .env.example .env
```
### Linux / macOS（bash）
```bash
git clone https://github.com/Phemassa/copamind-2026.git
cd copamind-2026
python -m venv .venv
source .venv/bin/activate
pip install -e ".[data,dev]"
cp .env.example .env
```
## 快速使用
```bash
# 检查环境（Python、依赖项、配置、本地服务）
copamind doctor
# 通过Docker启动Qdrant（RAG）
docker compose -f docker/compose.yaml up -d
# 启动API
copamind api serve
# 健康检查：
curl http://127.0.0.1:8000/health
```
## 仪表盘
```bash
copamind ingest sample # 加载示例数据集
pip install -e ".[ui]" # 安装Streamlit/Plotly
copamind ui serve # 打开双语仪表盘（EN/PT-BR）
```
## 开发
```bash
pre-commit install # 质量检查钩子
ruff check . # 代码检查
ruff format . # 代码格式化
mypy # 类型检查
pytest # 测试 + 覆盖率
```
## 项目状态（2026年7月9日）
**当前阶段：四分之一决赛**（法国×摩洛哥 · 西班牙×比利时 · 挪威×英格兰 · 阿根廷×瑞士）。决赛：2026年7月19日。
核心功能已交付（160+测试）：数据/摄取（E1），用户报告（E2），Elo + 格式（E3a），Poisson/Dixon-Coles（E4），集成 + 校准（E3b），蒙特卡罗模拟（E4b），RAG（E5），MCP（E6），LLM编排 + 基准测试（E7），Streamlit仪表盘（E8a/E8b），静态门户（E9）和AI竞猜与模型优先运行者（E11）。已实施FIFA v2分析，包含13个指标，上下文笔记与LLM提取器，以及预测摘要表。查看 [TASKS.md](TASKS.md) 和 [ROADMAP.md](ROADMAP.md)。
## 宣传内容
```bash
copamind content ranking --locale pt-BR # 冠军机会卡片（Markdown）
copamind content match --home T-NTL --away T-SDR --locale en
```
## 真实数据（OpenFootball）
```bash
# 从 https://github.com/openfootball/worldcup.json 下载 worldcup.json
copamind ingest worldcup /path/to/worldcup.json
```
## 贡献与安全
- [CONTRIBUTING](.github/CONTRIBUTING.md) · [SECURITY](.github/SECURITY.md) · [MODEL_CARD](MODEL_CARD.md)
- 传统提交；**必须**保证质量（`ruff`、`mypy`、`pytest`）后方可提交PR。
## 许可证
[MIT](LICENSE)。
