QQ机器人开发框架常见问题解决方案

QQ机器人开发框架常见问题解决方案

qqrobot-sdk QQ机器人一站式开发框架 项目地址: https://gitcode.com/gh_mirrors/qq/qqrobot-sdk

1. 项目基础介绍及主要编程语言

项目简介： 本项目是一款基于Spring Boot平台的QQ机器人开发框架，名为qqrobot-sdk。该框架为QQ机器人开发提供了便利的解决方案，能够帮助开发者快速、高效地搭建出基于Spring Boot的QQ机器人应用。项目主要包含两个模块：qqrobot-framework-api和qqrobot-spring-boot-starter。qqrobot-framework-api定义了QQ机器人框架需要遵循的规范，而qqrobot-spring-boot-starter则基于该规范实现了开发框架，提供了自动化命令匹配、命令权限校验、命令参数提取等功能。

主要编程语言： 本项目主要使用Java语言开发，并使用Spring Boot作为开发框架。

---

2. 新手常见问题及解决步骤

问题一：如何添加项目依赖？

问题描述： 新手在开始使用qqrobot-sdk项目时，可能会遇到不知道如何正确添加项目依赖的问题。

解决步骤：

1. 打开你的Maven或Gradle配置文件。
2. 在Maven的pom.xml文件中，添加以下依赖项：

<dependencies>
    <dependency>
        <groupId>de.honoka.qqrobot</groupId>
        <artifactId>qqrobot-spring-boot-starter</artifactId>
        <version>版本号</version>
    </dependency>
</dependencies>

3. 在Gradle的build.gradle文件中，添加以下依赖项：

dependencies {
    implementation 'de.honoka.qqrobot:qqrobot-spring-boot-starter:版本号'
}

4. 确保将版本号替换为最新的版本。

问题二：如何运行示例程序？

问题描述： 新手可能会不清楚如何运行项目提供的示例程序qqrobot-demo。

解决步骤：

1. 克隆demo-projects仓库到本地。
2. 使用IDE打开仓库中的qqrobot-demo目录（注意不是仓库的根目录）。
3. 运行qqrobot-demo的Spring Boot主类QqRobotDemo。
4. 等待应用启动完成后，打开测试框架界面，默认地址为http://localhost:8081/qqrobot-demo/tester-framework/index.html。
5. 点击“连接”，然后在群聊消息对应的输入框中输入%菜单。如果得到回复，则表示测试环境运行成功。

问题三：如何配置并启动正式环境？

问题描述： 新手可能会遇到不知道如何配置并启动正式环境的问题。

解决步骤：

1. 在qqrobot-demo目录下执行gradlew bootJar命令，等待构建完成。
2. 将qqrobot-demo/src/main/resources/config/application-prod.yml文件复制到qqrobot-demo/build/libs目录下。
3. 打开libs目录下的application-prod.yml文件，修改honoka.qqrobot项下的qq、password、admin-qq、developing-group四个配置项，指定机器人要使用的QQ账号、密码、可调用管理员命令的用户的QQ账号以及开发群的群号。
4. 在libs目录下创建startup.bat（Windows）或startup.sh（Linux）文件，并插入以下内容：

javaw -jar -Dfile.encoding=UTF-8 -Dspring.profiles.active=prod [jar包的名称]

5. 执行startup.bat或startup.sh文件，等待应用启动完成。注意确保jar包启用了prod配置文件。
6. 通过任何方式向机器人所登录QQ账户发送%菜单命令，如果收到回复，则表示应用在正式环境中启动成功。

qqrobot-sdk QQ机器人一站式开发框架 项目地址: https://gitcode.com/gh_mirrors/qq/qqrobot-sdk