答疑

常见问题

• 设备上Python环境太乱了，pip和python不对应怎么办？

  • 请使用/path/to/python -m pip install -r requirements.txt来安装依赖， 然后用/path/to/python main.py来启动Bot， 其中/path/to/python是你要用来运行Bot的可执行文件

• 为什么我启动后机器人没有反应？

  • 请检查配置文件的command_start或superusers，确认你有权限使用命令并按照正确的命令发送
  • 确认命令头没有和nickname{}冲突，例如一个命令是help，但是Bot昵称有一个help，那么将会被解析为nickname而不是命令

• 更新轻雪失败，报错InvalidGitRepositoryError

  • 请正确安装Git，并使用克隆而非直接下载的方式部署轻雪

• 怎么登录聊天平台，例如QQ？

  • 你有这个问题说明你不是很了解这个项目，本项目不负责实现登录功能，只负责处理和回应消息，登录功能由实现端（协议端）提供， 实现端本身不负责处理响应逻辑，将消息按照OneBot标准处理好上报给轻雪 你需要使用Onebot标准的实现端来连接到轻雪并将消息上报给轻雪，下面已经列出一些推荐的实现端

• Playwright安装失败

  • 输入playwright install安装浏览器

• 有的插件安装后报错无法启动

  • 请先查阅插件文档，确认插件必要配置项完好后，仍然出现问题，请联系插件作者或在安全模式safe_mode: true下启动轻雪，在安全模式下你可以使用npm uninstall卸载问题插件

• 其他问题

  加入QQ群775840726

推荐方案(QQ)

1. Lagrange.OneBot，基于NTQQ的OneBot实现，目前Markdown消息支持Lagrange
2. LLOneBot，NTQQ的OneBot插件，需要安装NTQQ
3. OpenShamrock，基于Lsposed的OneBot11实现
4. TRSS-Yunzai，基于node.js，可使用ws-plugin进行通信
5. go-cqhttp，go语言实现的OneBot11实现端，目前可用性较低
6. Gensokyo，基于 OneBot QQ官方机器人Api Golang 原生实现，需要官方机器人权限
7. 人工实现的Onebot协议，自己整一个WebSocket客户端，看着QQ的消息，然后给轻雪传输数据

推荐方案(Minecraft)

1. MinecraftOneBot，我们专门为Minecraft开发的服务器Bot，支持OneBotV11标准

使用其他项目连接请先自行查阅文档，若有困难请联系对应开发者而不是Liteyuki的开发者

鸣谢

• Nonebot2提供的框架支持
• nonebot-plugin-alconna提供的命令解析功能
• MiSans，MapleMono提供的字体，且遵守了相关字体开源协议