本帖最后由 lambilly 于 2025-10-16 10:57 编辑
历史上的今天 Home Assistant 集成
这是一个用于 Home Assistant 的集成，通过探数API获取"历史上的今天"数据，并提供滚动显示功能。
功能特点
- 📅 获取历史上的今天重要事件
- 🔄 自动过滤敏感内容（逝世、去世等）
- ⏰ 可配置的数据更新间隔（60-43200分钟）
- 📜 头条滚动显示功能，可配置滚动间隔（5-300秒）
- 🏷️ 中文界面，易于配置
- 📊 提供两个实体：今日历史和滚动历史
安装
通过 HACS 安装（推荐）
- 在 HACS 中点击"集成"
- 点击右下角的"添加自定义存储库"
- 输入仓库URL (https://github.com/lambilly/hass_today_history/) ,并选择类别为"集成"
- 在集成列表中找到"历史上的今天"并安装
- 重启 Home Assistant
手动安装
- 将
custom_components/today_history 文件夹复制到您的 Home Assistant 配置目录中
- 重启 Home Assistant
配置
第一步：获取 API 密钥
- 访问 探数API
- 注册账号并申请免费的"历史上的今天"API密钥
第二步：添加集成
- 进入 Home Assistant → 设置 → 设备与服务 → 集成
- 点击"添加集成"
- 搜索"历史上的今天"
- 输入您的 API 密钥
- 配置数据更新间隔和头条滚动间隔
- 点击提交
实体
集成会创建以下实体：
传感器.今日历史
- 状态: 数据更新时间
- 属性:
title: 标题today_item: 今日历史事件history_list: 历史事件列表total_count: 总事件数量update_interval: 数据更新间隔（分钟）
传感器.滚动历史
- 状态: 当前日期
- 属性:
title: 事件标题year: 事件年份month: 事件月份day: 事件日期content: 事件内容scroll_index: 当前滚动索引total_items: 总事件数量scroll_interval: 滚动间隔（秒）
设备
集成会创建一个名为"信息查询"的设备，包含上述两个实体。
配置选项
在集成选项中可以调整以下设置：
- 数据更新间隔: 60-43200分钟（默认1440分钟，即24小时）
- 头条滚动间隔: 5-300秒（默认30秒）
卡片显示，需要在HACS安装：Lovelace HTML Jinja2 Template card 卡片
type: custom:html-template-card
content: >-
{% set content = state_attr('sensor.xin_xi_cha_xun_gun_dong_li_shi',
'content') %} {% set month =
state_attr('sensor.xin_xi_cha_xun_gun_dong_li_shi', 'month') %} {% set day =
state_attr('sensor.xin_xi_cha_xun_gun_dong_li_shi', 'day') %}<div
style="color: white;"><p align=left><h3 style="color: white; margin-bottom:
0px;">【📋历史上的今天】({{month}}月{{day}}日)</h3> </p> </div> <p align= left
style="color: white; font-size: 1.0em; margin-top: 10px;">{{ content }}</p>
故障排除
常见问题
- API密钥无效
o 检查API密钥是否正确
o 确认在探数API平台已激活"历史上的今天"服务
- 无法获取数据
o 检查网络连接
o 查看Home Assistant日志获取详细错误信息
- 实体不更新
o 检查数据更新间隔设置
o 确认集成配置正确
日志调试
如需调试信息，请在 configuration.yaml 中添加：
logger:
default: info
logs:
custom_components.today_history: debug
支持
如有问题，请：
- 查看 Home Assistant 日志
- 检查集成配置
- 在项目仓库提交 Issue
许可证
MIT License
贡献
欢迎提交 Pull Request 和 Issue 来改进这个集成。
| 
发表于 
