{"id":15043187,"url":"https://github.com/simple-robot/simple-robot-v1","last_synced_at":"2025-10-04T05:31:35.788Z","repository":{"id":41414210,"uuid":"174523813","full_name":"simple-robot/simple-robot-v1","owner":"simple-robot","description":"这是基于java的聊天/通讯机器人开发框架，是一种注解开发风格、可扩展的、可与SpringBoot应用相互结合的开发框架，对接各种可提供接口的聊天/通讯机器人应用来实现以一种统一标准编写聊天/通讯机器人。","archived":true,"fork":false,"pushed_at":"2022-07-01T14:53:52.000Z","size":13579,"stargazers_count":173,"open_issues_count":2,"forks_count":16,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-14T23:55:59.688Z","etag":null,"topics":["core","framework","java","java-8","qqbot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simple-robot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-08T11:14:23.000Z","updated_at":"2025-08-03T14:02:17.000Z","dependencies_parsed_at":"2022-08-30T11:32:29.943Z","dependency_job_id":null,"html_url":"https://github.com/simple-robot/simple-robot-v1","commit_stats":null,"previous_names":["fortescarlet/simple-robot-core","fortescarlet/simple-coolq"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/simple-robot/simple-robot-v1","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simple-robot%2Fsimple-robot-v1","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simple-robot%2Fsimple-robot-v1/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simple-robot%2Fsimple-robot-v1/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simple-robot%2Fsimple-robot-v1/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simple-robot","download_url":"https://codeload.github.com/simple-robot/simple-robot-v1/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simple-robot%2Fsimple-robot-v1/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278267482,"owners_count":25958873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["core","framework","java","java-8","qqbot"],"created_at":"2024-09-24T20:48:40.780Z","updated_at":"2025-10-04T05:31:34.408Z","avatar_url":"https://github.com/simple-robot.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 基于接口的通讯机器人java开发框架-核心\n[![](https://img.shields.io/badge/simple--robot-core-green)](https://github.com/ForteScarlet/simple-robot-core)  [![img](https://camo.githubusercontent.com/f8464f5d605886b8369ab6daf28d7130a72fd80e/68747470733a2f2f696d672e736869656c64732e696f2f6d6176656e2d63656e7472616c2f762f696f2e6769746875622e466f727465536361726c65742f73696d706c652d726f626f742d636f7265)](https://search.maven.org/artifact/io.github.ForteScarlet/simple-robot-core) [![](https://img.shields.io/badge/%E7%9C%8B%E4%BA%91%E6%96%87%E6%A1%A3-doc-green)](https://www.kancloud.cn/forte-scarlet/simple-coolq-doc)  [![](https://img.shields.io/badge/QQ%E7%BE%A4-782930037-blue)](https://jq.qq.com/?_wv=1027\u0026k=57ynqB1)  \n\n\n\u003e 项目对应GITHUB地址: https://github.com/ForteScarlet/simple-robot-core\n\u003e\n\u003e 项目对应GITEE地址:  https://gitee.com/ForteScarlet/simple-robot-core\n\n**首先，点击项目右上角的`star`以开启隐藏链接。**\n\n核心版本：[![img](https://camo.githubusercontent.com/f8464f5d605886b8369ab6daf28d7130a72fd80e/68747470733a2f2f696d672e736869656c64732e696f2f6d6176656e2d63656e7472616c2f762f696f2e6769746875622e466f727465536361726c65742f73696d706c652d726f626f742d636f7265)](https://search.maven.org/artifact/io.github.ForteScarlet/simple-robot-core)\n\n\n\u003cbr\u003e\n\n\n# 使用2.x版本：\nhttps://github.com/ForteScarlet/simpler-robot\n\n当前仓库版本(1.x)已进入停止更新状态，请前往2.x版本。\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n\n\n**1.x文档请见文档地址：**\nhttp://simple-robot-doc.forte.love\n或\nhttps://www.kancloud.cn/forte-scarlet/simple-coolq-doc\n\u003cbr\u003e\n\n**1.x在线javadoc文档(由码云平台生成)：**\n https://apidoc.gitee.com/ForteScarlet/simple-robot-core\n\n由于目前核心部分与组件部分相互分离，所以核心与组件的github地址也相互分离了。\n所有组件均依赖于此**核心框架**，支持maven坐标，具体坐标请见**文档下文**或**入群咨询**\n\n点击`star`后即可申请加入QQ群聊，QQ群号：**782930037**\n\n\u003cbr\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n## 这是什么？\n这是一个基于网络通讯接口的通讯机器人开发框架，可以对接例如酷Q机器人等一系列通讯机器人应用。\n此框架分有两个部分：核心框架与组件框架，当前仓库为核心框架。\n\n### 核心框架？\n 核心框架提供主要的功能与接口，用于为组件框架提供实现接口，并借此可以实现不同平台、不同插件的简易切换。\n 核心框架提供标准化接口、功能，但是不能够直接使用。\n \n### 组件框架？\n 组件框架依赖于核心框架，其存在的主要目的就是为了针对某一个特定的插件（例如酷Q的CQ HTTP API插件）进行对接。\n\n### 为何要分离？\n 举个例子。假如你想要使用此框架对接 **A应用** ，那么你就要使用 **组件框架A** 来开发，然后过了两个月，你发现**B应用**也挺好的，想要切换到**B应用**，这时候分离的作用就出现了，你只需要将依赖的**组件框架A**切换为**组件框架B**，然后简单修改一下启动类和配置信息，而不需要修改任何功能性的代码（例如消息监听器、定时任务等等）。因为绝大部分功能性的东西都是核心框架所提供的，而你切换组件是不会变更核心的，这样就可以做到能够很好的去支持更多的应用，且切换起来也不会太繁琐。\n\n\u003e 简单来讲，核心框架就是一块儿主板，组件框架就是一块儿显卡，而最终开机后，电脑里的各种各样的应用程序，就是你最终所书写的功能性代码。\n\u003cbr\u003e\n只要这块儿主板不变，每次更换显卡只需要重新安装一下显卡驱动，而不需要删除所有的应用。\n\n也得益于核心组件分离，使其能够有更大的拓展空间，而不是仅局限于酷Q应用，也不一定局限于腾讯QQ的业务范围。毕竟有着“私信、群聊”等等一系列信息内容的应用可不仅限于腾讯QQ\n\n\u003cbr\u003e\n\n### 有何优点？\n\n- 有着极高的扩展性。任何人都可以根据核心框架，并针对某一个应用或者接口来开发组件框架，并投入使用。\n- 核心提供了极其丰富的功能，例如\n    - 注解开发风格\n    - 丰富的过滤规则\n    - 集成quartz定时任务框架\n    - 依赖注入\n    - 部分拦截器\n    - 支持与Spring(boot(+MyBatis))等其他框架的整合\n    - 目前针对Springboot，提供了快速启动器(starter)\n- 持续更新的代码\n- 好说话的作者（欢迎入群与群主交流催更😏\n- 高度接口化，可扩展性强\n- 有虽然没有完全写完但是已经很全面了的中文文档\n- 已上传Maven中央仓库，支持Maven、gradle等项目架构方式        \n  \n\n\n## 现在已经存在的应用？\n\n#### 已经存在的**组件框架**：\n\n| 平台 |      依赖       |                           项目地址                           |\n| :--: | :-------------: | :----------------------------------------------------------: |\n| 酷Q（停止）  |    LEMOC插件    | https://github.com/ForteScarlet/simple-robot-component-lemoc |\n| 酷Q（停止）  | HTTP TO CQ插件  | https://github.com/ForteScarlet/simple-robot-component-httpapi |\n| 酷Q（停止）  | CQ HTTP API插件 | https://github.com/ForteScarlet/simple-robot-component-coolHttpApi |\n| 酷Q（停止）  | JCQ插件 | https://github.com/ForteScarlet/simple-robot-component-JCQ |\n| JVM          | Mirai   | https://github.com/ForteScarlet/simple-robot-component-mirai | \n\n\u003e `酷Q已停止服务。R.I.P.`\n\n#### 已经存在的**模组**：\n\n| 名称 |      描述       |                           项目地址                           |\n| :--: | :-------------: | :----------------------------------------------------------: |\n| cqcodeutils模组  |    提供高效的cq码操作工具。可独立依赖、使用。    | https://github.com/ForteScarlet/simple-robot-module-cqcodeutils |\n| delay-task模组  |    提供基于携程的异步延时任务功能。可独立依赖、使用。    | https://github.com/ForteScarlet/simple-robot-module-delay-task |\n| redis-bot-manager模组  |    提供使用redis统一管理bot账号的功能。    | 暂无仓库，文档：http://simple-robot-doc.forte.love/1672448 |\n| debugger模组  |    提供一系列便于本地、远程debug的功能的模组。    | https://github.com/ForteScarlet/simple-robot-module-debuger-common |\n\n\n#### 已经存在的**Springboot-starter**\n\n| 名称 |      描述       |                           项目地址                           | \n| :--: | :-------------: | :----------------------------------------------------------: | \n|   core-starter  |    starter项目的父项目，提供一些基础配置    | https://github.com/ForteScarlet/simple-robot-core-springboot-starter |\n|   cqhttp-starter  |    cqhttp组件的starter  | https://github.com/ForteScarlet/simple-robot-component-cqhttp-springboot-starter |\n|   mirai-starter  |    mirai组件的starter    | https://github.com/ForteScarlet/simple-robot-component-mirai-springboot-starter |\n\n\n### 公开Demo\n\n如果你想要尝试一下，不妨在阅读过文档的快速开始的情况下，去[公开Demo项目(gitee)](https://gitee.com/ForteScarlet/simple-robot-demo-project)看一看。\n\n\n\n\u003e 如果你根据核心开发了组件框架，可以告知我，我会更新在此处与下文处。\n\n\u003e 如果你只是想开发一个QQ机器人，而不在乎使用什么平台，请参考文档开头提到的组件框架。\n\n# 安装\n\n此处仅对如何搭建Java项目进行说明，如果你想开发QQ机器人， 请移步至 [文档](https://www.kancloud.cn/forte-scarlet/simple-coolq-doc) 查看。\n\n首先你需要知道，此项目(即`核心`) **无法直接使用**，如果你想要开发酷Q平台的QQ机器人，请移步至 [文档](https://www.kancloud.cn/forte-scarlet/simple-coolq-doc) 查看。\n\n**其次，以下列举的部署方式中，版本号请自行修改为最新版。**\n\n你可以选择使用以下方法进行自动部署：\n\n版本参考：[![img](https://camo.githubusercontent.com/f8464f5d605886b8369ab6daf28d7130a72fd80e/68747470733a2f2f696d672e736869656c64732e696f2f6d6176656e2d63656e7472616c2f762f696f2e6769746875622e466f727465536361726c65742f73696d706c652d726f626f742d636f7265)](https://search.maven.org/artifact/io.github.ForteScarlet/simple-robot-core)\n\n## Maven \n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.ForteScarlet\u003c/groupId\u003e\n    \u003cartifactId\u003esimple-robot-core\u003c/artifactId\u003e\n    \u003cversion\u003e${version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Gradle\n\n```\n// https://mvnrepository.com/artifact/io.github.ForteScarlet/simple-robot-core\ncompile group: 'io.github.ForteScarlet', name: 'simple-robot-core', version: '\u003e${version}'\n```\n\n\n\n如果你不选择使用自动部署的方式，你可以直接前往 [Maven下载Jar](https://mvnrepository.com/artifact/io.github.ForteScarlet/simple-robot-core) 包或者碰碰运气，看看[releases](https://github.com/ForteScarlet/simple-robot-core/releases)有没有最新的Jar包。\n\n注意，当你选择下载jar包的时候，请同时下载项目中`lib`文件夹下的依赖包。\n\n\n\n\n## 看的有点蒙，但是想试试\n可以考虑：\n- 加入QQ群：782930037, 如果对水群没有兴趣，可以直接去找群主。\n- 邮箱：ForteScarlet@163.com (邮箱信息查看周期较长)\n- GITEE或者GITHUB留言\n\n首先建议进群交流，毕竟其他两个我并不经常看(●ˇ∀ˇ●)\n\n\n## 建议、意见、bug反馈\n- 你可以使用`issue`向我反馈bug或者提出建议意见。\n- 你可以加入QQ群聊`782930037`向我反馈bug或者提出建议意见。\n- 你可以通过联系邮箱`ForteScarlet@163.com`向我反馈bug或者提出建议意见（可能会处理不及时）。\n\n## 更新计划\n对于未来的更新计划可以从github的projects中或者[更新计划](更新计划.md)中看到。一般想到什么的话会优先更新`更新计划.md`。\n\n\n## 赞助一下？\n\n那真的真的太感谢了，你可以参考 [文档/捐助]( https://www.kancloud.cn/forte-scarlet/simple-coolq-doc/1115825 ) 或者去 [爱发电](https://afdian.net/@ForteScarlet) 逛逛~\n\n\n\n## 大家的成果\n\u003ctable\u003e\n    \u003cthead\u003e\n        \u003ctr\u003e\n            \u003cth\u003e项目名称\u003c/th\u003e\n            \u003cth\u003e作者\u003c/th\u003e\n            \u003ctd\u003e项目简介\u003c/td\u003e\n            \u003ctd\u003e项目链接\u003c/td\u003e\n\t\t\u003c/tr\u003e\n    \u003c/thead\u003e\n    \u003ctbody\u003e \n        \u003ctr\u003e\n            \u003ctd\u003e\n                \u003cp\u003e崩坏学园2小助手 - 萌萌新\u003c/p\u003e \n            \u003c/td\u003e\n            \u003cth\u003e瑶光天枢\u003c/th\u003e\n            \u003ctd style=\"word-wrap:break-word;word-break:break-all;\" width=\"120px\"\u003e崩坏学园2的在线群聊，查询装备，模拟扭蛋，查询up记录，来份色图的机器人\u003c/td\u003e\n            \u003ctd\u003ehttps://github.com/LiChen233/simple-robot\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                \u003cp\u003e群管机器人\u003c/p\u003e \n            \u003c/td\u003e\n            \u003cth rowspan='3'\u003e会跑的仓鼠\u003c/th\u003e\n            \u003ctd style=\"word-wrap:break-word;word-break:break-all;\" width=\"120px\"\u003e基于simple开发的群机器人\u003c/td\u003e\n            \u003ctd\u003ehttps://gitee.com/yaozhenyong/cqrobotjar2\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                \u003cp\u003e游戏查询机器人\u003c/p\u003e \n            \u003c/td\u003e\n            \u003ctd style=\"word-wrap:break-word;word-break:break-all;\" width=\"120px\"\u003e基于simple开发的娱乐性机器人\u003c/td\u003e\n            \u003ctd\u003ehttps://gitee.com/yaozhenyong/cqrobotIndependent\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                \u003cp\u003e云端控制面板\u003c/p\u003e\n            \u003c/td\u003e\n            \u003ctd style=\"word-wrap:break-word;word-break:break-all;\" width=\"120px\"\u003e主要做上面两个版本机器人的控制面板（web端）\t\u003c/td\u003e\n            \u003ctd\u003ehttps://gitee.com/yaozhenyong/Qqrobotwar\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                \u003cp\u003eRobot-Spring\u003c/p\u003e\n            \u003c/td\u003e\n            \u003cth\u003e千年老妖(1571650839)\u003c/th\u003e\n            \u003ctd style=\"word-wrap:break-word;word-break:break-all;\" width=\"120px\"\u003e\n                \u003cp\u003e基于酷Q的，使用Java语言开发的，面向COC的骰子机器人组件, \n                使用架构为SpringBoot-Mybatis-CoolHttpApI。主要功能：COC跑团基础功能+斗图,聊天,群管等乱七八糟的功能\u003c/p\u003e\n            \u003c/td\u003e\n            \u003ctd\u003ehttps://github.com/17336324331/Robot-Spring\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd\u003e\n                \u003cp\u003ecoolqhttpapisimpleyiluoeandxishirobot\u003c/p\u003e\n            \u003c/td\u003e\n            \u003cth\u003e以罗伊\u003c/th\u003e\n            \u003ctd style=\"word-wrap:break-word;word-break:break-all;\" width=\"120px\"\u003e\n                就是用simple-robot框架写的一个小机器人啦,windows linux上都能正确运行(目前)\n            \u003c/td\u003e\n            \u003ctd\u003ehttps://github.com/YiluoE/coolqhttpapisimpleyiluoeandxishirobot\u003c/td\u003e\n        \u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e  \n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimple-robot%2Fsimple-robot-v1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimple-robot%2Fsimple-robot-v1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimple-robot%2Fsimple-robot-v1/lists"}