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

七个专精 Skill 协同工作，从原生排盘到完整人生审计，再到双人合盘。

Seven specialized skills working together — from native chart calculation to complete life audit and two-person synastry.

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

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

# 从 GitHub 安装全部 7 个 skill（缺一不可）
# Install all 7 skills from GitHub (all required)

git clone https://github.com/CNWU16/vedic-astro-skills.git
cp -r vedic-astro-skills/codex/skills/vedic-* ~/.codex/skills/

git clone https://github.com/CNWU16/vedic-astro-skills.git
cp -r vedic-astro-skills/claude-code/skills/vedic-* ~/.claude/skills/

vedic-reader/
vedic-calculator/    ← 计算基座，必装！/ Required foundation!
vedic-core/
vedic-career/
vedic-love/
vedic-rectifier/
vedic-synastry/      ← 合盘（需两份盘）/ Synastry (needs two charts)

⚠️ 建议一次装全 7 个 skill。 vedic-calculator 是计算基座，其余分析 skill 都依赖它生成的 structured_data.md。其中 vedic-synastry（合盘）是双人分析 skill——它比较两个人的盘，用法与单人 skill 不同（需双方各一份盘）。

Install all 7 skills. vedic-calculator is the computational foundation that the other analysis skills depend on. Among them, vedic-synastry (synastry) is a two-person skill — it compares two charts and works differently from single-person skills (needs one chart per person).

# 推荐：使用自动安装脚本（处理依赖冲突 + 自动验证）
# 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.

用户星盘 (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

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

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

场景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-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.

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):

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

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

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

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

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

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

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

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

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

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.

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

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

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 扫描器
├── claude-code/skills/              # Claude Code 版本 (同上)
└── codex/skills/                    # Codex 原生版本（含 agents/openai.yaml）

详见 / See CHANGELOG.md

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

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

_{WeChat Pay（微信支付）  |  Alipay（支付宝）}

代码: 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.