用途：将多项伊斯兰日常工具整合为单一 CLI，通过共享配置和本地缓存减少重复 API 调用。
主要能力：礼拜时间（Fajr、Dhuhr、Asr、Maghrib、Isha）；斋戒的 Imsak 与 Maghrib 时间；按当前市场价格计算金银 Nisab 阈值；按关键词搜索古兰经经文，或获取指定 Surah/Ayah 及翻译；为任意城市生成月度礼拜时间表；获取随机伊斯兰语录或设置每日自动化；生成 OpenClaw cron 命令以安排每日礼拜提醒；本地缓存每日结果。
使用方式：通过 bash 脚本运行，例如： ./bin/islamic-companion prayer --today --lat -6.2088 --long 106.8456 --tz Asia/Jakarta ./bin/islamic-companion fasting --today --lat -6.2088 --long 106.8456 ./bin/islamic-companion zakat --nisab ./bin/islamic-companion quran --search "sabar" ./bin/islamic-companion quran --surah 1 ./bin/islamic-companion quran --surah 2 --ayah 255 ./bin/islamic-companion calendar --city "Serang" --month 2 --year 2026 ./bin/islamic-companion quotes --random ./bin/islamic-companion prayer --sync --lat -6.2088 --long 106.8456 --tz Asia/Jakarta
配置：编辑 config.json 设置计算方法与天课偏好，位置通过 CLI 参数提供，未指定时区默认 UTC。示例配置含 calculation.method（20 为 Kemenag RI 印尼）、school（0 为标准 Shafi/Maliki/Hanbali，1 为 Hanafi）、zakat.currency、gold_gram_threshold、api_key、timezone、quran_language。
依赖：系统需 bash、curl、jq（古兰经功能必需，jq 建议用于速度）；Python 替代实现需 python3、requests。安装时克隆仓库或下载技能，执行 pip install -r requirements.txt，并确保安装 curl。
限制与注意：天课功能使用 API key，可存于 config.json（较不安全）或通过环境变量 ZAKAT_API_KEY 导出（推荐）。--sync 与 --setup 会生成 cron 计划，加入系统 crontab 前应检查输出；使用 cron 工具时必须将 CRON_ADD: 输出的 JSON 字符串解析为 JSON 对象，不能直接传递。其他平台支持、收费与效果暂未提供。