安装前，请务必确认您已经激活了虚拟环境

✅ 第一步：确认并激活虚拟环境

在项目目录下，检查命令行提示符最前面是否有 (venv) 字样。

# 在 ~/ContentAutomationHub 目录下执行
cd ~/ContentAutomationHub
ls -la
# 您应该能看到一个名为 `venv` 的文件夹

# 检查当前是否在虚拟环境中：
which python3
# 如果显示路径类似于 `/home/bluetooth/ContentAutomationHub/venv/bin/python3`，则表示在虚拟环境中。
# 如果显示 `/usr/bin/python3`，则表示不在虚拟环境中。

# 如果不在虚拟环境中，请激活它：
source venv/bin/activate
# 激活后，提示符前会出现 (venv)

✅ 第二步：在虚拟环境中安装所有必要依赖

在确认提示符为 (venv) 后，一次性安装项目所需的核心包：

pip install sqlalchemy pymysql celery redis flask flask-cors

请完整复制上面这行命令执行。它会安装我们到目前为止讨论过的所有核心库：

• sqlalchemy: 数据库ORM（您现在缺失的）
• pymysql: MySQL驱动
• celery: 异步任务队列
• redis: Celery的消息代理后端
• flask: Web框架
• flask-cors: 处理跨域请求（为将来API预留）

✅ 第三步：验证安装成功

安装完成后，运行一个快速验证脚本，确保所有关键模块都能正确导入：

cat > check_imports.py << 'EOF'
try:
import sqlalchemy
import pymysql
import celery
import redis
import flask
import flask_cors
print("✅ 所有核心模块导入成功！")
print(f" SQLAlchemy 版本: {sqlalchemy.__version__}")
except ModuleNotFoundError as e:
print(f"❌ 模块导入失败: {e}")
print("请检查虚拟环境是否激活，并重新运行 pip install 命令。")
EOF

python check_imports.py

如果看到 “所有核心模块导入成功！” 和版本号，就说明环境已经准备就绪。

✅ 第四步：重新运行 models.py

现在，您可以重新运行 models.py 来创建数据库表了：

python models.py

您应该能看到 task, publish_platform, publish_log 这三张表。

🔧 如果安装仍然失败（备选方案）

如果 pip install 因为网络问题很慢或失败，可以尝试：

1. 使用国内镜像源（如清华源）加速：

pip install sqlalchemy pymysql celery redis flask flask-cors -i https://pypi.tuna.tsinghua.edu.cn/simple

升级pip本身：有时旧版pip会导致安装问题。

pip install --upgrade pip

逐一安装：如果批量安装有问题，可以尝试逐个安装，看是哪个包出了问题。

pip install sqlalchemy
pip install pymysql
...以此类推

🎯 总结与下一步

这个问题非常典型，核心就两步：激活虚拟环境 -> 安装缺失的包。

请先完成上述步骤，确认 python check_imports.py 和 sudo mysql -e “USE content_hub; SHOW TABLES;” 结果正常，那么环境就绪，就可以进入最激动人心的部分：编写调用DeepSeek API的Celery任务 (tasks.py) 和 创建Flask Web界面 (app.py)，让整个系统真正“活”起来。