本帖最后由 lambilly 于 2025-10-12 13:47 编辑
天聚数行免费版集成 v1.0.0 发布要点（2025-10-11）
天聚数行免费版 Home Assistant 集成
这是一个专为 Home Assistant 设计的免费版天聚数行API集成，提供丰富的中文文化内容。 🆓 为什么开发免费版？由于天聚数行API非会员最多只能申请10个免费API接口，为了让更广大的用户能够使用这些优质的文化内容，我们特别开发了这个免费版集成。
免费版特点：- ✅ 完全免费 - 无需付费API密钥
- ✅ 精选内容 - 保留最受欢迎的10个API接口
- ✅ 独立实体 - 每个API对应一个独立传感器，便于使用
- ✅ 智能缓存 - 1小时缓存机制，避免API调用超限
- ✅ 滚动展示 - 根据时间段智能切换显示内容
📋 包含内容本集成包含以下11个传感器实体： - 每日笑话 - 轻松一刻，每日更新
- 早安心语 - 温馨问候，开启美好一天
- 晚安心语 - 温馨祝福，伴您入眠
- 唐诗鉴赏 - 经典唐诗，文化瑰宝
- 最美宋词 - 婉约豪放，词韵悠长
- 精选元曲 - 戏曲精华，艺术传承
- 简说历史 - 历史知识，温故知新
- 古籍名句 - 经典名句，智慧结晶
- 经典对联 - 传统对联，文化韵味
- 英文格言 - 双语格言，启迪智慧
- 滚动内容 - 智能切换，全天候展示
天聚数行集成 v1.1.2 更新要点（2025-10-11）
1. 删除谜语笑话实体（使实体减少到9个，可以不申请会员使用API)2. 重新规划时间段🌅早安问候：5:30-8:29 ☘️英文格言：8:30-10:59 🌻古籍名句：11:00-12:59 🔖经典对联：13:00-13:59 🏷️简说历史：14:00-14:59 🔖唐诗鉴赏：15:00-16:59 🌼最美宋词：17:00-18:29 🔖精选元曲：18:30-20:59（延长时段） 🌃晚安问候：21:00-次日5:29
3. 优化滚动内容属性4. 改进首次加载体验5. 版本更新更新版本号为 v1.1.2 优化了缓存检查逻辑，移除了不再需要的缓存键
这些修改使集成更加精简，同时提供了更好的用户体验和更合理的时间段分配。
本回答由 AI 生成，内容仅供参考，请仔细甄别。
天聚数行集成 v1.1.0 更新要点（2025-10-10）
🎯 主要改进
1. 滚动内容传感器优化- 内容格式分离：将滚动内容分为 content1（纯内容）和 content2（完整信息）
2. 显示格式统一- HTML格式：content1 使用 <br> 标签进行换行，适合网页显示
- 纯文本格式：content2 使用 \n 进行换行，适合语音播报和文本处理
- 对齐方式：根据不同内容类型设置合适的对齐方式（居中或左对齐）
3. 时间段内容优化- 早安时段 (5:30-8:29)：显示早安问候语
- 格言时段 (8:30-10:59)：显示中英文对照格言
- 笑话时段 (11:00-12:59)：显示今日笑话
- 名句时段 (13:00-13:59)：显示古籍名句及出处
- 对联时段 (14:00-14:59)：显示经典对联
- 历史时段 (15:00-16:59)：显示简说历史
- 唐诗时段 (17:00-18:29)：显示唐诗及作者信息
- 宋词时段 (18:30-20:29)：显示宋词及出处
- 元曲时段 (20:30-20:59)：显示元曲及作者信息
- 谜语时段 (21:00-21:59)：显示谜语及答案
- 晚安时段 (22:00-次日5:29)：显示晚安问候语
4. 技术改进- 缓存机制：使用全局缓存避免重复API调用，提高性能
- 错误处理：增加重试机制，最多重试3次获取数据
- 数据验证：检查缓存数据完整性和有效性
- 日志记录：详细的日志记录，便于问题排查
5. 用户体验提升- 语音播报：为每个时段设置合适的语音播报标题
- 内容格式化：智能处理换行，提升阅读体验
- 状态反馈：清晰的状态提示，显示数据获取进度
🔄 向后兼容性- 所有现有配置和API接口保持不变
- 传感器实体ID和属性结构保持兼容
- 升级过程无需用户干预
📝 使用说明更新后，滚动内容传感器将根据时间段自动切换显示内容，且 content1 和 content2 分别适用于不同的使用场景： - content1：适合直接显示，内容简洁
- content2：适合需要完整信息的场景，如语音播报
此次更新主要优化了内容显示格式，提升了用户体验，同时保持了系统的稳定性和性能。 首页卡片截图如下，内容会定时滚动：
蘑菇卡片代码如下：
type: custom:html-template-card
content: >
{% set entity = 'sensor.gun_dong_nei_rong' %}<div style="color: white;"><p
align="left"><h3 style="color: white; margin-bottom: 0px;">【{{
state_attr(entity, 'title') }}】</h3><p align="{{ state_attr(entity,
'subalign') }}" style="color: yellow; margin: 0px 0;"><b>{{ state_attr(entity,
'subtitle') }}</b></p></div> <p align="{{ state_attr(entity, 'align') }}"
style="color: white; font-size: 1.0em; margin-top: 10px;">{{
state_attr(entity, 'content1') }}
天聚数行集成 v1.0.0 更新要点（2025-10-01）
在AI的帮助下糊里糊涂搞成了我的第一个HomeAssistant集成，已上传到github，地址：https://github.com/lambilly/hass_tian_api。说实话还不知道如何弄到HACS中去。
也可以下面直接下载。
# 天聚数行API Home Assistant 集成
这是一个为 Home Assistant 开发的定制集成，用于从[天聚数行](https://www.tianapi.com/)获取各类文化资讯内容，包括谜语笑话、早安晚安、古诗宋词和每日一言等。
## 功能特点
- 🎭 **谜语笑话** - 每日谜语和笑话
- 🌅 **早安晚安** - 早安心语和晚安心语
- 📜 **古诗宋词** - 唐诗、宋词、元曲鉴赏
- 💬 **每日一言** - 历史知识、古籍名句、经典对联和英文格言
## 安装前准备
### 1. 获取 API 密钥
在使用本集成前，您需要先申请天聚数行的 API 密钥：
1. 访问 [天聚数行官网](https://www.tianapi.com/)
2. 注册账号并登录
3. 进入控制台，申请 API 密钥
4. 确保您的账户有足够的调用次数（免费版本通常有每日限制）
### 2. 启用自定义集成
Home Assistant 需要启用自定义集成功能：
1. 确保您的 Home Assistant 实例可以访问互联网
2. 确认已启用高级模式（在用户配置文件中设置）
## 安装方法
### 方法一：通过 HACS 安装（推荐）
1. 确保已安装 [HACS](https://hacs.xyz/)
2. 在 HACS 的 "Integrations" 页面，点击右上角的三个点菜单，选择 "Custom repositories"
3. 在弹出窗口中添加仓库地址：https://github.com/lambilly/hass_tian_free，类别选择 "Integration"
4. 在 HACS 中搜索 "天聚数行API"
5. 点击下载
6. 重启 Home Assistant
### 方法二：手动安装
1. 下载本集成文件
2. 将 `custom_components/tian_api` 文件夹复制到您的 Home Assistant 配置目录中的 `custom_components` 文件夹内
3. 重启 Home Assistant
## 配置步骤
### 1. 添加集成
1. 进入 Home Assistant 的 **设置** → **设备与服务** → **集成**
2. 点击右下角的 **添加集成** 按钮
3. 搜索 "天聚数行API"
4. 点击进入配置界面
### 2. 输入 API 密钥
1. 在弹出的对话框中输入您从天行数据获取的 API 密钥
2. API 密钥应为 32 位字符串
3. 点击 **提交**
### 3. 完成安装
集成会自动创建以下实体：
- `sensor.mi_yu_xiao_hua` - 谜语笑话
- `sensor.zao_an_wan_an` - 早安晚安
- `sensor.gu_shi_song_ci` - 古诗宋词
- `sensor.mei_ri_yi_yan` - 每日一言
- `sensor.gun_dong_nei_rong` - 每日一言
所有实体都会归属于名为 **"天聚信息查询"** 的设备。
## 实体说明
### 实体状态 (State)
所有四个实体的状态 (State) 都显示为**最后更新时间**，格式为 "YYYY-MM-DD HH:MM:SS"。
### 实体属性
#### 谜语笑话实体
- **状态**: 最后更新时间
- **属性**:
- `riddle`: 谜语详细信息（内容、答案、类型等）
- `joke`: 笑话详细信息（标题、内容）
- `update_time`: 最后更新时间
#### 早安晚安实体
- **状态**: 最后更新时间
- **属性**:
- `morning`: 完整的早安心语
- `evening`: 完整的晚安心语
- `update_time`: 最后更新时间
#### 古诗宋词实体
- **状态**: 最后更新时间
- **属性**:
- `tangshi`: 唐诗详细信息（内容、作者、注释等）
- `songci`: 宋词详细信息
- `yuanqu`: 元曲详细信息
- `update_time`: 最后更新时间
#### 每日一言实体
- **状态**: 最后更新时间
- **属性**:
- `history`: 简说历史内容
- `sentence`: 古籍名句
- `couplet`: 经典对联
- `maxim`: 英文格言（含中文翻译）
- `update_time`: 最后更新时间
## API 调用说明
本集成使用以下天聚数行 API 接口：
- `caizimi/index` - 谜语
- `joke/index` - 笑话
- `zaoan/index` - 早安
- `wanan/index` - 晚安
- `poetry/index` - 唐诗
- `zmsc/index` - 宋词
- `yuanqu/index` - 元曲
- `pitlishi/index` - 历史
- `gjmj/index` - 名句
- `duilian/index` - 对联
- `enmaxim/index` - 英文格言
## 技术支持
如有问题，请：
1. 查看本 README 文档
2. 检查 Home Assistant 日志
3. 访问 [天聚数行官方文档](https://www.tianapi.com/)
4. 在项目 Issues 页面提交问题
## 版本历史
- v1.0.0 - 初始版本，集成四个主要功能模块，实体状态显示最后更新时间
## 免责声明
本集成为第三方开发，与天聚数行官方无关。使用本集成需要遵守天聚数行的 API 使用条款和调用限制。
天聚数行免费版v1.0.0集成下载地址：
天聚数行API版v1.1.2集成下载地址：（后续不再更新此版，只更新免费版）
| 
发表于 2025-10-1 20:32:26
