简介
本项目演示了如何使用腾讯 QQ 开放平台官方 API 构建一个基础群聊机器人。功能涵盖天气查询、待办事项编辑以及本地图片发送等。
资源获取
项目源码
GitHub 仓库：SanYeCao-bot
官方 SDK
GitHub 仓库：QQ 频道机器人 PythonSDK
部署教程
前置准备
确保本地已安装 Git 和 Conda 环境。若未安装，请自行查阅相关文档完成配置。
一、配置 QQ 开放平台
访问 QQ 开放平台 并完成注册登录。
1. 创建机器人
进入主页点击'创建机器人'，填写基本信息后进入控制面板。
找到'沙箱配置'，选择目标测试群组。注意：操作者必须拥有该群的群主或管理员权限。
在群设置 > 群机器人中邀请创建的机器人进群。
2. 发布与开发设置
导航至'发布设置' > '功能配置'，点击右上角重新配置。根据代码逻辑设置被 At 后的指令提示。
随后进入'开发设置'，查看并记录机器人的 AppID 和 AppSecret。
重要： AppSecret 仅生成时可见一次，请务必妥善保存，退出页面后将无法再次查看。
二、拉取项目
在 GitHub 仓库页面复制克隆链接。在本地终端执行以下命令将项目拉取至当前目录：
git clone https://github.com/ClovertaTheTrilobita/SanYeCao-bot.git
三、启动机器人
1. 配置账号凭证
打开项目根目录下的 ./botpy/examples/config.yaml 文件，修改以下字段：
appid: "Your_Bot_Id"
secret: "Enter_Your_Secret_Here"
将第一步中记录的 AppID 和 AppSecret 填入对应位置。
2. 配置图床服务
机器人需上传图片功能，建议配置第三方图床（如 SM.MS）。
- 访问 SM.MS 注册并登录。
- 进入用户中心 Dashboard，找到 API Token。
- 若首次使用，点击 Generate Secret Token 生成令牌。
- 复制令牌，在项目中找到
./botpy/examples/plugins/img_upload.py。 - 修改 headers 配置：
headers = {'Authorization': }
