OliveTin配置升级指南：2025.x.x版本关键变更解析

背景概述

OliveTin作为一款轻量级的Web界面工具，在2025.x.x版本中对配置语法进行了重要优化。本次升级主要针对触发器(trigger)配置项进行了标准化改造，将原先的单行声明方式调整为列表结构，这一变更显著提升了配置文件的规范性和可扩展性。

核心变更点

在2025.x.x版本中，触发器配置语法从原有的单行模式：

trigger: Update container entity file

升级为标准的YAML列表结构：

triggers: 
  - Update container entity file

技术原理

1. 语法规范化：新版本采用YAML标准列表语法，符合配置管理的最佳实践
2. 多触发器支持：列表结构为未来支持多个触发器奠定了基础
3. 配置可读性：清晰的缩进和列表标记提升了配置文件的可维护性

影响范围

该变更主要影响以下功能场景：

• 容器状态监控面板
• 自动化任务触发机制
• 实体(entity)更新流程

升级建议

1. 使用文本编辑器全局搜索trigger:关键字
2. 将所有匹配项替换为triggers:列表格式
3. 特别注意Dashboard部分的相关配置
4. 升级后建议执行配置校验命令

典型配置示例

dashboards:
  - title: Docker监控面板
    contents:
      - title: '容器管理'
        entity: container
        triggers: 
          - Update container entity file
          - Log rotation trigger

注意事项

1. 修改配置后需要重启OliveTin服务
2. 建议保留旧配置备份
3. 新语法完全向后兼容，不会影响现有功能

总结

2025.x.x版本的这项改进体现了OliveTin项目对配置标准化和未来扩展性的重视。开发者只需进行简单的语法调整即可获得更健壮的配置系统，为后续功能扩展打下了良好基础。建议所有用户尽快完成配置升级以获得最佳体验。