Xiaomi Vacuum Map Card 房间清洁功能消失问题解析

问题现象

在使用Xiaomi Vacuum Map Card（小米扫地机器人地图卡片）v2.3.1版本时，用户发现"房间清洁"功能选项突然消失，仅剩下"区域清洁"和"定点清扫"两个选项。尽管地图上所有房间仍然正常显示颜色标识，但无法选择特定房间进行清洁。

问题原因分析

经过技术排查，发现该问题主要由以下配置问题导致：

1. 卡片配置不完整：用户仅配置了地图源和校准源，但未在卡片配置中明确设置房间清洁相关参数。

2. 过度配置地图提取器：用户使用了完整的地图提取器配置而非推荐配置，虽然不影响功能但增加了系统负担。

解决方案

1. 完善卡片配置

正确的卡片配置应包含房间清洁相关设置。以下是推荐的最小配置示例：

type: custom:xiaomi-vacuum-map-card
map_source:
  camera: camera.xiaomi_cloud_map_extractor
calibration_source:
  camera: true
entity: vacuum.rrs5
vacuum_platform: Xiaomi Miio
map_locked: true

要恢复房间清洁功能，用户需要通过卡片编辑器中的"生成房间配置"按钮自动添加房间清洁相关配置。

2. 优化地图提取器配置

虽然这不是导致功能消失的直接原因，但建议用户简化地图提取器配置：

• 移除不必要的属性
• 仅保留实际使用的绘图元素
• 简化颜色配置

这样可以降低Home Assistant系统的资源消耗，提高整体性能。

技术背景

Xiaomi Vacuum Map Card的工作原理是：

1. 通过地图提取器获取扫地机器人的实时地图数据
2. 解析地图中的房间划分信息
3. 提供可视化界面和交互控制

房间清洁功能的显示依赖于两个关键要素：

• 地图提取器正确识别并标记了各个房间
• 卡片配置中明确启用了房间清洁选项

最佳实践建议

1. 定期备份配置：在进行重大更新前备份卡片配置
2. 渐进式配置：先使用基本配置，再逐步添加高级功能
3. 关注更新日志：了解新版本可能带来的配置变更
4. 合理使用自动化：可以设置自动化规则在特定条件下自动触发房间清洁

总结

该问题属于配置遗漏导致的常见问题，通过完善卡片配置即可解决。对于智能家居系统，保持配置的简洁性和规范性是避免类似问题的关键。建议用户在修改配置时遵循"最小必要"原则，只启用实际需要的功能，这样既能保证系统稳定运行，也便于后期维护和故障排查。