# Python环境管理器使用指南

## 🎯 功能概述

Python环境管理器是一个可视化界面，用于管理你的Tauri应用中的Python环境和依赖包。它支持：

- 📊 **环境状态监控** - 实时查看Python环境状态
- 📦 **包管理** - 安装、卸载、升级Python包
- 🔧 **环境设置** - 一键设置嵌入式Python环境
- 🔍 **包搜索** - 快速查找已安装的包

## 🚀 快速开始

### 1. 访问管理页面

在应用中：
1. 点击左侧导航栏的 "Python环境"
2. 或直接访问 `/python-env-manager` 路由

### 2. 查看环境状态

页面会显示两种Python环境的状态：

#### 嵌入式Python
- **优势**: 应用自带，用户无需安装
- **状态**: 绿色表示可用，红色表示未设置
- **设置**: 点击"设置嵌入式Python"按钮自动配置

#### 系统Python
- **优势**: 使用系统已安装的Python
- **状态**: 绿色表示可用，红色表示未安装
- **要求**: 需要用户系统已安装Python

## 📦 包管理功能

### 安装新包

1. 点击 "安装包" 按钮
2. 输入包名（如：`numpy`, `pandas`, `opencv-python`）
3. 点击 "安装" 按钮
4. 等待安装完成

**常用包推荐**：
- `requests` - HTTP请求库
- `Pillow` - 图像处理库
- `numpy` - 数值计算库
- `pandas` - 数据分析库
- `opencv-python` - 计算机视觉库

### 管理已安装的包

对于每个已安装的包，你可以：

- **升级** - 更新到最新版本
- **卸载** - 从环境中移除

### 搜索包

使用搜索框快速查找已安装的包：
- 输入包名进行实时搜索
- 支持模糊匹配

## 🔧 环境设置

### 设置嵌入式Python

如果嵌入式Python未设置（显示红色状态），可以：

1. 点击 "设置嵌入式Python" 按钮
2. 确认下载和安装（需要网络连接）
3. 等待自动完成设置
4. 刷新页面查看新状态

**设置过程包括**：
- 下载Python 3.11嵌入式版本
- 安装pip包管理器
- 安装基础依赖包
- 复制python_core模块
- 配置环境变量

### 环境优先级

应用会按以下优先级选择Python环境：
1. **嵌入式Python** - 如果可用，优先使用
2. **系统Python** - 作为备选方案

## 🛠️ 故障排除

### 常见问题

#### 1. 嵌入式Python设置失败

**可能原因**：
- 网络连接问题
- 磁盘空间不足
- 权限问题

**解决方案**：
- 检查网络连接
- 确保有足够磁盘空间（至少500MB）
- 以管理员权限运行应用

#### 2. 包安装失败

**可能原因**：
- 包名错误
- 网络问题
- 依赖冲突

**解决方案**：
- 检查包名拼写
- 确保网络连接正常
- 查看错误信息进行诊断

#### 3. 系统Python不可用

**可能原因**：
- 系统未安装Python
- Python未添加到PATH

**解决方案**：
- 安装Python 3.8+
- 将Python添加到系统PATH
- 或使用嵌入式Python

### 调试信息

如果遇到问题，可以：

1. **查看控制台日志** - 开发者工具中的Console
2. **检查错误信息** - 页面会显示详细错误
3. **重新加载状态** - 点击"刷新"按钮

## 📋 最佳实践

### 包管理建议

1. **最小化依赖** - 只安装必需的包
2. **定期更新** - 保持包的最新版本
3. **测试兼容性** - 升级后测试应用功能
4. **备份环境** - 记录重要的包列表

### 环境选择建议

#### 选择嵌入式Python，如果：
- 希望用户无需安装Python
- 需要确保环境一致性
- 应用面向普通用户

#### 选择系统Python，如果：
- 用户是开发者
- 需要使用系统特定的包
- 希望减少应用体积

## 🔄 维护和更新

### 定期维护

建议定期：
1. **检查包更新** - 升级重要的包
2. **清理无用包** - 卸载不再需要的包
3. **监控环境状态** - 确保Python环境正常

### 版本管理

- **记录包版本** - 在项目文档中记录关键包版本
- **测试兼容性** - 升级前在测试环境验证
- **回滚计划** - 准备回滚到稳定版本的方案

## 🎯 高级功能

### 环境变量控制

可以通过环境变量强制使用特定Python：

```bash
# 强制使用系统Python
set MIXVIDEO_FORCE_SYSTEM_PYTHON=1

# 启动应用
cargo tauri dev
```

### 自定义包源

如果需要使用自定义PyPI源，可以在设置脚本中修改：

```python
# 在 install_dependencies 函数中添加
subprocess.run([
    str(python_exe), "-m", "pip", "install", 
    "-i", "https://pypi.tuna.tsinghua.edu.cn/simple/",
    dep
], ...)
```

## 📊 监控和统计

管理页面提供：
- **环境状态概览** - 一目了然的状态信息
- **包数量统计** - 已安装包的总数
- **实时状态更新** - 操作后自动刷新状态

---

通过Python环境管理器，你可以轻松管理应用的Python环境，确保所有功能正常运行！
