732642856
d2cd5a369f
- Add sanitized Jyotish benchmark suite with fictional/public smoke samples - Include benchmark scripts and markdown reports while excluding raw JSON/CSV outputs - Add open-source Jyotish project comparison research - Add complete technique coverage roadmap - Add privacy-safe PDF chart validation methodology - Update SKILL.md and CHANGELOG with v6.1.9 scope and privacy boundaries Validation: - py_compile benchmarks/jyotish/scripts/*.py passed - quality gate passed with 35 pytest tests and golden case
13 KiB
13 KiB
开源吠陀占星（Jyotish）项目竞品分析报告
数据采集日期：2026-06-06 | 数据来源：GitHub API / PyPI / 项目官网
一、项目总览对比表
| 项目 | 仓库 | 语言 | Stars | Forks | 贡献者 | 最后提交 | 许可证 |
|---|---|---|---|---|---|---|---|
| PyJHora | naturalstupid/PyJHora | Python | 184 | 102 | 1 | 2026-05-28 | AGPL-3.0 |
| jyotisha | jyotisham/jyotisha | TeX/Python | 127 | 62 | 4 | 2026-06-04 | MIT |
| VedAstro | VedAstro/VedAstro | C# | 561 | 248 | 11 | 2026-04-23 | MIT |
| drik-panchanga (原版) | webresh/drik-panchanga | Python | 139 | 112 | 1 | 2023-05-02 | AGPL-3.0 |
| drik-panchanga (bdsatish fork) | bdsatish/drik-panchanga | Python | 10 | 4 | 1 | 2026-03-18 | AGPL-3.0 |
| Kerykeion (西方占星为主) | g-battaglia/kerykeion | Python | 647 | 186 | 18 | 2026-06-05 | AGPL-3.0 |
| VedicAstro (KP系统) | diliprk/VedicAstro | Python/Jupyter | 62 | 31 | 1 | 2026-01-07 | MIT |
| jyotishganit | northtara/jyotishganit | Python | 31 | 13 | 2 | 2026-06-02 | MIT |
注意：Kerykeion 主要是西方占星（Western Astrology）库，有 Sidereal 模式可选，列入作为参考对比。
二、各项目详细分析
1. PyJHora (naturalstupid/PyJHora) ⭐ 184
定位：最全面的吠陀占星 Python 计算库，复刻 Jagannatha Hora V8.0 全部功能
| 维度 | 详情 |
|---|---|
| GitHub Stars | 184 |
| 贡献者 | 1（Sundar Sundaresan，单人主力开发） |
| 最后版本 | v4.8.6 (2026-05-28) |
| PyPI 下载 | PIP 可安装，活跃发布 |
| 测试覆盖 | ✅ 约 6800~7678 个测试用例，所有计算与 JHora V8.0 逐项比对验证 |
| 验证基准 | ✅ 关键优势：所有结果与 PVR Narasimha Rao 的著作例题和 JHora 软件逐一对比验证 |
| 完整分析管线 | ✅ 覆盖 47 种 Dasha 系统、300+ 分盘（D1-D300）、284+ 种 Yoga、22 种 Graha Dasha、多种匹配算法、Ashtakavarga、Tajaka 年运、生时校正 |
| CI/质量门控 | ❌ 无 GitHub Actions CI 配置 |
| 文档 | ⚠️ 详细但不规范：README 含完整 changelog 式功能清单，但缺少标准 API 文档；API 文档散布在各模块 README |
| GUI | ✅ 基于 PyQt6 的完整图形界面 |
| 依赖 | pyswisseph (必需), PyQt6 (可选) |
| 核心优势 | JHora 般的全面性、6800+ 测试用例验证、持续活跃更新 |
| 核心劣势 | 单人维护、无 CI、文档非标准化 |
关键结论：功能最全的 Vedic Astrology Python 库，测试验证体系最完善，但文档质量和工程化程度有待提高。
2. jyotisha (jyotisham/jyotisha) ⭐ 127
定位：学术派的 Python 吠陀天文/历法计算工具
| 维度 | 详情 |
|---|---|
| GitHub Stars | 127 |
| 贡献者 | 4 |
| 最后提交 | 2026-06-04（活跃维护中） |
| 测试覆盖 | ✅ 有 jyotisha_tests/ 目录，含 6 个测试文件 |
| 验证基准 | ❌ 未明确提及与任何权威软件/书籍的基准验证 |
| 完整分析管线 | ❌ 主要聚焦 Panchanga 计算和历法生成，不是完整的星盘解读管线 |
| CI/质量门控 | ✅ 3 个 GitHub Actions workflows + ReadTheDocs 自动构建 |
| 文档 | ✅ 完善的文档体系：ReadTheDocs API 文档 + GitHub Pages 用户指南 + 示例日历 |
| 主要功能 | Panchanga 五要素、日历生成、节日数据库（adyatithi 事件数据库） |
| 依赖 | 轻量级 Python 包 |
| 核心优势 | 学术背景、完善的 CI/CD 和文档体系、活跃社区 |
| 核心劣势 | 只做历法/天文计算，不做占星解读；没有 Dasha/Yoga/Dosha 等占星分析功能 |
关键结论：最"学术规范"的项目，CI/文档体系最完善，但定位是天文历法工具而非占星解读引擎。
3. VedAstro (VedAstro/VedAstro) ⭐ 561
定位：全栈吠陀占星平台（C# 核心 + Python/Web 客户端）
| 维度 | 详情 |
|---|---|
| GitHub Stars | 561（该项目中最高的） |
| 贡献者 | 11 |
| 最后提交 | 2026-04-23 |
| 测试覆盖 | ⚠️ 未明确披露测试数量或覆盖率 |
| 验证基准 | ❌ 未明确提及与权威来源的验证对比 |
| 完整分析管线 | ✅ 全栈方案：Web 界面 + Python API + AI 占星师 + 云引擎 |
| CI/质量门控 | ✅ 1 个 GitHub Actions workflow |
| 文档 | ✅ 完善的官网文档（vedastro.org）+ Python 库文档 + 示例代码 |
| API 能力 | 596+ 种占星计算、47 种 Ayanamsa 系统、D1-D60 分盘、AI 生时填充、自然语言搜索 |
| 技术栈 | C# 核心引擎 + Python 轻量客户端（云端计算，本地零依赖） |
| 核心优势 | Star 数最高、社区最大、全栈方案、AI 驱动、零本地依赖 |
| 核心劣势 | 依赖云端 API（有速率限制）、非纯离线方案、Python 客户端只是封装层 |
关键结论：Star 数最高、生态系统最完整，但 Python 库是云端 API 封装（非纯本地计算），且 C# 核心引擎可能对 Python 开发者不友好。
4. drik-panchanga (webresh/drik-panchanga) ⭐ 139
定位：轻量级观测式印度阴阳历计算器
| 维度 | 详情 |
|---|---|
| GitHub Stars | 139（原版） |
| 贡献者 | 1（作者已归档项目） |
| 最后提交 | 2023-05-02（已停止维护） |
| 测试覆盖 | ❌ 无独立测试文件 |
| 验证基准 | ⚠️ 依赖 Swiss Ephemeris 精度，提供手动验证示例（Madhvacharya 忌日） |
| 完整分析管线 | ❌ 只做 Panchanga 五要素计算，无 Dasha/Yoga/Dosha/星盘解读 |
| CI/质量门控 | ❌ 无 GitHub Actions |
| 文档 | ⚠️ 仅有 README，一份 Python 文件实现全部功能，缺乏 API 文档 |
| 功能范围 | Tithi/Nakshatra/Yoga/Karana/Vaara + 日出日落 + CLI 版支持 Navamsa/Dasha（有限） |
| 依赖 | pyswisseph + wxPython（GUI） |
| 核心优势 | 代码极简（单文件 ~1200 行）、纯计算无依赖、支持 Python 2/3 |
| 核心劣势 | 已停止维护、无占星分析管线、功能范围窄 |
注：bdsatish/drik-panchanga (10 stars) 是上个月才创建的新 fork，有更新活动但尚不成熟。
关键结论：优秀的轻量 Panchanga 计算器，但已归档停更，且只覆盖历法层，无任何占星分析。
5. Kerykeion (g-battaglia/kerykeion) ⭐ 647
定位：数据驱动的通用占星库（非专属吠陀占星）
| 维度 | 详情 |
|---|---|
| GitHub Stars | 647（所有占星库中最高） |
| 贡献者 | 18（社区最大） |
| 最后提交 | 2026-06-05（高度活跃） |
| PyPI 月下载 | 140,000+ |
| 测试覆盖 | ⚠️ 有开发依赖 (.[dev])，但未披露具体测试数量 |
| 验证基准 | ❌ 未提及任何吠陀占星验证基准 |
| 完整分析管线 | ✅ 本命盘/合盘/行运/回归盘 + SVG 图表 + 文本报告 + AI Context 序列化 |
| CI/质量门控 | ❌ 无 GitHub Actions CI 配置（从 API 确认） |
| 文档 | ✅ 极完善：kerykeion.net 官网 + API 文档 + 示例库 + 迁移指南 |
| 吠陀支持 | 支持 Sidereal 模式（48 种 Ayanamsa），但不是吠陀专属库 |
| 核心优势 | 最大社区、最完善文档、SVG 图表生成、AI 报告、140K+ 月下载 |
| 核心劣势 | 主要面向西方占星，吠陀特有功能（Dasha/Dosha/Yoga/分盘等）缺失或需自行实现 |
关键结论：社区最大、文档最好的占星库，但不是吠陀占星专用。可作为 UI/图表生成层参考，但无法替代 PyJHora 或 VedAstro 的吠陀计算能力。
6. VedicAstro (diliprk/VedicAstro) ⭐ 62
定位：专注 KP (Krishnamurti Paddhati) 系统的吠陀占星 Python 包
| 维度 | 详情 |
|---|---|
| GitHub Stars | 62 |
| 贡献者 | 1 |
| 最后提交 | 2026-01-07 |
| 测试覆盖 | ❌ 未提及测试 |
| 验证基准 | ❌ 未提及验证基准 |
| 完整分析管线 | ⚠️ 有限：生成星盘、行星数据、级征象星（ABCD）、Vimshottari Dasa |
| CI/质量门控 | ❌ 无 GitHub Actions |
| 文档 | ⚠️ 仅有 README + PyPI 描述 |
| 主要功能 | KP 级征象星系统、KP 卜卦星盘、Vimshottari Dasa |
| 依赖 | pyswisseph + flatlib（需手动安装） |
| 核心优势 | KP 系统专注度高 |
| 核心劣势 | 依赖需要手动安装、文档不够完善、功能覆盖面窄 |
7. jyotishganit (northtara/jyotishganit) ⭐ 31
定位：新生代高精度吠陀占星 Python 库（NASA JPL 星历）
| 维度 | 详情 |
|---|---|
| GitHub Stars | 31 |
| 贡献者 | 2 |
| 最后版本 | v0.1.3 (2026-05-30) - Beta 阶段 |
| 测试覆盖 | ❌ Beta 阶段，未披露测试 |
| 验证基准 | ❌ 未提及 |
| 完整分析管线 | ❌ 初期阶段，基础计算为主 |
| CI/质量门控 | ✅ 2 个 GitHub Actions workflows |
| 文档 | ⚠️ 仅有 PyPI 描述和 GitHub README |
| 主要功能 | 高精度天文计算、NASA JPL 星历 |
| 核心优势 | NASA JPL 星历（非 Swiss Ephemeris）、现代化工程实践 |
| 核心劣势 | 极早期、功能有限、用户基数小 |
三、关键维度对比矩阵
| 维度 | PyJHora | jyotisha | VedAstro | drik-panchanga | Kerykeion |
|---|---|---|---|---|---|
| Star 数 | 184 | 127 | 561 | 139 | 647 |
| 活跃维护 | ✅ 2026-05 | ✅ 2026-06 | ✅ 2026-04 | ❌ 已归档 | ✅ 2026-06 |
| 贡献者数 | 1 | 4 | 11 | 1 | 18 |
| 测试覆盖 | 6800+ 测试 | 有测试目录 | 未披露 | 无 | 有 dev 依赖 |
| 验证基准 | ✅ JHora 对比 | ❌ | ❌ | 手动示例 | ❌ |
| 完整管线 | ✅ 极全面 | ❌ 仅历法 | ✅ 全栈 | ❌ 仅历法 | ⚠️ 西占为主 |
| CI/CD | ❌ | ✅ 3 workflows | ✅ 1 workflow | ❌ | ❌ |
| 文档质量 | ⚠️ 详细但非标 | ✅ 标准化 | ✅ 官网完善 | ⚠️ 仅 README | ✅ 极完善 |
| 吠陀专用 | ✅ 是 | ✅ 是 | ✅ 是 | ✅ 是 | ❌ 偏西占 |
| 离线可用 | ✅ 完全离线 | ✅ 完全离线 | ❌ 依赖云API | ✅ 完全离线 | ✅ 完全离线 |
| GUI | ✅ PyQt6 | ❌ | ✅ Web UI | ✅ wxPython | ✅ SVG 图表 |
| 多语言 | ✅ 6种 | ❌ | ❌ | ✅ 梵文名 | ✅ 10种 |
四、竞争定位分析
按场景推荐
| 使用场景 | 推荐项目 | 理由 |
|---|---|---|
| 最全面的吠陀占星计算 | PyJHora | 6800+ 测试、与 JHora 逐项验证、覆盖最广功能 |
| 学术研究/历法计算 | jyotisha | 最佳工程实践、CI/CD、ReadTheDocs 文档 |
| 全栈 Web 应用/快速原型 | VedAstro | 最多 Star、云 API 零依赖、AI 集成 |
| 轻量 Panchanga 计算 | drik-panchanga | 单文件实现（但已停维） |
| UI/图表可视化 | Kerykeion | 最佳 SVG 图表能力、最大社区（但非吠陀专用） |
| KP (Krishnamurti) 系统 | VedicAstro | 唯一专注 KP 的库 |
| 极简/起步阶段 | jyotishganit | NASA JPL 星历（但 Beta 阶段） |
PyJHora 的差异化优势
- 验证体系：唯一与 Jagannatha Hora V8.0 逐项验证的项目（6800+ 测试）
- 功能广度：47 种 Dasha 系统、300+ 分盘、284+ Yoga、22 种 Graha Dasha
- 离线运行：纯本地计算，无云端依赖
- 活跃度：v4.8.6 最新，持续月更
- GUI 支持：PyQt6 多语言图形界面
PyJHora 的主要差距
- 工程化不足：无 CI/CD、无标准化文档（API doc）、单人维护
- 社区规模小：184 stars vs VedAstro 561 和 Kerykeion 647
- 文档体验差：以 changelog 风格代替 API 参考文档
- 没有 Web 端：VedAstro 有完整 Web/AI 方案
五、社区声音摘要
搜索了 "best open source vedic astrology library"、"PyJHora vs drik-panchanga" 等关键词，社区讨论中的关键观点：
- PyJHora vs drik-panchanga 定位不同：PyJHora 是综合占星库，drik-panchanga 只是日历计算器，二者不直接竞争
- VedAstro 最受欢迎：Star 数最高，社区活跃，但 Python 封装依赖云端
- 没有完美的项目：PyJHora 功能最全但文档和工程化弱，VedAstro 社区最强但非纯 Python 离线，jyotisha 工程最佳但功能受限
- 测试是 PyJHora 的核心壁垒：6800+ 测试与 JHora 的对比验证是其他项目无法短期复制的
六、总结建议
| 竞争维度 | PyJHora 地位 | 建议改进方向 |
|---|---|---|
| 功能完整性 | 行业标杆 | - |
| 验证准确性 | 唯一有系统验证 | - |
| 社区规模 | 中等 | 加大宣传、增加贡献者 |
| 工程化/CI | 弱 | 优先引入 GitHub Actions CI |
| 文档质量 | 弱 | 重构文档结构，增加 API 参考 |
| 生态扩展 | 无 Web/API | 考虑提供轻量 API 层 |
| 活跃维护 | 好 | 持续保持 |