本项目提供了一个在 QQ 中运行的原神助手,与之聊天可以方便地查询玩家数据和游戏信息、模拟抽卡、模拟刷圣遗物,以及一些其他的功能。原项目的该版本已经不再维护,此项目当前会持续更新。
本项目仅供学习交流技术使用,严禁用于任何商业用途和非法行为!
- 代码提交前运行
npm run code-check
进行检查确保无报错,并运行npm run code-format
进行格式化。 - 代码自测完毕后发起 Pull request 合入
dev
分支。 - 新功能添加或者功能修改请先发起 Issue 询问我的意愿,根据沟通结果选择合入本项目或者提交到你账户下的一个 Fork 。漏洞修复无需事先沟通,直接发起 Pull request 并描述清楚问题即可。
请不要在你的 Fork 中开启下面的 workflow !它们对你没有任何帮助。
Update Node.js modules in dev branch
Update Vue.js in dev branch
Update resources in dev branch
本项目原则上只做 Linux 系统的支持,所有代码合入主线之前也只在 Linux 上进行测试,推荐使用一个主流的发行版(例如 CentOS )进行部署。如果你执意要在 Windows 系统上进行部署,请参照我在 FAQ 中写的《如何在 Windows 系统上进行部署》,注意虽然这份说明是出自我之手,但是不表示我推荐在 Windows 系统上部署本项目。
首先你需要有一份较新的 Node.js ,本项目不兼容较旧版本的 Node.js 。
echo 'export N_NODE_MIRROR="https://mirrors.ustc.edu.cn/node/"' | tee -a ~/.bashrc
echo 'export N_NODE_DOWNLOAD_MIRROR="https://mirrors.ustc.edu.cn/node/"' | tee -a ~/.bashrc
source ~/.bashrc
curl -fsSL https://raw.githubusercontent.com/tj/n/master/bin/n | sudo -E bash -s lts
sudo --preserve-env=PATH env npm install -g n
sudo --preserve-env=PATH env n lts
- 建议提供一个内存和交换空间容量总和达到
1.5 GiB
的 Linux 环境进行部署,以运行无头浏览器。- 不要遗漏
tee
命令的-a
选项,否则你的~/.bashrc
将被破坏。
git clone https://github.com/Arondight/Adachi-BOT.git
cd ./Adachi-BOT/
使用国内镜像克隆本项目
如果你访问 GitHub 的速度很慢,那么请使用下面的命令克隆本项目的镜像。
git clone https://gitcode.net/iSpeller/Adachi-BOT.git
你需要使用 npm
命令安装所需的依赖模块,但是因为 Puppeteer 在安装过程中具有特殊性,所以整个安装过程有了两种思路,你可以在下面的安装方法中任选其一。
这样做的好处有三个。
- 包管理器会提供 Chromium 安装和运行所需要的依赖。
- 包管理器会提供 Chromium 安全和功能更新。
- 不需要在系统里装多份 Chromium 浏览器。
你要做的是。
- 用包管理器安装 Chromium ,然后找到它的二进制 ELF 文件路径。
- 配置环境变量
PUPPETEER_EXECUTABLE_PATH
为这个路径,然后配置环境变量PUPPETEER_SKIP_CHROMIUM_DOWNLOAD
为true
。
这样 Puppeteer 就可以使用系统自带的 Chromium 了。这里以 CentOS 为例,上面两个步骤可以用转化为以下 Bash 命令。
sudo yum -y install epel-release
sudo yum -y install chromium
cp -v ~/.bashrc{,-backup}
echo 'export PUPPETEER_EXECUTABLE_PATH="/usr/lib64/chromium-browser/chromium-browser"' | tee -a ~/.bashrc
echo 'export PUPPETEER_SKIP_CHROMIUM_DOWNLOAD="true"' | tee -a ~/.bashrc
source ~/.bashrc
npm install
- 其中
/usr/lib64/chromium-browser/chromium-browser
是你的 Chromium 浏览器 ELF 文件路径,而非启动脚本或其链接的路径,具体请参照 FAQ 中的《Linux 下如何找到 Chromium 的二进制 ELF 文件路径》。- 不要遗漏
tee
命令的-a
选项,否则你的~/.bashrc
将被破坏。
这需要你的系统有访问国际互联网的能力,如果可以访问,直接执行以下命令。
npm install
如果无法访问,那么你需要通过任意合法途径获得一个可以访问国际互联网的 http
代理,然后执行以下命令。
npm_config_proxy=http://<代理地址>:<代理端口> npm install
注意使用此方法安装 Chromium ,你需要自行解决它的运行依赖问题(例如缺少动态库)。
首次配置,进入本项目所在的目录 ./Adachi-BOT/
,执行以下命令从 ./config_defaults/
下复制默认配置文件 setting.yml
和 cookies.yml
到 ./config/
中。
cp -iv ./config_defaults/{setting,cookies}.yml ./config/
然后需要编辑以下文件,根据注释填入合适的配置。
文件 | 作用 |
---|---|
setting.yml | 基本配置选项 |
cookies.yml | 米游社 Cookie |
- 你也可以从
./config_defaults/
下复制更多的文件到./config/
来进行自定义配置。但是有些配置文件如果你不想自己维护,那就不要把它们放到./config/
下。请详细阅读相关配置文件中注释的说明。- 你可以在 yamlchecker.com 网站上检查你写的配置文件语法是否正确,只需要将配置文件的内容复制到文本框中即可。
- 当前任何配置文件的更改都需要重启机器人方可生效。
进入本项目所在的目录 ./Adachi-BOT/
。
动作 | 命令 |
---|---|
初始化 | npm run init |
启动 | npm run start |
重启 | npm run restart |
停止 | npm run stop |
允许开机启动 | npm run startup |
禁止开机启动 | npm run unstartup |
查看状态 | npm run info |
查看日志 | npm run log |
- 首次运行必须进行初始化以完成 QQ 的新设备认证,随后按下组合键
Ctrl+C
停止,此时初始化完成。- 需要启动一次后才可以允许、禁止开机启动。
进入本项目所在的目录 ./Adachi-BOT/
。
./scripts/is_there_an_update_available.sh
git pull -p
npm install
./scripts/whats_updated_in_the_configuration_files.sh
你可以使用 Meld 把
./config_defaults/
中的变更合并到./config/
里。
npm run restart
功能 | 形式 | 配置选项 | 命令开关 | 管理者命令 |
---|---|---|---|---|
展示米游社、 UID 或者群友的游戏账号 | 插件 | ❌ | ✔️ | ❌ |
展示米游社、 UID 或者群友的深渊战绩 | 插件 | ❌ | ✔️ | ❌ |
米游社账号绑定和改绑 | 插件 | ❌ | ✔️ | ❌ |
圣遗物掉落和强化 | 插件 | ❌ | ✔️ | ❌ |
圣遗物截图评分 | 插件 | ❌ | ✔️ | ❌ |
展示角色官方数据 | 插件 | ❌ | ✔️ | ❌ |
抽卡(支持定轨) | 插件 | ❌ | ✔️ | ❌ |
今日素材、周本素材 | 插件 | ❌ | ✔️ | ❌ |
吃什么、喝什么 | 插件 | ❌ | ✔️ | ❌ |
点歌 | 插件 | ❌ | ✔️ | ❌ |
掷骰子 | 插件 | ❌ | ✔️ | ❌ |
求签 | 插件 | ❌ | ✔️ | ❌ |
主人和其他好友或群聊天、发送广播 | 插件 | ❌ | ❌ | ✔️ |
查看、搜索和统计添加的好友和群 | 插件 | ❌ | ❌ | ✔️ |
群广播和好友广播 | 插件 | ❌ | ❌ | ✔️ |
查看宿主系统状态 | 插件 | ❌ | ❌ | ✔️ |
报告无效 Cookie | 插件 | ❌ | ❌ | ✔️ |
其他管理功能和权限控制开关 | 插件 | ❌ | ❌ | ✔️ |
停止响应指定群 | 自有功能 | ❌ | ✔️ | ❌ |
米游社新闻推送 | 自有功能 | ✔️ | ✔️ | ❌ |
随机复读群信息 | 自有功能 | ✔️ | ❌ | ❌ |
一定时间后撤回机器人发送的群消息 | 自有功能 | ✔️ | ❌ | ❌ |
自我介绍 | 自有功能 | ✔️ | ❌ | ❌ |
上线通知 | 自有功能 | ✔️ | ❌ | ❌ |
请见 Wiki 中的《功能示例》。
此为项目的致谢名单,各项先后顺序均根据首字母排列。
感谢以下人员以及未提及的贡献者们,你们让一切变得更好了。
人员 | 贡献 |
---|---|
490720818 | 网页部分的维护,编写了深渊查询的原始版本 |
Mark9804 | 网页部分的主程,贡献了诸多资源文件 |
SilveryStar | 编写了项目的原始版本,提供了大量资源文件 |
Xm798 | 贡献了诸多资源文件 |
buzhibujuelb | 添加了武器定轨机制,美化了抽卡效果 |
ixCiel | 优化了 Cookie 池使用逻辑 |
本项目的一些功能使用了以下网站提供的 API 。
网站 | 功能 |
---|---|
QQ 音乐 | 歌曲查询 |
可莉特调 | 圣遗物图片识别 |
网易云音乐 | 歌曲查询 |