小飞刀 - 用户使用说明
软件下载地址：https://api.csh.space/api/v1/downloads/go?site=www&file=%E5%B0%8F%E9%A3%9E%E5%88%80_20261008.zip
一、软件简介
小飞刀是一款 3D/P3 号码历史开奖次数查询 工具，支持：
· 联网更新 3D、P3 开奖数据
· 输入一批号码，查询每个号码在历史开奖中的出现次数
· 按次数分类展示与导出（TXT / CSV / Excel）
· 近期 N 期统计、期号范围筛选、冷热号排行
· 试用与授权激活（7 天试用，到期需激活后继续使用）
·
二、运行与界面
运行方式
· 分发包：双击 启动小飞刀.bat 或 小飞刀\小飞刀.exe
· 源码运行：在项目根目录执行 python main_gui.py 或 启动程序.bat
主界面概览
· 顶部：彩种选择（3D / P3）、联网更新开奖数据、取消更新、注册/激活、状态提示
· 选项行：近期（0=全部 / 50 / 100 / 200 / 500 期）、统计期数（可选，填则按该期数统计最近 N 期）、排序（高→低 / 低→高）、数据信息（期数、期号范围、更新时间）
· 输入区：输入要查询的号码（支持空格、逗号分隔，每号三位数字；4 位按前 3 位统计）
· 按钮行：仅查询、导出 TXT/CSV/Excel、从文件导入、全部号码(000-999)、清空输入
· 结果区：按次数分类结果、从未开出号码、冷热排行预览
· 底部：版本、作者、QQ 群、邮箱、微信、版权与滚动广告
·
三、基本流程
· 选择彩种：3D 或 P3。
· 加载数据：点击「联网更新开奖数据」，等待更新完成（可点「取消更新」放弃）。
· 输入号码：在输入框中输入要查询的号码，如 123 456 789 或 123,456,789，支持多行。
· 仅查询：点击「仅查询」，结果区会显示按次数分类及冷热排行；状态栏会显示解析与去重提示。
· 导出：需要保存时点击「导出 TXT」「导出 CSV」或「导出 Excel」，选择保存路径即可。
·
四、功能说明
数据与统计
· 近期统计：在「近期」下拉选择 50 / 100 / 200 / 500 期，则统计仅基于最近 N 期；选 0 为全部历史。
· 统计期数：在「统计期数」框内直接填入数字（如 1000）时，按最近该期数进行统计；不填则按上方「近期」选择（0=全部，或 50/100/200/500 期）。
· 冷热排行：结果区底部会显示最热 50、最冷 50 的号码及出现次数。
· 排序：可选「高→低」（出现次数从多到少）或「低→高」（从少到多）。
查询与导出
· 仅查询：只刷新结果区，不弹出保存对话框。
· 导出 TXT/CSV/Excel：基于当前结果导出；若未先执行「仅查询」或「全部号码」，会提示先查询再导出。
· 全部号码(000-999)：对 000～999 共 1000 个号码做统计，适合做冷热表再导出。
输入与操作
· 从文件导入：菜单「文件 → 从文件导入号码」或按钮「从文件导入」，支持 TXT/CSV（每行一个或一行多个号码）。
· 清空输入：清空输入框内容。
· 右键菜单：输入区、结果区支持右键全选、复制、剪切、粘贴。
快捷键
快捷键功能
F5联网更新开奖数据
Ctrl+Enter仅查询
Ctrl+L清空输入
设置（菜单「设置 → 设置…」）
· 代理：如 http://127.0.0.1:7890，用于无法直连 联网更新 时。
· 超时(秒)、重试次数：网络请求超时与重试。
· 启动时检查更新：是否在启动时后台检查是否有新期数据并提示。
· 主题：浅色 / 深色。
· 字体大小：9～18。
数据备份与恢复（菜单「文件」）
· 数据备份：将当前 data 目录打包为 ZIP。
· 从备份恢复：从 ZIP 恢复 data，会覆盖当前数据。
·
五、注册与激活
· 试用期默认 7 天；到期未激活会弹出激活窗口，关闭后程序将退出。
· 点击「注册/激活」或菜单「帮助 → 注册/激活…」可查看试用状态、设备 ID 并导入授权文件。
· 详细说明见 注册与激活说明.md。
·
六、常见问题
· 更新失败 / 未解析到数据：检查网络与代理设置；确认 www.baidu.com 可访问。
· 导出 Excel 失败：需安装 openpyxl（分发包已包含；源码运行请执行 pip install openpyxl）。
· 激活成功但服务器同步失败：本地已激活可用；若提示 550 或“无此目录”，请在 FTP 服务器上手动创建「小飞刀」目录后重试。