# 🎱 彩票智能分析技能 (Lottery Picker)

基于 **6阶段数学建模分析系统** 的双色球 & 大乐透智能号码分析与机选推荐工具。

## 特性

- **集成学习模型**: 5种分析模型（频率加权、贝叶斯平滑、马尔可夫链、K-Means聚类、残差回归）自动优化权重
- **多数据源**: 支持 500.com、17500.cn、体彩官方API 等多个数据源
- **回滚迭代**: 自动追踪推荐准确率，版本化管理模型优化
- **结构化输出**: 4块报告格式（回滚迭代、数据采集、推理分析、机选号码）

## 支持彩种

| 彩种 | 前区 | 后区 | 开奖时间 |
|------|------|------|----------|
| 双色球 | 6个 (1-33) | 1个 (1-16) | 周二/四/日 21:15 |
| 大乐透 | 5个 (1-35) | 2个 (1-12) | 周一/三/六 20:25 |

## 安装

### 依赖

```bash
pip install requests
```

### 部署到 QwenPaw

```bash
# 克隆仓库
git clone https://git.qihuyun.com/your-username/lottery-picker.git

# 复制到 skills 目录
cp -r lottery-picker/lottery_picker /path/to/qwenpaw/skills/

# 重启 QwenPaw 服务
```

### 部署到其他 AI Agent 平台

将 `lottery_picker/` 目录复制到你的 Agent skills 目录，确保 `SKILL.md` 在正确位置。

## 使用方法

### CLI 命令

```bash
cd lottery_picker

# 完整报告（推荐）
python lottery_tool.py --action full_report --lottery dlt --count 5

# 仅推荐号码
python lottery_tool.py --action recommend --lottery ssq --count 3

# 仅分析报告
python lottery_tool.py --action analyze --lottery dlt

# 采集数据
python lottery_tool.py --action fetch --lottery dlt

# 回滚校验（开奖后）
python lottery_tool.py --action check --lottery dlt --earnings 0
```

### 参数说明

| 参数 | 值 | 说明 |
|------|-----|------|
| `--action` | full_report | 4块结构化输出（推荐） |
| `--action` | recommend | 仅输出推荐号码 |
| `--action` | analyze | 仅输出分析报告 |
| `--action` | fetch | 仅采集数据 |
| `--action` | check | 回滚迭代 |
| `--lottery` | ssq / dlt | 彩种 |
| `--count` | 5 | 推荐组数 |
| `--earnings` | 0.0 | 中奖收益（check专用） |

## 输出示例

```
============================================================
  [4/4] 机选号码（第26079期 | 2026-07-15 (周三)）
============================================================

  第1组: 前区 06 13 19 22 29  +  后区 06 08
       得分:5.7689 | 奇偶:3:2 | 大小:3:2 | 和:89

  第2组: 前区 08 13 14 22 30  +  后区 02 06
       得分:5.4209 | 奇偶:1:4 | 大小:2:3 | 和:87
```

## 文件结构

```
lottery_picker/
├── SKILL.md                 # Agent 技能定义
├── README.md                # 本文件
├── __init__.py              # Python 包初始化
├── lottery_tool.py          # 主工具（CLI 入口）
├── ensemble_learning.py     # 集成学习模型
├── evolution_tool.py        # 回滚迭代跟踪
├── enhanced_lottery.py      # 增强数据采集
├── blueball_optimizer.py    # 后区优化器
└── data/                    # 数据持久化目录
    ├── config.json          # 配置（种子、迭代计数）
    ├── feedback.json        # 回滚反馈（含收益）
    ├── ssq_history.json     # 双色球历史数据（自动填充）
    ├── dlt_history.json     # 大乐透历史数据（自动填充）
    ├── analysis_ssq.json    # 双色球分析结果（自动填充）
    └── analysis_dlt.json    # 大乐透分析结果（自动填充）
```

## 分析模型

### 集成学习权重

| 模型 | 描述 | 默认权重 |
|------|------|----------|
| 频率加权 | 基于历史出现频率 | 19.0% |
| 贝叶斯平滑 | 贝叶斯后验概率 | 19.0% |
| 马尔可夫链 | 状态转移概率 | 23.8% |
| K-Means聚类 | 号码聚类分析 | 19.0% |
| 残差回归 | 残差趋势预测 | 19.0% |

权重通过历史数据回测自动优化。

## 回滚迭代

系统会自动追踪每期推荐的准确率：

```bash
# 开奖后执行回滚校验
python lottery_tool.py --action check --lottery dlt --earnings 0
```

- 版本号在数据源变化时递增
- 累计精度 = 命中号码数 / 总推荐号码数
- 用户中奖后通过 `--earnings` 参数记录收益

## 数据源

| 彩种 | 主数据源 | 备用数据源 |
|------|---------|-----------|
| 双色球 | 500.com HTML | 17500.cn API |
| 大乐透 | 500.com HTML | 体彩官方API |

## 免责声明

⚠️ **本工具仅基于统计学分析提供号码推荐，不构成任何中奖承诺。**

彩票开奖结果具有完全随机性，历史数据无法预测未来。请理性购彩，量力而行。

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！