'init'

VENV_GUIDE.txt

@@ -0,0 +1,81 @@
+# 虚拟环境使用指南
+
+## 快速开始（推荐）
+
+直接双击运行 `start.bat`，脚本会自动：
+1. 检查并创建虚拟环境
+2. 激活虚拟环境
+3. 安装依赖包
+4. 启动服务
+
+## 手动使用虚拟环境
+
+### Windows 系统
+
+```bash
+# 1. 创建虚拟环境
+python -m venv venv
+
+# 2. 激活虚拟环境
+venv\Scripts\activate
+
+# 3. 安装依赖
+pip install -r requirements.txt
+
+# 4. 运行服务
+python app.py
+
+# 5. 退出虚拟环境（使用完毕后）
+deactivate
+```
+
+### Linux/Mac 系统
+
+```bash
+# 1. 创建虚拟环境
+python3 -m venv venv
+
+# 2. 激活虚拟环境
+source venv/bin/activate
+
+# 3. 安装依赖
+pip install -r requirements.txt
+
+# 4. 运行服务
+python app.py
+
+# 5. 退出虚拟环境
+deactivate
+```
+
+## 配置说明
+
+在启动服务前，需要配置 `.env` 文件：
+
+**必须配置项：**
+- `ADSPOWER_USER_ID`: 在 AdsPower 中创建的用户 ID
+
+**可选配置项：**
+- 其他配置项保持默认值即可
+
+## 验证虚拟环境
+
+激活虚拟环境后，命令行提示符前会显示 `(venv)`：
+
+```
+(venv) D:\project\Work\ai_mip>
+```
+
+## 常见问题
+
+**Q: 如何确认已在虚拟环境中？**
+A: 命令行提示符前有 `(venv)` 标识
+
+**Q: 虚拟环境在哪里？**
+A: 项目根目录下的 `venv` 文件夹
+
+**Q: 需要每次都激活虚拟环境吗？**
+A: 使用 `start.bat` 会自动激活，手动运行需要先激活
+
+**Q: 如何重建虚拟环境？**
+A: 删除 `venv` 文件夹，重新运行 `start.bat` 或手动创建