配置总览

配置文件位置

plugins/DominionProtect/config.yml

配置由插件启动时生成。修改后执行：

/domp admin reload

如果修改涉及数据库连接、表结构或依赖加载，建议安排重启并查看启动日志。

配置分组

分组	负责什么	重点键
language / debug	语言与调试	language、debug
database	连接池、存储优化、压缩、索引观察	poolSize、optimizeStorageOnStartup
recording	双缓冲刷新、批量写入和动作白名单	flushIntervalSeconds、batchSize
subscription	Vault 不可用策略、默认方案和方案列表	vaultUnavailableStrategy、plans
query	审查默认时间与分页	inspectDefaultTime、pageSize
rollback	上限、预览、确认和执行节奏	maxRecords、previewMaxBlocks
cleanup	过期宽限、历史保留、失败文件和空间回收	gracePeriodDays、maxRetentionDays

修改原则

• 先备份 config.yml，不要修改 version；
• 降低 recording.batchSize 或缩短刷新间隔会改变数据库写入压力；
• enabledActions 非空时进入白名单模式，disabledActions 优先级更高；
• rollback.maxRecords 是安全阈值，不建议为了“方便”无限放大；
• 生产环境优先使用独立数据库账号，并保持 dropUnusedActionIndex 与 dropUnusedDestinationIndex 为 false，直到观察期确认索引确实无用；
• 配置、实际生成文件和当前版本日志不一致时，以当前版本生成内容为准。