跳至主要內容

- 首页

- 安装及部署

  - 安装
  - 配置
  - 答疑

- 使用及功能

  - 基础命令
  - 功能命令
  - 用户协议
  - 轻雪API

- 资源及插件

  - 资源商店
  - 插件商店

- 开发及贡献

  - 资源包开发
  - 轻雪函数
  - 轻雪插件开发
  - 进程通信

# 答疑

远野千束
大约 2 分钟
使用指南
配置部署

此页内容

- 常见问题
- 推荐方案(QQ)
- 推荐方案(Minecraft)
- 鸣谢

## 常见问题

- 设备上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
  open in new window

## 推荐方案(QQ)

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

## 推荐方案(Minecraft)

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

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

## 鸣谢

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