# 体育彩票分析助手

🏆 智能体育彩票分析助手 - 基于数据分析和简单机器学习的比赛预测辅助工具

## 功能特点

- 📊 **数据收集**: 自动收集比赛基础数据、赔率、伤病信息
- 🎯 **智能预测**: 基于多维度特征的简单机器学习模型
- 💡 **辅助决策**: 提供风险评估和投注建议
- 📝 **可解释性**: 详细解释预测依据和各因素影响
- 🛡️ **风险控制**: 内置风险提示和资金管理建议

## 支持赛事

### 🏀 NBA
- 季后赛分析
- 主客场优势评估
- 四阶段预测
- 让分和大小球预测

### ⚽ 足球
- 欧洲五大联赛
- 世界杯赛事
- 欧亚指数分析
- 进球数预测

## 安装

### 依赖要求

```bash
Python 3.7+
numpy
```

### 安装步骤

1. 克隆或下载此 skill 到 OpenClaw skills 目录

2. 安装 Python 依赖

```bash
cd ~/.openclaw/workspace/skills/sports-betting-analyzer
pip install -r requirements.txt
```

3. 配置设置（可选）

编辑 `config/sports-betting.json` 根据需要调整参数

## 使用方法

### 分析比赛

```bash
# NBA比赛
python scripts/analyze.py NBA 湖人 勇士

# 足球比赛
python scripts/analyze.py football 巴萨 皇马

# 世界杯比赛
python scripts/analyze.py football 巴西 德国
```

### 获取今日推荐

```bash
# 所有运动
python scripts/analyze.py today

# 只看NBA
python scripts/analyze.py today NBA

# 只看足球
python scripts/analyze.py today football
```

### 查看历史记录

```bash
# 查看最近10条
python scripts/analyze.py history

# 查看最近20条
python scripts/analyze.py history 20
```

### 在OpenClaw中使用

```
分析 NBA 比赛 湖人 vs 勇士
分析足球比赛 巴萨 vs 皇马
NBA 今晚有什么值得投注的比赛
足球周末推荐
查看我的分析历史
```

## 输出示例

```
============================================================
📊 体育彩票分析报告
============================================================

🏆 NBA 比赛分析：湖人 vs 勇士

🎯 预测结果：湖人 胜
📊 置信度：72.5%
⚠️ 风险等级：中

💡 建议投注：2%

============================================================
📋 数据概览
============================================================

【主队】湖人
- 赛季胜率：62.5%
- 近5场：W L W W L
- 核心球员状态：active active

【客队】勇士
- 赛季胜率：55.0%
- 近5场：L W L W W
- 核心球员状态：active injured

【历史对战】
- 总场次：10
- 主队胜：6
- 客队胜：4
- 平局：0

============================================================
🎯 预测结果
============================================================

结果：team1
置信度：72.5%

概率分布：
  湖人: 72.5%
  勇士: 27.5%

============================================================
💡 投注建议
============================================================

建议：推荐投注
投注比例：2%
理由：价值投注机会，建议把握

风险等级：moderate
价值投注：是

============================================================
📊 因素分析
============================================================

【实力对比】（重要性：高）
  数值：+7.50%
  说明：基于赛季胜率、积分排名等综合实力评估

【主客场优势】（重要性：高）
  数值：+10.00%
  说明：主场球队通常有统计优势

【近期状态】（重要性：中）
  数值：+5.00%
  说明：基于最近5场比赛的表现

============================================================
⚠️ 免责声明
============================================================

⚠️ 重要提示：

1. 本分析仅供参考，不构成投注建议
2. 体育比赛存在不确定性，预测不保证准确
3. 请理性投注，控制风险，量力而行
4. 不要过度依赖单一分析工具
5. 请遵守当地法律法规

============================================================
```

## 预测方法论

### 数据维度

1. **实力对比**: 赛季胜率、积分排名、历史表现
2. **主客场优势**: 统计学上的主场优势系数
3. **近期状态**: 最近5-10场比赛的表现
4. **历史对战**: 两队历史交锋记录
5. **伤病影响**: 关键球员伤病情况

### 模型算法

- **基础模型**: 逻辑回归（简化版）
- **特征加权**: 多因素加权计算
- **概率转换**: Sigmoid函数转换为概率
- **集成预测**: 支持多模型集成（可选）
- **蒙特卡洛**: 支持模拟验证（可选）

### 风险评估

- **置信度**: 模型对预测结果的信心程度
- **风险等级**: low / moderate / high
- **价值投注**: 比较隐含概率与模型概率
- **投注比例**: 根据风险动态调整

## 配置说明

### config/sports-betting.json

```json
{
  "risk_level": "moderate",          // 风险偏好: conservative/moderate/aggressive
  "default_bet_percentage": 2,       // 默认投注比例(%)
  "preferred_leagues": [...],        // 优先关注的联赛
  "min_confidence": 0.6,            // 最低置信度阈值
  "max_daily_bets": 3,               // 每日最大投注数
  "model_settings": {
    "use_ensemble": false,           // 是否使用集成模型
    "use_monte_carlo": false         // 是否使用蒙特卡洛模拟
  }
}
```

## 重要提示

⚠️ **本工具仅提供辅助分析，不保证预测准确率**

- 体育比赛存在不确定性
- 建议结合自身判断
- 理性投注，控制风险
- 不要依赖单一工具决策
- 遵守当地法律法规

## 数据来源

**MVP版本**: 使用模拟数据

**后续版本计划**:
- NBA官方API
- 足球官方数据源
- 免费数据API
- 赔率聚合平台

## 未来规划

- [ ] 接入真实数据源
- [ ] 增强模型复杂度
- [ ] 添加更多赛事
- [ ] 实时赔率监控
- [ ] 历史准确率追踪
- [ ] 自动推送推荐
- [ ] 资金管理工具
- [ ] 社区分享功能

## 许可证

MIT License

## 免责声明

本工具仅供学习和娱乐使用，不构成任何投资或投注建议。使用本工具产生的任何后果，开发者不承担责任。请理性对待体育博彩，遵守当地法律法规。

---

**开发者**: 黄杨
**版本**: 1.0.0
**发布日期**: 2026-04-02