开源项目安装与配置指南：垃圾收集卡（Garbage Collection Card）

1. 项目基础介绍

垃圾收集卡（Garbage Collection Card）是一个用于Home Assistant的Lovelace UI的自定义卡片。它可以显示垃圾收集信息，这些信息由Garbage Collection自定义组件提供。该卡片能够在垃圾收集前一天改变图标颜色，以提醒用户。

该项目主要使用JavaScript进行开发，它是Home Assistant Lovelace UI自定义卡片的标准编程语言。

2. 项目使用的关键技术和框架

• Home Assistant: 一个智能家居自动化平台，本项目为其提供自定义卡片。
• Lovelace UI: Home Assistant的一个前端界面，允许用户自定义和控制家居自动化系统。
• JavaScript: 用于编写自定义卡片的脚本语言。
• MIT License: 该项目的开源协议，允许用户自由使用、修改和分享。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您已经满足以下条件：

• 安装了Home Assistant。
• Home Assistant中安装了HACS（Home Assistant Community Store）。
• 如果不使用HACS，则需要能够访问GitHub和下载文件。

安装步骤

使用HACS安装

1. 打开Home Assistant的Lovelace UI。
2. 进入“配置” > “HACS” > “集成”。
3. 点击“添加集成”，搜索“Garbage Collection Card”，然后安装。
4. 安装完成后，在Lovelace UI中刷新页面。

手动安装

1. 访问项目的GitHub页面，下载garbage-collection-card.js文件。
2. 将下载的文件放到homeassistant_config_dir/www/community/garbage-collection-card/目录下。
3. 如果没有community目录，则需要创建它。
4. 重新加载Home Assistant配置。

配置步骤

1. 在Home Assistant的Lovelace UI中，进入“配置” > “Lovelace仪表板” > “资源”。
2. 点击“添加资源”，选择“模块”类型，输入以下URL（如果是手动安装，则是本地路径）：

   - type: module
     url: '/hacsfiles/garbage-collection-card/garbage-collection-card.js'
   

3. 保存并返回仪表板。
4. 在仪表板的编辑模式下，添加一个自定义卡片，选择“Garbage Collection Card”。
5. 根据需要配置卡片的参数，例如entity、icon_size、icon_color等。

完成以上步骤后，您的垃圾收集卡应该就可以在Lovelace UI中正常显示了。记得根据实际情况调整配置，以达到最佳显示效果。