开源项目启动和配置文档

1. 项目目录结构及介绍

开源项目 pvpc-hourly-pricing-card 的目录结构如下：

• .github/：包含与GitHub操作相关的文件，如资金选项等。
• dist/：存放编译后的文件，可能包括JavaScript模块等。
• docs/：文档目录，可能包含项目的说明文档和图片。
• images/：存放项目相关的图片文件。
• .eslintrc：ESLint配置文件，用于保持代码风格的一致性。
• LICENSE：项目使用的许可文件，本项目使用Apache-2.0许可。
• README.md：项目自述文件，包含了项目的描述、功能、安装和使用方法。
• hacs.json：Home Assistant Community Store（HACS）的配置文件，用于在Home Assistant中添加自定义组件。

每个目录和文件都承载着项目的一部分功能，是项目正常运作不可或缺的部分。

2. 项目的启动文件介绍

项目的启动主要依赖于Home Assistant集成。pvpc-hourly-pricing-card 是一个Home Assistant的Lovelace自定义卡片，用于显示西班牙电力小时定价（PVPC）的信息。

启动文件并不在传统意义上存在，因为它是作为Home Assistant的一部分运行的。用户需要通过HACS或者手动方式将自定义卡片集成到Home Assistant中。

• 通过HACS安装：在Home Assistant的HACS界面中添加pvpc-hourly-pricing-card。
• 手动安装：将pvpc-hourly-pricing-card.js文件放置在Home Assistant配置目录的custom_cards/文件夹中。

在Lovelace仪表盘中配置使用该卡片，可以通过以下方式：

• 可视化模式：配置UI -> 添加新卡片 -> PVPC Hourly Pricing Card，然后设置相应的选项。
• YAML模式：在Lovelace仪表板的YAML配置文件中添加相应的卡片配置。

3. 项目的配置文件介绍

项目的配置主要是通过在Lovelace仪表板中的卡片配置来实现的。以下是一些可配置的选项：

• type：定义卡片类型为custom:pvpc-hourly-pricing-card。
• title：卡片的标题，默认为“PVPC Prices”。
• entity：西班牙电力小时定价（PVPC）实体的名称，例如sensor.esios_pvpc。
• entity_injection：（可选）西班牙电力注入定价（Surplus）实体的名称。
• show_current：（可选）是否显示当前价格和定价周期，默认为true。
• show_details：（可选）是否显示当前和下一天的最高和最低价格及时间段，默认为true。
• show_graph：（可选）是否显示当前和下一天的价格图表，默认为true。
• show_info：（可选）是否显示信息，如“明天的数据尚未可用”，默认为true。
• show_only_today：（可选）是否仅显示今天的数据，默认为false。
• graph_baseline_zero：（可选）是否将图表的基线设为零，默认为false。

通过以上配置，用户可以根据自己的需求定制卡片显示的内容和样式。