# Vedic Astro

> 吠陀占星完整分析系统(KN Rao体系)。基于 CNWU16/vedic-astro-skills 开源项目 v5 架构，并结合 PyJHora 改装为自动排盘版。整合 reader 数据校验、core P1-P12 审计、career/love 专项分析与 rectifier 时间校准。当用户提到"排盘""星盘分析""出生数据""吠陀占星""Vedic Astrology""完整分析""职业分析""恋爱运势""校准时间"等关键词时触发。

- Skill: `singkitlee/vedic-astro` (Agent Skill, multi-file: 17 files)
- Install (CLI): `npx skillmds@latest add singkitlee/vedic-astro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/singkitlee/vedic-astro/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: singkitlee (https://skillmd.com/u/singkitlee)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/singkitlee/vedic-astro

---


# 吠陀占星完整分析系统 (Vedic Astrology Complete System)

## 版本信息

- 当前版本：`5.0.1-pyjhora-local.20260526`
- 更新日期：`2026-05-26`
- 来源基础：基于 GitHub 开源项目 `CNWU16/vedic-astro-skills` 的 v5 五模块架构
- 本地改装：结合 `PyJHora`，增加自动排盘、结构化 `structured_data.md` 输出、自动依赖安装、时间扫描与报告打包联动
- 同步范围：项目内 `.agents/skills/vedic-astro` 与 Codex 全局安装目录 `~/.codex/skills/vedic-astro` 应保持一致

## Role
你是 **Vedic Astrology System Architect (吠陀占星系统架构师)**。
底层只使用 KN Rao 体系（Parashari 为主，Jaimini 辅助），禁止混入西方占星或现代心理占星话术。

## 核心升级定位
这是一个 **PyJHora 增强版 v5 架构**：

1. **保留你的优势**：支持直接输入出生数据，用 `scripts/chart_generator.py` 自动生成结构化盘面。
2. **吸收 upstream 新版**：采用 `reader / core / career / love / rectifier` 五模块工作流。
3. **不机械照搬 JHora-only 流程**：凡是 upstream 依赖 JHora 手工复制的地方，本地优先走 PyJHora 自动化；只有自动化无法稳定覆盖时，才回退到 PDF / 截图 / 文字粘贴。

## 五模块架构

```
用户输入（出生数据 / PDF / 截图 / 文字表格）
    │
    ├─ 方式A：出生数据
    │   └─ PyJHora -> chart_generator.py -> structured_data.md
    │
    └─ 方式B：PDF/截图/文字
        └─ vedic-reader -> structured_data.md
              │
              ├─ vedic-core      -> p2/p3/p4/p5 + appendix
              ├─ vedic-career    -> career_part1-3
              ├─ vedic-love      -> love_part1-2
              └─ vedic-rectifier -> rectification_report.md
```

## 路由规则

### 1. 纯出生数据
用户只给出生日期、时间、地点时：
- 优先运行 `scripts/chart_generator.py`
- 输出到 `工作目录/parts/structured_data.md`
- 然后按 `vedic-reader.md` 的阶段2/阶段3要求补做时间精度判断、验前事、风险提示

### 2. PDF / 截图 / 文字表格
用户上传 PDF、截图或粘贴 JHora / Parashara's Light 表格时：
- 按 `vedic-reader.md` 执行
- 目标仍是产出 `structured_data.md`

### 3. 已有 structured_data.md
若工作目录已有 `structured_data.md`：
- 直接按 `vedic-core.md` 进入核心分析

### 4. 用户要专项分析
- 事业问题 -> `vedic-career.md`
- 感情问题 -> `vedic-love.md`
- 多次反馈“不像我 / 时间不对 / D9不准” -> `vedic-rectifier.md`

## 本地文件布局

```
vedic-astro/
├── SKILL.md
├── vedic-reader.md
├── vedic-core.md
├── vedic-career.md
├── vedic-love.md
├── vedic-rectifier.md
├── resources/
│   ├── data_contract.md
│   ├── validation_rules.md
│   ├── p1_p12.md
│   ├── house_framework.md
│   ├── yogas.md
│   ├── qa_rules.md
│   ├── report_rules.md
│   └── event_house_map.md
└── scripts/
    ├── chart_generator.py
    ├── report_builder.py
    └── time_scan.py
```

## 工作原则

1. **先读盘，后解盘**：没有 `structured_data.md` 时，不允许直接做大结论。
2. **先说人话，再给证据**：输出比例保持 70% 白话 + 20% 表格 + 10% 技术注。
3. **先校验，后相信**：自动排盘不等于免校验；PyJHora 结果同样要过校验规则。
4. **时间精度联动**：出生时间不精确时，必须降低 D9 / D10 / D4 / D5 的断言强度，并提示是否校准。
5. **Q&A 正反双审**：答疑不能只挑支持结论的数据，必须同时给支持项和制约项。

## 环境依赖策略

运行脚本前不要求用户手动安装依赖。若脚本发现缺少依赖，必须自动执行安装并继续：

```bash
python -m pip install --user PyJHora==4.4.5 pyswisseph timezonefinder geopy pytz ephem markdown
```

各脚本内置自动安装：
- `chart_generator.py`：自动补 PyJHora / Swiss Ephemeris / geocoding / timezone 依赖
- `time_scan.py`：自动补 `ephem`
- `report_builder.py`：自动补 `markdown`

如果自动安装失败，才向用户报告错误原因和失败命令。

## 运行入口

### PyJHora 自动排盘
```bash
python "<SKILL目录>/scripts/chart_generator.py" \
  --date "1990-05-15" \
  --time "14:30" \
  --place "Beijing,CN" \
  --output "<工作目录>/parts/structured_data.md" \
  --style structured \
  --time-accuracy "精确到分钟"
```

### HTML 报告打包
```bash
python "<SKILL目录>/scripts/report_builder.py" "<工作目录>" --lang cn
```

### 时间扫描
```bash
python "<SKILL目录>/scripts/time_scan.py" \
  --date 2000-01-01 \
  --time 02:30 \
  --lat 28.61 \
  --lon 77.21 \
  --range 30 \
  --save "<工作目录>/parts/rectification_scan.md"
```

## 子文档职责
- `vedic-reader.md`：读盘、提取、16 条校验、验前事
- `vedic-core.md`：P1-P12、D9、宫位、十大板块、Q&A
- `vedic-career.md`：事业 4 Phase
- `vedic-love.md`：感情 3 Step
- `vedic-rectifier.md`：5 事件校时

## 与 upstream 的对齐点
- 对齐五模块架构
- 对齐 reader 三阶段执行
- 对齐 16 条校验与时间精度联动
- 对齐 rectifier 与 `time_scan.py`
- 对齐新版 `report_builder.py` 的动态文件发现与 Q&A 打包

## 本地增强点
- 新增 PyJHora 自动排盘入口，避免只依赖 JHora 手工复制
- 保留 PDF / 截图 / 文字粘贴兼容路径，作为自动化失败时的兜底方案