> 规范网页：https://docs.tensuu.com/功能模块详解/16_应用设置.html ｜ Markdown：/功能模块详解/16_应用设置.md ｜ 文档修订：2026.10.26

# 应用设置

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

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

## 开始前确认

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

## 设置项参考

| 设置项 | 含义 | 取值范围与默认值 |
| --- | --- | --- |
| 消息发送限速 | 机器人发消息的最小间隔（毫秒）；值越小发得越快，过小可能触发平台风控 | 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） |
| 数据备份频率 | 每天 / 每周 / 每月 / 手动 | 默认每天，见下节与[数据备份与校验](07_云端设置.md) |
| 二维码识别 | 全局总开关 | 默认关闭 |

生效与影响：

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

## 数据备份（本页仅作入口说明）

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

## 各卡片操作要点

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

## 没成功先检查什么

- 点了保存但数值变回去：刷新页面回读；仍不一致说明保存失败，看错误提示。
- 提示"配置已被其他窗口修改，已刷新为最新值"：页面已重载最新配置，按最新值重新调整后再保存；不要两个窗口同时改同一项。
- 提示"设置读取版本未加载，请刷新页面后重试"：本次没有拿到配置的读取版本，保存未发出，刷新页面后重试即可。
- 改了队列容量"没效果"：该参数要重启服务才生效。
- 备份一直"执行中"或失败：查看历史里的错误信息列；备份写盘需要部署配置中指定的备份目录可用，更多核对项见[数据备份与校验](07_云端设置.md)。
- 想确认缓存改动生效：点 **刷新所有缓存**，提示"所有缓存已刷新"。

## 关闭或改回

- 恢复默认参数：页面底部 **恢复默认**（自动保存，不可撤销）。
- 停止自动备份：频率改为"手动"，保存。
- 关闭调试模式：关掉开关并保存，或等自动关闭时长到期。
- 停止图片处理：关闭开关、确认、保存；恢复则重新打开。

## 和其他页面的关系

- 备份功能的完整说明（覆盖范围、保留、验证、恢复边界）见[数据备份与校验](07_云端设置.md)。
- 全局设置页的"功能控制"开关与本页恢复默认的跨页影响见[全局设置](01_全局设置.md)。
- 公告与版本信息查看见[公告管理](29_公告管理.md)。
- 首次安装与部署步骤见[使用指南](../快速入门指南/使用指南.md)。