{"id":16804100,"url":"https://github.com/rf-tar-railt/raianbot","last_synced_at":"2025-10-05T17:24:24.958Z","repository":{"id":41456824,"uuid":"495052385","full_name":"RF-Tar-Railt/RaianBot","owner":"RF-Tar-Railt","description":"一个基于Avilla与Alconna的简易QQ机器人","archived":false,"fork":false,"pushed_at":"2025-05-12T11:56:36.000Z","size":16877,"stargazers_count":29,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2025-07-23T06:26:15.800Z","etag":null,"topics":["alconna","bot","graia","qqbot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RF-Tar-Railt.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-05-22T12:22:38.000Z","updated_at":"2025-05-12T11:56:32.000Z","dependencies_parsed_at":"2023-02-16T11:01:13.040Z","dependency_job_id":"8f79d2b0-cf15-44db-99e6-c669708fcd55","html_url":"https://github.com/RF-Tar-Railt/RaianBot","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/RF-Tar-Railt/RaianBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RF-Tar-Railt%2FRaianBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RF-Tar-Railt%2FRaianBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RF-Tar-Railt%2FRaianBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RF-Tar-Railt%2FRaianBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RF-Tar-Railt","download_url":"https://codeload.github.com/RF-Tar-Railt/RaianBot/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RF-Tar-Railt%2FRaianBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278486611,"owners_count":25995006,"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-05T02:00:06.059Z","response_time":54,"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":["alconna","bot","graia","qqbot"],"created_at":"2024-10-13T09:44:13.127Z","updated_at":"2025-10-05T17:24:24.941Z","avatar_url":"https://github.com/RF-Tar-Railt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RaianBot\n\n`RaianBot` 是基于 [`Avilla`](https://github.com/GraiaProject/Avilla) 与 [`Alconna`](https://github.com/ArcletProject/Alconna) 的简易机器人框架 \n\n目前支持平台有 `Mirai`, QQ频道\u0026群全域接口\n\n## 交流反馈\n\nQQ交流：[122680593](https://jq.qq.com/?_wv=1027\u0026k=lhxRkibY)\n\n---\n\n## 目录\n\n+ **[项目结构](#项目结构)**\n+ **[已有功能](#已有功能)**\n+ **[下载](#下载)**\n+ **[安装](#安装)**\n  + [配置环境](#配置环境)\n  + [配置文件](#配置文件)\n  + [运行程序](#运行程序)\n\n---\n\n## 项目结构\n\n```\nRaianBot\n├─── app                         机器人功能相关\n│   ├─── core.py                 机器人核心代码, 负责统一调度资源\n│   ├─── config.py               机器人配置访问接口\n│   ├─── logger.py               为log增加文件输出\n│   ├─── control.py              鉴权接口\n│   └─── ...\n├─── assets\n│   ├─── data                    存放插件运行时需要的静态资源或数据文件\n│   │   ├─── ill_templates.json  \n│   │   └─── ...\n│   ├─── image                   存放插件运行时需要图片资源\n│   └─── ...\n├─── data                       机器人运行时产生的临时文件或缓存数据\n│   ├─── plugins \n│   │   ├─── weibo_data.json     插件运行时产生的临时文件或缓存数据\n│   │   └─── ...\n│   ├─── data.db                 总数据库\n│   └─── ...\n├─── config\n│   ├─── plugins                 机器人插件的配置目录 (可以在主配置文件中自行变更)\n│   │   └─── ...                 各插件的配置 (如需要)\n│   └─── config.yml              主配置文件\n├─── logs                        机器人日志目录\n│   ├─── latest.log\n│   └─── ...\n├─── library                     插件依赖的功能库，但没有上传到 pypi等中\n│   ├─── dice                    骰娘功能库\n│   ├─── weibo                   微博 api 功能库\n│   ├─── rand                    存放随机函数\n│   └─── ...\n├─── plugins                     机器人插件目录 (可以在主配置文件中自行变更)\n│   └─── ...\n├─── main.py                     应用执行入口\n├─── requirements.txt            项目运行环境依赖包\n├─── README.md                   项目说明文件\n└─── ...  \n```\n\n## 已有功能\n\n- 聊天对话 （需要适配）\n- 管理\n- 签到\n- 获取微博动态\n- 方舟公招计算截图\n- 天气查询\n- 发病\n- 随机方舟干员\n- 方舟模拟抽卡\n- 每日抽签\n- 状态获取\n- 跑团掷骰\n- 点歌\n- 查询干员信息\n- 猜干员游戏\n- 森空岛自动签到\n\n## 下载\n\n下载压缩包: [link](https://github.com/RF-Tar-Railt/RaianBot/releases/latest)(点击 Assets 下的 raian-bot-XXX)\n\n或 直接使用 git clone:\n```shell\ngit clone https://github.com/RF-Tar-Railt/RaianBot.git\n```\n\n## 安装\n\n### 配置环境\n解压缩最新的`raian-bot.zip`, 并进入存放有`main.py`的文件夹下\n\n**mirai部分**\n1. 确保安装并配置好了`java`环境, 推荐`java17`或`openj9`\n2. 前往[`mirai-console-loader`](https://github.com/iTXTech/mirai-console-loader)下载 mcl, 并使用 `mcl -u` 命令更新 `mirai`\n, 并在[`mirai-api-http`](https://github.com/project-mirai/mirai-api-http/releases)处下载mirai-api-http.jar(当前bot使用版本为2.9.1), 然后放入`.mcl/plugins/`下\n3. 下载 [`mirai-console-dev-qrlogin`](https://github.com/MrXiaoM/mirai-console-dev-qrlogin)，放入`.mcl/plugins/`下\n\n**bot部分**\n1. 安装`python`环境，至少要求`python 3.8`及以上版本\n2. 命令行输入如下命令: (确保命令行运行在`main.py`文件夹下)\n\n```bash\npip install -r requirements.txt\n```\n\n### 配置文件\n\n**mirai部分**\n1. 先运行一遍mcl, 以自动生成配置文件, 确认生成后关闭mcl\n2. 前往`mcl/config/net.mamoe.mirai-api-http`下, 打开`setting.yml`文件\n3. 修改其中的`verifyKey`, 适当修改`adapterSettings`下的`host`与`port`\n~~4. 前往`mcl/config/Console`下, 打开`AutoLogin.yml`文件~~\n~~5. 按提示修改其中的`account`与`password`~~\n\n**bot部分**\n1. bot 的初始配置位于 `./config/` 下\n2. 首先更改 `config/config.yml`，按照提示逐个修改. 其中`mirai.verify_key`, `mirai.host`, `mirai.port`应与`mcl/config/net.mamoe.mirai-api-http/setting.yml`内的相同\n3. 其次更改 `config/bots/` 下的配置文件，文件名应为 `\u003cbot账号\u003e.yml` (如 \"114514.yml\")，多个账号则对应多个文件\n4. 适当调整各插件的配置文件, 默认位置为 `./config/plugins/`\n\n(或先配置 bot部分，然后运行 `./mah_setting.py`)\n### 运行程序\n\n**mirai部分**\n1. 在`mcl`文件夹下双击运行`mcl.cmd`文件\n2. 在命令框内输入`qrlogin \u003cbot账号\u003e` (如 \"qrlogin 114514\"), 然后扫描弹出的二维码\n~~2. 若提示弹窗验证, 请按以下方法操作: [链接](https://docs.mirai.mamoe.net/mirai-login-solver-selenium)~~\n3. 命令框内出现正常对话信息则代表登录成功\n\n**bot部分**\n\n运行`main.py`, 机器人发送提示信息则代表启动成功\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frf-tar-railt%2Fraianbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frf-tar-railt%2Fraianbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frf-tar-railt%2Fraianbot/lists"}