README_HF.md

# NoneBot QQ 官方机器人 Hugging Face 部署指南

已经为你准备好了代码基础，请按照以下步骤在 Hugging Face 部署：

## 1. 准备 Hugging Face Space
1. 访问 [Hugging Face Spaces](https://huggingface.co/spaces)。
2. 点击 **"Create new Space"**。
3. 输入名称（如 `my-qq-bot`），License 选择 `Apache-2.0`。
4. **关键步骤**：在 **"Select the Space SDK"** 中选择 **"Docker"**。
5. 硬件建议选择默认的免费 CPU 实例即可。
6. 点击 "Create Space"。

## 2. 上传文件
将以下本地目录中的三个文件上传到你的 Space 仓库中：
- `bot.py`
- `requirements.txt`
- `Dockerfile`

## 3. 配置密钥 (Secrets)
1. 在你的 Space 页面点击 **"Settings"** 选项卡。
2. 滚动到 **"Variables and secrets"** 部分。
3. 点击 **"New secret"**，添加以下三个密钥（名称必须大写）：
   - `QQ_APP_ID`: `1903143166`
   - `QQ_TOKEN`: `HGap2RVsnFwqmS0Q4e2jQZqoewA8R8qO`
   - `QQ_SECRET`: `cTKC4xrlgbXTQNLJIIIJKMORUYchnt07`

## 4. 运行与验证
1. 上传文件和配置密钥后，Hugging Face 会自动开始构建镜像并运行。
2. 在 **"Logs"** 中看到 `NoneBot is running` 即表示成功。
3. **测试回复**：在你的测试群中（确保机器人已拉入群），发送 `/echo 你好`，机器人应该会原样返回“你好”。

## 注意事项
- **Intent 配置**：如果你发现机器人收不到群消息，请检查你在 QQ 开放平台的“开发设置”中，是否勾选了相应的“事件订阅”（例如“群聊 @ 机器人”或“私域消息”）。
- **休眠机制**：Hugging Face 免费版可能会进入休眠（如果长时间无请求），但 WebSocket 连接通常能保持活跃。如果断连，重新进入 Space 页面即可唤醒。