Dashy 配置中关于子项(subItems)标题的注意事项

Dashy 是一款开源的仪表盘工具，允许用户通过 YAML 配置文件自定义界面布局。在使用过程中，开发者需要注意子项(subItems)的配置方式，以避免出现配置验证警告。

问题现象

在 Dashy 2.1.1 和 2.1.2 版本中，当用户按照以下方式配置子项时：

- title: 示例主项
- subItems:
    - title: 示例子项

系统会抛出配置验证警告："/sections/7/items/5 must have required property 'title'"

正确配置方式

实际上，Dashy 的子项配置需要遵循特定的嵌套结构。正确的配置方式应该是：

- title: 示例主项
  subItems:
    - title: 示例子项

或者如果不需要主项标题，可以这样配置：

- subItems:
    - title: 示例子项

技术原理

这个问题的根源在于 Dashy 的配置验证机制。系统会检查每个配置项是否符合预定义的 JSON Schema 结构。当子项被错误地放置在顶级而非嵌套在父项下时，验证器会认为这是一个缺失了必要属性的配置项。

最佳实践建议

1. 始终确保子项(subItems)被正确地嵌套在父项下
2. 使用 YAML 编辑器的智能提示功能可以帮助避免此类错误
3. 对于复杂的配置，建议先在小范围内测试验证通过后再扩展到整个配置文件

通过遵循这些简单的规则，用户可以避免配置验证警告，同时确保 Dashy 仪表盘能够按照预期正常工作。