README_HF.md

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

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

1. 准备 Hugging Face Space

1. 访问 Hugging Face 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 页面即可唤醒。