ShopTRAINING/docs/portable_README.md

药店销售预测系统 - 便携式环境使用说明

介绍 📋

这是一个基于Python 3.13嵌入式包的便携式环境，可以在不安装Python的情况下运行药店销售预测系统。此环境完全独立，不会影响系统中的其他Python安装。

系统要求 🖥️

• Windows 10/11 64位操作系统
• PowerShell 5.0或更高版本
• 互联网连接（用于初始下载）
• 至少500MB的磁盘空间

安装步骤 🔧

1. 确保PowerShell的执行策略允许运行脚本：

   以管理员身份打开PowerShell，运行：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. 运行环境设置脚本：

   .\setup_portable_env.ps1
   

   此脚本将：

   • 下载Python 3.13嵌入式包
   • 设置基本环境
   • 安装pip和所需依赖
   • 创建便捷的启动脚本

3. 安装完成后，系统将显示使用说明。

使用方法 🚀

进入Python环境

.\portable_python\activate.ps1

激活后，命令提示符前会显示一条消息，表明环境已激活。

运行药店销售预测系统

.\portable_python\run_project.ps1

运行API服务

.\portable_python\run_api.ps1

退出环境

在激活的环境中运行：

deactivate

GPU支持 🎮

默认安装的是PyTorch CPU版本。如需启用GPU支持，请在环境激活后手动安装对应CUDA版本的PyTorch：

.\portable_python\activate.ps1
python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121

注意：您需要已安装兼容的NVIDIA显卡驱动和CUDA工具包。

常见问题 ❓

Q: 为什么选择便携式环境？

A: 便携式环境避免了Python版本冲突、路径问题和依赖冲突，特别是在含有中文路径的系统中。

Q: 如何更新依赖？

A: 在激活环境后，使用pip命令：

python -m pip install -r portable_requirements.txt --upgrade

Q: 如何移动环境到其他计算机？

A: 只需复制整个项目文件夹，包括portable_python目录即可。环境是完全自包含的。

故障排除 🔍

如果遇到"无法执行脚本"错误，请确保已设置PowerShell执行策略：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

如果安装依赖时出错，请尝试手动安装单个包：

.\portable_python\activate.ps1
python -m pip install 包名称