cnwu16/vedic-astro-skills

🔱 Vedic Astro Skills v8.0

AI驱动的吠陀占星分析系统 | AI-Powered Vedic Astrology Analysis System

---

八个专精 Skill 协同工作，从原生排盘到完整人生审计、双人合盘，再到即时卜卦（Prashna）。

Eight specialized skills working together — from native chart calculation to complete life audit and two-person synastry, plus moment-based Prashna (horary).

兼容 Antigravity、Claude Code 和 Codex。 Compatible with Antigravity, Claude Code, and Codex.

---

📖 目录 / Table of Contents

• 安装 / Installation
• 八Skill架构 / Architecture
• 快速开始 / Quick Start
• 各Skill说明 / Skill Details
• 项目结构 / Project Structure
• 技术体系 / Technical Stack
• 版本历史 / Version History
• 赞赏 / Support

---

📦 安装 / Installation

Step 1: 安装 Skill 文件 / Install skill files

⚠️ 建议一次装全 8 个 skill。 vedic-calculator 是计算基座，多数分析 skill 都依赖它生成的 structured_data.md。其中 vedic-synastry（合盘）是双人分析 skill——需双方各一份盘；vedic-prashna（卜卦/时盘）是独立生态位——不需本命盘，以提问时刻起盘答一事，与本命分析路径分开。

Install all 8 skills. vedic-calculator is the computational foundation that most analysis skills depend on. Among them, vedic-synastry (synastry) is a two-person skill (needs one chart per person); vedic-prashna (Prashna/horary) is a standalone module — it needs no natal chart and casts a chart for the moment of asking.

Step 2: 安装 Python 依赖 / Install Python dependencies

# 推荐：使用自动安装脚本（处理依赖冲突 + 自动验证）
# Recommended: Use the auto-setup script (handles dependency conflicts + auto-validates)
python vedic-calculator/scripts/setup_env.py

# ⚠️ 不要直接 pip install -r requirements.txt（dashaflow 依赖冲突）
# ⚠️ Do NOT use pip install -r requirements.txt (dependency conflict with dashaflow)

💡 AI 首次运行时会自动检测环境并运行 setup_env.py。但 请确保系统已安装 Python 3.8~3.13。

The AI agent will auto-detect and run setup_env.py on first use. But make sure Python 3.8~3.13 is installed on your system.

注：vedic-synastry 的脚本是纯标准库，不需要额外依赖。/ Note: vedic-synastry scripts use only the Python standard library.

---

🏛️ 八Skill架构 / Architecture

用户星盘 (PDF/截图/文本)          用户出生信息 (日期+时间+地点)
Chart file (PDF/image/text)      Birth info (date+time+place)
    │                                    │
    ▼                                    ▼
┌──────────────┐                ┌───────────────────┐
│ vedic-reader │                │ vedic-calculator   │
│ 提取 + 校验   │                │ 原生排盘引擎        │
│ Extract+Verify│                │ Native calc engine │
└──────┬───────┘                └────────┬──────────┘
       │                                 │
       │     structured_data.md          │
       └────────────┬────────────────────┘
                    ▼
             ┌─────────────┐      ┌────────────────┐
             │ vedic-core   │─────▶│ vedic-rectifier │
             │ P1-P12 审计   │      │ 时间校准 ±5min   │
             │ 宫位诊断      │      │ Time rectify     │
             │ 十大板块总结   │      └────────────────┘
             └──────┬──────┘
                    │
          ┌─────────┼──────────┐
          ▼         ▼          ▼
   ┌──────────┐ ┌────────┐ ┌──────────────────┐
   │vedic-career│ │vedic-love│ │ vedic-synastry   │
   │职业蓝图    │ │恋爱时机  │ │ 合盘（需两份盘）  │
   │Career      │ │Love      │ │ Synastry (2 charts)│
   └──────────┘ └────────┘ └──────────────────┘
                              ▲
              另一个人的 structured_data.md
              second person's chart

─── 独立生态位 / Standalone（不接入上面的数据流）───
┌──────────────────────────────────────┐
│ vedic-prashna — 卜卦/时盘 (Prashna)      │
│ 不需本命，以提问时刻起盘答一事            │
│ No natal chart; cast for the moment    │
└──────────────────────────────────────┘

---

⚡ 快速开始 / Quick Start

💡 只需说"读盘"或"占星"即可启动。 reader 是统一入口，会根据你提供的内容自动选择最佳路径。

Just say “读盘” or “占星” to start. Reader is the unified entry point and auto-routes based on your input.

用法示例 / Usage

场景1：只有出生时间
用户: 帮我排盘，1990年3月15日 14:30 北京
 AI: → reader 检测到出生信息 → 自动调用 calculator 排盘
    → 输出 structured_data.md

场景2：有 JHora PDF
用户: [发送PDF] 读盘
 AI: → reader 从 PDF 提取出生信息 → calculator生成主数据
    → PDF数据做交叉验证（Shadbala例外：有PDF则对照并展示PDF值）
    → 输出 structured_data.md

场景3：什么都没带
用户: 激活占星
 AI: → reader 弹出引导菜单，让你选择输入方式

后续（任何场景都一样）：
用户: 开始分析      → vedic-core 完整审计
用户: 分析事业      → vedic-career 职业蓝图
用户: 分析感情      → vedic-love 恋爱时机
用户: 合盘 / 我和XX合不合 → vedic-synastry 双人合盘（再提供对方出生信息即可）
用户: 卜卦 / 起一卦 / 占问一事 → vedic-prashna 即时起盘（独立·不需本命）

reader 内部路由 / Internal Routing

用户输入
  │
  ├─ 提供了出生时间 ──→ 自动调用 vedic-calculator ──→ structured_data.md
  ├─ 提供了 PDF/截图 ──→ reader提取出生信息 ──→ calculator主数据 ──→ PDF交叉验证
  └─ 什么都没提供   ──→ 弹出引导菜单

⚠️ 不需要手动选择 skill。说"占星"就行——reader 会自动判断。

You don’t need to manually choose a skill. Just say “占星” — reader handles routing automatically.

💡 关于 PDF 补充： calculator 排盘完成后会提示：

• a) 直接进入分析（推荐）— calc 精度 >97%，排序与 JHora 一致，可直接用
• b) 发送 JHora PDF 补充 — 可选；先与calc逐行对照，再展示PDF Shadbala值
• 若二者不一致，报告会明确标注“calc与PDF不一致；当前采用PDF”，并保留calc基准

不补充也完全不影响分析质量。

About PDF supplement: Calculator output is canonical. PDF data is used for cross-validation; valid Shadbala values are compared row by row and displayed from the PDF, with differences explicitly flagged and the calc baseline retained.

---

📋 各Skill说明 / Skill Details

🧮 vedic-calculator — 精确排盘引擎 / Precision Chart Engine

v6.1 升级。 engine.py v0.5 — 基于 PyJHora 精确天文算法，fail-fast 架构。

Updated in v6.1. engine.py v0.5 — Built on PyJHora’s precise astronomical algorithms, fail-fast architecture.

计算架构 / Calculation Architecture:

⚠️ 为什么 Shadbala 需要修正？ PyJHora 的 SAV/Dasha/分盘模块是正确的，但 Shadbala 的 3 个子项（Sthana/Kaala/Dig）有算法 bug（如 Hora chart method 硬编码错误、Dig Bala 基准点错误等）。shadbala_pyjhora.py 在 PyJHora 基础上修正了 9 个子项，使 7 星 rupas 与 JHora 桌面版偏差 < 0.1。

Why does Shadbala need fixes? PyJHora’s SAV/Dasha/divisional modules are correct, but Shadbala has algorithm bugs in 3 sub-components. shadbala_pyjhora.py applies 9 targeted fixes on top of PyJHora’s internal functions.

计算项 / Outputs:

• 行星位置（经度、星座、Nakshatra）/ Planet positions
• Vimsottari Dasha（大运 + 小运，≤2天精度）/ Dasha periods (≤2 day accuracy)
• Chara Karakas（8K）/ Jaimini Karakas
• 15 张分盘 (D1~D60) / 15 divisional charts
• Shadbala 六力（含 9 项修正 + Ishta/Kashta Phala）/ Six strengths (9 fixes)
• SAV / BAV 吉凶值 / Ashtakavarga
• 尊贵度（Compound Relationship）/ Dignity
• 相位、宫主表 / Aspects, house lords

精度验证 / Accuracy (tested against JHora, 2 charts):

---

📖 vedic-reader — 读盘引擎 / Chart Reader

从 PDF/截图/文本中提取出生信息，以calculator生成主数据，再执行交叉验证和16条数学校验。

Extracts birth data from PDF/image/text, generates canonical calculator data, then cross-validates it with 16 mathematical checks.

---

🔬 vedic-core — 核心分析引擎 / Core Analysis

P1-P12行星逐一审计 → D9交叉验证 → 宫位诊断 → 十大板块人生总结。正反双审防偏见。

Planet-by-planet audit → D9 cross-validation → House diagnosis → Ten life domains. Double-blind audit against bias.

---

💼 vedic-career — 职业蓝图 / Career Blueprint

4Phase 分析：生态位 → 格局 → D9确认 → 全维合成。覆盖 D1/D9/D10 三盘。

4-Phase analysis: Ecological niche → Yogas → D9 confirmation → Full synthesis across D1/D9/D10.

---

💘 vedic-love — 恋爱时机 / Love Timing

3Step 分析：体质评估 → Dasha窗口 → 性质定性。婚姻三阶段模型（L7确立 → 9宫法律 → 11宫公开）。

3-Step analysis: Constitutional assessment → Dasha windows → Qualitative definition. Three-phase marriage model.

---

💞 vedic-synastry — 合盘 / Synastry

比较两个人的星盘：先中性平扫关系性质，再按 情感/合作/友谊/家人 四框架做五层分析（双盘资格 → 月宿 → 方向叠盘 → 时机 → 六维矩阵）。不给"匹配度%"总分，吸引与承载分开看；纯吠陀判据，需双方各一份盘。

Compares two charts: a neutral scan first, then a five-layer analysis under one of four frames (romantic/business/friendship/family) — dual-chart capacity → koota → directional overlay → timing → six-dimension matrix. No “match %” score; pure Vedic, needs one chart per person.

---

📐 vedic-rectifier — 时间校准 / Time Rectification

5个人生重大事件逆推出生时间，精度 ±5分钟。不强制改时间——用户确认后才更新。

5 major life events to reverse-engineer birth time to ±5 min accuracy. Never forces a time change.

---

🔮 vedic-prashna — 卜卦/时盘 / Prashna (Horary)

独立生态位，不需本命盘。求问者心中有一具体问题、在某刻提问，即以"提问那一刻的时间地点"起盘（Prashna Kundali）答那个问题。主判读走纯 Parashari（KN Rao 路线）；Tajika/KP 作可选沙箱层，默认关，物理隔离于本 skill 内、绝不污染主系统。

Standalone module, no natal chart needed. Casts a chart for the exact moment a question is asked (Prashna Kundali) and answers that one question. Main judgment is pure Parashari (KN Rao line); Tajika/KP are optional, sandboxed, and off by default — physically isolated inside this skill.

---

📁 项目结构 / Project Structure

vedic-astro-skills/
├── README.md
├── CHANGELOG.md
├── LICENSE
├── antigravity/skills/              # Antigravity 版本
│   ├── vedic-calculator/
│   │   ├── SKILL.md                 # 排盘引擎指令
│   │   ├── requirements.txt         # Python 依赖
│   │   └── scripts/
│   │       ├── engine.py            # 主计算引擎 v0.5 (fail-fast)
│   │       ├── setup_env.py         # 环境自动搭建 (10依赖+SAV校验)
│   │       ├── formatter.py         # structured_data 输出
│   │       ├── transit.py           # 过运计算
│   │       ├── dasha_pyjhora.py     # Dasha 精确包装 (≤2天)
│   │       ├── shadbala_pyjhora.py  # Shadbala 修正层 (9项fix)
│   │       ├── divisional_pyjhora.py
│   │       ├── ashtakavarga_pyjhora.py
│   │       ├── extras_pyjhora.py
│   │       └── ephe/                # 星历数据 .se1 (bundled)
│   ├── vedic-reader/
│   │   ├── SKILL.md                 # 读盘引擎
│   │   └── resources/
│   ├── vedic-core/
│   │   ├── SKILL.md                 # 核心分析引擎
│   │   ├── resources/               # 参数/规则/框架
│   │   └── scripts/
│   │       └── report_builder.py    # HTML 报告生成
│   ├── vedic-career/
│   │   └── SKILL.md                 # 职业分析
│   ├── vedic-love/
│   │   └── SKILL.md                 # 恋爱分析
│   ├── vedic-synastry/              # 合盘
│   │   ├── SKILL.md                 # 合盘引擎指令（五层 + QA）
│   │   ├── USAGE.md                 # 使用指南
│   │   ├── resources/               # 跨盘相位/月宿/性质盲扫/六维矩阵规则
│   │   └── scripts/
│   │       ├── build_synastry_data.py    # 跨盘计算引擎（纯标准库）
│   │       └── validate_synastry_data.py # 双盘自检
│   ├── vedic-rectifier/
│   │   ├── SKILL.md                 # 时间校准
│   │   ├── requirements.txt
│   │   ├── resources/
│   │   └── scripts/
│   │       └── time_scan.py         # Lagna/D9 扫描器
│   └── vedic-prashna/               # 卜卦/时盘（独立·不需本命）
│       ├── SKILL.md                 # Prashna 引擎（纯 Parashari 主判读）
│       ├── resources/               # 判读规范/宫位卡拉卡/月亮政策/本命交叉政策 等
│       └── scripts/
│           ├── build_prashna_data.py    # 卜卦盘计算
│           ├── calc_moon_vedic.py       # 月亮状态
│           ├── calc_optional_tajika.py  # Tajika 可选层（沙箱·默认关）
│           └── calc_optional_kp.py      # KP 可选层（沙箱·默认关）
├── claude-code/skills/              # Claude Code 版本 (同上)
└── codex/skills/                    # Codex 原生版本（含 agents/openai.yaml）

---

🧪 技术体系 / Technical Stack

---

📋 版本历史 / Version History

详见 / See CHANGELOG.md

---

☕ 赞赏 / Support

如果这个项目对你有帮助，欢迎赞赏支持：

If this project helps you, consider buying me a coffee:

    

WeChat Pay（微信支付）  |  Alipay（支付宝）

---

License

代码: AGPL-3.0 — 你可以自由使用、修改、学习。如果你基于本项目提供网络服务（SaaS），需要开源你的完整服务端代码。

指令文件 (SKILL.md / prompt 模板 / resources): 附加商用限制 — 个人使用无限制；未经授权不得用于商业服务。详见 COMMERCIAL_NOTICE。

简单说：个人用随便用，拿去卖钱的请先联系我。

Code: AGPL-3.0 — free to use, modify, study. Network services must open-source their full server code. Prompt files: additional commercial restriction — personal use unlimited; commercial use requires written permission. See COMMERCIAL_NOTICE.