Introduction
-
HoshinoBot - 机器人本体
HoshinoBot是基于Python的开源通用QQ机器人框架，插件很多，魔改方便。 -
LLOneBot - 通讯框架
旧有的go-cqhttp方案因为QQ协议的更新经常会出现冻结和无法登录的情况，无奈替换成了性能开销比较大的LiteloaderQQNT框架的LLOneBot方案，目前非常稳定。
由于QQ官方针对协议库的围追堵截, 不断更新加密方案, 我们已无力继续维护此项目. 建议Bot开发者尽快迁移至无头NTQQ项目
备选方案还有基于安卓端的Shamrock和基于无头ntqq的NapCatQQ方案，推荐尝试NapCat，全平台且更加轻量。
HoshinoBot 部署
直接照搬HoshinoBot文档了，部分修改以适配LLOneBot
环境 windows10
-
安装下面的软件/工具
- Python 3.8：https://www.python.org/downloads/windows/
不建议其他版本，如已安装其他版本Python，自行谷歌多Python共存 - Git：https://git-scm.com/download/win
- VScode：https://code.visualstudio.com/Download
- Python 3.8：https://www.python.org/downloads/windows/
-
打开一个合适的文件夹，点击资源管理器左上角的
文件 -> 打开Windows Powershell -
输入以下命令克隆本仓库并安装依赖
1 2 3git clone https://github.com/Ice9Coffee/HoshinoBot.git cd HoshinoBot py -3.8 -m pip install -r requirements.txt若此处有报错信息，请务必解决，将错误信息复制到谷歌搜索一般即可找到解决办法。
若安装python依赖库时下载速度缓慢，可以尝试使用
py -3.8 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt -
回到资源管理器，进入
hoshino文件夹，将config_example文件夹复制一份，重命名为config，然后右键使用VScode打开其中的__bot__.py，按照其中的注释说明进行编辑。如果您不清楚某项设置的作用，请保持默认。
-
回到powershell，输入以下命令，启动 HoshinoBot
1py -3.8 run.py若能看到日志
INFO: Running on 127.0.0.1:8080，说明HoshinoBot启动成功。您可以忽略启动时的WARNING信息。如果出现ERROR，说明部分功能可能加载失败。至此，HoshinoBot的“大脑”已部署成功。接下来我们需要部署LLOneBot与NTQQ，作为HoshinoBot的“口”和“耳”，收发消息。
LLOneBot 部署
- 安装最新版ntqq https://im.qq.com/pcqq/index.shtml
- 安装LLOneBot https://github.com/super1207/install_llob/releases
下载 exe，双击运行即可，之后打开 QQ 的设置，看到了 LLOneBot 就代表安装成功了。 - 对接HoshinoBot
在
QQ设置 -> LLOneBot中启用反向WebSocket服务并添加地址ws://127.0.0.1:8080/ws，然后保存。 - 正式运行
启动HoshinoBot与NTQQ后，私聊机器人发送
在？，若机器人有回复，说明已经成功搭建起HoshinoBot啦！
自用插件
大部分已经被我改的面目全非，功能用法可能不同，仅做自我备份用，如有需要可以去插件库选用心仪的插件。
bot_manager_web
插件项目地址： https://github.com/pcrbot/HosBotManagerWeb
bot功能网页管理，可以分群开关功能，即生效，不需要重启HoshinoBot
aichat-chatGPT
插件项目地址： https://github.com/Cosmos01/aichat-chatGPT
aichat插件，可以利用chatGPT实现QQ机器人对话，支持上下文记忆，可用多种API不只限于openai
我使用的GPT 3.5免费API项目地址： https://github.com/chatanywhere/GPT_API_free
uma_plugin
插件项目地址： https://github.com/azmiao/uma_plugin
赛马娘插件，大佬维护得很好。
Blue_Archive_HoshinoBot
插件项目地址： https://github.com/Cosmos01/Blue_Archive_HoshinoBot
碧蓝档案的插件，很完美，不需要什么修改。
dailynews
插件项目地址： https://github.com/pcrbot/dailynews
每日早报
music
插件项目地址： https://github.com/pcrbot/music
点歌功能
LLOneBot方案有些问题，解决方法：
- 在
QQ设置 -> LLOneBot中填写音乐卡片签名地址：http://napcat-sign.wumiao.wang:2052/music_sign。 - QQ音乐查询接口年久失修，可能需要自行寻找可用的。
picfinder_take
插件项目地址： https://github.com/pcrbot/picfinder_take
识图搜图插件
应该是我魔改最多的插件，主要问题是ntqq使用了新的图片协议，导致拿不到正确的图片地址，请自行摸索。
uma_voi
插件项目地址： https://github.com/Yukari-Lily/uma_voi
自写的赛马娘语音插件，主要工作量在解包与整理语音文件，到后期实际上不止赛马娘语音了233，遇到喜欢的就会加上。
