mirror.Manyana/README.md

144 lines
8.2 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align="center">
<img src="https://socialify.git.ci/avilliai/Manyana/image?description=1&descriptionEditable=based%20on%20mirai&font=Inter&forks=1&issues=1&language=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Favilliai%2FimgBed%2Fmaster%2Fimages%2F24202439348A04800FE5D98F76125113.png&name=1&owner=1&pattern=Circuit%20Board&stargazers=1&theme=Light" alt="Manyana" /></br>
</div>
----
# 🎆鸣谢
- [Mirai](https://github.com/mamoe/mirai)
- [petpet](https://github.com/Dituon/petpet)
- [CjangCjengh-MoeGoe](https://github.com/CjangCjengh/MoeGoe)
- [overflow](https://mirai.mamoe.net/topic/2565/overflow-%E5%B0%86-mirai-%E5%AE%9E%E7%8E%B0%E6%8D%A2%E6%88%90-onebot-%E6%9C%BA%E5%99%A8%E4%BA%BA%E7%9A%84%E5%8F%88%E4%B8%80%E4%B8%AA%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88?_=1712421277845)
- [arona api](https://doc.arona.diyigemt.com/)
- [star-rail-atlas](https://gitee.com/Nwflower/star-rail-atlas)
- [Yiri-mirai](https://github.com/YiriMiraiProject/YiriMirai)
- [install_llob](https://github.com/super1207/install_llob)
- 如果遇到使用问题请在QQ群623265372反馈
<div align="center">
<p>声明本项目根据AGPL V3协议开源任何组织和个人在引用本项目的源码时不得歪曲、隐藏项目的开源事实并需依照协议公开项目的源代码。任何由二次分发行为产生的责任均由行为者自行承担本项目不承担任何连带责任。</p>
</div>
---
[阅读文档](https://doc.luxmix.top/)
> 因本人学业繁忙未来几个月本仓库将以维护为主要工作。如果您有意愿参与开发和维护欢迎pr。
> 未来恢复更新后,开发的重心将转向[Eridanus](https://github.com/avilliai/Eridanus)
>
> 源码矢山警告⚠本仓库一开始是我为了学习py而创建的因此代码内容及项目规划有许多不够明智和成熟的地方加上并没有很好地管理来自其他开发者的pr源码杂乱无章未来有时间会进行整体重构现在……先凑合着吧
# 🚀linux部署
[linux部署脚本](https://github.com/lux-QAQ/Manyana_deploy)
# 🚀windows部署
**如果你没有代理或git连接不稳定可在搭建时选择【镜像源】镜像源和git源完全同步更新。**<br>
压缩包中附带了readme.txt 照做就行<br>
能用Launcher改设置就用launcher改不规范地修改文件导致的格式错误自行搜索解决。<br>
## 方法1搭建工具部署(推荐)
**如果你觉得自己从零开始搭建bot比较困难请使用此方案**<br>
对于windows用户存在两款启动器分别是[Manyana1.x](https://github.com/avilliai/Manyana/releases) 和[Manyana_deploy](https://github.com/lux-QAQ/Manyana_deploy/releases) 你可以根据自己的喜好选择<br>
[Manyana1.x](https://github.com/avilliai/Manyana/releases)使用方式如下。
- 从[release](https://github.com/avilliai/Manyana/releases)下载最大的rar文件并解压
- 如果下载过慢你也可以从Q群623265372获得这个压缩包
- 运行launcher.exe<br>
- 点击主界面 克隆仓库(没有自己的onebot实现的需要额外安装onebot文件夹下的两个文件先qq后llob_install)
- 关闭launcher重启launcher
- 此时可以看到主界面已经变化,填写主界面设置并保存。使用压缩包仅需修改前四项。<br>
- 在第二个页面依次启动overflow和Manyana<br>
## 方法2不使用release(不推荐除非你有丰富bot搭建经验)
- 请确保py版本为3.9
- 请确保已安装[mirai-api-http](https://github.com/project-mirai/mirai-api-http) 并[正确配置](https://github.com/avilliai/wReply/blob/master/setting.yml)
- 强烈推荐使用[release](https://github.com/avilliai/Manyana/releases))的LAUNCHER_ALL_Requirements.rar进行部署请参考 搭建工具部署 部分,这将省去大量折腾的时间。
### 如果你仍坚持不使用一键包
- 从[release](https://github.com/avilliai/wReply/releases/tag/yirimirai-Bot)下载python39_amd.exe并安装(**安装python39的第一步一定要先勾选add to path**)
- 克隆本仓库。找一个你喜欢的目录(**不要带中文**)打开cmd或git bash执行
```
git clone --depth 1 https://github.com/avilliai/Manyana.git
或使用镜像源
git clone --depth 1 https://mirror.ghproxy.com/https://github.com/avilliai/Manyana
其他镜像源(推荐)
git clone --depth 1 https://github.moeyy.xyz/https://github.com/avilliai/Manyana
国内镜像(最快)
git clone --depth 1 https://www.gitlink.org.cn/lux-QAQ/Manyana
```
- 双击Manyana/一键部署脚本.bat即可
- 填写config.json(必做,填写方式见下方)
```
Manyana/config.json的填写示例如下。
{"botName": "机器人名字", "botQQ": "机器人QQ", "master": "你的QQ", "mainGroup": "你自己群的群号","vertify_key": "这里写你http-api的key,尖括号不用带", "port": "httpapi的ws运行端口"}
下面是一个config.json填写实例如使用整合包不要修改后两项
{"botName": "Manyana", "botQQ": "1283992481", "master": "1840094972","mainGroup": "623265372", "vertify_key": "1234567890", "port": "23456"}
```
`对于verify_key和port如果你用了我上面给出的【正确配置】那就不用动这两项。`
- 启动bot
- 自行搭建启动你自己的mirai或overflow以及Manyana/启动脚本.bat
---
# 🍩功能
一些功能不会很快同步到菜单(懒得开ps),请以更新日志为准。
#### 功能列表
搭建后在群内发送@bot 帮助 以查看功能列表。其他相关问题请查看[Manyana wiki](https://github.com/avilliai/Manyana/wiki)
<details markdown='1'><summary>图片版菜单</summary>
<div align="center">
<img width="70%" height="70%" src="data/fonts/help1.png" alt="logo"></br>
<img width="70%" height="70%" src="data/fonts/help2.png" alt="logo"></br>
<img width="70%" height="70%" src="data/fonts/help3.png" alt="logo"></br>
<img width="70%" height="70%" src="data/fonts/help4.png" alt="logo"></br>
<img width="70%" height="70%" src="data/fonts/master.png" alt="logo"></br>
</div>
</details>
#### 未来更新计划
由于学业繁忙下面这些可能要到明年才能开始了如果您有意向参与开发欢迎pr🏵
- [ ] 各大手游/端游数据查询
- [x] 词库优化
- [x] UI重制
- [x] 优化搭建引导
- [x] jmcomic对接
- [ ] [Eridanus](https://github.com/avilliai/Eridanus)
# 🎲可选配置
<details markdown='1'><summary>填写配置文件</summary>
有关配置文件的填写config文件夹每个yaml文件基本都有注释每个yaml文件几乎都是可供修改的默认的记事本即可打开yaml文件但对于windows用户尤其是不熟悉yaml用户结构的用户来说我们强烈建议在launcher的UI中进行配置文件的修改而不是通过记事本。
不规范地修改配置文件将破坏yaml文件结构并最终导致bot无法运行。
</details>
<details markdown='1'><summary>ai回复配置方式</summary>
请查看[Manyana wiki](https://github.com/avilliai/Manyana/wiki/%E8%AE%BE%E7%BD%AEai%E5%AF%B9%E8%AF%9D%E6%A8%A1%E5%9E%8B)
</details>
# 开源协议
由于 mirai 及 yirimirai 均采用了 AGPL-3.0 开源协议,本项目同样采用 AGPL-3.0 协议。<br>
请注意AGPL-3.0 是传染性协议。如果你的项目引用了 Manyana请在发布时公开源代码并同样采用 AGPL-3.0 协议。不得歪曲、隐藏项目开源事实。<br>
# 🎄最后
如果觉得项目还不错的话给个star喵给个star谢谢喵
![Star History Chart](https://api.star-history.com/svg?repos=avilliai/Manyana&type=Date)
其他相关项目如下
- [Enkianthus_tts](https://github.com/avilliai/Enkianthus_tts) 简单易用的语音合成工具
- [Petunia](https://github.com/avilliai/Petunia/releases) 轻量版Manyana无需搭建环境已打包
- [Amaranth](https://github.com/avilliai/Amaranth) 欢迎关注我们的新版启动器
- [Eridanus](https://github.com/avilliai/Eridanus) Manyana直接对接onebot实现的版本欢迎参与开发
感谢JetBrains为开源项目提供的license<br>
<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/PyCharm_icon.png" alt="PyCharm logo." width="50">
<div align="center">
<img width="70%" height="70%" src="https://moe-counter.glitch.me/get/@:manyana" alt="logo"></br>
</div>