prayer-times

该 Skill 为穆斯林用户提供了一套完整的礼拜时间查询与提醒解决方案，通过接入权威的 AlAdhan API，结合 20 余种国家特定计算方法，确保全球任何地点的祈祷时间准确性。

核心用法分为即时查询与自动化提醒两大模式。即时查询支持通过城市名、国家名或精确坐标获取当日五次礼拜（Fajr、Dhuhr、Asr、Maghrib、Isha）时间，并可计算距离下一次礼拜的剩余时间；自动化提醒则通过后台定时任务实现三段式通知：礼拜前 10 分钟提醒准备、礼拜时刻正点提醒、以及礼拜后 5 分钟的补礼提示，即使用户正在进行对话也不会错过。

显著优点包括高度的权威性与本地化支持。系统内置摩洛哥、沙特、埃及、土耳其、阿联酋等 20 多个国家的官方计算方法自动匹配，避免了用户手动选择计算规则的困扰。同时，基于 Python 的轻量级脚本设计使得部署简单，输出格式支持纯文本与 JSON，便于与其他工具集成。

潜在缺点主要体现在网络依赖性与来源可信度。该 Skill 完全依赖 AlAdhan API 的在线服务，在部分数据中心网络环境下可能出现连接问题，需要通过 Cloudflare WARP 等 VPN 工具解决。此外，开发者 diepox 为个人账号（T3 来源），虽代码通过安全审计，但长期维护与更新稳定性仍需观察。

适合的目标群体主要为有固定礼拜需求的穆斯林用户，特别是生活在非伊斯兰国家、需要精确计算当地礼拜时间的海外穆斯林，以及希望建立自动化礼拜提醒习惯的用户。对于伊斯兰金融机构、清真寺或宗教应用开发者，该 Skill 也可作为基础时间计算模块集成。

使用风险包括 API 服务的稳定性与可用性限制。AlAdhan API 虽提供免费服务且 uptime 高达 99%+，但仍存在速率限制与偶发网络不可达情况。用户需正确配置时区偏移参数，否则"下次礼拜"计算将出现偏差。此外，自动化提醒功能需要配置 cron 任务持续运行，可能产生约每月 2 美元的计算资源成本。数据隐私方面，仅传输城市名或坐标至 API，无敏感信息泄露风险，但用户应谨慎评估文档中提供的 VPN 安装脚本，建议在隔离环境中执行系统级命令。

核心用法

Prayer Times 是一款面向全球穆斯林用户的祈祷时间查询与提醒工具，基于成熟的 AlAdhan API 提供精确的每日五时礼拜时刻（晨礼Fajr、晌礼Dhuhr、晡礼Asr、昏礼Maghrib、宵礼Isha）。用户可通过城市名或地理坐标快速查询，系统自动识别20+国家的官方计算方法（如沙特Umm Al-Qura、土耳其Diyanet、埃及官方标准等），确保结果符合当地宗教权威认定。

显著优点：

• 地域精准度高：内置20+国家专属计算法，自动匹配无需手动选择，避免跨地区误差
• 零配置门槛：无需注册API密钥，开箱即用，支持即时查询与自动化定时任务双模式
• 智能三阶段提醒：独创"提前10分钟-正点-延后5分钟"提醒机制，后台Cron任务确保聊天过程中不遗漏礼拜
• 双模式灵活调用：既支持单次查询（--next查看下一拜时间），也支持每日自动获取+周期性检测的完整提醒系统
• 多格式输出：纯文本便于阅读，JSON格式便于程序集成

潜在缺点与局限性：

• 网络依赖单一：完全依赖AlAdhan API，部分数据中心IP存在路由故障（如DigitalOcean→Hetzner），需手动配置Cloudflare WARP等VPN解决
• 个人开发者维护：来源为GitHub个人账号（diepox），非宗教组织或知名机构背书，长期维护稳定性待观察
• 成本隐性累积：自动提醒模式下每日约60K tokens消耗，月均$1.8-2.0，高频使用需预算规划
• 提醒精度边界：Cron 5分钟间隔可能导致±2分钟提醒延迟，极端场景下或错过精确时刻

适合人群：

• 跨国旅行/留学生需快速查询当地礼拜时间的穆斯林用户
• 希望建立自动化礼拜提醒习惯、减少手动查询摩擦的日常实践者
• 需要将祈祷时间集成至个人工作流的技术型用户（支持JSON输出与Python模块调用）

常规风险：

• 地理位置数据（城市/坐标）会本地持久化为JSON文件，虽非敏感信息但需知情同意
• API服务偶发不可用时将完全失效，建议关键日期（如斋月）提前离线备份时刻表
• 来源可信度T3级别，建议fork后自主审计再用于生产环境