app/docs/zh/deploy/config.md

title, order

title	order
配置	2

配置

轻雪配置文件说明

轻雪支持 .yaml、.json 和 .toml 三种文件类型作为配置文件, 您可以根据个人喜好选择使用

配置文件生成

首次运行轻雪后，会生成以下文件和目录结构:

./
├── config.yml # 默认生成的配置文件
└── config/ # 配置目录，可包含多个配置文件
    └── file1.yaml # 示例配置文件1
    └── file2.json # 示例配置文件2
    └── file3.toml # 示例配置文件3

配置文件修改

您可以修改生成的 config.yml 文件或在 config 目录下添加新的配置文件

绝大多数情况下，您只需要修改以下字段:

• superusers：超级用户列表
• nickname：昵称配置

修改完成后，重启轻雪以应用新的配置

配置文件加载

启动轻雪时，会加载项目目录下以下文件和 config 目录下的所有配置文件:

• config.yml
• config.yaml
• config.json
• config.toml

轻雪会自动合并 config 目录下的所有配置文件

这意味着您可以在 config 目录下创建多个配置文件, 轻雪会将它们的内容合并为一个完整的配置

示例配置文件

基础配置项

请注意, 文档中的配置代码是被拆分的, 实际上为一个配置文件(config.yml)，此处仅为方便阅读拆分

Nonebot配置

nonebot:
  # Nonebot机器人的配置，6.3.10版本后，NoneBot下配置已迁移至nonebot键下，不再使用外层配置，但是部分内容会被覆盖，请尽快迁移
  command_start: [ "/", "" ]  # 指令前缀，若没有""空命令头，请开启alconna_use_command_start保证alconna解析正常
  host: 127.0.0.1             # 监听地址，默认为本机，若要接收外部请求请填写0.0.0.0
  port: 20216                 # 绑定端口
  nickname: [ "liteyuki" ]    # 机器人昵称列表
  superusers: [ "1919810" ]   # 超级用户列表

Liteyuki配置

liteyuki:
  # 写在外层的配置项将会被覆盖，建议迁移到liteyuki下
  log_level: "INFO"          # 日志等级
  log_icon: true             # 是否显示日志等级图标（某些控制台字体不可用）
  auto_report: true          # 是否自动上报问题给轻雪服务器
  auto_update: true          # 是否自动更新轻雪，每天4点检查更新
  plugins: [ ]               # 轻雪插件列表
  plugin_dirs: [ ]           # 轻雪插件目录列表

其他配置

以下为默认值，如需自定义请手动添加

# 高级NoneBot配置
nonebot:
  onebot_access_token: ""         # 访问令牌，对公开放时建议设置
  default_language: "zh-CN"       # 默认语言
  alconna_auto_completion: false  # alconna是否自动补全指令，默认false，建议开启
  safe_mode: false                # 安全模式，开启后将不会加载任何第三方NoneBot插件

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

# 开发者选项
liteyuki:
  allow_update: true         # 是否允许更新
  debug: false               # 轻雪调试，开启会自动重载Bot或者资源，其他插件自带的调试功能也将开启
  dev_mode: false            # 开发者模式，开启后将会启动监视者，监视文件变化并自动重载
# ...其他配置项...