期差绝对值查询器 - 安装部署文档

软件名称：期差绝对值查询器摸球校尉版
版本：v2.0
更新日期：2025年

本文档说明软件的安装、运行环境、分发包结构、打包方法及服务器端配置，面向最终用户与发布/运维人员。

一、面向最终用户（推荐方式）

1.1 获取软件

• 从发行方获取 分发包压缩包（如 期差绝对值查询器摸球校尉版v2.0_分发包.zip）。
• 解压到任意目录（建议路径不含空格和特殊字符，如 D:\期差绝对值查询器）。

1.2 运行要求

1.3 安装与运行（无需“安装”）

• 无需安装：本软件为绿色版，解压即用。
• 运行方式：双击 期差绝对值查询器摸球校尉版v2.0.exe。
• 首次运行：
• 程序会在 exe 同目录下自动创建：
• data/：存放开奖数据、分析历史、主题、备份、许可证等。
• registration/：注册与激活用文件（公钥、licenses 等），仅含运行与激活所需内容。
• 自动进入 7 天免费试用；试用期满后需激活才能继续使用。

1.4 分发包目录结构（解压后典型结构）

期差绝对值查询器摸球校尉版v2.0_分发包/
├── 期差绝对值查询器摸球校尉版v2.0.exe   # 主程序
├── 启动说明.txt                         # 可选
├── 数据文件夹说明.txt                   # 可选
└── （其他说明文档，若有）

运行后由程序自动生成：

（同上）
├── data/                    # 数据目录
│   ├── 3D_data.txt          # 3D 历史数据（更新后生成）
│   ├── P3_data.txt
│   ├── P5_data.txt
│   ├── trial.json           # 试用信息（试用期内）
│   ├── license.json         # 许可证（激活后）
│   ├── theme_setting.json
│   ├── analysis_history/
│   └── backups/
└── registration/            # 注册相关（程序自动生成）
    ├── keys/
    │   └── public_key.pem
    ├── licenses/            # 用户可放置许可证文件
    └── （若干 .py 模块，仅激活用）

1.5 注意事项

• 请勿删除 data 与 registration 目录及其中的必要文件，否则可能导致数据丢失或无法激活。
• 若杀毒软件或防火墙提示，请将 exe 或安装目录加入信任/白名单。
• 如需在多台电脑使用，每台电脑需单独试用或单独激活（按设备绑定）。

二、从源码运行（开发/调试）

2.1 环境要求

• Python：3.8 或更高。
• 依赖：见项目根目录 requirements.txt。

2.2 安装步骤

# 进入项目根目录
cd 期差绝对值查询器

# 安装依赖
pip install -r requirements.txt

2.3 启动程序

python main.py

或使用项目提供的 启动程序.bat（若有）。

2.4 开发环境下 registration 与 data

• registration 目录需存在于项目根目录，且包含 client_registration.py、client_license_validator.py、production_registration_core.py 及 keys/public_key.pem 等（见《注册系统文档》）。
• 数据目录 data 会在首次运行时在程序工作目录下创建。

三、打包与创建分发包（Windows）

3.1 一键打包（推荐）

在项目根目录执行：

打包并创建分发包.bat

该脚本通常会：

1. 检查 Python、PyInstaller 及项目依赖。
2. 清理旧的 build、dist 及 dist\registration（若存在）。
3. 使用 期差绝对值查询器摸球校尉版v2.0.spec 调用 PyInstaller 生成单文件 exe。
4. 将生成的 exe 复制到指定位置。
5. 创建分发包目录，复制 exe 与说明文件，并打包为 zip（如 期差绝对值查询器摸球校尉版v2.0_分发包.zip）。

3.2 手动打包

pip install pyinstaller
pip install -r requirements.txt

pyinstaller 期差绝对值查询器摸球校尉版v2.0.spec --clean --noconfirm

生成 exe 位于 dist\期差绝对值查询器摸球校尉版v2.0.exe（以 spec 中配置为准）。

3.3 spec 与 registration 打包策略

• spec 的 datas：仅包含注册激活所需文件，例如：
• client_license_validator.py、client_registration.py、production_registration_core.py
• keys/public_key.pem
• 不打包：注册管理工具、私钥、开发用许可证等。
• 运行期：exe 启动时会在 exe 同目录生成 registration 文件夹，仅包含上述文件及空目录 licenses/，供用户放置许可证。

详见《注册系统文档》及项目 spec 文件。

四、服务器端验证（FTP）

4.1 作用

• 试用开始时间与设备 ID 上传至服务器，防止同一设备重复获得 7 天试用。
• 激活成功后可将许可证信息上传，便于发行方统计与管理。

4.2 配置位置

• FTP 地址、账号、端口及软件专用目录由程序或 ftp_uploader 模块配置。
• 本软件在服务器上使用独立目录（如「期差绝对值查询器」），与其它产品隔离。

4.3 网络要求

• 用户端需能访问该 FTP 服务器（首次试用、启动时同步、激活上传时）。
• 离线时仅使用本地已有试用/许可证信息。

五、故障排查（安装与运行）

更多问题见《故障排除文档》。

六、相关文档

• 用户使用：《用户使用手册》
• 试用与激活：《注册系统文档》
• 问题排查：《故障排除文档》
• 开发与接口：《开发者文档》《API_REFERENCE》

文档版本：2.0
最后更新：2025年