📌 系统概述
排列五智能分析系统是一款面向彩票研究爱好者的高级数据分析工具。它利用全量历史开奖数据（近万期），通过 30条核心规律、9维度评分模型 和 自适应权重系统，对每位数字、组合形态（五不同/四不同/三不同/二不同/豹子）、和值、跨度、AC值、位置分布进行全面量化评估，并通过 5大推荐模块加权投票（v10 命中0.7/覆盖0.3技巧分 + 模块来源多样性Tiebreak） 生成"综合推荐号码"。v10 内置默认权重（外部0.728 / 内部0.968 / 热度0.947 / 位置1.000 / 目标0.886），若 pub 目录存在历史报告可运行时自动重算覆盖。v10.1 起"位置最大遗漏推荐"万/千/百/十/个每位置只保留 1 个最大遗漏数字（原前3个），与综合推荐投票口径及回测（每位置 top-1）完全对齐。v10.4 起精选号码 Top 10 改为位置定位选号：前三位（万/千/百）按各位置遗漏定位取前 3 候选，后两位（十/个）从全局候选池组合（参考 v10.1 无位置定位逻辑）；v10.6 起数字综合评分由分数阈值改为排名制（前3强推/4-6推荐/7-10参考）。v9.5 起改为可复现的 walk-forward 回测，真实任中率与随机基准（约 96.9%）无显著差异——排列五为独立随机事件，本系统不具备预测优势。系统提供可视化 HTML 报告和命令行表格输出两种形式，便于快速解读。
📊 数据驱动
全量历史数据（本地 Excel / 网络爬虫 / 缓存文件）自动获取，支持近万期深度分析，带1小时缓存加速。
⚡ 高性能架构
使用 LRU 缓存装饰器、生成器替代列表、哈希表优化模式匹配，完整类型注解，自带性能监控日志。v9.9/v10 进一步对组合生成、网格搜索、walk-forward 回测进行算法层优化（O(N²)→O(N)），并通过等效性验证保证结果与 v9.8 一致。
🧠 自适应评分 (v7.0+)
根据近期命中率动态调整各维度权重，结合回测分与回测系统校验，有效防止过拟合，提升泛化能力。
🏆 综合推荐5号码 (v10)
5大推荐模块加权投票（v10：技巧分 = 命中提升×0.7 + 覆盖提升×0.3，更关注实际中奖数），综合评分 total_score 作为第三排序键；v10 新增"模块来源多样性"Tiebreak（被N个不同模块推荐加 N×0.05 分，多模块共识更稳定）；运行时可基于 pub 报告重算权重覆盖内置默认值。
🌌 号码空间全局分析 (v9.1+)
00000-99999 全号码空间扫描：从未出现号码、历史出现 Top/Bottom10、遗漏 Top30、六大策略推荐、类型分布。
📈 多维度分析
涵盖数字频率、遗漏、AC值连续、跨度连续、位置连续统计&最大遗漏、和值模式、质合&012路 等 20+ 专项分析。
🏆 综合推荐号码 (v10 数据驱动加权 + 模块多样性 + v10.6 位置定位选号)
v10 的综合推荐模块采用 5大推荐模块加权投票（v10 命中0.7/覆盖0.3技巧分） + 模块来源多样性 Tiebreak + 综合评分 Tiebreak 三级排序算法，输出 5 个号码。权重来自 pub 目录 134 期 HTML 报告与真实开奖的逐期回测（0.7/0.3加权技巧分归一化）：各模块真实命中/覆盖均与随机基准无显著差异，故权重均 ≤1.0，位置遗漏因覆盖最高保留 1.0。v10 新增模块多样性加分：同一数字被 N 个不同模块推荐时，加 N×0.05 分作为第二排序键，鼓励多模块共识的稳定数字。v10.6 口径对齐：位置最大遗漏模块由"每位置3个数字投票"改为"每位置只投1个最大遗漏数字"，与回测评估口径（compute_voting_backtest 每位置 top-1）一致，pos 权重 1.000 的评估基准才名副其实，综合推荐 5 号码随票面收窄而重排。真实任中率与随机基准（约 96.9%）无显著差异，系统不具备预测优势，结果仅供娱乐参考。
v10 三级排序算法 (v10.6 位置定位选号)
- ① 加权票数 = Σ (模块权重 × 该模块是否推荐此数字)
- ② 模块多样性加分 = 被推荐模块数 × 0.05（v10新增，鼓励多模块共识）
- ③ 综合评分 total_score（9维度加权总分）作为第三排序键
- 模块权重默认(v10)：外部0.728 / 内部0.968 / 热度0.947 / 位置1.000 / 目标0.886
- v10 权重公式：技巧分 = 命中提升×0.7 + 覆盖提升×0.3（更关注实际命中）
- 位置最大遗漏模块每位置只投 1 个最大遗漏数字（v10.1 引入，原3个），与回测口径 top-1 对齐
- 运行时若 pub 目录存在报告，compute_comprehensive_module_weights() 自动重算权重覆盖内置默认
各模块内置权重 (v10, 134期回测)
| 推荐模块 | v10权重 | 说明 |
|---|---|---|
| 🎯 位置最大遗漏 | 1.000 | 覆盖最高，技巧分最大归一化为1.0 |
| 📊 内部精选(遗漏) | 0.968 | 遗漏分析候选 |
| 📈 热度上升数字 | 0.947 | 近10期趋势上升 |
| 🔥 目标期高频数字 | 0.886 | 目标期号码统计特征 |
| 🎯 外部精选号码 | 0.728 | 外部预测网站胆码 |
| 🏆 综合推荐5号码 | — | 见动态回测（≈随机基准） |
✨ 核心功能特性
🔍 连续两期和值模式匹配
全量历史中查找与最近两期和值变化完全相同的记录（含排列五完整号码），统计目标期五不同/四不同/三不同/二不同/豹子概率及热门数字，提供模式胆码池。
🌡️ 全局遗漏统计 & 内部精选
从最新一期向前计算每个数字在所有位置均未出现的期数，标记冷热程度，按遗漏最大推荐 2 个数字作为内部精选号码。
🎲 数字频率热度分析 (v6.8+)
统计全量 / 近100期 / 近30期 / 近10期 0-9 出现次数与排名，分析热度趋势（上升/下降/稳定），给出热度上升数字推荐及热度评分（低于8分禁止进入精选候选池）。
📍 位置连续统计 & 位置最大遗漏
分别对万位、千位、百位、十位、个位进行奇偶/大小连续统计并记录历史最大值；同时计算各位置数字遗漏期数并给出位置最大遗漏推荐（每位置只保留 1 个最大遗漏数字，与回测口径对齐）。
📐 AC值 & 跨度值连续分析 (v6.5/v6.6)
统计 AC 值（0-8）和跨度（0-9）的奇偶/大小连续情况，结合历史最大连续记录、连续奇/偶/大/小，动态调整评分权重。
🎯 和值范围智能预测 (v6.9+)
综合长期分布、周期性、概率密度函数（和值 0-45，均值 22.5），给出推荐和值区间及 Top5 和值，并配合和值模式匹配结果用于组合生成。
🏆 综合评分系统 (v9.0 权重调整)
对 0-9 每个数字进行 9 大维度加权评分：遗漏分1.4（最高）、外部分1.2（已下调）、模式分1.5、热度分1.2、回测分1.4、频率分0.9、冷热分0.7、位置分0.5、重复分0.3。总分排名前 3 强推、第 4-6 推荐、第 7-10 参考（v10.6 起由分数阈值改为排名制）。
🔢 智能号码组合生成 (v10 优化)
基于候选数字池、和值范围、五不同/四不同/三不同/二不同/豹子理论比例精确生成 Top 10 精选组合。v10.4 起采用位置定位选号：前三位（万/千/百）按各位置遗漏定位取前 3 候选，后两位（十/个）从全局候选池组合（参考 v10.1 无位置定位逻辑），按组型理论概率分配注数；不足时优先用热门/外部精选/热度上升特殊组合补充，仍不足时按综合评分补足。v10 组合生成移除无效排列去重，计算量大幅下降。
🌐 外部预测集成 & 近15期命中统计
抓取外部预测网站数据，内置全量命中规律，计算连续未中/命中概率，动态调整外部精选号码权重。HTML报告显示近15期外部预测与命中情况（红色命中/绿色未中）。
🎯 目标期号码统计特征 (v6.8.2+)
基于目标期号的历史开奖记录，提取高频数字、冷热分布、和值/跨度特征，给出 目标期高频数字 Top5，作为综合推荐投票的模块之一。
🔄 回测与过拟合防范 (v6.9+)
8:2 划分训练/测试集，对评分系统、组合生成、各维度准确率做回测验证，计算过拟合程度；并提供回测分参与综合评分，有效避免数据泄露。
📄 HTML 可视化报告 (v10.6)
生成详细的交互式 HTML 报告：版本号 v10.6，含期号信息横幅、近10期开奖、推荐号码卡片、5模块+综合推荐展示、Top10精选号码表格（v10.4 起前三位定位+后两位池化）、号码空间全局分析、遗漏网格、AC/跨度统计；v10.5 起"历史匹配记录详情"表格每期只保留单列排列五；支持移动端自适应。
⚡ 算法层性能优化 (v9.9/v10 继承)
组合生成移除无效 set(permutations) 去重（O(排列数)→O(1)）；网格搜索预计算 freq_prefix / missing_at 前缀数组（O(N²)→O(N)，N=1000 期约 1000x 提速）；walk-forward 回测用 last_seen 增量跟踪替代反扫全历史；循环外排序消除重复 sorted。所有优化经等效性验证与 v9.8 输出一致。
🛠️ 技术架构
🐍 编程语言
Python 3.8+
全面类型注解（Type Hints / dataclass）
📦 核心依赖
pandas · numpy · requests · openpyxl
需自行 pip 安装
⚙️ 运行 & 部署
命令行参数运行，支持 PyInstaller 打包 EXE
输出：控制台表格 + HTML 报告 + 缓存 JSON
📂 数据源优先级
① 本地 Excel PL3.xlsx（脚本默认路径沿用）
② 网络 https://data.17500.cn/pl5_asc.txt 排列五数据
③ 网络爬虫抓取
④ Mock 兜底生成
🗄️ 数据缓存 (v8.9+)
网络获取的开奖数据自动缓存至 pl5_cache.json，1小时有效期，避免重复下载，显著提升运行速度；网格搜索权重缓存 pl5_weights.json。
📁 文件命名规则
HTML 报告：pl5_report_{预测期号}_{YYYYMMDD}_{HHMMSS}.html，自动保存到脚本目录及服务器 /www/wwwroot/tc.mjhg.cn/pub/ 目录（若存在）。
📊 评分系统详解
每位数字的 total_score 由 9 大维度加权组成，权重会根据近期命中率做自适应调整（v9.0 权重调整后如下）：
| 评分维度 | 基础权重 | 自适应范围 | 满分参考 |
|---|---|---|---|
| 遗漏分 | 1.4（最高权重） | 1.0 - 1.4 | 20分 |
| 外部分 | 1.2（中等权重） | 1.0 - 1.4 | 20分 |
| 模式分 | 1.5 | 1.2 - 1.6 | 22分（22/21/20...递减） |
| 热度分 | 1.2 | 0.8 - 1.2 | 20分 |
| 回测分 | 1.4 | 1.0 - 1.4 | 20分 |
| 频率分 | 0.9（降权） | 0.8 - 1.2 | 15分 |
| 冷热分 | 0.7（降权） | 0.6 - 1.0 | 12分 |
| 位置分 | 0.5（降权） | 0.4 - 0.8 | 8分 |
| 重复分 | 0.3（降权） | 0.3 - 0.5 | 5分 |
推荐阈值（v10.6 起改为排名制）：数字综合评分按总分降序排名，前 3 名 → ★★★ 强推；第 4-6 名 → ★★ 推荐；第 7-10 名 → 参考。热度分低于 8 分的数字将被禁止进入最终精选候选池。
组合形态理论概率：五不同 30.24% · 四不同 50.40% · 三不同 14.40% · 二不同 4.32% · 豹子 0.64%（与历史分布对比，智能推荐）。
Tiebreak 用法：综合推荐5号码（加权票数 → 模块多样性 → 综合评分）、精选号码 Top10 排序、号码补足阶段等遇到并列时，均以 total_score 作为最终排序键。
📁 输出内容 & 使用方式
命令行输出
- 表格化输出：期号信息、数字频率统计、位置连续分析、遗漏统计、AC/跨度统计、和值模式匹配、近15期外部预测命中
- 精选号码 Top 10（v9.2+）：号码 / 和值 / 跨度 / 评分 / 类型 / 奇偶 / 大小 / 特征（含 ★特殊推荐 标记）
- 五不同/四不同/三不同/二不同/豹子概率评分、和值范围预测 Top5、候选数字池、5模块推荐号码明细 + 综合推荐5号码
- 号码空间全局分析摘要、回测系统摘要、各模块耗时性能日志
HTML 报告 (v10.6)
- 自动保存至脚本目录 +
/www/wwwroot/tc.mjhg.cn/pub/目录（若存在），文件名含预测期号 + 日期 + 时间，v9.4+ 全移动端自适应 - 章节：期号信息卡片（含预测期号横幅） · 近10期开奖记录 · 数字频率表 · 连续两期和值模式匹配（含排列五完整号码） · 外部预测近15期命中表
- 🎯 推荐号码区：5 大模块卡片（外部精选 / 内部精选遗漏 / 热度上升 / 和值范围 / 位置遗漏推荐 / 目标期高频） + 🏆 综合推荐5号码渐变卡片 + 数字综合评分紧凑面板
- 🏆 精选号码 Top 10 评分表 · 🌌 号码空间全局分析 · 数字综合评分表 · 组合评分表
- AC/跨度连续分析 · 位置号码连续统计 · 位置最大遗漏分析 · 遗漏网格
运行方式
-c, --config 指定配置文件（JSON）
-n, --number 输出预测号码数量（精选 Top 10）
-v, --verbose 详细输出模式
--no-local 强制使用网络数据（不使用本地 Excel）
--timeout 网络请求超时时间（秒）
--missing-threshold 遗漏阈值（默认30）
--no-html 不生成 HTML 报告
--html-path HTML 报告输出路径
数据源优先级：① PL3.xlsx（脚本默认路径沿用）；② 网络 pl5_asc.txt（https://data.17500.cn/pl5_asc.txt）原始文本；③ 网络数据抓取（缓存至 pl5_cache.json，1小时有效）；④ Mock 兜底数据生成保证系统稳定运行。
🔖 主要版本迭代
| 版本 | 日期 | 核心更新 |
|---|---|---|
| v10.6 | 2026-08-18 | 数字综合评分改为排名制：移除原分数阈值（≥100强推/≥80推荐/≥60参考），改为按总分降序排名——前 3 名 ★★★ 强推、第 4-6 名 ★★ 推荐、第 7-10 名 参考；版本号统一更新为 v10.6。 |
| v10.5 | 2026-08-18 | 历史匹配记录详情表格去重：期号n / 期号n+1 / 目标期每期只保留一列"排列五"显示 5 位完整号码，移除重复的组选号码列；版本号统一更新为 v10.5。 |
| v10.4 | 2026-08-18 | 精选号码 Top 10 改为位置定位选号：前三位（万/千/百）按各位置遗漏定位取前 3 候选，后两位（十/个）从全局候选池组合（参考 v10.1 无位置定位逻辑），按五不同/四不同/三不同理论概率分配注数；10 组互不重复；版本号统一更新为 v10.4。 |
| v10.3 | 2026-08-18 | HTML 报告"五不同/四不同分析"新增鼠标悬停提示：悬停类型名显示体彩官方形态、说明与示例；版本号统一更新到 v10.3。 |
| v10.1 | 2026-08-12 | 位置最大遗漏推荐每位置只保留 1 个最大遗漏数字（原前3个）：报告"推荐号码"卡片、位置遗漏详表、综合推荐 5 号码投票自动同步，位置模块从"最多15个候选各1票"收窄为"最多5个各1票"；实际运行口径与回测（compute_voting_backtest 每位置 top-1）对齐，pos 权重 1.000 的评估基准名副其实，综合推荐 5 号码构成随票面收窄而重排。版本号统一更新为 v10.1，保留 v10 版本。 |
| v10 | 2026-08-10 | 模块权重公式优化（134期回测，命中提升×0.7+覆盖提升×0.3）：原技巧分 = (命中提升+覆盖提升)/2（等权），现改为 技巧分 = 命中提升×0.7 + 覆盖提升×0.3，更关注实际中奖数字的价值。内置默认权重更新：外部0.728 / 内部0.968 / 热度0.947 / 位置1.000 / 目标0.886。 综合推荐5号码排序增强：新增"模块来源多样性"作为第二排序键（被 N 个不同模块共同推荐加 N×0.05 分），最终排序键：(加权票数, 模块多样性×alpha, 综合评分total_score)。 算法层性能优化（组合生成 O(排列数)→O(1)、网格搜索 O(N²)→O(N) 约 1000x、walk-forward 回测 O(N²)→O(N)、循环外排序）；compute_comprehensive_module_weights() 同步使用 0.7/0.3 加权技巧分运行时重算覆盖内置默认；保留 v9.9 版本。 |
| v10-PL5 | 2026-08-10 | 基于排列五 v10 脚本改造为排列五分析预测脚本：号码位数 3位→5位（万位/千位/百位/十位/个位）；和值范围 0-27 → 0-45，均值 13.62 → 22.5；位置分析 3个 → 5个；组三/组六概念 → 5位组合特征（不同数字个数1-5）；频率窗口 ×3→×5；外部预测URL与数据缓存文件切换为排列五（pl5_cache.json）。 |
| v9.9 | 2026-08-07 | 算法层全面性能优化（功能与 v9.8 等效，已通过等效性验证）：组合生成移除无效 set(permutations) 去重；网格搜索预计算前缀数组 O(N²×10)→O(10) 查表（N=1000 期约 1000x 提速）；walk-forward 回测用 last_seen 增量跟踪替代反扫全历史 O(N²)→O(N)；global_missing 由 O(N×10) 反扫改为 O(N) 单遍；循环外排序消除重复 sorted。逻辑修正：频率统计对每期号码先 set 去重避免组三/豹子重复计数；predict 中 top_digits 重命名消除歧义。保留 v9.8 版本。 |
| v9.8 | 2026-08-07 | 报告"推荐号码"模块新增预测期号与预测开奖日期横幅（基于最新一期+1期/日期+1天推算）；报告排版响应式升级（容器宽度 min(1480px,96vw)、标题 clamp() 流式字号、六宫格窄屏 3→2→1 列、宽表格 .table-scroll 横向滚动）；理顺"数字评分→综合推荐→精选号码"三者关系并可视化（数字综合评分紧凑面板高亮综合推荐5个数字、精选 Top10 每行标注"含综合推荐X个"）。 |
| v9.7 | 2026-08-07 | 真实历史回测驱动权重修正：解析 pub 目录 133 期 HTML 报告"推荐号码"模块，与 pl5_cache.json 真实开奖逐期对比 5 模块（外部精选/内部精选/热度上升/位置遗漏/目标高频）。结论：各模块真实命中与随机基准无显著差异，仅报告自带综合略高于随机。据此将综合推荐模块权重由等权改为数据驱动加权；新增 compute_comprehensive_module_weights() 运行时可基于 pub 报告重算权重（可复现，非硬编码）。 |
| v9.6 | 2026-08-07 | 方法学修复（延续 v9.5 诚信路线）：网格搜索维度与代理评分对齐并增加默认基线守卫；组合形态口径一致（移除"偏离即强烈推荐"臆测、组合内形态评分中性化、注数按理论概率分配）；和值范围改用经验高概率和值并集；AC/跨度由乘法缩放改为有界加性修正；两期和值模式匹配增加显著性检验；外部预测权重默认 1.6→1.2（实测仅~52%任中）。 |
| v9.5 | 2026-08-07 | 诚信修正：移除不可复现的"89.9%任中率"宣传，改为可复现 walk-forward 回测（真实任中率与随机基准≈96.9%无显著差异）；数据获取失败强制红色告警；等权投票真正按模块等权、候选池保留冷号、移除死代码、BacktestSystem 不再重复创建；内部精选纳入极冷号。 |
| v9.4 | 2026-08-07 | 130期历史回测；综合推荐从3号码升级为5号码；5大模块等权投票 + 综合评分 Tiebreak 算法；注：原"任中率89.9%"为依据不足的宣传语，v9.5 已移除并改为可复现回测；保留 v9.3 版本。 |
| v9.3 | 2026-05-17 | 修复精选号码生成逻辑：五不同+四不同不足时用特殊推荐组合（热门/外部精选/热度上升）补充，仍不足时按综合评分补足，确保精确输出 10 组精选号码。 |
| v9.2 | 2026-05-17 | HTML 视觉大升级：渐变配色、3列满宽 Grid 布局（六大策略/号码类型）、精选 Top 15 → Top 10；修复号码空间全局分析 section 位置 bug；footer 版本统一。 |
| v9.1 | 2026-05-15 | 🌌 新增号码空间全局分析模块（00000-99999 从未出现号码、历史 Top/Bottom10、遗漏 Top30、六大策略推荐、类型分布）。 |
| v9.0 | 2026-05-09 | 9 维度权重全面调整：遗漏/外部/模式/热度/回测分加权，频率/冷热/位置/重复分降权；六大策略推荐卡片改为 3 列。 |
| v8.9 | 2026-05-09 | 数据缓存（pl5_cache.json，1小时有效）；网络数据带数值范围校验；和值模式匹配改用哈希表大幅提速。 |
| v8.8 | 2026-05-09 | 全面支持排列五5位号码解析与显示（历史匹配记录/期号信息/HTML表格均展示完整5位）。 |
| v8.7 | 2026-05-09 | 位置号码最大遗漏增加各位置历史最大遗漏期数与对应遗漏数字。 |
| v8.1 | 2026-05-05 | 🏆 首次引入综合推荐模块：3个重复率最高的号码；精选号码 Top 15 生成逻辑优先使用重复率高的 4-6 个数字。 |
| v7.6 | 2026-05-04 | 评分阈值分级（≥100强推/≥80推荐/≥60参考）；热度分低于8分禁止进入精选池。 |
| v7.0 | 2026-04-29 | 自适应权重系统、智能胆码推荐、性能监控日志、LRU缓存装饰器、生成器优化、完整类型注解。 |
⚠️ 重要提示
- 本系统基于历史数据统计分析，彩票开奖为随机事件，所有预测结果仅供参考研究，不构成任何投资建议。
- v9.5 已移除原"任中率 89.9%"宣传语，改为可复现回测：历史回测真实任中率与随机基准（约 96.9%）无显著差异，系统不具备预测优势，切勿期望稳定盈利。请理性参与，切勿沉迷。
- 系统作者不对使用本工具产生的任何损失负责。
- 外部预测数据源可能存在延迟或变更，建议定期更新本地数据或确保缓存及时刷新，以保证分析时效。
- 服务器部署需安装依赖：
pip install pandas numpy requests openpyxl；EXE 打包可参考仓库build_exe.bat。 - 系统保留历史版本脚本（v10、v9.x、v8.x 等），可按文件名按需切换使用。