| # 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 页面即可唤醒。 | |