jyotish-engine-modules - SKILL.md Agent Skill

name: jyotish-engine-modules description: 印度占星排盘引擎缺失模块完整代码（5个核心模块） version: 1.0.0 author: 助手 tags: [jyotish, vedic-astrology, calculation-engine, karaka, special-lagnas, vimsopaka, avastha, divisional-charts] related_skills: [jyotish-full-reading-integration, jyotish-vedic-astrology]

印度占星排盘引擎缺失模块

本skill包含5个核心计算模块的完整Python代码，用于补充GitHub仓库 yinduzhanxing 的排盘引擎。

模块清单

karaka_calculator.py - Karaka分配计算器（支持BPHS/JH兼容模式）
special_lagnas.py - 特殊上升点计算（Bhava/Hora/Ghati Lagna等）
vimsopaka_calculator.py - Vimsopaka Bala分盘力量计算
avastha_calculator.py - Avasthas行星状态计算（年龄/警觉/情绪）
divisional_charts_extended.py - D2-D60完整分盘宫位图

使用方法

1. 创建本地工作目录

mkdir -p ~/Projects/yinduzhanxing-local/scripts
cd ~/Projects/yinduzhanxing-local

2. 复制模块代码

从本skill的 scripts/ 目录复制5个Python文件到本地工作目录。

3. 同步到GitHub

# 克隆GitHub仓库
cd ~/Projects
git clone https://github.com/732642856/yinduzhanxing.git
cd yinduzhanxing

# 复制新模块
cp ~/Projects/yinduzhanxing-local/scripts/*.py ./scripts/

# 提交并推送
git add scripts/
git commit -m "feat: 新增5个核心排盘引擎模块

- karaka_calculator.py: Karaka分配计算器（BPHS/JH兼容模式）
- special_lagnas.py: 特殊上升点计算
- vimsopaka_calculator.py: Vimsopaka Bala分盘力量
- avastha_calculator.py: Avasthas行星状态
- divisional_charts_extended.py: D2-D60完整分盘"

git push origin main

模块详细说明

1. karaka_calculator.py

核心功能：

计算Jaimini Chara Karaka（7大可变象征星）
支持3种模式：
- BPHS 8-Karaka（标准）
- BPHS 7-Karaka（不含Rahu）
- JH兼容模式（Rahu限制在MK）

关键特性：

自动识别Karaka模式
星座内度数排序（0-30度）
详细的Karaka象征意义
完整的验证机制

命令行使用：

python3 scripts/karaka_calculator.py --mode bphs --planets "Sun:45.5,Moon:120.3,Mars:200.1,Mercury:50.8,Jupiter:180.5,Venus:90.2,Saturn:250.7,Rahu:150.4"

2. special_lagnas.py

核心功能：

Bhava Lagna（宫位上升）
Hora Lagna（时辰上升）
Ghati Lagna（Ghati上升）
Arudha Lagna（映像上升）
Upapada Lagna（配偶映像上升）

计算公式：

Bhava Lagna = Asc + (Sun - Moon)
Hora Lagna = Asc + (Sun位置 × 时间因子)
Ghati Lagna = 基于Ghati单位的上升点推进

3. vimsopaka_calculator.py

核心功能：

16分盘权重系统（Shodasavarga）
Varga Dignity尊严等级判定
分盘综合力量评分
Vimsopaka Bala总分计算

权重体系：

D1 (Rasi): 3.5
D2 (Hora): 1.0
D3 (Drekkana): 1.0
D9 (Navamsa): 3.5
D12 (Dwadasamsa): 0.5
... (共16个分盘)

4. avastha_calculator.py

核心功能：

Bala Avastha（年龄状态）：婴儿/少年/青年/老年/死亡
Jagrat Avastha（警觉状态）：清醒/梦境/深睡
Deeptadi Avastha（情绪状态）：15种状态

判定规则：

基于行星度数位置
基于行星与其他行星的关系
基于行星在星座中的位置

5. divisional_charts_extended.py

核心功能：

D1-D60完整计算
每个分盘的12宫位行星分布
分盘上升点精确计算
分盘宫位图可视化输出

支持的分盘：

D1-D12（基础分盘）
D16, D20, D24, D27, D30（特殊分盘）
D40, D45, D60（高级分盘）

集成到主引擎

在 jyotish_engine.py 中导入这些模块：

from karaka_calculator import KarakaCalculator, KarakaMode
from special_lagnas import SpecialLagnasCalculator
from vimsopaka_calculator import VimsopakaBalaCalculator
from avastha_calculator import AvasthaCalculator
from divisional_charts_extended import DivisionalChartsCalculator

注意：这 5 个模块已整合到主仓库的 scripts/ 目录中，与引擎一起维护。本 Skill 的 scripts/ 副本仅作为独立分发包。

验证测试

# 测试Karaka计算器
python3 scripts/karaka_calculator.py --mode bphs

# 测试特殊上升点
python3 scripts/special_lagnas.py --asc 45.5 --sun 120.3 --moon 200.1

# 测试Vimsopaka
python3 scripts/vimsopaka_calculator.py --planet Sun --d1 Aries --d9 Leo

# 测试Avastha
python3 scripts/avastha_calculator.py --planet Sun --degree 15.5

# 测试分盘
python3 scripts/divisional_charts_extended.py --asc 45.5 --divisions all

注意事项

Karaka模式选择：
- 与Jagannatha Hora保持一致时使用 --mode jh
- 标准BPHS使用 --mode bphs
精度要求：
- 所有度数计算精确到小数点后4位
- 分盘计算使用Swiss Ephemeris标准
依赖项：
```
pip install swisseph numpy
```
性能优化：
- 分盘计算支持批量模式
- 缓存机制减少重复计算

更新日志

v1.0.0 (2026-05-03)

初始版本
5个核心模块完整实现
支持命令行和Python API两种调用方式