应用设置

这篇帮你做什么：应用设置 是左侧菜单的一个分组，包含全局设置、指令设置、全局黑白名单、提示设置、自动化统计和高级设置。本页讲的是其中的 高级设置 页——消息发送速度、队列缓冲、定时扫描、缓存、调试日志、图片存储等运行参数的作用范围、默认值与生效时机。其余页面各有专页。

入口：应用设置 → 高级设置。

开始前确认

页面参数分三种生效时机，卡片上有标注：点应用立即生效、点保存后生效、下次服务启动才生效。保存成功不等于已经生效，逐项见下方参考表。
页面底部 恢复默认 会把本页各参数还原为默认值并自动保存，不可撤销；它不影响二维码识别开关。注意：恢复范围还包含全局设置模块——全局设置页里"功能控制"的四个开关（停用群功能、停用私聊功能、停用讨论组功能、退出讨论组）会被一并复位为关闭，"好友申请处理"也会被改回"忽略"（本页的恢复默认只按自己的默认值写回，不会保留你在全局设置页做过的这两类选择）。保存分两步进行：先保存其他默认配置，再单独保存发送限速。即使提示恢复失败，前一步也可能已经生效；请先刷新核对本页及全局设置页的实际值，不要认为所有设置都未改变。

设置项	含义	取值范围与默认值
消息发送限速	机器人发消息的最小间隔（毫秒）；值越小发得越快，过小可能触发平台风控	100–60000，默认 1000
队列缓冲容量	消息队列缓冲区大小（条）	100–10000，默认 1024
不发言踢人扫描间隔	后台检查"多久没发言"的周期（分钟）；踢人阈值在群设置 → 踢人设置配	5–1440，默认 60
人数控制扫描间隔	后台核对群人数的周期（分钟）；目标人数在踢人设置里配	5–1440，默认 30
受保护用户缓存 / 超管列表缓存	名单类数据的缓存时长（分钟）	1–60，默认 5
群配置缓存	单群配置的缓存时长（秒）	10–3600，默认 60
调试模式	日志切到 DEBUG 级别；自动关闭时长 0＝不自动关	0–1440 分钟，默认 60
图片保留天数	群内新图片的本地保留天数	最少 1 天，默认 30
图片 GC 执行计划	历史图片清理周期（六段 cron 表达式）	默认 `0 0 3 * * *`（每天 03:00）
数据备份频率	每天 / 每周 / 每月 / 手动	默认每天，见下节与数据备份与校验
二维码识别	全局总开关	默认关闭

生效与影响：

设置项	保存方式	生效时机	关键影响
消息发送限速	点应用	立即（无需重启）	影响所有出站消息的发送节奏
二维码识别	点应用	立即	须与群级"识别二维码"同时开启才生效，见下文
队列缓冲容量	点保存	下次服务启动才生效（启动时创建缓冲区）	改完需重启服务
调度扫描间隔 / 缓存时长 / 调试模式 / 图片存储 / 备份频率	点保存	保存后生效	缓存改小更实时、改大更省查询；系统在数据变更时会自动失效缓存，这里只是兜底时长

数据备份设置 卡片提供备份频率、立即备份、查看历史和完整性验证。备份覆盖范围、保留与补跑规则、验证的含义、为什么当前没有恢复入口，统一见数据备份与校验专题——该页是备份功能的权威说明，本页不再重复。要点只有一句：备份只覆盖应用数据库，重要备份请复制到其他盘或设备。

消息发送限速：填好后点应用，提示"限速间隔已更新，立即生效"。这一项是热更新，不用重启。
队列缓冲容量：改完点保存并重启服务才生效——这个值只在服务启动时用于创建缓冲区。
调试模式：打开开关并保存后，日志切换为 DEBUG 级别，写入日志文件，不影响控制台显示。调试日志增长较快（50MB 轮转、保留 5 个备份、7 天），排障结束后记得关闭；日志为异步写入（尽力而为），缓冲满时会丢弃日志并上报丢弃计数，不能把调试日志当作逐条完整的记录。
图片处理与存储：关闭开关需要二次确认，且确认后还要点保存才生效；关闭后不再抓取和识别新图片，但历史图片仍按 GC 计划清理。
二维码识别：全局总开关，默认关闭。须与 群聊监控 页的群级"识别二维码"开关同时开启，群内图片消息才会进入二维码识别；修改后点应用立即生效。
刷新所有缓存（页面右上角）：立即清空全部缓存；出现异常旧值时点它，提示"所有缓存已刷新"即成功。