跳至主要內容
资源包

简介

资源包,亦可根据用途称为主题包、字体包、语言包等,它允许你一定程度上自定义轻雪的外观,并且不用修改源代码

  • 资源/主题商店提供了一些资源包供你选择,你也可以自己制作资源包
  • 资源包的制作很简单,如果你接触过Minecraft的资源包,那么你能够很快就上手,仅需按照原有路径进行文件替换即刻,讲起打包成一个新的资源包。
  • 部分内容制作需要一点点前端基础,例如htmlcss
  • 轻雪原版资源包请查看LiteyukiBot/liteyuki/resources,可以在此基础上进行修改
  • 欢迎各位投稿资源包到轻雪资源商店

远野千束大约 2 分钟使用手册
答疑

常见问题

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

    • 请使用/path/to/python -m pip install -r requirements.txt来安装依赖, 然后用/path/to/python main.py来启动Bot, 其中/path/to/python是你要用来运行Bot的可执行文件
  • 为什么我启动后机器人没有反应?

    • 请检查配置文件的command_startsuperusers,确认你有权限使用命令并按照正确的命令发送
    • 确认命令头没有和nickname{}冲突,例如一个命令是help,但是Bot昵称有一个help,那么将会被解析为nickname而不是命令
  • 更新轻雪失败,报错InvalidGitRepositoryError

    • 请正确安装Git,并使用克隆而非直接下载的方式部署轻雪
  • 怎么登录聊天平台,例如QQ?

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

    • 输入playwright install安装浏览器

远野千束大约 2 分钟使用指南配置部署
用户协议
  1. 本项目遵循MIT协议,你可以自由使用,修改,分发,但是请保留原作者信息
  2. 你可以选择开启auto_report(默认开启),轻雪会收集以下内容
    • 运行环境的设备信息:CPU,内存,系统信息,Python信息
    • 插件信息(不含插件数据),
    • 部分异常信息,
    • 会话负载信息(不含隐私部分) 以上内容仅用于项目的优化,不包含任何隐私信息,且通过安全的方式传输到轻雪的服务器,若你不希望提供这些信息,可以在配置文件中把auto_report设定为false
  3. 本项目不会收集用户的任何隐私信息,但请注意甄别第三方插件的安全性
  4. 使用此项目代表你已经同意以上协议

远野千束小于 1 分钟使用手册
基础命令

基础插件命令

命令前有[S]的表示仅超级用户可用,[O]和[A]分别为群主和群管可用,[P]为私聊可用

轻雪liteyuki

[S]reload-liteyuki  # 重载轻雪
[S]update-liteyuki  # 更新轻雪
[S]liteecho # 查看当前bot
[S]config set <key> value  # 添加配置项,若存在则会覆盖,输入值会被执行,以便于转换为正确的值,"10"和10是不一样的
[S]config get [key]  # 查询配置项,不带key返回配置项列表,推荐私聊使用
[S]reload-resources  # 重载资源
[S]switch-image-mode  # 切换图片模式,该功能需要commit:505468b及以后的Lagrange.OneBot,在普通图片和Markdown图片之间切换,后者更大但有失败的可能
liteyuki-docs  # 查看轻雪文档
# 上述两个命令修改的配置项在数据库中保存,但是优先级低于配置文件,如果配置文件中存在相同的配置项,将会使用配置文件中的配置
------
别名: reload-liteyuki 重启轻雪, update-liteyuki 更新轻雪, reload-resources 重载资源, config 配置, set 设置, get 查询, 
switch-image-mode 切换图片模式, liteyuki-docs 轻雪文档

远野千束大约 2 分钟使用手册
功能命令

功能插件命令

轻雪天气liteyuki_weather

配置项

weather-key # 和风天气的天气key

命令

weather <keywords...> # 查询目标地天气,例如:"天气 北京 海淀", "weather Tokyo Shinjuku"
bind-city <keywords...> # 绑定查询城市,个人全局生效
别名:weather 天气

远野千束小于 1 分钟使用手册
配置

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

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

# 生成文件的配置项
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"
...

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

设备要求

  • 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绘画之类的,具体查看插件文档

远野千束小于 1 分钟使用指南安装