🏀 NBA 实时比赛推送项目安装指南（uv 版）

本项目可以实时抓取 NBA 比赛信息，并通过 企业微信 或 Telegram Bot 推送通知。
核心抓取逻辑在 nba.py，Bot 仅用于接收远程命令 "nba" 并触发 nba.py。

配置和依赖均通过 uv 虚拟环境 管理，运行前请确保 .env 配置正确。

📦 项目结构

nba/
├── pyproject.toml
├── README.md
├── nba.sh                  # 起停管理脚本
├── .env                     # 配置文件，填写微信/Telegram信息
├── .venv/                  # uv 创建的虚拟环境
└── src/
    └── nba/
        ├── __init__.py
        ├── nba.py           # 核心抓取逻辑
        ├── tg/
        │   ├── __init__.py
        │   └── nbabot.py    # Telegram Bot：添加 nba 命令并触发 nba.py
        └── wx/
            ├── __init__.py
            ├── wx.py        # 企业微信 Bot：添加 nba 命令并触发 nba.py
            ├── WXBizMsgCrypt.py
            └── ierror.py

🛠 安装步骤

1️⃣ 克隆仓库

git clone https://github.com/CC342/nba.git
cd nba

2️⃣ 使用 uv 创建虚拟环境并安装依赖

uv init

✅ uv 会自动解析 pyproject.toml，创建 .venv 并安装项目依赖：

beautifulsoup4
loguru
lxml
m3u8
playwright
pycryptodome
python-dotenv
python-telegram-bot
requests

💡 无需手动 pip 安装，所有依赖在虚拟环境内统一管理。

3️⃣ 配置 `.env`

在项目根目录编辑 .env 文件：

# 代理配置（可选）
# 填写域名+端口，例如：https://example.com:5000
# 或者在 Nginx 做反向代理后直接填域名
PROXY_HOST="你的代理地址"

# Telegram 配置
TELEGRAM_BOT_TOKEN="你的token"
TELEGRAM_CHAT_ID="聊天id"

# 企业微信配置
WX_CORP_ID="企业微信id"
WX_AGENT_ID="应用id"
WX_SECRET="密钥"
WX_TOKEN="企业微信应用——接收消息——启用api"
WX_ENCODING_AES_KEY="企业微信应用——接收消息——启用api"

⚠️ 注意：

如果不使用 Bot 功能，可以不填写 Telegram/微信配置，直接执行 nba.py 也能抓取比赛信息。

4️⃣ 安装 `nba.sh` 到全局

sudo cp nba.sh /usr/local/bin/nba.sh
sudo chmod +x /usr/local/bin/nba.sh

✅ 安装完成后，可在任何路径直接执行：

nba.sh

🏃‍♂️ 启动方式

方式 1：通过管理脚本启动 Bot

 nba.sh

菜单选择：

启动微信 Bot → 添加 nba 命令，可接收企业微信触发
启动 Telegram Bot → 添加 nba 命令，可接收 Telegram 触发

Bot 功能主要作用：远程触发 nba.py，并将比赛信息推送到对应平台。
开关与否只影响 Bot 接收命令，nba.py 本身的抓取逻辑不依赖 Bot。

方式 2：直接执行核心抓取脚本

cd src/nba
python3 nba.py

✅ 无需启动 Bot，也可以直接获取并输出比赛信息。

📄 日志文件

文件	说明
`wx.py.log`	企业微信 Bot 日志
`nbabot.py.log`	Telegram Bot 日志

示例日志：

INFO:root:收到文本消息: nba
INFO:root:已触发 nba.py 执行

🎯 总结

核心抓取逻辑在 nba.py，可单独运行。
Bot (wx.py / nbabot.py) 仅用于远程触发 nba.py。
uv 管理依赖，避免系统 Python 冲突。
配置统一在 .env，无需修改源码。
支持直接运行或通过 Bot 远程触发。