Unciv游戏规则集验证系统的改进方案

背景介绍

Unciv是一款开源的文明类游戏，其核心机制依赖于一套复杂的规则集系统。在游戏开发过程中，随着版本迭代，某些游戏特性(Uniques)会被标记为"即将废弃"(deprecated)，这可能导致兼容性问题。当前系统对所有废弃特性统一使用黄色警告标识，无法区分"即将失效"和"已经失效"两种状态。

问题分析

现有的规则集验证系统存在以下局限性：

1. 视觉区分不足：所有废弃特性都显示为黄色警告，无法直观反映不同级别的废弃状态
2. 功能影响不明确：玩家和模组开发者难以判断哪些特性已经失效，哪些只是即将失效
3. 错误级别单一：系统仅使用Warning和Error两种级别，缺乏中间状态

技术解决方案

新增错误级别

建议在RulesetErrorSeverity枚举中新增一个中间级别：

enum class RulesetErrorSeverity {
    OK(Color.GREEN),
    WarningOptionsOnly(Color.YELLOW),
    Warning(Color.YELLOW),
    ErrorOptionsOnly(Color.ORANGE), // 新增级别
    Error(Color.RED),
}

验证逻辑调整

在UniqueValidator中，根据废弃级别设置不同的错误严重程度：

val severity = when(deprecationAnnotation.level) {
    DeprecationLevel.WARNING -> RulesetErrorSeverity.WarningOptionsOnly
    else -> RulesetErrorSeverity.ErrorOptionsOnly
}

颜色编码方案

采用三级颜色编码系统：

1. 黄色：警告级别，特性仍有效但即将废弃
2. 橙色：错误级别，特性已部分失效
3. 红色：严重错误，将阻止游戏启动

实现优势

1. 更好的可视性：通过颜色梯度直观展示不同级别的废弃状态
2. 更精确的反馈：帮助开发者准确理解特性状态
3. 渐进式过渡：为特性废弃提供清晰的过渡路径

技术考量

1. 向后兼容：不影响现有规则集的解析和处理
2. 用户体验：保持界面简洁的同时提供更多信息
3. 扩展性：为未来可能新增的验证级别预留空间

结语

这一改进将显著提升Unciv规则集验证系统的表达能力，为模组开发者和玩家提供更精确的反馈，同时保持系统的简洁性和易用性。通过分级显示废弃状态，用户可以更合理地规划模组更新和维护工作。