Prayer Times - Automated Salat Reminders

🕌 全球精准礼拜时间 · 智能提醒不缺席

全球伊斯兰礼拜时间精准计算工具,支持20+国家官方算法,含智能背景提醒系统

收藏
6k
安装
1.5k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Prayer Times Skill 基于 AlAdhan API 提供全球伊斯兰五时礼拜时间查询与自动化提醒服务。核心功能分为即时查询与后台提醒两大模式:

即时查询:通过城市/国家名称或经纬度坐标获取当日礼拜时间,支持特定日期查询、下一礼拜倒计时及 JSON 格式输出。内置 20+ 国家官方计算方法自动匹配(如沙特 Umm Al-Qura 法、摩洛哥官方法、埃及宗教部法、土耳其 Diyanet 法等),确保与各国宗教当局发布的时间一致。

后台提醒:通过 cron 任务实现三级提醒机制——礼拜前 10 分钟、正点时刻("Salat First")、礼拜后 5 分钟。即使处于对话中也能触发提醒,适合需要严格遵守礼拜时间的用户。

技术实现:Python 脚本驱动,支持模块化调用(get_prayer_times()get_next_prayer()),可集成到自动化工作流。输出包含伊斯兰历日期、计算方式编号、24小时制时间及下一礼拜倒计时。

显著优点

1. 权威性高:直接对接 AlAdhan 伊斯兰网络 API,采用各国宗教当局认可的官方计算法,非通用估算
2. 覆盖全面:支持全球任意地点,坐标查询精度优于城市名匹配

3. 自动化强:后台 cron 系统实现"设置即忘",无需手动每日查询

4. 无 API 密钥门槛:免费层级即可使用,降低部署成本

5. 多场景适配:即时问答、日程规划、IoT 设备集成均可支持

潜在局限

1. 网络依赖:API 可能因数据中心路由问题(如 DigitalOcean→Hetzner)间歇性不可达,需配合 Cloudflare WARP 等工具使用
2. 时区需手动指定:API 返回当地时间,但"下一礼拜"计算需用户主动提供时区偏移

3. 无内置地理编码:城市名依赖 API 解析,偏僻地点建议直接使用坐标

4. 计算法争议:伊斯兰教法理学派间对晨礼起始角、晡礼时间等有分歧,自动匹配虽覆盖主流,但极个别地区可能需手动覆盖

适合人群

  • 旅居海外的穆斯林需查询当地礼拜时间
  • 严格遵守礼拜时间的虔信者
  • 伊斯兰生活类应用/设备开发者
  • 需要为穆斯林用户定制服务的 AI 助手场景

常规风险

  • 网络层:API 可达性受基础设施路由影响,生产环境建议增加重试机制与 VPN 备选
  • 时间敏感性:cron 任务漂移或系统时间错误会导致提醒失准,需确保服务器 NTP 同步
  • 隐私合规:用户位置数据(城市/坐标)需符合 GDPR 等法规,建议本地处理避免日志留存
  • 宗教敏感性:计算法选择涉及信仰认同,自动匹配失败时应尊重用户主动指定

Prayer Times - Automated Salat Reminders 内容

references文件夹
scripts文件夹
手动下载zip · 24.9 kB
example-cron-jobs.jsonapplication/json
请选择文件