本帖最后由 hhh. 于 2026-7-8 14:54 编辑
前言
天元历法集成可以说是 [流程系列] node-red本地计算万年历流程+万年历卡片 的集成版本。
所以原 node-red 流程 将不再更新，同样原 Lunar Info Card 农历卡片，已适配集成。
有人会问，一个农历集成，增加这么多 岐黄 和 术数 实体干嘛？
我想因人而异，如果喜欢传统文化，那么 可以根据 季节/气候/环境为基础，配合 岐黄 实体，提供专业的 中医养生知识，如：真太阳时为子时，胆经当令，提醒睡觉。等等等等。
同样 术数 实体，也有其他用处，在这不展开。
当然，如果只需要农历信息，集成提供 子设备 开关，可按需选择。
🌙天元历法 (TianYuan Calendar)
天元历法不再仅仅是历法传感器，它是一个深度整合中国传统“天文、术数、医学”的智能引擎。通过真太阳时修正，为用户提供精确的排盘、取穴与卦象预测。
✨ 核心特性
系统使用本地数据库作为数据源，所有逻辑均在 本地离线计算 完成。
📅 基础历法 (Foundation)
- 精准农历：支持完整的农历日期、闰月提醒、月相信息。🌙
- 二十四节气：提供节气倒计时、精确交节时刻及物候描述。🍂
- 法定节假日：实时同步国家放假安排，包含加班调休提醒、最近节日预报。🏮
🔭 天文授时 (Accuracy)
- 真太阳时 (TST)：基于地理经度自动修正均时差，提供真正意义上的“地方时”，是术数推算与子午流注的灵魂。☀️
☯️ 术数与预测 (Advanced Shushu)
⚙️ 逻辑化架构
- 多设备管理：默认添加天元农历设备，岐黄和术数子设备，可按需开启。
- 动态清理：关闭功能开关后，系统会自动清理注册表，不留“幽灵实体”。
📦 安装
⚙️ 配置 (Configuration)
步骤 1：添加集成
- 进入 Home Assistant 的 设置 -> 设备与服务 -> 添加集成。
- 搜索并选择 天元农历 (TianYuan Lunar)。
- 在配置界面填写以下基础信息：
- 自定义经度：输入您所在位置的经度（例如：北京 116.4、上海 121.4）。用于计算极其精确的真太阳时，默认为自动识别HA地点。
- 刷新频率：建议设置为 1 至 5 分钟，以保证时辰和真太阳时状态实时更新。
步骤 2：选项设置 (UI Options)
集成添加后，点击 “选项” 可实时调整以下高级参数： - 计算模式 (Calculation Mode)：
- 系统时间 (ST)：默认模式。农历属性（宜忌、干支等）参考北京时间。
- 真太阳时 (TST)：专业模式。农历属性完全依据地理位置的真实太阳高度角计算。
- 开启更多实体：开启后农历设备生成更多实体。
- 开启天元岐黄：开启后将添加子设备（TianYuan QiHuang）生成子午流注（纳甲、纳子）、灵龟八法，五运六气等专业医学传感器。
- 开启天元术数：开启后将添加子设备（TianYuan ShuShu）生成小六壬，梅花易数，皇极经世，易经卦象等术数传感器。
🤝 感谢
- 感谢 lunar-python 提供的强大核心算法库。
- 感谢作者 6tail 的开源贡献
🤝 贡献
欢迎贡献代码、报告问题或提出功能建议！ - 提交Issues：报告问题或功能请求
- 提交Pull Requests：贡献代码改进
- 项目讨论：分享使用经验或建议
📄 许可证
本项目基于MIT许可证开源。详情请查看LICENSE文件。
❤️ 支持
如果这个项目对您有帮助，请给项目点个Star ⭐！
📜 免责声明
本集成提供的数据仅供传统文化研究与居家参考使用。涉及中医养生及择日等信息时，请结合专业建议。
兼容版本: Home Assistant 2024.5+
集成添加+配置+日历卡片
集成最小添加（默认）
集成界面
天元农历界面
天元岐黄界面
天元术数界面
| 
发表于 2026-7-8 14:55:34
发表于 2026-7-8 18:06:05
