OpenHUTB 项目缺少统一环境初始化脚本，新人部署环境配置流程繁琐

[XieTJ]

Issue 描述

问题现状

项目当前无一键环境初始化脚本，新人部署需要手动依次完成创建虚拟环境、激活环境、安装依赖、配置PYTHONPATH等多步操作，步骤分散易漏操作，频繁出现依赖缺失、路径导入报错两类问题。

复现流程

1. 新开发者克隆仓库；
2. 手动敲命令创建venv、激活虚拟环境；
3. 手动执行pip安装依赖，容易遗忘导出/同步requirements；
4. 未自动配置PYTHONPATH，运行时报自定义模块找不到。

示例基础脚本逻辑

#!/bin/bash
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
export PYTHONPATH=$(pwd):$PYTHONPATH
echo "环境初始化完成，当前Python路径：$(which python3)"
python -c "import sys;print(sys.path)"

[tyy433]

一、当前痛点总结

项目无统一环境初始化脚本，新人部署需手动分步执行创建虚拟环境、激活、安装依赖、配置PYTHONPATH，步骤繁琐易漏操作，频繁触发依赖缺失、模块导入失败两类报错。

二、临时简化部署方案（现有项目直接可用）

1. 一键初始化脚本 init_env.sh

#!/bin/bash
# 创建虚拟环境
python3 -m venv venv
# 激活环境
source venv/bin/activate
# 安装锁定依赖
pip install -r requirements.txt
# 自动配置模块检索路径
export PYTHONPATH=$(pwd):$PYTHONPATH
# 校验环境信息
echo "=== 环境初始化完成 ==="
echo "当前Python路径: $(which python3)"
python -c "import sys;print('Python检索路径:', sys.path[:3])"
echo "启动命令：python main.py"

2. 使用方式

chmod +x init_env.sh
./init_env.sh

三、长期项目优化建议

1. 仓库内置标准化脚本
   在项目根目录提交init_env.sh环境初始化脚本、start.sh启动脚本，固化环境配置逻辑，消除手动操作遗漏。
2. README简化部署文档
   删减分步命令，仅保留脚本一键部署指令，降低新人上手门槛。
3. 内置环境自检逻辑
   脚本增加版本校验、虚拟环境检测、依赖完整性校验，提前输出环境异常提示。
4. Docker配套适配
   同步提供标准化Dockerfile，容器内自动完成路径与依赖配置，统一本地、线上部署流程。

四、配套快速校验命令（用于排错）

# 检查是否处于虚拟环境
python -c "import sys; print('虚拟环境已激活' if sys.base_prefix != sys.prefix else '未激活虚拟环境')"
# 核对模块检索路径
python -c "import sys; print('\n'.join(sys.path))"
# 比对依赖完整性
diff requirements.txt <(pip freeze)