jadwal-sholat

🕌 印尼官方数据源礼拜时间助手

基于印尼宗教部官方数据源,为印尼地区穆斯林提供精准的每日/月度礼拜时间查询服务,无需第三方依赖,开箱即用。

收藏
5.8k
安装
1.7k
版本
v1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

jadwal-sholat 是一款专注于印度尼西亚地区伊斯兰祈祷时间查询的实用工具。用户可通过命令行脚本快速获取特定城市的礼拜时间表,支持三种查询模式:当日祈祷时间(hari-ini)、指定日期(tanggal)以及整月日程(bulan)。使用前需先通过关键词搜索定位城市/县的唯一 ID,系统会优先尝试精确匹配,若失败则返回首个候选结果。对于高级用户,也支持直接通过 curl 调用 REST API,灵活集成至自动化工作流。

显著优点

该 Skill 的最大亮点在于数据权威性——直接对接 api.myquran.com,其数据源为印度尼西亚宗教事务部(Kemenag Bimas Islam),确保了祈祷时间的官方准确性。技术实现上极为轻量:纯 Python 标准库编写,零第三方依赖,彻底规避了依赖链攻击风险。脚本设计遵循 Unix 哲学,功能单一但完备,命令行接口直观易懂,无论是技术用户还是普通用户都能快速上手。时区处理上默认采用 Asia/Jakarta,贴合印尼本土需求。

潜在缺点与局限性

功能边界清晰也带来了使用限制:服务范围严格限定于印度尼西亚境内,无法覆盖其他穆斯林国家或地区。城市搜索的模糊匹配策略虽简化了操作,但在同名地区(如 TANGERANG 与 KOTA TANGERANG)场景下可能返回非预期结果,需用户手动优化关键词。此外,该 Skill 完全依赖外部 API 的可用性,若 api.myquran.com 遭遇宕机或网络中断,本地无任何缓存或降级机制,功能将完全失效。

适合的目标群体

主要面向印度尼西亚的穆斯林用户群体,包括需要日常查询礼拜时间的普通信众、规划宗教活动的社区组织者,以及开发伊斯兰相关应用的工程师。对于学习印尼语或研究印尼宗教文化的国际用户,该工具也提供了便捷的数据获取入口。由于其纯命令行交互特性,更适合具备基础终端操作能力的用户。

使用风险

常规风险集中于外部依赖层面:API 服务的稳定性与持续性不在用户控制范围内,建议关键场景下提前获取并本地备份月度数据。网络延迟可能影响响应体验,尤其在移动网络环境下。脚本本身无持久化存储,每次查询均为实时请求,高频调用需注意 API 速率限制(如有)。

安全解读

核心用法

jadwal-sholat 是专为印尼穆斯林用户设计的祈祷时间查询技能,通过调用 api.myquran.com 提供的公开API(数据来源:印尼宗教事务部 Kemenag Bimas Islam),支持查询全国县级以上城市的每日五时祈祷时间表(含 Imsak、Subuh、Dzuhur、Ashar、Maghrib、Isya)。

主要功能模式

| 模式 | 命令示例 | 输出 |
|------|---------|------|
| 城市搜索 | `cari "tangerang"` | 返回匹配的城市ID列表 |
| 今日祈祷 | `hari-ini "kota tangerang"` | 当日完整时间表(Asia/Jakarta时区) |
| 指定日期 | `tanggal "kota tangerang" 2026-02-03` | 特定日期时间表 |
| 整月预览 | `bulan "kota tangerang" 2026-02` | 月度完整日历 |

显著优点

  • 数据源权威:直接对接印尼宗教部官方数据,非民间计算
  • 零外部依赖:Python辅助脚本仅使用标准库(urllib、json、argparse),彻底规避供应链攻击风险
  • 安全编码规范:URL参数经 urllib.parse.quote 编码,无注入漏洞
  • 网络层防护:HTTPS传输、证书验证、20秒超时、自定义User-Agent
  • 隐私零侵犯:不收集、存储、传输任何个人数据

潜在局限

  • 地域限制:仅覆盖印尼境内城市,不支持其他国家
  • 网络依赖:需实时联网查询,无离线缓存机制
  • 模糊匹配风险:城市搜索采用"精确匹配优先,否则首条"策略,偏远地区可能存在定位偏差
  • 时区固定:默认锁定 Asia/Jakarta,未显式支持印尼西部/中部/东部时区自动切换

适合人群

  • 旅居印尼的外籍穆斯林需本地化祈祷时间
  • 印尼本土用户快速查询非居住城市时间表
  • 开发伊斯兰相关应用的开发者(可作为数据源参考)

常规风险

  • API可用性:依赖第三方公共服务,存在间歇性不可达可能
  • 数据准确性:官方数据偶有调整,建议与本地清真寺确认关键日期
  • 城市命名歧义:建议优先使用完整官方名称(如"KOTA TANGERANG"而非"TANGERANG")

jadwal-sholat 内容

scripts文件夹
手动下载zip · 3.6 kB
myquran_sholat.pytext/plain
请选择文件