Kavita项目用户评分过滤器功能缺陷分析与解决方案

问题背景

在Kavita 0.8.3稳定版中，用户反馈了图书馆过滤功能中关于用户评分的多个异常现象。主要表现为：当使用小于等于100%的过滤条件时本应返回所有书籍却无结果返回；大于80%的条件会错误地包含60%评分的书籍；而等于特定值的过滤则完全失效。

技术分析

经过深入排查，发现问题的根源在于系统内部对用户评分的存储方式与前端过滤逻辑存在不一致性：

1. 数据存储机制：Kavita实际将用户评分以0-5的十进制浮点数形式存储在数据库中
2. 前端交互设计：过滤界面却要求用户输入0-100%的百分比数值
3. 转换逻辑缺陷：在过滤条件处理时，百分比数值到实际评分值的转换存在逻辑错误，导致比较运算失效

解决方案设计

针对该问题，我们提出了以下改进方案：

1. 统一数值标准：将过滤条件的输入范围调整为与存储格式一致的0-5分制
2. 精确比较算法：实现严格的数值比较逻辑，避免浮点数精度问题
3. 前端显示优化：虽然UI仍显示百分比评分，但内部处理时进行规范化转换

技术实现细节

具体实施时需要注意以下技术要点：

• 在过滤条件解析层添加数值标准化处理
• 对浮点数比较采用容差范围内的近似相等判断
• 保持用户界面显示的一致性，仅在数据处理层进行转换
• 增加边界条件的测试用例，确保0%和100%等极端值的正确处理

用户影响评估

该改进方案将带来以下用户体验提升：

1. 过滤结果将严格符合数学逻辑预期
2. 消除当前存在的各种边界条件异常
3. 保持界面显示习惯的同时提高功能可靠性

后续优化方向

未来可考虑进一步优化：

• 实现多评分源的平均值计算前进行规范化处理
• 增加评分分布直方图等可视化过滤辅助功能
• 支持更灵活的范围查询语法

该修复已在最新版本中部署，建议用户升级到包含此修复的版本以获得完整的过滤功能体验。