# caipiao

**Repository Path**: dot9527/caipiao

## Basic Information

- **Project Name**: caipiao
- **Description**: 个人编写的彩票软件，3D,双色球，大乐透，快乐8等。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-12-14
- **Last Updated**: 2025-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 摸球校尉彩票软件系统

[![Python Version](https://img.shields.io/badge/python-3.7+-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Status](https://img.shields.io/badge/status-stable-brightgreen.svg)]()

一个功能强大的彩票号码生成和分析系统，支持福彩3D、大乐透、双色球、快乐8等多种彩票类型的机选和筛选功能。

## ✨ 主要特性

- 🎯 **多彩票支持**：福彩3D、大乐透、双色球、快乐8
- 🎲 **智能机选**：纯随机机选和条件筛选机选
- 📊 **数据分析**：3D号码属性分析（和值、跨度、奇偶形态等）
- 🎁 **套餐功能**：大乐透88元套餐、双色球108元套餐
- 🔥 **热号机选**：快乐8支持结合热号机选
- ⚡ **高性能**：预计算优化，筛选速度提升10倍
- 🛡️ **类型安全**：完整的类型注解和错误处理
- 🎨 **用户友好**：直观的菜单界面和清晰的输出格式

## 🚀 快速开始

### 环境要求

- Python 3.7 或更高版本
- 无需额外依赖包

### 安装使用

1. **下载代码**
   ```bash
   git clone https://github.com/fgkr/3D.git
   cd lottery-system
   ```

2. **运行程序**
   ```bash
   python lottery_system.py
   ```

3. **开始使用**
   - 按照菜单提示选择彩票类型
   - 根据需求选择机选模式
   - 输入筛选条件（如需要）
   - 查看生成的号码结果

## 📋 功能详解

### 1. 福彩3D系统

#### 简单机选
- 生成1-100注随机3D号码
- 显示号码类型、和值、跨度等属性
- 支持批量生成

#### 条件筛选机选
- **奇偶形态**：全奇、全偶、2奇1偶、2偶1奇
- **和值范围**：0-27，支持单个值或范围输入
- **跨度条件**：0-9，支持多选
- **012路形态**：三位数字的路形态组合
- **容错机制**：允许0-4个条件不满足

**示例输入：**
```
奇偶形态: a,c (全奇,2奇1偶)
和值: 13-17,20
跨度: 3,4,5
012路形态: 011,021,001
容错: 0-1
```

### 2. 大乐透系统

#### 简单机选
- 生成1-100注大乐透号码
- 红球：1-35选5个
- 蓝球：1-12选2个
- 自动排序显示

#### 88元套餐
- **5+2组合**：5注单式
- **7+2组合**：1组复式，拆解为21注
- **6+3组合**：1组复式，拆解为18注
- **总计**：44注，88元

#### 固定号码机选
- 红球固定：7,8,10,15,16,24,27,30
- 蓝球固定：3,10
- 生成40注不重复号码
- 智能组合算法

### 3. 双色球系统

#### 简单机选
- 生成1-100注双色球号码
- 红球：1-33选6个
- 蓝球：1-16选1个
- 自动排序显示

#### 108元套餐
- **6+1单式**：5组，共5注
- **8+2复式**：1组，拆解为28注
- **7+3复式**：1组，拆解为21注
- **总计**：54注，108元

### 4. 快乐8系统

#### 纯机选
- 支持选5至选10
- 生成1-1000注号码
- 号码范围：1-80
- 自动排序显示

#### 结合热号机选
- 输入指定热号
- 自动补充随机号码
- 智能验证热号有效性
- 支持批量生成

## 🏗️ 系统架构

```
lottery_system/
├── lottery_system.py      # 主系统文件
├── lottery_utils.py       # 工具模块
├── lottery_config.py      # 配置文件
├── test_lottery_system.py # 测试文件
└── README.md             # 说明文档
```

### 核心模块

- **LotterySystem**: 主系统类，负责菜单和流程控制
- **NumberGenerator**: 号码生成器，支持所有彩票类型
- **ThreeDProperties**: 3D属性计算器，预计算优化
- **InputValidator**: 输入验证器，统一验证逻辑
- **Formatter**: 格式化工具，统一显示格式
- **CombinationGenerator**: 组合生成器，处理复式拆解

## ⚙️ 配置说明

系统使用 `lottery_config.py` 进行配置管理：

```python
# 3D配置
THREE_D_CONFIG = {
    'SUM_RANGE': (0, 27),      # 和值范围
    'SPAN_RANGE': (0, 9),      # 跨度范围
    'TOLERANCE_RANGE': (0, 4), # 容错范围
}

# 大乐透配置
DALETOU_CONFIG = {
    'RED_BALL_RANGE': (1, 35), # 红球范围
    'BLUE_BALL_RANGE': (1, 12), # 蓝球范围
}

# 通用配置
COMMON_CONFIG = {
    'MAX_TICKET_COUNT': 100,   # 最大注数
    'TICKET_PRICE': 2,         # 单注价格
}
```

## 🧪 测试

运行测试套件：

```bash
python test_lottery_system.py
```

测试覆盖：
- ✅ 号码生成器功能
- ✅ 3D属性计算器功能
- ✅ 输入验证器功能
- ✅ 格式化工具功能
- ✅ 配置常量功能

## 📊 性能优化

### 3D筛选优化
- **预计算**：启动时预计算所有1000个3D号码属性
- **缓存机制**：避免重复计算，直接使用缓存结果
- **性能提升**：筛选速度提升约10倍

### 算法优化
- **集合去重**：大乐透固定号码使用集合去重算法
- **防无限循环**：添加最大尝试次数限制
- **内存优化**：合理使用数据结构，减少内存占用

## 🛠️ 开发说明

### 代码规范
- **类型注解**：所有函数都有完整的类型注解
- **错误处理**：统一的异常处理机制
- **命名规范**：遵循Python命名约定
- **文档字符串**：所有公共函数都有详细文档

### 扩展开发
1. **添加新彩票类型**：
   - 在 `lottery_config.py` 中添加配置
   - 在 `NumberGenerator` 中添加生成方法
   - 在主系统中添加对应的系统类

2. **添加新功能**：
   - 在 `lottery_utils.py` 中添加工具函数
   - 在配置文件中添加相关配置
   - 更新测试文件

## 📝 使用示例

### 3D条件筛选示例

```
===== 福彩3D条件筛选机选 =====

请输入奇偶形态条件 (可多选，用逗号分隔):
a:全奇, b:全偶, c:2奇1偶, d:2偶1奇
输入: a,c

请输入和值条件 (0-27，可输入多个或范围，用逗号分隔，例如:13-17,20)
输入: 13-17,20

请输入跨度条件 (0-9，可输入多个，用逗号分隔)
输入: 3,4,5

请输入012路形态条件 (可输入多个，用逗号分隔，例如:011,021,001)
输入: 011,021

请输入允许错误的条件数量 (0-4，可输入范围，例如:0-1)
输入: 0-1

===== 筛选结果 =====
符合条件的3D号码共有 45 个
```

### 大乐透88元套餐示例

```
===== 大乐透88元套餐 =====

【1】5+2组合（共5组，每组1注）：
  第1组：红球    5, 12, 18, 25, 33  |  蓝球3, 8
  第2组：红球    7, 14, 21, 28, 35  |  蓝球2, 9
  ...

【2】7+2组合（1组，拆解为21注5+2）：
  红球    3, 8, 15, 22, 29, 31, 34  |  蓝球4, 11

【3】6+3组合（1组，拆解为18注5+2）：
  红球    6, 13, 20, 27, 30, 32     |  蓝球1, 5, 10

【套餐统计】
  5+2组合： 5注  |  7+2拆解：21注  |  6+3拆解：18注
  总注数：44注  |  单注金额：2元  |  套餐总金额：88元
```

## ⚠️ 免责声明

本软件仅供学习和娱乐使用，不构成任何投资建议。彩票中奖号码具有随机性，本软件无法保证任何号码一定会中奖。请理性购彩，量力而行。

## 📞 联系方式

- **作者**：摸球校尉陈八七
- **邮箱**：moqiuxiaowei@qq.com
- **QQ群**：253799100 摸金门
- **版本**：2.0.0
- **更新日期**：2025年09月

## 📄 许可证

本项目采用 MIT 许可证。详情请参阅 [LICENSE](LICENSE) 文件。

## 🙏 致谢

感谢所有为彩票系统开发做出贡献的开发者和用户。

---

**祝您好运！** 🍀