常见问题

• 设备上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安装浏览器

轻雪配置项(Nonebot插件配置项也可以写在此，与dotenv格式不同，应为小写)

配置文件会在首次启动后生成，你可以在config.yml中修改配置项后重启轻雪，绝大多数情况下，你只需要修改superusers和nickname。如果不确定字段的含义，请不要修改（部分在自动生成配置文件中未列出，需手动添加）

# 生成文件的配置项
command_start: [ "/", "" ] # 指令前缀，若没有""空命令头，请开启alconna_use_command_start保证alconna解析正常
host: 127.0.0.1 # 监听地址，默认为本机，若要对外开放请填写0.0.0.0或者你的公网IP
port: 20216 # 绑定端口
nickname: [ "liteyuki" ]  # 机器人昵称
superusers: [ "1919810" ]  # 超级用户

# 未列出的配置项（如要自定义请手动修改）
onebot_access_token: "" # 访问令牌，对公网开放时建议设置
default_language: "zh-CN" # 默认语言，支持i18n部分语言和自行扩展的语言代码
log_level: "INFO" # 日志等级
log_icon: true # 是否显示日志等级图标（某些控制台字体不可用）
auto_report: true # 是否自动上报问题给轻雪服务器，仅包含硬件信息和运行软件版本
fake_device_info: # 统计卡片显示的虚假设备信息，用于保护隐私
  cpu:
    brand: AMD
    cores: 16 # 物理核心数
    logical_cores: 32 # 逻辑核心数
    frequency: 3600 # CPU主频：MHz
  mem:
    total: 32768000000  # 内存总数：字节
alconna_use_command_start: false # alconna是否使用默认指令前缀，默认false
alconna_auto_completion: false # alconna是否自动补全指令，默认false，建议开启

# 其他Nonebot插件的配置项
custom_config_1: "custom_value1"
custom_config_2: "custom_value2"
...

设备要求

• Windows系统版本最低Windows10+/Windows Server 2019+
• Linux系统要支持Python3.10+，推荐Ubuntu 20.04+/CentOS 8+(别用你那b CentOS)
• CPU: 至少1vCPU
• 内存: Bot无其他插件会占用100MB，其他插件占用视具体插件而定，建议1GB以上
• 硬盘: 至少1GB空间
• GPU: 原生轻雪无需GPU，某些插件需要GPU支持，例如AI绘画之类的，具体查看插件文档