islamic-daily-reflection

🤲 基于经文的每日灵性指引与行动挑战

基于 Python 脚本的开源伊斯兰每日反思工具,自动识别斋月与主麻日,提供经权威认证的古兰经/圣训引用及可操作日常挑战,助力穆斯林精神生活。

收藏
15.3k
安装
3.1k
版本
v1.0.0
CLS 安全性认证2026-06-03
点击查看完整报告 >

使用说明

Islamic Daily Reflection 是一款专注于提供每日伊斯兰灵性指导的自动化工具。该 Skill 通过执行本地 Python 脚本,结合公历与伊斯兰历(希吉来历)的双历系统,为用户在斋月(Ramadan)、主麻日(Jummah)、Dhul Hijjah 等重要宗教时段提供针对性的精神反思内容。

核心用法

用户可通过"daily reflection"、"islamic reminder"或"ramadan reflection"等自然语言指令触发该 Skill。系统接收到指令后,会立即执行 python scripts/reflection.py 脚本,该脚本首先检测当前公历日期,通过调用 Aladhan API 转换为对应的伊斯兰历日期,然后根据日期特征(是否为斋月期间、是否为星期五、是否为普通工作日)从预设数据库中选择相应的反思主题。脚本输出采用格式化的文本块,包含日期信息、主题标题(如耐心、感恩、托靠真主等)、详细反思内容、当日可执行的具体挑战(如"花5分钟感谢家人")以及相关的古兰经或圣训引用。整个输出保留了装饰性的边框和表情符号,确保视觉上的清晰与庄重。

显著优点

该 Skill 的首要优势在于其历法智能感知能力。它不仅能识别常规日期,更能针对伊斯兰教的特殊时节(如斋月的每一天、Dhul Hijjah 的前十天、阿舒拉日等)提供定制化的内容,这种时效性使其在宗教实践场景中极具价值。其次,内容权威性得到保障,所有反思均基于经典的古兰经和圣训,并附有具体出处,而非随意编撰的心灵鸡汤。第三,技术架构简洁稳健,仅依赖 Python 标准库(datetime、urllib、json),无外部 pip 依赖,大大降低了供应链攻击风险。此外,脚本内置了30个常规主题的轮换机制(涵盖忍耐、感恩、敬畏、诚实等美德),确保内容的多样性和持续性。

潜在缺点与局限性

尽管功能实用,该 Skill 仍存在若干局限。首先,它依赖网络连接以获取伊斯兰历日期转换(通过 Aladhan API),在离线环境下无法正常工作,这对于网络不稳定的用户或在特定宗教场所(要求关机或飞行模式)使用时可能造成不便。其次,内容来源于预编写的静态数据库,虽然涵盖30个常规主题和特殊日期内容,但缺乏动态生成能力,长期使用后可能出现重复感。第三,作为 T3 来源(个人/社区维护项目),其长期维护和内容更新的可持续性不如商业级或基金会支持的项目。此外,当前版本仅支持英语输出(从示例看),对于非英语母语用户可能存在语言障碍。

适合的目标群体

该 Skill 主要面向穆斯林用户群体,特别是那些希望在日常生活中保持宗教意识、寻求精神提醒的实践者。对于正在经历斋月的信徒,它能提供每日特定的斋戒反思;对于忙碌的职场人士,它提供了简短而深刻的每日灵性"微学习"。同时,对伊斯兰文化感兴趣的非穆斯林研究者也可将其作为了解伊斯兰伦理观和日常实践的教育工具。此外,伊斯兰教育机构、清真寺社区管理者也可利用其标准化输出作为每日提醒的素材来源。

使用风险

从技术与安全角度看,主要风险在于对外部 API 的依赖。虽然 Aladhan API 是公开且广泛使用的伊斯兰历服务,但如果该服务出现宕机或网络超时(尽管脚本设置了10秒超时保护),可能导致功能暂时不可用。由于脚本需要执行本地 Python 文件,用户应确保 scripts/reflection.py 文件未被恶意篡改,虽然当前版本无文件写入或系统修改操作,但建议从可信渠道获取 Skill 文件。另外,虽然脚本本身不收集敏感信息,仅传输当前日期数据,但用户应注意 API 调用会暴露其大致时区信息(通过日期请求)。总体而言,这是一个只读性质的轻量级工具,不会对系统造成持久性变更或数据泄露风险。

安全解读

核心用法

用户通过自然语言指令(如"daily reflection"、"friday reflection"、"ramadan reflection"等)触发后,系统自动执行 python scripts/reflection.py,返回格式化的每日伊斯兰灵修内容。脚本核心功能包括:

  • 双历感知:自动获取当日公历与伊斯兰历(Hijri)日期
  • 场景适配:根据日期智能选择灵修类型——斋月(Ramadan,1-30日专属主题)、主麻日(Jummah,周五)、都尔黑哲月初十天(Dhul Hijjah 1-10,朝觐主题)、阿舒拉日(Muharram 10),以及常规日期(30个轮换主题如耐心、感恩、托靠安拉等)
  • 结构化输出:统一格式包含日期头、主题反思、可执行挑战(附时间建议)、古兰经/圣训出处

显著优点

1. 零依赖安全:纯Python标准库实现,无第三方依赖包,彻底消除供应链攻击风险
2. 来源权威:经文引用经过筛选,API数据来源为公开可信的伊斯兰历服务(api.aladhan.com)

3. 行为透明:代码功能与声明完全一致,无隐蔽网络行为或数据收集

4. 输出即所得:预编写反思内容经格式化后直接呈现,避免生成式AI的幻觉风险

潜在局限

  • 内容固定性:30个常规主题循环使用,长期使用可能产生重复感;斋月/主麻日等特殊日期内容亦为预设,缺乏动态个性化
  • API单点依赖:伊斯兰历转换依赖单一外部API,若服务中断则日期显示可能异常(尽管核心反思功能仍可运行)
  • 文化语境:内容基于逊尼派主流传统,对其他伊斯兰学派或文化背景的适配性有限

适合人群

  • 寻求结构化日常灵修辅助的穆斯林用户
  • 需要斋月、主麻日等特殊节点提醒的信仰实践者
  • 对AI生成宗教内容持谨慎态度、偏好预设权威引用的用户

常规风险

  • 过度依赖:工具定位为辅助提醒,不可替代系统性宗教学习和社群互动
  • API隐私:虽仅传输日期参数,但用户应注意网络环境安全

islamic-daily-reflection 内容

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