3D/P3藏书阁 v3.0 - 功能说明文档

📑 目录

1. 核心功能模块
2. 数据管理功能
3. 查询分析功能
4. 用户界面功能
5. 系统功能

核心功能模块

1. 数据导入模块

功能描述

支持从Excel文件导入3D和P3历史开奖数据，自动识别数据格式和类型。

技术特点

• 多格式支持：支持 .xls（Excel 97-2003）和 .xlsx（Excel 2007+）格式
• 智能识别：根据列数和列标题自动识别数据类型（3D或P3）
• 格式兼容：支持简化标题（如"开"、"奖"、"号"）和完整标题
• 数据验证：自动清理无效数据行，只保留有效的期号数据

使用场景

• 导入历史数据文件
• 导入新的一期开奖数据
• 合并多个数据文件

数据格式要求

3D数据（17列）：

列1: 开奖期号
列2: 开奖日期
列3-5: 开奖号百位、十位、个位
列6-8: 试机号百位、十位、个位
列9-10: 机号、球号
列11-17: 投注总额、单选注数、单选金额、组三注数、组三金额、组六注数、组六金额

P3数据（12列）：

列1: 开奖期号
列2: 开奖日期
列3-5: 开奖号百位、十位、个位
列6-12: 投注总额、直选注数、直选金额、组三注数、组三金额、组六注数、组六金额

2. 数据展示模块

功能描述

在GUI界面中以表格形式清晰展示所有历史开奖数据。

技术特点

• 动态列显示：根据数据类型（3D/P3）自动调整表格列
• 智能排序：按期号数字降序排列（最新数据在前）
• 滚动支持：支持鼠标滚轮和鼠标中键拖动滚动
• 交互功能：单击和双击表格行触发不同操作

显示内容

3D数据显示：

• 基本信息：期号、日期
• 开奖信息：开奖号百位、十位、个位
• 试机信息：试机号百位、十位、个位
• 机器信息：机号、球号
• 投注信息：投注总额、单选注数/金额、组三注数/金额、组六注数/金额

P3数据显示：

• 基本信息：期号、日期
• 开奖信息：开奖号百位、十位、个位
• 投注信息：投注总额、直选注数/金额、组三注数/金额、组六注数/金额

3. 自动更新模块

功能描述

从互联网自动获取最新开奖数据，支持3D和P3两种数据源。

技术特点

• 多数据源：
• 3D数据：`[数据源地址已隐藏]
• P3数据：`[数据源地址已隐藏]
• 智能识别：根据当前数据类型或实际数据列数自动识别
• 后台更新：使用多线程技术，不阻塞GUI界面
• 错误处理：完善的网络错误和数据解析错误处理

更新流程

1. 用户点击"自动更新"按钮
2. 根据数据类型选择对应的URL
3. 发送HTTP请求获取数据
4. 解析文本数据（空格分隔格式）
5. 根据列数识别数据类型
6. 更新数据表格显示
7. 显示更新成功消息

4. 数据保存模块

功能描述

将当前数据保存为Excel文件，文件名自动包含数据类型和最后期号信息。

技术特点

• 智能命名：文件名格式 {数据类型}历史开奖数据_{最后期号}_{最后日期}.xlsx
• 格式一致：保存的文件格式与导入格式一致
• 标题行：包含两行标题行（第一行为空，第二行为列标题）
• 数据排序：保存时按期号升序排列

保存格式

• 文件格式：Excel 2007+（.xlsx）
• 标题行：两行（第一行空，第二行列标题）
• 数据行：从第三行开始
• 列标题：使用简化标题（如"开"、"奖"、"号"）

数据管理功能

1. 导入Excel数据

功能：从Excel文件导入历史开奖数据

操作步骤：

1. 点击工具栏"导入Excel数据"按钮
2. 在文件选择对话框中选择Excel文件（默认打开data文件夹）
3. 软件自动识别数据类型并加载数据
4. 数据加载成功后显示在表格中

支持格式：

• Excel 97-2003：.xls
• Excel 2007+：.xlsx

数据验证：

• 自动验证列数（3D=17列，P3=12列）
• 自动清理无效数据行
• 自动识别数据类型

2. 刷新数据

功能：重新加载当前数据文件

操作步骤：

1. 点击工具栏"刷新数据"按钮
2. 软件重新读取当前数据文件
3. 更新表格显示

使用场景：

• 数据文件被外部修改后需要重新加载
• 验证数据是否正确加载

3. 自动更新

功能：从互联网获取最新开奖数据

操作步骤：

1. 点击工具栏"自动更新"按钮
2. 软件自动从对应数据源获取最新数据
3. 更新完成后显示成功消息

数据源：

• 3D数据：`[数据源地址已隐藏]
• P3数据：`[数据源地址已隐藏]

更新特点：

• 自动识别数据类型
• 后台更新不阻塞界面
• 完善的错误处理

4. 保存开奖数据

功能：将当前数据保存为Excel文件

操作步骤：

1. 点击工具栏"保存开奖数据"按钮
2. 在文件保存对话框中选择保存位置（默认保存到data文件夹）
3. 可以修改文件名
4. 点击"保存"完成保存

文件命名：

• 格式：{数据类型}历史开奖数据_{最后期号}_{最后日期}.xlsx
• 示例：3D历史开奖数据_2025303_20251113.xlsx
• 示例：P3历史开奖数据_2025303_20251113.xlsx

查询分析功能

1. 历史号码查询

功能：查询指定3D/P3号码在历史记录中的所有出现情况

输入：3位数字（如：715）

输出：

• 该号码的所有历史开奖记录
• 每条记录包含：期号、日期、开奖号、投注信息等
• 统计信息：首次开出日期、最近开出日期、开出次数

查询逻辑：

匹配条件：开奖号百位 == 输入[0] AND 开奖号十位 == 输入[1] AND 开奖号个位 == 输入[2]
排序：按日期降序排列（最新在前）

结果格式：

• 显示所有匹配的记录
• 每条记录显示完整信息
• 根据数据类型显示不同字段

2. 试机号查询（仅3D）

功能：查询指定试机号在3D历史记录中的所有出现情况，并统计开奖号分布

输入：3位数字（如：904）

输出：

• 该试机号的所有历史记录
• 每条记录包含：期号、日期、开奖号、试机号、机球号、投注信息
• 开奖号分布统计（前10个最常见的开奖号）

查询逻辑：

匹配条件：试机号百位 == 输入[0] AND 试机号十位 == 输入[1] AND 试机号个位 == 输入[2]
排序：按期号降序排列（最新在前）
统计：统计开奖号出现频率

注意事项：

• 此功能仅适用于3D数据
• P3数据没有试机号信息

3. 期号查询

功能：查询指定期号的详细开奖信息

输入：开奖期号（数字或字符串）

输出：

• 该期的完整开奖信息
• 根据数据类型显示不同字段

查询逻辑：

匹配条件：开奖期号 == 输入期号
输出：显示该期的所有详细信息

结果格式：

• 显示期号、日期、开奖号
• 3D数据：显示试机号、机球号、投注信息
• P3数据：显示投注信息（直选、组三、组六）

4. 日期范围查询

功能：查询指定日期范围内的所有开奖记录

输入：

• 开始日期：YYYY-MM-DD格式
• 结束日期：YYYY-MM-DD格式

输出：

• 该时间段内的所有开奖记录
• 每条记录包含：期号、日期、开奖号
• 根据数据类型显示额外信息

查询逻辑：

匹配条件：开奖日期 >= 开始日期 AND 开奖日期 <= 结束日期
排序：按日期降序排列（最新在前）

结果格式：

• 列表形式显示所有匹配的记录
• 每条记录显示关键信息
• 显示总记录数

5. 快速查看功能

单击表格行

功能：单击表格行自动显示该期详细信息

操作：单击表格中的任意数据行

效果：

• 查询结果框自动显示该期的详细开奖信息
• 无需输入期号即可查看

显示内容：

• 期号、日期
• 开奖号详细信息
• 根据数据类型显示其他信息

双击表格行

功能：双击表格行自动填充期号并执行查询

操作：双击表格中的任意数据行

效果：

1. 自动将期号填充到"期号查询"输入框
2. 自动执行期号查询
3. 显示查询结果

用途：

• 快速查询单期数据
• 可以进一步操作查询结果

用户界面功能

1. 工具栏功能

导入Excel数据按钮

• 功能：打开文件选择对话框导入数据
• 状态：激活后可用
• 默认路径：data文件夹

刷新数据按钮

• 功能：重新加载当前数据文件
• 状态：激活后可用
• 使用场景：数据文件被修改后重新加载

自动更新按钮

• 功能：从互联网获取最新数据
• 状态：激活后可用
• 更新过程：按钮显示"更新中..."，完成后恢复

保存开奖数据按钮

• 功能：保存当前数据为Excel文件
• 状态：激活后可用
• 默认路径：data文件夹

激活按钮

• 功能：软件激活和注册信息查看
• 状态：始终可用
• 功能：
• 未激活：显示激活对话框
• 已激活：显示注册信息

关于按钮

• 功能：显示软件信息和版本信息
• 状态：始终可用

2. 状态显示

文件路径显示

• 位置：工具栏中间
• 内容：显示当前加载的数据文件名和数据类型
• 颜色：绿色（已加载）、灰色（未加载）

激活状态显示

• 位置：工具栏中间
• 内容：
• "已激活"（绿色）：软件已激活
• "未激活"（红色）：软件未激活
• 字体：加粗显示

版权信息

• 位置：工具栏右侧
• 内容：软件版本、版权信息、联系方式
• 字体：小号灰色字体

3. 查询功能区

布局

• 位置：界面左侧
• 布局：垂直排列的查询功能组
• 滚动：支持滚动查看

功能组

1. 历史号码查询：输入3D/P3号码查询
2. 试机号查询：输入试机号查询（仅3D）
3. 期号查询：输入期号查询
4. 日期范围查询：输入日期范围查询

输入框特点

• 字体：大号字体（Arial 14），方便输入
• 回车键：支持回车键快速查询
• 验证：输入验证和错误提示

4. 数据表格显示区

表格特点

• 动态列：根据数据类型自动调整列
• 排序：按期号降序排列（最新在前）
• 滚动：支持垂直和水平滚动
• 选择：支持行选择（蓝色高亮）

交互功能

• 单击：显示该期详细信息
• 双击：填充期号并执行查询
• 滚动：鼠标滚轮和中键拖动

5. 查询结果输出框

显示特点

• 位置：界面右侧
• 格式：格式化文本显示
• 滚动：支持滚动查看
• 自动滚动：查询后自动滚动到最新内容

操作按钮

• 一键复制：复制所有结果到剪贴板
• 清空结果：清空输出框内容

结果格式

• 标题：查询类型和数据类型
• 数据：格式化的查询结果
• 统计：统计信息（如适用）
• 版权：自动添加版权信息

系统功能

1. 注册系统

功能描述

基于硬件ID的软件授权系统，确保软件在授权设备上使用。

技术特点

• 硬件绑定：基于硬件信息生成唯一设备ID
• RSA加密：使用RSA 2048位密钥对进行签名和验证
• 授权管理：支持授权类型、有效期、功能模块等管理
• 自动验证：启动时自动验证授权状态

激活流程

1. 用户获取设备ID
2. 开发者生成授权文件
3. 用户导入授权文件
4. 软件验证并激活

授权信息

• 设备ID：唯一设备标识
• 授权类型：高级版/标准版
• 有效期：授权到期日期
• 签发日期：授权签发日期
• 功能模块：授权包含的功能列表

2. FTP上传功能

功能描述

自动上传注册信息到FTP服务器，用于授权管理和统计。

技术特点

• 后台上传：使用多线程技术，不阻塞GUI
• 状态显示：在激活对话框中显示上传状态
• 错误处理：完善的错误处理和重试机制
• 隐私保护：不显示FTP服务器地址

上传内容

• 设备ID
• 激活时间
• 授权类型
• 其他授权信息

3. 数据文件夹管理

功能描述

自动创建和管理数据文件夹，方便数据文件管理。

技术特点

• 自动创建：首次运行时自动创建data文件夹
• 默认路径：软件根目录下的data文件夹
• 路径识别：支持打包后的exe和Python脚本两种模式

文件夹用途

• 存储历史开奖数据文件
• 导入和保存数据的默认位置
• 集中管理数据文件

4. 错误处理

功能描述

完善的错误处理和用户提示机制。

处理类型

• 文件错误：文件不存在、格式错误、权限错误
• 数据错误：数据格式错误、列数不匹配、数据类型错误
• 网络错误：连接失败、超时、服务器错误
• 系统错误：激活失败、授权过期、硬件识别失败

错误提示

• 消息框：使用messagebox显示错误信息
• 控制台：输出详细错误信息到控制台
• 日志：记录错误日志（如适用）

📊 功能对比表

🔄 功能流程图

数据导入流程

用户点击"导入Excel数据"
    ↓
打开文件选择对话框（默认data文件夹）
    ↓
用户选择Excel文件
    ↓
读取文件（支持.xls和.xlsx）
    ↓
解析标题行（使用第二行作为列标题）
    ↓
识别数据类型（根据列数和标题）
    ↓
加载数据行（从第三行开始）
    ↓
数据验证和清理
    ↓
更新表格显示
    ↓
显示加载成功消息

查询流程

用户输入查询条件
    ↓
点击查询按钮或按回车
    ↓
验证输入格式
    ↓
查询数据（根据查询类型）
    ↓
格式化查询结果
    ↓
显示在查询结果框
    ↓
自动滚动到最新内容

自动更新流程

用户点击"自动更新"
    ↓
根据数据类型选择URL
    ↓
发送HTTP请求（后台线程）
    ↓
解析响应数据
    ↓
识别数据类型（根据列数）
    ↓
更新数据表格
    ↓
显示更新成功消息

📈 性能特点

数据处理性能

• 大数据支持：支持处理数千条历史记录
• 快速查询：使用pandas进行高效数据查询
• 内存优化：合理使用内存，避免内存溢出

界面响应性能

• 多线程：网络请求和FTP上传使用后台线程
• 异步更新：GUI更新使用after方法，避免阻塞
• 流畅滚动：优化的滚动机制，流畅的用户体验

文件操作性能

• 快速加载：优化的Excel读取算法
• 批量处理：支持批量数据处理
• 格式兼容：兼容多种Excel格式

🔒 安全特性

数据安全

• 本地存储：数据文件存储在本地，不上传服务器
• 格式验证：严格的数据格式验证，防止恶意数据

授权安全

• 硬件绑定：基于硬件ID的唯一设备识别
• RSA加密：使用RSA 2048位密钥对
• 签名验证：授权文件签名验证，防止篡改

隐私保护

• FTP地址隐藏：不显示FTP服务器地址
• 最小信息：只上传必要的授权信息

3D/P3藏书阁 v3.0
© 2025 东湖沙湾论彩彩迷群 版权所有