小飞刀 - 用户使用说明

一、软件简介

小飞刀是一款 3D/P3 号码历史开奖次数查询与统计分析 工具，支持：

• 联网更新 3D、P3 开奖数据
• 输入一批号码，查询每个号码在历史开奖中的出现次数
• 按次数分类展示与导出（TXT / CSV / Excel）
• 近期 N 期统计、统计期数、期号范围筛选、冷热号排行
• 高级统计：百/十/个位频率、和值分布、跨度分布、大小比/奇偶比、形态分类（豹子/组三/组六）
• 遗漏分析：当前遗漏、最大遗漏、平均遗漏排行
• 单号追溯：查某号码历史开出的全部期号与日期
• 试用与授权激活（7 天试用，到期需激活后继续使用）

二、运行与界面

运行方式

• 分发包：双击 启动小飞刀.bat 或 小飞刀\小飞刀.exe
• 源码运行：在项目根目录执行 python main_gui.py 或 启动程序.bat

主界面概览

• 顶部：彩种选择（3D / P3）、联网更新开奖数据、取消更新、注册/激活、状态提示
• 选项行 1：近期（0=全部 / 50 / 100 / 200 / 500 期）、统计期数（可选，填则按该期数统计最近 N 期）、排序（高→低 / 低→高）、数据信息（期数、期号范围、更新时间）
• 选项行 2：期号范围（起 ~ 止，可选，留空=不限；与「近期/统计期数」同时有效时取交集）
• 输入区：输入要查询的号码（支持空格、逗号分隔，每号三位数字；4 位按前 3 位统计）
• 按钮行：仅查询、导出 TXT/CSV/Excel、从文件导入、全部号码(000-999)、单号追溯、清空输入
• 结果区：按次数分类结果、从未开出号码、冷热排行、高级统计、遗漏分析
• 底部：版本、作者、QQ 群、邮箱、微信、版权与滚动广告

三、基本流程

1. 选择彩种：3D 或 P3。
2. 加载数据：点击「联网更新开奖数据」，等待更新完成（可点「取消更新」放弃）。
3. 设置范围（可选）：

• 在「近期」下拉选 50/100/200/500 期，或
• 在「统计期数」框直接填入数字（如 1000），或
• 在「期号范围」起止框填入期号（如 2024001 ~ 2024365）。
• 三者可组合使用，最终取交集；不填则默认全部历史。

1. 输入号码：在输入框中输入要查询的号码，如 123 456 789 或 123,456,789，支持多行。
2. 仅查询：点击「仅查询」，结果区会显示按次数分类、冷热排行、高级统计、遗漏分析；状态栏会显示解析与去重提示。
3. 导出：需要保存时点击「导出 TXT」「导出 CSV」或「导出 Excel」，选择保存路径即可。

四、功能说明

数据与统计

• 近期统计：在「近期」下拉选择 50 / 100 / 200 / 500 期，则统计仅基于最近 N 期；选 0 为全部历史。
• 统计期数：在「统计期数」框内直接填入数字（如 1000）时，按最近该期数进行统计；不填则按上方「近期」选择（0=全部，或 50/100/200/500 期）。
• 期号范围：在「期号范围」起止框填入期号（如 2024001 ~ 2024365），仅统计该期号区间内的开奖；留空表示不限。可与「近期/统计期数」组合使用，取交集。
• 冷热排行：结果区底部会显示最热 50、最冷 50 的号码及出现次数。
• 排序：可选「高→低」（出现次数从多到少）或「低→高」（从少到多）。

高级统计（结果区中部）

每次查询后结果区会自动追加「【高级统计】」段，包含：

• 位置频率：百位 / 十位 / 个位 0-9 各自出现次数及占比（基于当前筛选范围的总期数）。
• 和值分布：三位数字相加之和（0-27）各值的出现次数。
• 跨度分布：最大数字 - 最小数字（0-9）各值的出现次数。
• 大小比分布：5-9 为大、0-4 为小，按 0大3小 / 1大2小 / 2大1小 / 3大0小 四类汇总。
• 奇偶比分布：1/3/5/7/9 为奇、0/2/4/6/8 为偶，按 0奇3偶 / 1奇2偶 / 2奇1偶 / 3奇0偶 四类汇总。
• 形态分类：豹子（三同，如 111）、组三（两同，如 112）、组六（三不同，如 123）三类数量。

遗漏分析（结果区底部）

每次查询后结果区会自动追加「【遗漏分析】」段，给出：

• 当前遗漏前 30：从最新一期回溯，每个号码距上次开出的期数；越大表示越「冷」（一直未出）。
• 最大遗漏前 30：历史上最长未出现的连续期数。
• 平均遗漏前 30：总期数 / 出现次数，反映平均出现间隔；从未开出的号码此处等于总期数。

遗漏与高级统计均基于当前筛选后的数据范围计算。若用「期号范围」筛选，则「最新一期」为范围内最后一期。

查询与导出

• 仅查询：只刷新结果区，不弹出保存对话框。
• 导出 TXT/CSV/Excel：基于当前结果导出；若未先执行「仅查询」或「全部号码」，会提示先查询再导出。
• 全部号码(000-999)：对 000～999 共 1000 个号码做统计，适合做冷热表再导出。
• 单号追溯：打开追溯窗口，输入一个三位号码（默认取输入框选中文本或仅一个号码时自动填入），点击「查询」或回车，列出该号码在当前筛选范围内的全部开出期号与日期，按期号降序排列。在该窗口内可反复输入不同号码查询，不影响主界面结果区。

输入与操作

• 从文件导入：菜单「文件 → 从文件导入号码」或按钮「从文件导入」，支持 TXT/CSV（每行一个或一行多个号码）。该功能仅读取本地文件、使用独立解析器，与联网更新流程互不影响。
• 清空输入：清空输入框内容。
• 右键菜单：输入区、结果区支持右键全选、复制、剪切、粘贴。

快捷键

数据备份与恢复（菜单「文件」）

• 数据备份：将当前 data 目录打包为 ZIP。
• 从备份恢复：从 ZIP 恢复 data，会覆盖当前数据。

五、注册与激活

• 试用期默认 7 天；到期未激活会弹出激活窗口，关闭后程序将退出。
• 点击主界面右上角「注册/激活」可查看试用状态、设备 ID 并导入授权文件。
• 激活方式为本地 RSA 验签，无需联网；详细说明见 注册与激活说明.md。

六、常见问题

• 更新失败 / 未解析到数据：检查网络连接；确认 www.baidu.com 可访问。如遇「请求过于频繁」提示，请等待 1-2 分钟后重试（程序已内置 429 退避机制）。
• 导出 Excel 失败：需安装 openpyxl（分发包已包含；源码运行请执行 pip install openpyxl）。
• 遗漏/高级统计为空：请确认已加载并选中彩种，且「期号范围/近期/统计期数」筛选后仍有数据。
• 单号追溯查不到：在当前筛选范围内未开出该号码属正常现象，可放宽范围（如改为 0=全部）后重试。