2码稳定底王 - 安装部署文档

📚 目录

1. 系统要求
2. 安装步骤
3. 配置说明
4. 打包发布
5. 部署说明
6. 故障排除

💻 系统要求

最低要求

• 操作系统: Windows 7 SP1 (64位) 或更高版本
• Python版本: Python 3.6 或更高版本
• 内存: 512MB RAM
• 硬盘空间: 100MB 可用空间
• 网络: 需要网络连接（用于获取开奖数据）

推荐配置

• 操作系统: Windows 10/11 (64位)
• Python版本: Python 3.8 或更高版本
• 内存: 1GB RAM 或更多
• 硬盘空间: 500MB 可用空间
• 网络: 稳定的网络连接

📦 安装步骤

方法1：从源码安装（开发环境）

步骤1：下载源码

# 如果有Git仓库
git clone <repository-url>
cd 2码稳定底王

# 或直接下载ZIP文件并解压

步骤2：安装Python

1. 访问 Python官网
2. 下载Python 3.6或更高版本
3. 运行安装程序
4. 重要: 勾选"Add Python to PATH"
5. 完成安装

步骤3：安装依赖

Windows用户（推荐）:

# 双击运行
安装依赖.bat

手动安装:

# 打开命令提示符（CMD）或PowerShell
cd 2码稳定底王

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

步骤4：验证安装

# 检查Python版本
python --version

# 检查依赖是否安装
pip list | grep -E "requests|pandas|openpyxl|cryptography"

步骤5：启动程序

Windows用户（推荐）:

# 双击运行
启动程序.bat

手动启动:

python main.py

方法2：使用打包的exe（最终用户）

步骤1：下载exe文件

从发布页面下载打包好的exe文件。

步骤2：运行exe

1. 双击exe文件
2. 如果提示缺少DLL，安装Visual C++ Redistributable
3. 首次运行会提示试用或注册

⚙️ 配置说明

配置文件位置

• 开发环境: config.py
• 打包后: 配置文件已编译到exe中

主要配置项

网络配置

# config.py
REQUEST_TIMEOUT = 15  # 请求超时时间（秒）
DATA_URLS = {
    '3D': '[数据源地址已隐藏]
    'P3': '[数据源地址已隐藏]
}

UI配置

# config.py
WINDOW_WIDTH = 900
WINDOW_HEIGHT = 750
WINDOW_TITLE = "2码稳定底王 v1.5"

数据目录配置

数据文件默认保存位置：

• 开发环境: 脚本所在目录的 data 文件夹
• 打包后的exe: exe所在目录的 data 文件夹

环境变量（可选）

可以设置以下环境变量：

• LOTTERY_DATA_DIR: 自定义数据保存目录
• LOTTERY_LOG_LEVEL: 日志级别（DEBUG, INFO, WARNING, ERROR）

📦 打包发布

使用PyInstaller打包

步骤1：安装PyInstaller

pip install pyinstaller

步骤2：创建打包脚本

创建 build_exe.bat:

@echo off
echo 开始打包...

pyinstaller --onefile ^
    --windowed ^
    --name="2码稳定底王" ^
    --icon=icon.ico ^
    --add-data "registration;registration" ^
    --add-data "config.py;." ^
    --hidden-import=tkinter ^
    --hidden-import=pandas ^
    --hidden-import=openpyxl ^
    --hidden-import=cryptography ^
    main.py

echo 打包完成！
pause

步骤3：执行打包

build_exe.bat

步骤4：测试打包结果

1. 进入 dist 目录
2. 运行生成的exe文件
3. 测试所有功能
4. 检查文件大小是否合理

打包选项说明

• --onefile: 打包成单个exe文件
• --windowed: 不显示控制台窗口
• --name: 指定exe文件名
• --icon: 指定图标文件
• --add-data: 添加数据文件
• --hidden-import: 隐藏导入的模块

打包注意事项

1. 文件大小: 打包后的exe文件可能较大（50-100MB），这是正常的
2. 首次启动: 首次启动可能较慢，因为需要解压文件
3. 杀毒软件: 某些杀毒软件可能误报，需要添加白名单
4. 依赖检查: 确保所有依赖都已正确打包

🚀 部署说明

单机部署

1. 复制文件

• 将exe文件复制到目标目录
• 或解压ZIP文件到目标目录

1. 创建快捷方式

• 右键exe文件
• 选择"创建快捷方式"
• 将快捷方式放到桌面或开始菜单

1. 首次运行

• 双击exe文件
• 选择"开始试用"或"激活/注册"

批量部署

1. 准备安装包

• 创建安装包（ZIP或安装程序）
• 包含exe文件和说明文档

1. 分发安装包

• 通过邮件、网盘等方式分发
• 或创建下载页面

1. 用户安装

• 用户解压或运行安装程序
• 按照说明文档操作

网络部署

如果需要通过网络部署：

1. 创建安装脚本

   @echo off
   echo 正在下载2码稳定底王...
   # 下载exe文件
   echo 下载完成！

1. 配置下载服务器

• 上传exe文件到服务器
• 配置下载链接

1. 用户下载安装

• 用户访问下载链接
• 下载并运行exe文件

🔧 故障排除

问题1：Python未安装或版本不对

症状: 提示"python不是内部或外部命令"

解决方法:

1. 检查Python是否安装
2. 检查PATH环境变量
3. 重新安装Python并勾选"Add Python to PATH"

问题2：依赖包安装失败

症状: pip install失败或提示缺少模块

解决方法:

1. 升级pip: python -m pip install --upgrade pip
2. 使用国内镜像源:

   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

1. 逐个安装依赖包，查看具体错误

问题3：打包后的exe无法运行

症状: 双击exe后没有反应或报错

解决方法:

1. 检查是否有杀毒软件阻止
2. 检查是否缺少Visual C++ Redistributable
3. 在命令行运行exe查看错误信息
4. 检查是否有文件权限问题

问题4：网络功能无法使用

症状: 无法获取开奖数据

解决方法:

1. 检查网络连接
2. 检查防火墙设置
3. 检查代理设置
4. 访问 [数据源地址已隐藏] 确认网站可访问

问题5：数据文件无法保存

症状: 导出功能失败或文件无法保存

解决方法:

1. 检查data目录是否有写入权限
2. 检查磁盘空间是否充足
3. 检查文件是否被其他程序占用
4. 尝试以管理员身份运行

📋 部署检查清单

开发环境

• [ ] Python 3.6+ 已安装
• [ ] 所有依赖包已安装
• [ ] 程序可以正常启动
• [ ] 所有功能测试通过
• [ ] 日志系统正常工作

打包环境

• [ ] PyInstaller已安装
• [ ] 打包脚本已创建
• [ ] 打包成功无错误
• [ ] exe文件可以正常运行
• [ ] 所有功能测试通过

部署环境

• [ ] 目标系统满足要求
• [ ] 安装包已准备
• [ ] 用户文档已准备
• [ ] 技术支持联系方式已提供
• [ ] 测试环境已验证

📞 技术支持

如果在安装或部署过程中遇到问题，请通过以下方式获取帮助：

• 邮箱: moqiuxiaowei@qq.com
• QQ群: 253799100 摸金门
• 微信号: moqiuxiaowei

提供问题时，请附上：

1. 操作系统版本
2. Python版本（如适用）
3. 错误信息截图
4. 操作步骤描述

文档版本: v1.5
最后更新: 2026-01-03