一款面向福彩3D / 排列三的桌面选号辅助工具,按最近一期开奖号码,分别统计 100 期、300 期(及自定义期数)内各位置"同数字出现后下一期该位开出什么",给出百/十/个位的热码定位结果,适合想从历史数据观察短期热码分布的玩家。
一、这是什么 / 适用场景
- 核心逻辑:给定最近一期开奖号(如
123),在历史数据里找出"百位是 1"的所有记录,统计这些记录下一期百位开出的 0–9 各多少次,取次数最多的 3 个作为百位热码;十位、个位同理。100 期与 300 期各做一遍,便于对照短期与中期。 - 结果格式:
百位abc/十位def/个位ghi,数字按出现次数从大到小排列,并附详细统计百位: 5(8次), 3(6次), 7(5次)。 - 典型场景:①观察某位数字的"后继热码";②同时分析多个期数(如 50,100,200,300)做对比;③批量分析多个号码;④把结果导出为 TXT/CSV 留档。
- 数据源:
http://data.17500.cn/3d_asc.txt(3D)、http://data.17500.cn/pl3_asc.txt(P3)。
二、环境准备与安装启动
- 系统要求:Windows(已测试),Python 3.7+,联网用于更新数据。
- 依赖:
requests>=2.31.0、pandas>=2.0.0(见requirements.txt)。 - 启用方式:
- 推荐:双击
启动程序.bat——脚本先检查 Python,再检测并自动pip install requests / pandas,最后执行python main.py。 - 或手动:
pip install -r requirements.txt后执行python main.py。 - 首次使用需点「更新数据」联网下载;之后程序会自动从
data_cache/加载缓存,无需重复下载。
三、快速上手(第一次怎么用)
- 双击
启动程序.bat打开「中短期热码定位选号器」窗口。 - 顶部选择数据类型「3D」或「P3」。
- 点「更新数据」(或按 Ctrl+U / F5),联网拉取历史开奖数据;数据加载后工具栏会显示
3D: 最新2024001期 | 2024-01-01 | 最早2023001期 | 共1000期这样的范围信息。 - 输入最近一期开奖号(格式 3 位,如
123),或点「自动获取最新」自动填充。 - 「分析期数」默认
100,300,可改成50,100,200,300(英文逗号分隔)。 - 点「开始分析」(或 Ctrl+A);输入区右侧依次显示"正在分析… → 正在分析100期数据… → 正在分析300期数据… → 正在生成结果… → 分析完成!",完成后 2 秒自动清除。
- 在各期数标签页查看定位结果与详细统计;需要时点「一键复制」或「导出结果」(Ctrl+E)。
四、核心功能详解
- 热码定位分析(核心):入口「开始分析」。对目标期号逐位做"同数字 → 下一期该位数字"频次统计,每位取 Top3。支持自定义期数(
分析期数输入框,逗号分隔,如50,100,200,300),每个期数一个结果标签页;默认 100,300。分析在后台线程进行,不会卡住界面,期间「开始分析」按钮禁用防重复点击。 - 统计次数详情:结果不只给数字,还给出每个推荐数字的实际出现次数,格式如
百位: 5(8次), 3(6次), 7(5次);按次数降序、次数相同按数字升序;分析器内部保留 0–9 的完整次数字典。 - 数据持久化缓存:数据更新后和程序关闭时自动把数据存到
data_cache/data_3d.pkl、data_p3.pkl,并写元信息data_3d_meta.json、data_p3_meta.json(保存时间、数据量、最新/最早期号);启动时自动加载,缓存损坏会自动清除;工具栏「清除缓存」按钮可手动清掉重新下载。 - 数据信息与进度提示:工具栏右侧蓝色文字显示数据类型、最新期号/日期、最早期号、总期数,数据加载/更新/切换类型时自动刷新;输入区右侧显示实时分析进度。
- 数据验证与更新:更新后做数据完整性检查(失败给出友好错误提示和解决建议);工具栏「更新数据」(Ctrl+U/F5)联网拉取,并有自动更新提醒(检测到数据较旧时提示)。
- 批量分析:入口「批量分析」按钮,弹窗中每行输入一个号码,一次分析多个号码并生成对比报告,报告按号码和期数分类,可复制或导出。
- 历史记录:每次分析会写入
history/analysis_history.json;「历史记录 (Ctrl+H)」打开历史窗口,方便回顾之前的分析。 - 结果导出:「导出结果 (Ctrl+E)」支持 TXT(完整分析报告)和 CSV(表格,便于 Excel 再分析)两种格式;分析结果区有「一键复制」。
- 数据统计面板:「数据统计 (Ctrl+S)」打开统计面板,展示数据分布信息。
- 快捷键:Ctrl+N 清除输入、Ctrl+A 开始分析、Ctrl+U / F5 更新数据、Ctrl+E 导出、Ctrl+H 历史记录、Ctrl+S 数据统计、Escape 关闭弹窗。
- 其他:「自动获取最新」从当前数据取最新一期开奖号填入输入框;界面文本目前为中文(多语言仅为预留扩展,未实装)。
五、近期更新功能(重点)
未发现 2026-05 之后发布新功能或改版的说明文档:README.md(2026-04-05)、各改进功能说明(2025-12-01)均早于 2026-05;main.py 等代码文件为 2025-12。依据文件时间戳可确认的是软件在 2026-05 之后仍被持续使用(以下为依据文件时间戳推断):
- 2026-10-16 缓存与历史记录更新:
data_cache/data_3d.pkl、data_p3.pkl及对应_meta.json、history/analysis_history.json在该日更新。影响:说明"数据自动缓存 + 启动秒开"和"分析历史记录"两项功能在该日期正常使用;用户再次打开程序时会直接加载 10 月 16 日缓存,无需重新联网下载,并可在「历史记录」中回顾当天分析。 - 说明:以上是运行产物的更新,不代表新增功能。本软件最后一次有据可查的功能增强是 2025-12 的一批改进(数据持久化、统计次数详情、数据信息展示、进度提示、自定义期数、导出、批量分析、数据验证、历史记录、快捷键、统计面板等)以及 2026-04-05 的 README 更新,均不在"近半年"窗口内,故不列为近期更新。
六、常见问题与排错(FAQ)
- 更新数据失败:检查网络连接,确保能访问
data.17500.cn(3D 用 3d_asc.txt,P3 用 pl3_asc.txt)。 - 分析结果为空 / 提示数据不足:先确认已「更新数据」,且数据量足够(README 提示至少 100 期);自定义期数不要超过实际数据量。
- 如何手动安装依赖:
pip install -r requirements.txt;或直接运行启动程序.bat,它会自动检测并安装 requests、pandas。 - 启动后没有数据、想重新下载:点「清除缓存」删除
data_cache/中的 pkl 与 meta 文件,再点「更新数据」。缓存不会自动更新,需手动更新。 - 分析时按钮点不动:正常现象——分析在后台线程执行,期间「开始分析」按钮被禁用以防重复点击;看输入区右侧进度提示即可。
- 结果次数都是 0 或数值异常:说明历史数据不足或缓存已过期,更新数据后重试;统计结果基于历史数据,仅供参考。
- 快捷键不起作用:确认焦点在主窗口而非文本框快捷键冲突;按钮文字上标注了对应快捷键(Ctrl+A/U/E/H/S、Ctrl+N、F5)。
七、补充信息
- 目录:
data_cache/(pkl 数据缓存与 meta 元信息)、history/analysis_history.json(分析历史)、main.py(GUI 主程序)、analyzer.py(热码分析算法)、data_fetcher.py(联网取数)、requirements.txt、启动程序.bat。 - 分析口径:以"最近一期开奖号码"为参照,对每一位分别找出历史中该位等于目标数字的期,统计其后一期同位的 0–9 出现次数,取前 3;100 期与 300 期(或自定义期数)各自独立统计。
- 相关改进文档:
改进建议.md(需求清单)、已实现改进.md(第一批 3 项)、中优先级改进功能说明.md(5 项)、低优先级改进功能说明.md(6 项),均写明了"改进前 → 改进后"的对照,是理解当前功能来源的参考。 - 风险提示:开奖为独立随机事件,本软件仅对历史数据做转换、统计与展示,无法预测未来结果、无中奖承诺,不依赖任何分析工具作为购彩依据;理性购彩,通过官方渠道购彩。