📌 系统概述
排列三智能分析系统是一款面向彩票研究爱好者的高级数据分析工具。它利用全量历史开奖数据（近万期），通过 30条核心规律、9维度评分模型 和 自适应权重系统，对每位数字、组选形态、和值、跨度、AC值、位置分布进行全面量化评估，并通过 5大推荐模块加权投票（v10 命中0.7/覆盖0.3技巧分 + 模块来源多样性Tiebreak） 生成"综合推荐号码"。v10 内置默认权重（外部0.729 / 内部0.971 / 热度0.953 / 位置1.000 / 目标0.889），运行时由历史开奖数据 walk-forward 回测自动重算覆盖(取代报告解析法)。v10.1 起"位置最大遗漏推荐"每位置只保留 1 个最大遗漏数字（原前3个），报告显示与综合推荐投票口径与回测（每位置 top-1）完全对齐。v9.5 起改为可复现的 walk-forward 回测，真实任中率与随机基准（约 87.5%）无显著差异——排列三为独立随机事件，本系统不具备预测优势。系统提供可视化 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+)
000-999 全号码空间扫描：从未出现号码、历史出现 Top/Bottom10、遗漏 Top30、六大策略推荐、类型分布。
📈 多维度分析
涵盖数字频率、遗漏、AC值连续、跨度连续、位置连续统计&最大遗漏、和值模式、质合&012路 等 20+ 专项分析。
🏆 综合推荐号码 (v10.3 数据驱动加权 + 模块多样性, v10.1 位置模块口径对齐)
v10 的综合推荐模块采用 5大推荐模块加权投票（v10 命中0.7/覆盖0.3技巧分） + 模块来源多样性 Tiebreak + 综合评分 Tiebreak 三级排序算法，输出 5 个号码。权重来自历史开奖数据的 walk-forward 逐期回测（0.7/0.3加权技巧分归一化，取代原报告解析法）：各模块真实命中/覆盖均与随机基准无显著差异(提升 0.89x~1.04x)，故权重均 ≤1.0，位置遗漏因覆盖最高保留 1.0。v10 新增模块多样性加分：同一数字被 N 个不同模块推荐时，加 N×0.05 分作为第二排序键，鼓励多模块共识的稳定数字。v10.1 口径对齐：位置最大遗漏模块由"每位置3个数字投票"改为"每位置只投1个最大遗漏数字"，与回测评估口径（compute_voting_backtest 每位置 top-1）一致，pos 权重 1.000 的评估基准才名副其实，综合推荐 5 号码随票面收窄而重排。真实任中率与随机基准（约 87.5%）无显著差异，系统不具备预测优势，结果仅供娱乐参考。
v10 三级排序算法 (v10.1 位置模块口径对齐)
- ① 加权票数 = Σ (模块权重 × 该模块是否推荐此数字)
- ② 模块多样性加分 = 被推荐模块数 × 0.05（v10新增，鼓励多模块共识）
- ③ 综合评分 total_score（9维度加权总分）作为第三排序键
- 模块权重默认(v10)：外部0.729 / 内部0.971 / 热度0.953 / 位置1.000 / 目标0.889
- v10 权重公式：技巧分 = 命中提升×0.7 + 覆盖提升×0.3（更关注实际命中）
- v10.1：位置最大遗漏模块每位置只投 1 个最大遗漏数字（原3个），与回测口径 top-1 对齐
- 运行时由 compute_module_weights_from_backtest() 基于历史开奖数据重算权重(取代原报告解析法)覆盖内置默认
各模块回测表现 (134期)
| 推荐模块 | 平均命中提升 | 覆盖提升 | v10权重 |
|---|---|---|---|
| 🎯 位置最大遗漏 | 0.99x | 1.00x | 1.000 |
| 📊 内部精选(遗漏) | 1.04x | 0.96x | 0.971 |
| 📈 热度上升数字 | 1.03x | 0.94x | 0.953 |
| 🔥 目标期高频数字 | 0.98x | 0.89x | 0.889 |
| 🎯 外部精选号码 | 0.89x | 0.77x | 0.729 |
| 🏆 综合推荐5号码 | —（见动态回测） | ≈随机基准 | — |
✨ 核心功能特性
🔍 连续两期和值模式匹配
全量历史中查找与最近两期和值变化完全相同的记录（含排列五完整号码），统计目标期组三/组六概率及热门数字，提供模式胆码池。
🌡️ 全局遗漏统计 & 内部精选
从最新一期向前计算每个数字在所有位置均未出现的期数，标记冷热程度，按遗漏最大推荐 2 个数字作为内部精选号码。
🎲 数字频率热度分析 (v6.8+)
统计全量 / 近100期 / 近30期 / 近10期 0-9 出现次数与排名，分析热度趋势（上升/下降/稳定），给出热度上升数字推荐及热度评分（低于8分禁止进入精选候选池）。
📍 位置连续统计 & 位置最大遗漏
分别对百位、十位、个位进行奇偶/大小连续统计并记录历史最大值；同时计算各位置数字遗漏期数并给出位置最大遗漏推荐（v10.1 起每位置只保留 1 个最大遗漏数字，与回测口径对齐）。
📐 AC值 & 跨度值连续分析 (v6.5/v6.6)
统计 AC 值（0-2）和跨度（0-9）的奇偶/大小连续情况，结合历史最大连续记录、连续奇/偶/大/小，动态调整评分权重。
🎯 和值范围智能预测 (v6.9+)
综合长期分布、周期性、概率密度函数，给出推荐和值区间及 Top5 和值，并配合和值模式匹配结果用于组合生成。
🏆 综合评分系统 (v9.0 权重调整)
对 0-9 每个数字进行 9 大维度加权评分：遗漏分1.4（最高）、外部分1.2（实测~52%任中，已下调）、模式分1.5、热度分1.2、回测分1.4、频率分0.9、冷热分0.7、位置分0.5、重复分0.3。总分 ≥100 强推，≥80 推荐，≥60 参考。
🔢 智能号码组合生成 (v10 优化)
基于候选数字池、和值范围、组三/组六理论比例，精确生成 组选 Top 10 精选组合（数字集合、升序展示）。不足时优先用热门/外部精选/热度上升特殊组合补充，仍不足时按综合评分补足。v10 组合生成移除无效排列去重，计算量大幅下降。
🎯 直选（定序）Top 10 (v10.3 新增)
在原有组选 Top 10（数字集合、升序展示）之外，新增直选定序候选：百位/十位/个位各自从本位置的最大遗漏与冷热分析独立取候选，笛卡尔积成形，按各位遗漏+和值+综合推荐重合评分取前 10。位置顺序有真实意义、不随机也不升序，与组选互补呈现两种玩法。
🌐 外部预测集成 & 近15期命中统计
抓取外部预测网站（cpzj.com 胆码计算器）数据，内置全量命中规律，计算连续未中/命中概率，动态调整外部精选号码权重。HTML报告显示近15期外部预测与命中情况（红色命中/绿色未中）。
🎯 目标期号码统计特征 (v6.8.2+)
基于目标期号的历史开奖记录，提取高频数字、冷热分布、和值/跨度特征，给出 目标期高频数字 Top5，作为综合推荐投票的模块之一。
🔄 回测与过拟合防范 (v6.9+)
8:2 划分训练/测试集，对评分系统、组合生成、各维度准确率做回测验证，计算过拟合程度；并提供回测分参与综合评分，有效避免数据泄露。
📄 HTML 可视化报告 (v10)
生成详细的交互式 HTML 报告：版本号 v10.3，含期号信息横幅、近10期开奖、推荐号码卡片、5模块+综合推荐展示、Top10精选号码表格、号码空间全局分析、遗漏网格、AC/跨度统计，支持移动端自适应。
⚡ 算法层性能优化 (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
② pl5_asc.txt 排列五数据
③ 网络爬虫抓取
④ Mock 兜底生成
🗄️ 数据缓存 (v8.9+)
网络获取的开奖数据自动缓存至 pl3_cache.json，1小时有效期，避免重复下载，显著提升运行速度。
📁 文件命名规则
HTML 报告：pl3_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分 |
推荐阈值：总分 ≥100 → 强推；≥80 → 推荐；≥60 → 参考；低于60 → 一般。热度分低于 8 分的数字将被禁止进入最终精选候选池。
Tiebreak 用法：综合推荐5号码（加权票数 → 模块多样性 → 综合评分）、精选号码（组选）Top10 排序、号码补足阶段等遇到并列时，均以 total_score 作为最终排序键。
📁 输出内容 & 使用方式
命令行输出
- 表格化输出：期号信息、数字频率统计、位置连续分析、遗漏统计、AC/跨度统计、和值模式匹配、近15期外部预测命中
- 精选号码（组选） Top 10（v9.2+）：号码 / 和值 / 跨度 / 评分 / 类型 / 奇偶 / 大小 / 特征（含 ★特殊推荐 标记）
- 组三/组六概率评分、和值范围预测 Top5、候选数字池、5模块推荐号码明细 + 综合推荐5号码
- 号码空间全局分析摘要、回测系统摘要、各模块耗时性能日志
HTML 报告 (v10.3)
- 自动保存至脚本目录 +
/www/wwwroot/tc.mjhg.cn/pub/目录（若存在），文件名含预测期号 + 日期 + 时间，v9.4+ 全移动端自适应 - 章节：期号信息卡片（含预测期号横幅） · 近10期开奖记录 · 数字频率表 · 连续两期和值模式匹配（含排列五完整号码） · 外部预测近15期命中表
- 🎯 推荐号码区：5 大模块卡片（外部精选 / 内部精选遗漏 / 热度上升 / 和值范围 / 位置遗漏推荐 / 目标期高频） + 🏆 综合推荐5号码渐变卡片 + 数字综合评分紧凑面板
- 🏆 精选号码（组选） Top 10 评分表 · 🎯 直选（定序）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（同目录本地 Excel）；② pl5_asc.txt 排列五原始文本；③ 网络数据抓取（缓存至 pl3_cache.json，1小时有效）；④ Mock 兜底数据生成保证系统稳定运行。
🔖 主要版本迭代
| 版本 | 日期 | 核心更新 |
|---|---|---|
| v10.3 | 2026-08-26 | 组选 Top 10 区块明确命名：原"精选号码 Top 10"改为"精选号码（组选） Top 10"，与 v10.2 新增的"直选（定序）Top 10"区分更清晰（组选=数字集合升序、直选=百十个位定序）。版本号统一升级为 v10.3（header/副标题/HTML报告标题/页脚/argparse/banner/运行时日志）；历史特性注释(data驱动权重、直选Top10 的 v10.2 引入说明)保留不误改。 |
| v10.2 | 2026-08-26 | 模块权重改为数据驱动重算，取代原 compute_comprehensive_module_weights 的"HTML 报告解析法"：扩展 compute_voting_backtest 在同一 walk-forward 循环内逐期累计 internal/hot/pos/target 四模块命中/覆盖，换算技巧分(命中0.7/覆盖0.3)→归一化 5 模块权重（external 保留内置默认）；消除时间错配与对报告累积/HTML 抓取的脆弱依赖。新增"直选（定序）Top 10"：百/十/个各从本位置分析派生，位置有真实意义（非随机/非组选升序）。 |
| v10.1 | 2026-08-12 | 位置最大遗漏推荐每位置只保留 1 个最大遗漏数字（原前3个）：报告"推荐号码"卡片、位置遗漏详表、综合推荐 5 号码投票自动同步，位置模块从"最多9个候选各1票"收窄为"最多3个各1票"；实际运行口径与回测（compute_voting_backtest 每位置 top-1）对齐，pos 权重 1.000 的评估基准名副其实，综合推荐 5 号码构成随票面收窄而重排。版本号统一更新为 v10.1，保留 v10 版本。 |
| v10 | 2026-08-10 | 模块权重公式优化（134期回测，命中提升×0.7+覆盖提升×0.3）：原 v9.7 技巧分 = (命中提升+覆盖提升)/2（等权），现改为 技巧分 = 命中提升×0.7 + 覆盖提升×0.3，更关注实际中奖数字的价值（命中数 > 覆盖率）。内置默认权重更新：外部0.729 / 内部0.971 / 热度0.953 / 位置1.000 / 目标0.889。 综合推荐5号码排序增强：在"模块权重×票数"的基础上，新增"模块来源多样性"作为第二排序键（被 N 个不同模块共同推荐的数字更稳定，加 N×0.05 分作为 tiebreak），最终排序键：(加权票数, 模块多样性×alpha, 综合评分total_score)。 compute_comprehensive_module_weights() 同步使用 0.7/0.3 加权技巧分，运行时基于 pub 报告重算覆盖内置默认；报告横幅与 footer 版本号统一升级为 v10；保留 v9.9/v9.8 版本。 |
| v9.9 | 2026-08-07 | 算法层全面性能优化（功能与 v9.8 等效，已通过等效性验证）：① 组合生成移除无效 set(permutations) 去重（combinations_with_replacement 已是有序元组，所有排列合并为同一 key），O(排列数)→O(1)；② 网格搜索预计算 freq_prefix / missing_at 前缀数组，单次评分 O(N²×10)→O(10) 查表，N=1000 期约 1000x 提速；③ walk-forward 回测用 last_seen 增量跟踪替代每 i 反扫全历史，O(N²)→O(N)；④ global_missing 由 O(N×10) 反扫改为 O(N) 单遍 last_seen；⑤ 循环外排序消除重复 sorted。逻辑修正：_precompute_score_arrays 频率统计对每期号码先 set 去重避免组三/豹子号重复计数；predict 中 top_digits 重名为 top_digits_by_score/top_digits_by_repeat。代码清理：移除重复 timing_decorator、json/glob/re/math 提至模块顶部、魔法数 300 替换为 Constants.FREQ_WINDOW_DIGITS。保留 v9.8 版本。 |
| v9.8 | 2026-08-07 | 报告"推荐号码"模块新增预测期号与预测开奖日期横幅（基于最新一期+1期/日期+1天推算）；报告排版响应式升级（容器宽度 min(1480px,96vw)、标题 clamp() 流式字号、六宫格窄屏 3→2→1 列、宽表格 .table-scroll 横向滚动，适配更多分辨率）；理顺三者关系并可视化——新增"数字综合评分(0-9)"紧凑面板高亮综合推荐5个数字，精选号码 Top10 每行标注"含综合推荐X个"，使"数字评分→综合推荐→精选号码"链路可见。 |
| v9.7 | 2026-08-07 | 真实历史回测驱动权重修正：解析 pub 目录 133 期 HTML 报告"推荐号码"模块，与 pl3_cache.json 真实开奖逐期对比 5 模块（外部精选/内部精选/热度上升/位置遗漏/目标高频）。结论：各模块真实命中与随机基准无显著差异(提升0.89x~1.03x)，仅报告自带3位共识略高于随机(0.820 vs 0.792)。据此将综合推荐模块权重由等权改为数据驱动加权（外部0.61/内部0.91/热度0.93/位置1.00/目标0.82），低于随机的模块自动降权；新增 compute_comprehensive_module_weights() 运行时可基于 pub 报告重算权重（可复现，非硬编码）。 |
| v9.6 | 2026-08-07 | 方法学修复（延续 v9.5 诚信路线）：② 网格搜索维度与代理评分对齐(freq/missing/hot_cold)并增加默认基线守卫，避免过拟合噪声；⑤ 组三/组六口径一致（移除"偏离即强烈推荐"臆测、组合内组型评分中性化、注数按理论概率分配）；⑧ 和值范围改用经验高概率和值并集，不再对区间端点取平均；⑨ AC/跨度由乘法缩放改为有界加性修正；⑩ 两期和值模式匹配增加显著性检验，未通过则清空胆码池降权；⑪ 外部预测权重默认 1.6→1.2（实测仅~52%任中）。 |
| v9.5 | 2026-08-07 | 诚信修正：移除不可复现的"89.9%任中率"宣传，改为可复现 walk-forward 回测（真实任中率与随机基准≈87.5%无显著差异）；数据获取失败强制红色告警；等权投票真正按模块等权、候选池保留冷号、移除死代码、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 | 🌌 新增号码空间全局分析模块（000-999 从未出现号码、历史 Top/Bottom10、遗漏 Top30、六大策略推荐、类型分布）。 |
| v9.0 | 2026-05-09 | 9 维度权重全面调整：遗漏/外部/模式/热度/回测分加权，频率/冷热/位置/重复分降权；六大策略推荐卡片改为 3 列。 |
| v8.9 | 2026-05-09 | 数据缓存（pl3_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%"宣传语，改为可复现回测：历史回测真实任中率与随机基准（约 87.5%）无显著差异，系统不具备预测优势，切勿期望稳定盈利。请理性参与，切勿沉迷。
- 系统作者不对使用本工具产生的任何损失负责。
- 外部预测数据源可能存在延迟或变更，建议定期更新本地 Excel 数据或确保缓存及时刷新，以保证分析时效。
- 服务器部署需安装依赖：
pip install pandas numpy requests openpyxl；EXE 打包可参考仓库build_exe.bat。 - 系统保留历史版本脚本（v9.x、v8.x 等），可按文件名按需切换使用。