油价 HomeAssistant集成

安装/更新

以下两种方法任选其一！

方法1: HACS (点击这里安装)

方法2: 通过 Samba / SFTP 手动安装

下载解压并复制custom_components/oilprice文件夹到HA配置目录下的custom_components文件夹

使用方法：

• 安装完毕后重启Home Assistant。
• 打开 设置 -> 设备与服务 -> 添加集成
• 搜索并选择 油价 (Oil Price)
• 在弹窗中选择地区
• 设置更新周期（小时），默认 12 小时
• 点击提交后，集成会自动创建油价实体
• 如果地区重复或网络不可用，界面会给出友好错误提示
• 会额外创建一个“立即更新”按钮实体，点击后会立刻拉取最新油价

升级说明（重要）

• 本次升级已从“单实体 + 多属性”模式升级为“多实体状态”模式。
• ~~旧命名 you_jie 已统一迁移为 you_jia~~。
• ~~升级后会自动执行：~~
• ~~旧实体重命名（you_jie -> you_jia）~~
• ~~旧单实体自动清理~~
• ~~新按钮命名规范化 ~~
• ~~如升级后仍看到旧实体，请重启 Home Assistant 或重载一次本集成。~~

新实体模型（示例：北京）

• sensor.you_jie_bei_jing_gas92
• sensor.you_jie_bei_jing_gas95
• sensor.you_jie_bei_jing_gas98
• sensor.you_jie_bei_jing_die0
• sensor.you_jie_bei_jing_time
• sensor.you_jie_bei_jing_tips
• sensor.you_jie_bei_jing_update_time
• sensor.you_jie_bei_jing_friendly_name
• button.you_jie_bei_jing_refresh

修改更新周期

• 进入 设置 -> 设备与服务 -> 油价 -> 配置
• 可修改“更新周期（小时）”，保存后会自动重载并应用新周期

说明：新版本无需在configuration.yaml中配置platform: oilprice。

查看是否成功：

• 开发者工具-状态-实体-输入筛选实体
• 输入 油价 关键字进行筛选
• 确认已生成多个独立实体（如 sensor.you_jie_bei_jing_gas92）
• 点击 button.you_jie_bei_jing_refresh 可立即刷新油价
• 查看是否有数据，形如：

面板调用：

1. 打开概览页面，点击右上角三个点，进入「编辑仪表盘」。
2. 点击右下角「添加卡片」，选择「手动」。
3. 粘贴模板代码（任选其一）：
4. 亮色版：油价卡片模板.yaml
5. 深色版：油价卡片模板-深色.yaml
6. 把模板中的实体替换为你自己的实体（重点改这两个）：
7. sensor.you_jie_bei_jing_gas92（及同地区的其它 sensor.you_jie_bei_jing_*）
8. button.you_jie_bei_jing_refresh
9. 保存卡片后返回概览，即可查看油价并点击“立即更新”。

提示：如果你添加的是其他地区，只需要把实体中的 bei_jing 替换为对应地区。

交流

• QQ群：198841186

• 微信群：(添加该机器人，发送“进群”会自动发送邀请链接）