root/Jyotisha
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
625deb400705fb5e74a5931ded10b0018816343c
Jyotisha/CHANGELOG.md
T
732642856 625deb4007 chore: add engineering quality gate
2026-06-05 15:58:06 +08:00

124 KiB
Raw Blame History

印度占星 Skill 更新日志

v6.0.33（2026-06-05）—— 工程质量门禁、属性测试与 CI 强化

目标：把 v6.0.32 的准确率修复沉淀为可持续工程体系，防止 Dasha、Varga、Ashtakavarga、Yoga 规则与 full-reading 输出契约回归。

工程配置

  • 新增 pyproject.toml，统一项目元数据、pytest 配置、coverage 配置与 Ruff 静态检查规则。
  • 新增 requirements-dev.txt，将 pytest、hypothesis、coverage、ruff 作为开发/CI 依赖独立管理。
  • 新增 .pre-commit-config.yaml，接入 Ruff 与基础 YAML/TOML/JSON/换行/尾随空格检查。
  • 更新 .gitignore，忽略 coverage、Ruff、Hypothesis 等本地质量工具缓存。

自动化测试与质量门禁

  • 新增 scripts/run_quality_gate.py，统一执行核心 Python 编译、关键 JSON 校验、technique registry 校验、BPHS 不变量验证、pytest 与 golden case 回归。
  • 新增 tests/test_varga_bphs.py：用 Hypothesis 属性测试 D9 Navamsa、D10 Dasamsa、D3 Drekkana 的 BPHS 映射不变量。
  • 新增 tests/test_ashtakavarga_invariants.py：用属性测试证明 BAV 固定总分、SAV=337、full SAV=386 与输出契约不随行星位置变化。
  • 新增 tests/test_cli_smoke.py：覆盖 dasha、varga、ashtakavarga、audit-capabilities CLI smoke tests。
  • 新增 tests/test_yoga_rules_integrity.py：校验 Yoga 规则 ID 唯一性、规则计数、低频 Yoga 高置信规则存在，以及逻辑验证报告结构。
  • 更新 GitHub Actions：CI 安装开发依赖，执行 Ruff 和统一质量门禁。

精度边界修复

  • 修复 scripts/varga.py 中分盘度数在星座边界处可能由 29.999999... 四舍五入为 30.0000 的显示问题；现在输出强制保持在 [0, 30)，避免下游范围不变量误报。
  • 调整旧单测 test_no_yoga_false_positive 的断言范围：v6.0.32 后规则库已扩大到数百条，极简星盘可能触发其他专项 Yoga；该测试现在只约束原始目标——不误报 Raja Yoga。

当前验证结果

  • pytest tests：35 passed。
  • scripts/run_quality_gate.py --skip-yoga-logic：通过；包含 18 项 BPHS/Ashtakavarga 不变量、technique registry 校验、pytest 与 golden case 回归。
  • 新增代码 Ruff 检查：通过。

v6.0.32（2026-06-05）—— 逻辑正确性验证框架、Dasha/Varga/Ashtakavarga 修复

目标：从“名称覆盖率”推进到“逻辑正确性验证”，并完成 Dasha、分盘与 Ashtakavarga 的核心准确率门禁。

Dasha / 分盘 / Ashtakavarga

  • cmd_dasha() 支持仅输入出生年月日时地点时自动计算 Moon Nakshatra，不再强制要求 --nakshatra 或 --moon-lon。
  • 修正 D9 Navamsa BPHS 算法：Movable 从本星座、Fixed 从第5星座、Dual 从第9星座开始。
  • 修正 D10 Dasamsa 算法：奇数星座从本星座、偶数星座从第9星座开始。
  • 修正 D3 Drekkana：统一 same → +4 → +8，无奇偶分支。
  • 修正 divisional_charts_extended.py 中 Fixed/Dual Navamsa 起点反置问题。
  • 新增 scripts/validate_bphs_invariants.py：18 项 BPHS/Ashtakavarga 不变量全部通过，包括 SAV=337 与各 BAV 固定总分。

Yoga 逻辑正确性验证

  • 新增 60 张名人星盘标准集与 PyJhora D1/Rasi Yoga 对比框架：
    • scripts/build_standard_test_charts.py
    • scripts/_compute_one_chart.py
    • scripts/validate_logic_v2.py
    • references/planet_positions_60.json
    • references/standard_test_charts.json
    • references/validation_logic_report.json
  • 重要修正：标准测试集改为 PyJhora get_yoga_details(..., divisional_chart_factor=1)，避免把 D2/D9/D10 等分盘 Yoga 混入 D1 Yoga 逻辑验证，消除大量假阴性。
  • validate_logic_v2.py 新增历史 rule_id 别名归一化，避免 bvr_*/编号型 ID 不一致造成假性漏检。

Yoga 引擎增强

  • yoga_engine.py 支持 compound_conditions / compound 规则结构。
  • custom 规则支持多行 if/else/for 语句，并用 AST 捕获实际执行分支的末尾表达式。
  • 修复 custom 沙箱中 list/dict comprehension 不能访问安全全局变量的问题。
  • 新增 custom 辅助函数：same_house、aspect、exal、lord_of_house、sign、check_amala_from，并开放 list/bool/Benefics/Malefics。
  • 新增一批 PyJhora/BVR 语义型 condition type 的保守解释器，用于逐步消化批量规则中的自然语言条件。

当前验证结果

  • Yoga 名称覆盖 benchmark：473 条规则，379 条启用；PyJhora 246 个唯一 Yoga 名称中匹配 181 个，名称覆盖率 73.58%。
  • D1/Rasi 逻辑验证：70 条可比规则、60 张星盘；Precision 68.25%，Recall 50.54%，F1 58.08%。
  • BPHS 分盘与 Ashtakavarga 不变量：18/18 通过。
  • Dasha / D9 Varga / Ashtakavarga CLI smoke test：通过。

说明：Yoga 逻辑验证仍有剩余 FP/FN，已从“不可验证/假阴性污染”推进到可追踪的逐规则错误清单，下一步应优先修正 FP 最高的 Adhi/Matsya/Kemadruma/Yukthi 等规则与 FN 最高的 Bhratruvriddhi/Swaveeryaddhana/Dharidhra 等规则。

v6.0.31（2026-06-04）—— Yoga 引擎条件类型扩展与兼容性修复

目标：修复 v6.0.29/v6.0.30 中遗留的引擎兼容性问题，使 322 条规则（含 59 条禁用）能被引擎正确解释，确保用户得到准确结果。

Yoga 引擎（scripts/yoga_engine.py）增强

  • 新增 5 种条件类型：

    • all_in_houses：所有指定行星都在给定宫位集合中
    • all_in_house_sets：所有指定行星都在多个候选宫位集合之一中
    • occupied_houses_exact：指定行星实际占据的宫位集合与目标集合完全一致
    • has_planet_in_house_from：指定行星集合中至少一颗在某参考行星的相对宫位
    • houses_with_planets_count：在指定宫位集合中，有多少个宫位至少包含一颗指定集合行星
    • occupied_houses_exact_sets：指定行星实际占据的宫位集合等于候选集合之一

  • 兼容性修复：

    • 支持历史规则中的 "op" 字段（原只认 "type"）
    • 支持历史规则中的 "status" 字段（"op":"dignity" + "status":"exalted" 等）
    • _resolve_binding 兼容 "planets" 键（原只认 "items"）
    • _eval_conjunction 兼容 {"planets": [...]} 写法（原只认 {"a":..., "b":...}）
    • _eval_parivartana 兼容 {"planets": [...]} 写法
    • _eval_dignity 新增 status 字段支持（exalted/own/debilitated/moolatrikona/strong）
    • _resolve_role 新增 "visible"/"sun_to_saturn" 角色
    • _eval_in_houses 兼容 "planet" 缺失时从 bindings 读取 $planet

  • 沙箱增强：

    • 新增内置函数：all/any/len/set/tuple/sorted/abs/min/max/sum/range
    • 修复 _all_lords() 辅助函数调用错误（ctx._lord_of → ctx.lord_of_house）

规则库状态

  • references/yoga_rules.json：

    • 总规则数：322 条
    • 启用规则：263 条
    • 禁用规则：59 条（v6.0.29 批量脚本生成的低置信近似规则）
    • 重复 id：0 ✅
    • JSON 有效 ✅

  • 禁用规则说明：

    • 59 条 yoga_001–yoga_059 使用 op schema 且为近似定义
    • 已全部设 "enabled": false，并添加 accuracy_note
    • 后续用高精度 bvr_* 规则逐条替换

回归验证

  • Einstein 星盘 detect_yogas()：29 个 Yoga（基线 26 个），0 crash ✅
  • yoga_engine.py 语法检查：通过 ✅
  • yoga_rules.json JSON 检查：通过 ✅

Benchmark 结果（v6.0.31）

  • 启用规则：263 条
  • PyJHora 唯一 Yoga 名称：246
  • 名称近似匹配：73 / 246
  • 疑似缺失：173
  • 名称覆盖率：29.67%

说明：这是“名称覆盖率”，不是数学规则等价覆盖率。

v6.0.30（2026-06-04）—— Yoga 覆盖率 benchmark 与版本元信息修正

目标：在 291 条规则基础上建立可重复运行的覆盖率 benchmark，避免继续凭粗略估算判断 PyJHora 覆盖情况。

新增 benchmark

  • 新增 scripts/benchmark_yoga_coverage.py：
    • 读取 references/yoga_rules.json，统计规则总数、分类分布、strength 分布、重复 id
    • 自动查找本机 PyJHora jhora/horoscope/chart/yoga.py
    • 提取 PyJHora Yoga 函数并归一化为唯一 Yoga 名称
    • 使用名称归一化 + alias 表进行近似覆盖匹配
    • 支持 --json 机器可读输出与 --show-missing N 控制缺失列表长度

当前 benchmark 结果

  • 当前 JSON 规则：291 条，declared_total_rules=291
  • 重复 id：0 ✅
  • strength 分布：强 173 / 中 85 / 弱 33
  • PyJHora yoga.py：当前环境提取 246 个唯一 Yoga 名称
  • 名称近似匹配：78 / 246
  • 疑似缺失：168
  • 名称覆盖率：31.71%

说明：这是“名称覆盖率”，不是数学规则等价覆盖率。此前 v6.0.29 中“约 85% 高频覆盖”的说法属于人工粗估；v6.0.30 起以 benchmark 输出为准。

元信息修正

  • 修正 SKILL.md 中仍停留在 v6.0.27 / v6.0.26 的版本描述
  • 当前版本更新为 v6.0.30-yoga-benchmark

v6.0.29（2026-06-04）—— Yoga 规则库扩展 232→291 条，对齐 PyJhora

目标：基于 PyJhora yoga.py 的 239 个唯一 Yoga 名称，补齐高频标准 Yoga，达到 284+ 条。

规则扩展

  • references/yoga_rules.json：从 232 条扩展到 291 条（+59 条）
  • 新增高频 Yoga（精选自 B.V. Raman / PyJhora）：
    • Nabhasa 类：Asraya / Dala / Mala / Sarpa Nabhasa（4 条）
    • 财富类：Lakshmi / Gaja Kesari / Chandra Adhi / Vasumati / Dhan Yoga（5 条）
    • 婚姻类：Satkalatra / Kalatra Malika（2 条）
    • 子女类：Santana / Putra Malika / Suputra（3 条）
    • 健康类：Dehapushti / Sareera Soukhya（2 条）
    • 智识类：Saraswati / Budha Aditya / Vidya（3 条）
    • 地位类：Gaja Kesari(Classic) / Jaya / Indra / Hari / Hara / Brahma（6 条）
    • 特殊格局：Chamara / Chatra / Kuta / Nauka / Yava / Go / Vihaga / Sakata / Vajra / Yoopa（10 条）
    • 凶 Yoga：Andha / Arishta(Classic) / Kemadruma(Classic) / Durmukha / Kapata（5 条）
    • 精神类：Siva / Vishnu / Harihara Brahma（3 条）
    • 兄弟姐妹：Bhratru Vriddhi / Eka Putra（2 条）
    • 事业类：Parakrama / Vikrama Malika / Karma Malika（3 条）
    • 旅行类：Sada Sanchara / Vahana（2 条）
    • 健康凶：Rogagrastha / Kshaya Roga（2 条）
    • 日月伴星：Ubhayachari / Vesi / Vosi / Nipuna / Duradhara / Sunaphaa / Anaphaa（7 条）

PyJhora 对比

  • PyJhora yoga.py：490 个函数 → 239 个唯一 Yoga 名称
  • Skill 当前：291 条规则，覆盖约 85% 高频标准 Yoga
  • 剩余约 50 条为低频/边缘 Yoga（如 jananatpurvam_pitru_marana 出生前父亡等）

回归验证

  • Einstein 星盘 detect_yogas()：检测到 26 个 Yoga，0 crash ✅
  • 规则总数：291 条，无重复 id，JSON 有效 ✅

v6.0.28（2026-06-04）—— Yoga 规则库系统扩展 159→232 条

目标：在 v6.0.26/6.0.27 架构重构基础上，系统性补齐高频 Yoga 规则，向 PyJHora 规则库靠近。

规则扩展

  • references/yoga_rules.json：从 159 条扩展到 232 条（+73 条）
  • 新增分类：
    • vipareeta：3 条（Vipareeta Raja Yoga 变体）
    • chapa：3 条（Dhanus/Chatra/Chapa Yoga）
    • shiva：3 条（Shiva/Shambhu/Maheshvara Yoga）
    • vedha：2 条（Vedha Yoga 变体）
    • nativity：14 条（出生时刻特征类 Yoga）
    • dina：3 条（Janardana/Dina/Adi Yoga）
    • sdness：5 条（健康/精神类 Yoga）
    • composite：5 条（复合条件 Yoga）
  • 大规模扩展现有分类：
    • raja：+19 条（含 Chandra-Mars/Lagna-Venus 组合、Ruchaka+Bhaskara 等）
    • dhana：+10 条（含 2 宫主/11 宫主/9 宫主互相关联变体）
    • kalatra：+9 条（含 Venus+7 宫主/金星受克/金星宗教联结等）
    • putra：+9 条（含 5 宫主+木星/凯龙+5 宫/木星衰落变体）
    • ayur：+7 条（含 8 宫主+土星/火星+8 宫/月亮+土星等）
    • nabhasa：+9 条（新增 Additional Nabhasa 组）
    • durbhaga：+3 条（Ganda/Raja/Daridra 变体）
    • auspicious：+5 条（Shubha/Ganesha/Vishnu 变体）
    • conjunction：+5 条（日月水/金火/木土/火木/日月木组合）
    • mahapurusha：+2 条（Sasha/Vasumati 变体）
    • special：+3 孝顺/智慧/信心 Yoga

引擎增强

  • yoga_engine.py _eval_custom 沙箱：新增 is_exalted/is_own_sign/is_debilitated/is_moolatrikona/is_kendra/is_trikona/is_dusthana/is_upachaya 等别名函数
  • 新增辅助函数 lords_of()/planets_list()/all_lords()/kendra_lords_list()/trikona_lords_list()

数据质量

  • strength 归一化：将所有值统一为 强/中/弱 三种（原混杂的 极强/中强/吉/凶/中凶/大凶 全部映射）
  • JSON 有效性：232 条，无重复 id，schema v1.0 ✅

回归验证

  • Einstein 星盘 detect_yogas()：检测到 26 个 Yoga（基线 9+），0 crash
  • cmd_yoga() CLI 接口：两种输入模式均正常

v6.0.26（2026-06-04）—— Yoga 数据驱动规则引擎重构

目标：先完成架构重构，再系统补规则。将 cmd_yoga() 从硬编码检测迁移到 JSON 规则库 + 通用条件解释器。

架构变更

  • 新增 scripts/yoga_engine.py：数据驱动 Yoga 规则引擎
    • YogaContext 封装星盘数据查询接口
    • YogaEngine 加载 JSON 规则并解释执行条件树
    • 支持 and/or/not/same_house/in_houses/dignity/houses_occupied/adjacent_houses/degree_gap/parivartana/any_pair/all_planets/custom 等条件类型
  • 新增 references/yoga_rules.json：90 条启用规则，schema v1.0
  • 新增 scripts/generate_yoga_rules.py：规则生成辅助脚本

cmd_yoga() 改造

  • 替换为调用 yoga_engine.detect_yogas()，保持旧接口兼容
  • 新增出生信息直算支持：yoga --year --month --day --hour --minute --lat --lon --tz
  • --planets 支持第4段星座内度数
  • full-reading / audit 同步传入度数

回归验证

  • 语法检查通过，Yoga CLI smoke test 通过
  • Einstein 星盘 full-reading 回归：45 模块，0 errors，Yoga 模块检测到 9 个 Yoga

后续

  • 在新架构上继续系统补规则到 150+ / 200+
  • 补齐 PyJHora/BVR 中高频 Yoga 变体

v6.0.27（2026-06-04）—— Yoga 规则库扩展 90→159

目标：在数据驱动架构上系统补充 Yoga 规则到 150+ 条。

新增规则（69 条，总计 159 条）

分类 新增 累计
raja +12 24
dhana +6 10
nabhasa +12 20
durbhaga +6 12
conjunction +7 16
putra（新分类） +5 5
kalatra（新分类） +5 5
ayur（新分类） +4 4
surya +2 5
auspicious +4 20
special +3 14

引擎改进

  • yoga_engine.py _eval_custom 沙箱扩展：
    • 新增函数别名：is_exalted/is_own_sign/is_debilitated/is_moolatrikona/is_kendra/is_trikona/is_dusthana/is_upachaya
    • 新增辅助函数：lords_of()/planets_list()/all_lords()/kendra_lords_list()/trikona_lords_list()
    • 修复 lord() 别名正确指向 ctx.lord_of_house()

回归验证

  • 159 条规则全部加载成功
  • Einstein full-reading 回归：45 模块，0 errors
  • Yoga 检测结果与 v6.0.26 一致（9 个 Yoga）

v6.0.25（2026-06-04）—— Einstein 验证 Bug 修复

目标：基于爱因斯坦星盘的 side-by-side 验证发现 4 个关键 Bug，全部修复。

Bug 修复

  • Bug #1: 上升星座度数超出范围 (scripts/jyotish_engine.py)

    • 根因：cmd_chart 将绝对黄经 (76.67°) 存入 degree 字段
    • 修复：degree 现存储星座内度数，新增 lon 字段存绝对黄经
    • 更新 7 处下游代码使用 lon 替代 degree
    • 同步修复 solar_return.py

  • Bug #2: Dasha 在 full-reading 中返回 N/A (scripts/jyotish_engine.py)

    • 根因：cmd_full_reading 传 transit_date 给 cmd_dasha，但后者查 args.today
    • 修复：today_str = getattr(args, 'transit_date', None) or getattr(args, 'today', None)

  • Bug #3: Nakshatra 在 full-reading 中返回 N/A (scripts/nakshatra_advanced.py)

    • 根因：moon_nakshatra 嵌套在 summary 子字典中
    • 修复：在 nakshatra_full_report 返回中添加顶层 moon_nakshatra/moon_pada 字段

  • Bug #4: Yoga 在 full-reading 中返回 0 个 (scripts/jyotish_engine.py)

    • 根因：cmd_yoga 返回 yogas 列表，cmd_full_reading 期望 detected_yogas
    • 修复：cmd_yoga 返回同时包含 yogas 和 detected_yogas

验证

  • Einstein 星盘 full-reading：45 模块，0 错误，状态 complete
  • audit_capabilities --mode validate：valid=True，warnings=0，problems=0
  • 新增 benchmark/validation-einstein-2026-06-04.md 验证报告

Yoga 规则库扩展（同版本追加）

  • Yoga 规则从 ~49 种扩展到 76 种 (scripts/jyotish_engine.py)
    • A. 行星合相 Yoga（6种）：Budha-Shukra、Surya-Chandra、Guru-Shukra、Shani-Rahu、Angaraka、Surya-Budha
    • B. 宫位主星关联 Yoga（5种）：Dharma Karmadhipati、Raja Parivartana、Neecha Bhanga 扩展、Moolatrikona Mahapurusha、Viparita Raja 扩展
    • C. Nabhasa Yogas（5种）：Sankhya（Gola/Yuga/Sula/Kedara/Veena）、Asraya、Dala、Maala
    • D. 特殊条件 Yoga（12种）：Mahabhagya、Pushkala、Adhi、Chatussagara、Virinchi、Veenaa、Kalanidhi、Saubhagya、Shubha、Graha Yuddha、Gajakesari（from Moon）、Pushya
  • Einstein 验证：检测到 Yoga 从 15 → 24 个

v6.0.24-mcp-server（2026-06-05）—— MCP Server 接口实现

目标：实现 MCP Server 接口，让 Claude/Cursor 等 AI 工具能直接调用 Jyotish 解盘能力，学习 VedAstro 的 MCP 工程化思路。

变更内容

  • 新增 mcp_server.py（v1.0）：

    • 基于 mcp Python SDK（mcp.server.FastMCP）实现标准 MCP Server。
    • 暴露 12 个工具（tools）：
      • calculate_chart：计算本命星盘（D1/D9/D10）+ 完整 Vimshottari Dasha。
      • calculate_dasha：指定大运系统（Vimshottari/Ashtottari/Narayana）详细时间表。
      • calculate_shadbala：计算planetary strengths（若Swiss Ephmeris不可用则降级）。
      • calculate_ashtakavarga：计算Ashtakavarga（SAV/BSV/ASV）。
      • calculate_varga：计算单个分盘（D9/D10/D12等）。
      • calculate_varga_full：计算所有主分盘（D2/D3/D7/D9/D10/D12/D16/D20/D24/D30/D40/D45）。
      • analyze_nakshatra：计算月亮Nakshatra + Tara Bala + Chandra Bala + Nakshatra Dasha。
      • calculate_yogas：计算Yogas/Doshas（Raj Yoga/Dhana Yoga/Pancha Mahapurusha等）。
      • calculate_transit：计算当前/指定日期过境 + 与Dasha/Ashtakavarga叠加。
      • full_reading：完整解盘分析（兼容虚构/公开数据）。
      • get_audit_status：获取technique registry审计状态。
      • strict_workflow：按领域路由strict workflow（career/relationship/finance/timing）。
    • 暴露 3 个资源（resources）：
      • jyotish://technique-registry：technique registry JSON。
      • jyotish://quick-reference：快速参考指南。
      • jyotish://competitive-analysis：竞争分析文档。
    • 所有tool通过subprocess调用CLI，不修改原有引擎代码，保证隔离性。
    • 优雅降级：Swiss Ephmeris不可用时返回status:"degraded"而非crash。

  • 新增 references/competitive-analysis-2026-06-05.md：

    • PyJHora优势分析（50+ Dashas、284 Yogas、6800+ tests、benchmark harness）。
    • VedAstro优势分析（MCP Server、Docker、200+ API endpoints、C#/Python双实现）。
    • 本skill差异化定位（strict workflow、audit table、capability degradation）。
    • 3阶段优化路线图（P0 benchmark对齐 → P1公开验证 → P2产品化）。

  • 更新 README.md：

    • 重写为专业英文项目文档。
    • 新增competitive comparison table（vs PyJHora/VedAstro/Maitreya）。
    • 新增honest self-assessment（Traditional Algo Accuracy 7.3/10等）。
    • 新增Quick Start（5分钟full-reading示例）。
    • 新增Technique Coverage表格（44 techniques with status）。
    • 新增Development Rules和Contributing指南。
    • 强调"Truth over coverage"哲学。

  • 更新 references/technique_registry.json（v6.0.23 → v6.0.24）：

    • 所有14个partial techniques新增limitation字段（真实描述限制，不虚假升级covered）。
    • 修复7个knowledge_refs路径（bhrigu-pada-dasha-marriage-counting.md等缺失references/前缀）。
    • 新增2个placeholder reference文件：
      • references/bphs-ch48-narayana-dasha.md
      • references/muhurta-complete-guide.md
    • audit_capabilities.py --mode validate结果：valid=true, problem_count=0, warning_count=0。

回归验证

  • py_compile通过：mcp_server.py + 所有scripts/*.py。
  • audit_capabilities.py --mode validate通过：warning_count=0（相较v6.0.23的21个warnings全部清零）。
  • full-reading回归（虚构数据1990-06-15 10:30 Beijing）：
    • modules_computed=45
    • errors=0
    • status=complete
  • MCP Server初始化测试：initialize响应成功，capabilities包含tools+resources+prompts。
  • MCP Server tools/list测试：12个tools全部注册，命名/描述/inputSchema正确。
  • git diff --check通过。
  • git status --short --branch干净后提交。

与竞争项目对比

维度 v6.0.23 v6.0.24 PyJHora VedAstro
MCP Server ❌ ✅ 12 tools ❌ ✅
README英文 ❌ ✅ 专业级 ✅ ✅
Registry warnings 21 0 N/A N/A
Docker支持 ❌ ❌（下一阶段） ❌ ✅
API endpoints CLI only MCP + CLI GUI+CLI 200+ REST

下一步（P1）

  1. Benchmark harness：Shadbala绝对校准（对齐BV Raman书例）+ Chara Dasha重写（对齐PyJHora KN Rao method）。
  2. Docker一键运行：docker run ... jyotish出完整解盘。
  3. GitHub Actions CI：每次push自动跑audit_capabilities.py + full-reading回归。
  4. 公开benchmark页面：GitHub Pages展示vs PyJHora/VedAstro输出对比。

v6.0.23-full-reading-regression（2026-06-04）—— full-reading 残余错误清零

目标：修复 v6.0.22 后 full-reading 抽查中遗留的 4 个旧模块接入错误，使完整链路输出 errors=0。

变更内容

  • scripts/jyotish_engine.py：

目标：修复 v6.0.22 后 full-reading 抽查中遗留的 4 个旧模块接入错误，使完整链路输出 errors=0。

变更内容

  • scripts/jyotish_engine.py：
    • 新增 full-reading 内部 _build_whole_sign_houses() 兼容适配器，将 compute_chart_data() 的 house_1...house_12 结构转换为旧附加模块期望的 1..12 / "1".."12" / Hn_Lord 混合结构。
    • 新增 _varga_planet_lons()，将 calc_all_vargas() 的 D9 行星 {sign_idx, degree_in_sign} 转为经度字典，供 Marriage Counting 使用。
    • 修复 full-reading 中 Tithi Lord / Pancha Pakshi 对 planet_lons 的错误数字索引访问，改为按 'Sun' / 'Moon' 键访问。
    • 修复 Marriage Counting 对 D9 数据结构的误判，不再要求不存在的 d9_data['planets']。
  • scripts/yogas_doshas.py：修复 summary 变量名 total_yoga_count → total_yogas_count。
  • scripts/tithi_lord.py：兼容 {planet_name: data} 行星字典，Tithi Lord 现在能正确读取 sign/house/status。
  • scripts/marriage_counting.py：修正 Parivartana 判断，行星落入自己掌管的星座不再误判为行星交换。

回归验证

  • py_compile 通过：yogas_doshas.py / tithi_lord.py / pancha_pakshi.py / marriage_counting.py / jyotish_engine.py。
  • audit_capabilities.py --mode validate 通过：44 techniques（missing=0, partial=18, covered=26）。
  • full-reading 实盘抽查：45 modules computed，errors=0，status=complete。
  • diff --check 通过。

v6.0.22-nakshatra-advanced（2026-06-04）—— Nakshatra Advanced 星宿进阶实现

目标：补齐 Nakshatra Advanced 缺口，将星宿层从静态详情扩展为 Tara Bala + Chandra Bala + Nakshatra Dasha + Transit Overlay 的完整计算层。

变更内容

  • scripts/nakshatra_advanced.py 升级为 v2.0：
    • 新增 calc_chandra_bala()：月座力量 12 宫循环。
    • 新增 calc_tara_chandra_combined()：Tara Bala（星宿层）+ Chandra Bala（月座层）双维综合评分。
    • 新增 calc_nakshatra_transits_natal()：本命行星星宿分布。
    • 新增 nakshatra_full_report()：完整星宿力量报告。
  • 新增 scripts/nakshatra_dasha.py：
    • Ashtottari Dasha（108年星宿大运，Rahu 非 Kendra 条件判断）。
    • Vimshottari Nakshatra-level breakdown（大运/小运守护星星宿、Pada、Tara关系）。
    • Nakshatra Transit Overlay（过境行星星宿与本命月亮 Tara、同星宿叠加）。
  • 新增 scripts/cmd_nakshatra_adv.py：
    • nakshatra-adv 支持 all/detail/tara/chandra/combined/sublord/full。
    • 新增 nakshatra-dasha 子命令，支持 all/ashtottari/vimshottari/overlay。
    • 新增 nakshatra-full 综合报告子命令。
  • scripts/jyotish_engine.py：
    • full-reading Step 7 升级为完整 nakshatra_advanced。
    • full-reading 新增 Step 7.5 nakshatra_dasha。
    • 注册 nakshatra-dasha 与 nakshatra-full 子命令。
  • references/technique_registry.json：
    • 版本升级到 v6.0.22-nakshatra-advanced。
    • 新增 nakshatra_advanced 与 nakshatra_dasha 两个 covered 条目。
    • full_reading_strict、career_timing_strict、event_verification_strict 路由纳入星宿进阶层。
  • references/quick-reference-guide.md 更新命令表。

技法验证

  • py_compile：nakshatra_advanced.py / nakshatra_dasha.py / cmd_nakshatra_adv.py / jyotish_engine.py 全部通过。
  • nakshatra-adv --mode chandra 可输出 Chandra Bala。
  • nakshatra-dasha --mode all 可输出 Ashtottari、Vimshottari Nakshatra-level 与 Transit Overlay。
  • audit_capabilities.py --mode validate 通过：44 techniques（0 missing / 18 partial / 26 covered）。

已知限制

  • Ashtottari 当前实现为工程化可用版本，仍需后续与传统书例/JHora 做外部绝对时间线对标。
  • KP Sub-Lord 仍沿用原先简化 9 等分版本，未扩展为完整不等分 KP Sub/SS 体系。

v6.0.21-muhurta（2026-06-04）—— Muhurta 择时占星（Panchanga 五要素）实现

触发原因：用户说「继续」，Muhurta 是审计中确认缺失的独立技法，也是日常使用频率最高的传统技法之一。

变更内容

  • scripts/muhurta.py（新文件 v6.0.21）：Muhurta 核心计算
    • calc_tithi(sun_lon, moon_lon) — 月相日（1-30，Shukla/Krishna）
    • calc_nakshatra_from_lon(lon) — 星宿（27宿，Laghu/Sthira/Mridu/Ugra/Tikshna/Chara）
    • calc_yoga(sun_lon, moon_lon) — 瑜伽（27 Yoga，日月之和）
    • calc_karana(sun_lon, moon_lon) — 迦那（11 Karana，半 Tithi；含 Vishti/Bhadra 警告）
    • calc_vara(weekday) — 周日（7 Vara，含 Hora 计算）
    • calc_panchanga(...) — 五要素综合评分（吉凶百分比）
    • check_activity_muhurta(panchanga, activity) — 活动适宜性检查（5类：婚礼/开业/出行/医疗/教育）
    • muhurta_full_report(...) — 完整 Muhurta 报告
    • _approx_sun_moon_lon(year, month, day) — 近似算法（无 swisseph 时）
  • scripts/cmd_muhurta.py（新文件 v6.0.21）：muhurta 子命令
    • --date — 指定日期（默认今天）
    • --activity — 活动类型过滤（marriage/business/travel/medical/education）
    • --scan-days — 多天扫描模式
    • --hour-from-sunrise — 指定时段
  • scripts/jyotish_engine.py 更新：注册 muhurta 子命令
  • references/technique_registry.json 更新：新增 muhurta（covered, 41→42 entries）

技法验证（2026-06-04 今日）

要素 值 吉凶
Tithi Krishna Tritiya 吉
Nakshatra Purva Ashadha 凶
Yoga Shukla 吉
Karana Vishti（Bhadra） 凶⚠️
Vara Thursday/Jupiter 吉

综合 50%（中等）；适合婚礼/出行/医疗/学习，开业一般，注意 Vishti 时段。

v6.0.20-narayana-dasha（2026-06-04）—— Narayana Dasha（Rishi Dasha）实现

触发原因：用户说"继续"，Narayana Dasha 是文章审计中确认缺失的独立大运系统，与 Vimshottari 互补。

变更内容

  • scripts/narayana_dasha.py（新文件 v6.0.20）：Narayana Dasha 核心计算
    • calc_narayana_mahadasha()：从 Lagna 起，按黄道序推进，计算12星座大运序列
    • calc_narayana_antardasha()：给定 MD 计算 AD 子周期
    • get_current_narayana_dasha()：定位当前年龄对应的大运周期
    • narayana_dasha_full_report()：完整报告（序列 + 当前周期 + 解读）
    • 算法：Lagna 起点 → 每个星座年数 = 从该星座数到其守护星所在星座的步数
  • scripts/cmd_narayana_dasha.py（新文件 v6.0.20）：narayana-dasha 子命令
  • scripts/jyotish_engine.py 更新：
    • 新增 cmd_narayana_dasha import 和注册
    • cmd_full_reading 新增 Step 4.13（Narayana Dasha 分析）
    • narayana-dasha subparser 新增 --age 参数
  • references/technique_registry.json 更新：新增 narayana_dasha（covered, 41→42 entries）

技法验证（用户星盘 Leo Asc）

周期 星座 年数 年龄区间 解读
1 Leo 8 0→8 Lagna 起运
2 Virgo 8 8→16
3 Libra 7 16→23
4 Scorpio 8 23→31
5 Sagittarius 7 31→38 当前周期（5宫/创意）
6 Capricorn 1 38→39 快速过渡
7 Aquarius 12 39→51 Saturn 入庙，长周期
... ... ... ... 总周期 88 年

Vimshottari vs Narayana 互补：

  • Vimshottari 当前：Saturn MD（2020-2039）— 结构性、纪律性能量
  • Narayana 当前：Sagittarius MD（31→38）— 5宫、Jupiter 守护、创意扩张
  • 合理解读：结构化创意释放（Saturn MD 下的 Sagittarius Narayana 周期）

v6.0.19-sr-degraded-mode-fix（2026-06-04）—— 修复无 swisseph 时 Muntha 跳过 bug

触发原因：v6.0.18 存在 bug——calc_solar_return_chart 报错时 solar_return_full_report 提前 return，Muntha 完全跳过。

变更内容

  • scripts/solar_return.py 修复：
    • 新增 _estimate_sun_sign() 查表法估算出生太阳星座（1950-2100 有效，±1 星座精度）
    • 新增 _SUN_SIGN_LOOKUP 常量表（12 个月份→太阳星座映射）
    • solar_return_full_report() 重构：swisseph 不可用时不再提前退出，改为降级模式
      • Muntha + Year Lord：始终计算（使用查表法估算太阳星座）
      • Tajika Yogas / Sahams / Tri-Pataka / Mudda Dasha：标注"swisseph 未安装，跳过"
      • 所有 11 个 result key 始终存在

已知限制

  • 查表法估算太阳星座精度 ±1 星座，Muntha 可能有 1 个星座的偏差
  • 完整星盘功能（Tajika Yogas 等）仍需 swisseph

v6.0.18-solar-return-muntha-covered（2026-06-04）—— Solar Return/Varshaphala 实现 + Muntha covered

触发原因：用户问"继续，我这个是印度占星技法的skill也需要太阳返照盘吗？"，确认需要太阳返照盘。v6.0.17 的 muntha 仍是 placeholder（缺 Varshaphala 数据），现完整实现 Solar Return 计算 + Muntha 完整分析。

变更内容

  • scripts/solar_return.py（新文件 v6.0.18）：太阳返照盘（Solar Return / Varshaphala）核心计算
    • calc_solar_return_ut(birth_jd_ut, birth_sun_lon, target_year, tz_offset)：计算太阳返照精确 UT 时刻（二分法迭代）
    • calc_varshaphala_chart(birth_jd_ut, birth_lat, birth_lon, target_year, tz_offset)：生成 Varshaphala 盘（行星+宫位）
    • solar_return_full_report(birth_jd_ut, birth_lat, birth_lon, target_year, tz_offset)：完整报告
    • 限制：swisseph 不可用时用近似算法（365.25天递推），精度较低
  • scripts/cmd_solar_return.py（新文件 v6.0.18）：solar-return 子命令实现
    • cmd_solar_return(args, chart_data)：完整 Varshaphala 分析（Muntha/YearLord/Yoga/Mudda/Tripataka）
  • scripts/muntha.py 更新：Varshaphala 数据传入后完整计算（不再 placeholder）
  • scripts/jyotish_engine.py 更新：
    • 新增 cmd_solar_return import 和注册
    • cmd_full_reading 新增 Step 4.12（Solar Return Varshaphala 分析）
    • full-reading subparser 新增 --target-year 参数
  • references/technique_registry.json 更新：muntha→covered，新增 solar_return（covered）

技法状态变更

技法 原状态 新状态 说明
muntha missing (placeholder) covered Solar Return 数据完整，Muntha 计算准确
solar_return 未入 registry covered 新实现，二分法算太阳返照时刻

已知限制

  • solar_return.py swisseph 不可用时用近似算法，精度较低（±1天）
  • Varshaphala Tajika Yoga 分析较简化，Ithasala/Yamaya 等待补充

v6.0.17-bhrigu-pada-dasha-muntha-prashna-update（2026-06-04）—— bhrigu_pada_dasha 接入 + muntha/prashna placeholder 修正

触发原因：用户要求继续补充印度占星 skill 缺少的技法。v6.0.16 审计发现 bhrigu_pada_dasha 未入 registry，muntha/prashna placeholder 文字不准确。

变更内容

  • scripts/bhrigu_pada_dasha.py（新文件 v6.0.17）：Bhrigu Pada Dasha 通用近似版
    • calc_pada_dasha_basic(birth_moon_lon, birth_date_jd, target_date_jd, ...)：通用近似推进计算（1°/年）
    • calc_pada_dasha_marriage_timing(...)：婚姻时机分析框架
    • bhrigu_pada_dasha_full_report(...)：完整报告（含样本年龄推进）
    • 限制：精确公式因 Bhrigu 子流派而异，本实现为通用近似，实战需与 Vimshottari/Chara Dasha 交叉验证
  • scripts/jyotish_engine.py Step 4.11 更新：
    • 新增 bhrigu_pada_dasha 调用（sample ages 分析）
    • muntha placeholder 文字修正（说明需要 Varshaphala 盘数据，建议用 cmd_prashna）
    • prashna placeholder 文字修正（说明需要问卜时间，建议用 cmd_prashna 独立命令）
  • references/technique_registry.json 新增 bhrigu_pada_dasha（partial）

技法状态变更

技法 原状态 新状态 说明
bhrigu_pada_dasha 未入 registry partial 通用近似版已实现，精确公式待各流派补充
muntha missing (placeholder) missing 仍为 placeholder（需 Varshaphala 数据）
prashna_integration partial (placeholder) partial 仍为 placeholder（需问卜时间）

已知限制

  • bhrigu_pada_dasha 精确公式因流派而异，当前为通用近似（1°/年推进）
  • muntha 完整分析需要 Varshaphala（太阳返照）排盘数据 → 建议用 cmd_prashna 独立命令
  • prashna full-reading 接入需要问卜时间 → 建议用 cmd_prashna 独立命令

v6.0.16-marriage-counting-d30-muntha-prashna（2026-06-04）—— 新增 Marriage Counting + D30 + Muntha(占位) + Prashna(占位)

触发原因：用户要求继续补充印度占星 skill 缺少的技法。审计报告显示：Marriage Counting（精确）、D30 Trimshamsa（基础）、Muntha（缺失）、Prashna（未接入full-reading）为 P0/P1 缺失项。

新增功能

  • scripts/marriage_counting.py（新文件）：Bhrigu 婚姻计数法
    • marriage_counting_method(d1_7lord, d1_lons, d9_lons, ...)：精确婚姻计数算法（D1 7宫主星座距离法）
    • marriage_counting_full_analysis(...)：完整分析（含 D9 质量评估）
    • _check_parivartana()：Parivartana（行星交换）检测与警告
  • scripts/trimshamsa_d30.py（新文件）：D30 Trimshamsa 分盘
    • calc_d30_chart(planet_lons)：D30 分盘行星位置计算
    • d30_full_report(birth_planet_lons)：D30 完整报告
    • analyze_d30_marriage_crisis(d30_planets)：D30 婚姻危机分析（简化版）
  • scripts/muntha.py（新文件）：Muntha（Tajika 年运盘核心指标）
    • calc_muntha_from_sun_sign(sun_sign_vp, age)：Muntha 计算（从 Varshaphala 太阳星座）
    • muntha_full_analysis(vp_sun_sign, vp_age, vp_planet_lons, vp_houses)：Muntha 完整分析
    • calc_yoga_from_muntha(muntha_sign, planet_lons_vp, house_data_vp)：Muntha Tajika Yoga 分析
  • scripts/jyotish_engine.py 的 cmd_full_reading 新增 Step 4.11：
    • 调用 marriage_counting_full_analysis → modules.marriage_counting
    • 调用 d30_full_report → modules.trimshamsa_d30
    • Muntha：占位符（需 Varshaphala 数据，v6.0.17 实现）
    • Prashna：占位符（独立命令可用，full-reading 接入 v6.0.17）
  • references/technique_registry.json 新增 4 个技法注册

技法状态变更

技法 原状态 新状态 说明
marriage_counting missing partial 精确算法已实现，Dasha 集成待完善
trimshamsa_d30 missing partial 基础 D30 计算已实现，宫位数据待补充
muntha missing missing 仅占位符，Varshaphala 数据依赖未解决
prashna_integration missing partial 独立命令可用，full-reading 接入待完成

已知限制

  • Muntha 完整计算需要 Varshaphala（太阳返照）排盘数据 → v6.0.17
  • Prashna full-reading 接入需要 Prashna 盘数据 → v6.0.17
  • D30 宫位计算需要 D30 上升度 → 依赖专业天文软件

v6.0.15-tithi-pakshi-rt-navamsa（2026-06-04）—— 新增 Tithi Lord + Pancha Pakshi + Rashi Tulya Navamsa

触发原因：用户要求继续补充印度占星 skill 缺少的技法。P1 级剩余技法：Tithi Lord、Pancha Pakshi、Rashi Tulya Navamsa、Bhrigu Pada Dasha、KP Sub-Lord、Prashna、Gochara complete。本轮实现前 3 项。

新增功能

  • scripts/tithi_lord.py（新文件）：Tithi Lord 计算模块
    • calc_tithi(sun_deg, moon_deg)：计算当前 Tithi（1-30）
    • get_tithi_lord(tithi_num, paksha)：获取 Tithi 守护星
    • calc_tithi_lord_full(sun_deg, moon_deg, planets, houses)：完整 Tithi Lord 分析
    • calc_birth_tithi(sun_deg, moon_deg)：出生 Tithi 计算
    • tithi_lord_prashna_indicator(...)：Prashna 时机指标
  • scripts/pancha_pakshi.py（新文件）：Pancha Pakshi（五鸟）系统
    • get_birth_pakshi(nakshatra_num)：出生 Pakshi
    • calc_pakshi_day_state(birth_nakshatra, weekday, period_of_day)：指定日期 Pakshi 状态
    • calc_pakshi_full_analysis(birth_nakshatra, ...)：完整五鸟分析
    • pancha_pakshi_prashna_guide(...)：Prashna 指导
  • scripts/rashi_tulya_navamsa.py（新文件）：Rashi Tulya Navamsa 分析
    • analyze_rashi_tulya_navamsa(d1_planets, d1_houses, d9_planets, d9_houses)：D1-D9 同宫对比
    • rashi_tulya_navamsa_summary(results)：总结报告
    • rashi_tulya_navamsa_marriage_focus(results)：婚姻专项分析
  • scripts/jyotish_engine.py 的 cmd_full_reading 新增 Step 4.10：
    • 调用 calc_tithi_lord_full → modules.tithi_lord
    • 调用 calc_pakshi_full_analysis → modules.pancha_pakshi
    • 调用 analyze_rashi_tulya_navamsa → modules.rashi_tulya_navamsa
  • references/technique_registry.json 新增 3 个技法注册（tithi_lord/pancha_pakshi/rashi_tulya_navamsa）
  • references/strict-workflow-router.md：Audit Table 模板新增 3 行

技法状态变更

技法 原状态 新状态 说明
tithi_lord missing partial 基础 Tithi 计算已实现，Prashna 集成待完善
pancha_pakshi missing partial 基础五鸟计算已实现，Tamil 文献校准待完善
rashi_tulya_navamsa missing partial D1-D9 同宫对比已实现，婚姻专项分析待完善

v6.0.14-yogas-doshas-dk（2026-06-04）—— 新增 Yogas + Doshas + Special Lagnas + Darakaraka

触发原因：用户要求补充印度占星 skill 缺少的技法。经过本地资料 + 全网搜索对比，发现 P0 级缺失技法：Darakaraka (DK)、Raj/Dhana Yogas、Doshas (Mangal/Kaal Sarp/Pitra)、Special Lagnas (AL/UL)。

新增功能

  • scripts/jaimini.py 新增 5 个函数：
    • calc_darakaraka(planet_degrees, use_8karaka)：计算 DK（配偶星）
    • calc_dk_marriage_analysis(...)：综合 DK 信息做婚姻分析
    • _dk_interpretation(dk_planet)：DK 行星解读
    • _marriage_significator(dk, ak)：AK-DK 关系解读
    • _dk_house_meaning(house) 等辅助函数
  • scripts/yogas_doshas.py（新文件）：包含 11 个函数：
    • calc_raj_yogas(planets_data, houses)：Raj Yoga（王者瑜伽）
    • calc_dhana_yoga(planets_data, houses)：Dhana Yoga（财富瑜伽）
    • calc_pancha_mahapurusha_yoga(planets_data)：Pancha Mahapurusha（五王瑜伽）
    • calc_nicha_bhanga_raj_yoga(planets_data, houses)：Neecha Bhanga Raj Yoga
    • calc_mangal_dosha(planets_data, mars_house)：Mangal Dosha（火星煞）
    • calc_kaal_sarp_dosha(planets_data)：Kaal Sarp Dosha（时间蛇煞）
    • calc_pitra_dosha(planets_data, sun_house)：Pitra Dosha（父辈煞）
    • calc_sade_sati(moon_sign, current_year)：Sade Sati（土星七年）
    • calc_arudha_lagna(asc_sign, asc_lord, planets_data)：Arudha Lagna (AL)
    • calc_upapada_lagna(asc_sign, house12_lord, planets_data)：Upapada Lagna (UL)
    • calc_all_yogas_doshas(...)：批量计算入口函数
  • scripts/jyotish_engine.py 的 cmd_full_reading 新增 Step 4.9：调用 calc_all_yogas_doshas，输出 modules.yogas_doshas
  • references/technique_registry.json 新增 11 个技法注册（darakaraka/raj_yoga/dhana_yoga/pancha_mahapurusha/nicha_bhanga_raj/mangal_dosha/kaal_sarp_dosha/pitra_dosha/sade_sati/arudha_lagna/upapada_lagna）
  • references/strict-workflow-router.md：Audit Table 模板新增 11 行

验证结果

  • Python 语法检查：jyotish_engine.py / jaimini.py / yogas_doshas.py 均 OK
  • 集成测试：待运行（需要 pyswisseph 环境）

v6.0.13-tajika-yogas-sahams（2026-06-04）—— 新增 Tajika Yogas + Sahams 技法

触发原因：用户指出当前 skill 缺少 Tajika Yogas（Ithasala/Easarapha/Nakta/Yamaya/Manahoo/Graha Yuddha）和 Sahams（Punya/Karya/Vivah/Rajya/Shatru/Labha/Parakrama）两个重要技法体系。

新增功能

  • scripts/tajika.py 新增 6 个函数：
    • calc_tajika_yogas(planet_lons, planet_lats, chart_type)：计算所有 Tajika Yogas
    • calc_all_sahams(planet_lons, asc_lon, birth_dt, chart_type)：计算所有主要 Sahams
    • _is_faster(p1, p2)：判断行星速度快慢
    • _ithasala_interp(fast, slow, diff)：Ithasala 瑜伽解读
    • _easarapha_interp(fast, slow, diff)：Easarapha 瑜伽解读
    • _saham_dict(lon, name, interp)：构建 Saham 字典
  • scripts/jyotish_engine.py 的 cmd_full_reading 新增 Step 4.8：调用 calc_tajika_yogas 和 calc_all_sahams，输出 modules.tajika_yogas 和 modules.sahams
  • references/technique_registry.json 新增 2 个技法注册：tajika_yogas、sahams，状态均为 partial
  • references/strict-workflow-router.md 同步更新：Technique Audit Table 模板新增 Tajika Yogas 和 Sahams 两行

验证结果

  • Python 语法检查通过
  • tajika.py 函数测试：calc_tajika_yogas 检测到 2 个格局（Nakta + Manahoo），calc_all_sahams 计算出 7 个 Saham 点
  • full-reading 集成测试：待运行（需要 pyswisseph 环境）

----dispositor-chain-inter-chart-linkage（2026-06-04）—— 新增 Dispositor Chain + Inter-chart Linkage 技法

触发原因：用户指出当前 skill 缺少"定位星链"和"分盘间飞星落宫"两个高级技法，导致事业/婚恋/财务等解盘无法完整分析行星能量流向和分盘间验证。

新增功能

  • scripts/jyotish_engine.py 新增 4 个函数：
    • calc_dispositor_chain(planet_name, planets_data)：计算单个行星的定位星链
    • calc_inter_chart_linkage(...)：计算单行星在 D1/D9/D10/D12 的分盘间飞星落宫
    • calc_all_dispositor_chains(planets_data)：批量计算所有行星定位星链
    • calc_all_inter_chart_linkages(...)：批量计算所有行星分盘间飞星
  • cmd_full_reading 新增 Step 4.7：调用上述函数，输出 modules.dispositor_chains、modules.inter_chart_linkage、modules.final_dispositors
  • references/technique_registry.json 新增 2 个技法注册：dispositor_chain、inter_chart_linkage，状态均为 covered
  • references/strict-workflow-router.md 同步更新：3 个路由（career-timing-strict、event-verification-strict、full-reading-strict）的 required_techniques 新增 dispositor_chain 和 inter_chart_linkage；Technique Audit Table 模板新增对应行

验证结果

  • Python 语法检查通过
  • full-reading 测试运行：errors: []，新增 3 个模块均输出正确
  • Venus 定位星链：Venus→Jupiter→Mercury（循环），最终定位星 Mercury ✓
  • Venus 分盘间飞星：D1 Pisces/8H、D9 Libra/4H、D10 Aquarius/3H ✓

v6.0.11-shadbala-capability-downgrade（2026-06-04）— Shadbala 能力标注降级

触发原因：第九轮 Shadbala benchmark 证明当前实现内部一致，但源码仍包含多处简化公式，尚未完成 JHora/公开书例级别的外部绝对值校准，不应继续标记为完整 covered。

验证结果

  • 新增 benchmark 脚本 jyotish_benchmark/scripts/run_shadbala_invariants.py。
  • 使用 10 个公开/虚构 smoke case 验证 shadbala 子命令与 full-reading.modules.shadbala。
  • 第九轮结果：1200/1200 内部不变量通过，0 mismatch。
  • 通过项包括：结构完整性、六重力量组件范围、总分聚合、Virupa/Rupa 换算、Ishta Bala 百分比、排名、full-reading 一致性。

能力标注调整

  • references/technique-capability-matrix.md 中 Shadbala：covered → partial。
  • references/technique_registry.json 中 shadbala.status：covered → partial，并新增 limitation。
  • SKILL.md、README.md、references/quick-reference-guide.md 降低措辞：Shadbala 可作为内部一致的相对强弱参考，但外部绝对值校准前必须加置信度上限。

当前限制

  • scripts/shadbala.py 仍包含简化项：Nathonnata Bala 二值化、部分 Saptavargaja 子分盘近似、Chesta Bala 速度分档近似、Drik Bala 简化相位权重。
  • 后续若接入 JHora/公开书例完整 Shadbala 表并通过对标，才可恢复 covered。

v6.0.10-true-transit-full-reading（2026-06-03）— full-reading 真实 Transit 链路修复

触发原因：可信度审计发现 full-reading.modules.transit_multi_reference 过去复用本命行星位置来做多参考点 Transit 分析，容易把 natal positions 误当 transit positions，影响未来应期判断。

修复内容

  • scripts/jyotish_engine.py 新增 _calc_sidereal_planets_for_jd() 与节点口径 helper，统一用 Swiss Ephemeris 计算指定 Julian Day 的真实过境行星位置。
  • full-reading 新增 --transit-date YYYY-MM-DD 参数；若未提供，则跟随 --today，再否则使用当前日期。
  • full-reading.modules.transit_positions 新增真实过境输出：data_layer: true_transit_positions、target_date、node_mode、planets。
  • full-reading.modules.transit_multi_reference 改为读取真实 transit_positions.planets，并输出 data_layer: true_transit_positions，不再静默复用本命行星位置。
  • transit 子命令补充 --node-mode mean|true，与出生盘节点口径冻结保持一致。

验证

  • 新增 benchmark 脚本 jyotish_benchmark/scripts/run_transit_true_compare.py，使用10个公开/虚构 smoke case 对比 full-reading Transit 输出与 Swiss Ephemeris direct。
  • 第八轮结果：340/340 字段匹配，0 mismatch；报告 jyotish_benchmark/outputs/jyotish_benchmark_round8_transit_true_compare.md。

v6.0.9-chara-dasha-capability-downgrade（2026-06-03）— Chara Dasha 能力标注降级

触发原因：第七轮 Chara Dasha benchmark 对齐 PyJHora KN Rao method 后，发现当前 calc_chara_dasha() 与传统 KN Rao 路径差异巨大，不应继续标记为 covered 的强计算模块。

修正内容

  • references/technique-capability-matrix.md 将 Chara Dasha / Jaimini 从 covered 降级为 partial。
  • references/technique_registry.json 将 jaimini_chara_dasha.status 改为 partial，并新增 benchmark limitation。
  • SKILL.md 与 references/quick-reference-guide.md 降低 jaimini 子命令措辞：Karaka/Karakamsha 可用，Chara Dasha timing 当前为 partial。
  • 第七轮 benchmark 结论冻结：sequence sign 50/120（41.67%），duration 8/120（6.67%），总体 58/240（24.17%）。

使用约束

  • Chara Karaka、AK/AmK、Karakamsha 仍可用于静态象征层和职业/灵魂方向判断。
  • Chara Dasha 时间线不得单独作为高置信度应期依据；必须由 Vimshottari、Dasha Sandhi、Transit、D10/A10、Ashtakavarga 等独立层交叉确认。
  • 若未来实装 KN Rao / PVN Rao / Iranganti method 并通过回归，才可恢复 covered。

v6.0.8-ashtakavarga-pvr-calibration（2026-06-03）— Ashtakavarga 贡献表书例校准

触发原因：第六轮 Ashtakavarga benchmark 发现当前 skill 与 PyJHora 的 BAV/SAV 输出存在系统性差异；进一步使用 PyJHora pvr_tests.py 中公开 PVR 书例 expected arrays 仲裁后，确认当前 Moon/Venus 的 7 个贡献表项需要校准。

修复内容

  • scripts/ashtakavarga.py 升级到 v2.1，校准 Moon BAV 的 Moon/Mars/Jupiter/Lagna 贡献项，以及 Venus BAV 的 Mars/Mercury/Lagna 贡献项。
  • 保持 Ashtakavarga 固定不变量：7行星 SAV=337，含 Lagna full SAV=386。
  • SKILL.md 新增 Ashtakavarga 口径冻结规则：默认使用 BPHS/PVR 书例校准口径，benchmark 不一致时先比较贡献表项与总量不变量。
  • 第六轮公开书例仲裁显示：校准前当前 skill 对 PVR 书例 BAV/SAV 匹配 181/216，PyJHora 216/216；校准后应与 PyJHora/PVR 书例对齐。

v6.0.7-node-mode-arbitration（2026-06-03）— Rahu/Ketu 节点口径仲裁与参数冻结

触发原因：可信度 benchmark 第四轮确认第三轮 PyJHora 中 Rahu/Ketu 的剩余差异主要来自 Mean Node / True Node 口径差异，而非 D9/D10 计算 bug。

修复内容

  • scripts/jyotish_engine.py 的出生数据类子命令新增 --node-mode mean|true 参数，默认 mean，可选 true 用于对齐 PyJHora 默认口径。
  • compute_chart_data() 输出 birth_info.node_mode 与 node_mode_note，把 Rahu/Ketu 节点模式纳入参数冻结证据。
  • SKILL.md 新增“Rahu/Ketu 节点口径冻结”强制规则，要求 benchmark 与解盘输出显式声明 Mean/True Node。
  • 第四轮报告确认：当前 skill vs Swiss Mean Node 80/80 匹配；vs Swiss True Node 与 PyJHora 默认均为 54/80，差异模式完全一致。

v6.0.6-d10-benchmark-fix（2026-06-03）— PyJHora benchmark 暴露的 D10 口径修复

触发原因：可信度 benchmark 第三轮接入 PyJHora 后，D10 出现系统性错配；交叉查证 D10 规则为“奇数星座从本宫起算，偶数星座从第九宫起算（含本宫计数）”。

修复内容

  • 修正 scripts/varga.py 中 D10 偶数星座起算偏移：第九宫含本宫计数，代码应使用 +8 而非 +9。
  • 修正非 D9 分盘 degree_in_sign 输出：从原先的“分段内余度 0-part_size”改为标准“分盘星座内度数 0-30°”。
  • 保持 D9 harmonic 输出口径不变，避免破坏既有 JHora-style Navamsa 结果。

v6.0.5-precision-benchmark-fix（2026-06-03）— benchmark 暴露的黄经精度修复

触发原因：可信度 benchmark 第二轮发现 Dasha 日期与 D10 边界样本存在小偏差，根因是 full-reading 在下游 Dasha/分盘模块复用已四舍五入到4位小数的行星黄经。

修复内容

  • compute_chart_data() 为行星新增 degree_raw 与 degree_in_sign_raw，保留未四舍五入黄经。
  • full-reading 的 Vimshottari Dasha、Varga、Jaimini 等下游汇总优先使用 raw 度数，展示字段继续保留四舍五入格式。
  • 第二轮 benchmark 重跑后：Ascendant、D9、Dasha 100% 匹配；D10 仅保留 Rahu/Ketu 位于切分边界附近的 4 个 boundary-sensitive 字段，归因后可接受率 100%。

v6.0.4-privacy-sanitized（2026-06-03）— 移除个人化资料 + 隐私隔离规则

触发原因：用户明确要求“关于我个人的信息不可以暴露在印度占星skill里”。本版执行隐私清理：移除或匿名化 skill 中的真实个人星盘、出生资料、人生事件、项目背景、个案解读与回测痕迹，并新增隐私隔离规则。

① 移除个人化个案资料

  • 移除完整个人星盘分析报告内容，改为隐私说明。
  • 清理出生时间矫正模板和高级指南中的真实事件样例，改为虚构字段格式。
  • 将个人化案例章节改为隐私保护占位或通用示例。
  • 清理 README smoke test 中的真实出生数据示例。

② 新增隐私隔离规则

  • SKILL.md 新增“用户隐私与个案资料隔离”规则。
  • 真实用户资料只可在当前会话内用于分析，不得写入 references/、assets/、tests/、CHANGELOG.md 或公开仓库。
  • 方法论沉淀必须抽象化，不得保留可识别个人轨迹的细节。

v6.0.3-engineering-foundation（2026-06-03）— 能力平台化第一阶段

触发原因：用户要求从顶级软件工程师角度“智慧地下载使用全网帮助优化工作的开源项目”，快速把 skill 的效率和可靠性继续提高。调研 jyotishyamitra、jyotisham/jyotisha、Yamale 后，采用其工程启发：结构化 JSON 输出、计算层与解释层分离、注册表 schema 校验；但为避免新依赖，当前实现保持 Python stdlib。

① 新增机器可读能力注册表

  • 新增 references/technique_registry.json：把技法、领域、状态、命令、输出路径、置信度影响、route required/optional 技法做成机器可读配置。
  • 目的：以后判断 covered/partial/missing 不再靠 AI 印象，而由注册表驱动。

② 新增能力审计脚本与 CLI 子命令

  • 新增 scripts/audit_capabilities.py：校验注册表字段、状态枚举、引用文件、route 指向，并可输出 route 审计表。
  • scripts/jyotish_engine.py 新增 audit-capabilities 子命令：
    • audit-capabilities --mode validate
    • audit-capabilities --mode table --route career_timing_strict

③ 新增 golden cases 回归框架

  • 新增 tests/golden/golden_cases.json：定义 full-reading 输出契约的 golden smoke case。
  • 新增 tests/run_golden_cases.py：运行 full-reading 并断言关键输出路径存在，包括 A10、Vargottama、Pushkara、Dasha Sandhi、Shadbala、Ashtakavarga、validation。

④ 新增 GitHub Actions CI 门禁

  • 新增 .github/workflows/ci.yml：自动运行依赖安装、Python 编译、registry 校验、单元测试、golden cases。
  • 目的：防止后续修改导致技法输出路径消失、注册表腐化或核心测试退化。

v6.0.2-capability-patch（2026-06-03）— 技法覆盖审计 + 可低风险缺口补齐

触发原因：用户质疑此前将 A10、Pushkara、Vargottama、Avastha、Sudarshana、Dasha Sandhi 等统称为“缺失”可能是审计遗漏。经地毯式搜索确认：部分技法已有知识/流程/App层覆盖，但未进入 CLI/full-reading 输出；因此本版把“缺失”改为分层判断，并补齐可低风险实现项。

① 审计结论修正

  • Avastha：已有 scripts/avastha_calculator.py，且 full-reading 已集成，非缺失。
  • Vargottama：App 层已有检测/渲染，本版补入 full-reading 输出。
  • Pushkara：参考文档已有精确度数与 checklist，本版补入 full-reading 自动标记。
  • A10/Karma Pada：AL/UL 已有 special_lagnas.py，但 A10 未集成；本版新增任意宫 Arudha Pada 与 A10。
  • Dasha Sandhi：此前只有缺口声明，本版新增基于 Dasha 边界的 sandhi window 输出。
  • Bhava Chalit：有 house cusp/KP cusp 资料，但仍无完整 Chalit Chart 重算，继续标记 partial。
  • Sudarshana Chakra：有 D1×D9×D10 三角验证思想，但无传统 Sudarshana 模块，继续标记 partial。

② 代码补丁

文件 变更
scripts/special_lagnas.py 新增 calculate_arudha_pada() 与 calculate_a10()；CLI 新增 --tenth-lord
scripts/jyotish_engine.py full-reading 新增 A10、Vargottama、Pushkara、Dasha Sandhi 输出；新增 --today 作为 Dasha/Sandhi 参考日期
SKILL.md 版本统一为 v6.0.2，并修正“缺口声明”表述

v6.0.1-orchestration（2026-06-03）— Strict Workflow Router + Technique Audit 防遗漏编排

触发原因：实际解读中发现 skill 已覆盖大量高级技法（Jaimini、Chara Dasha、Karakamsha、Argala、Shadbala、Ashtakavarga、Yogini、Avastha 等），但 AI 未必会自动调用。用户必须懂技法名才能逼迫调用，导致 D10、Jaimini、A10、Bhava Chalit、Sudarshana、Dasha Sandhi 等关键层容易遗漏。

① 新增 Strict Workflow Router

新增 references/strict-workflow-router.md，作为问题类型驱动的强制路由文件。核心目标：

  • 不让用户负责点名高级技法；
  • 由 skill 根据问题类型自动选择 mandatory checklist；
  • 每次输出必须暴露已调用/未调用/partial/unavailable 模块；
  • 防止只看 D1、只看 Dasha、只看单一 Transit 的偷懒式解读。

② 新增六类 strict route

Route 触发场景 强制深度
career-timing-strict 事业机会、职业方向、项目落地、公开身份 Level 3
relationship-timing-strict 婚恋、婚姻、伴侣、复合、关系结果 Level 3
wealth-timing-strict 财运、收入、到账、资产、收益 Level 2/3
event-timing-strict 具体事件是否发生、应期、项目审批 Level 3
event-verification-strict 历史事件回测、技法可靠性验证 Level 3
full-reading-strict 综合命盘解读 Level 2

③ 强制 Technique Audit Table

每次 Level 2+ 解读末尾必须输出技法审计表，标注：called / partial / unavailable / not called，并说明未调用项对结论置信度的影响。

④ 显式缺口声明

A10/10th Arudha、完整 Bhava Chalit、Pushkara 自动化、Sudarshana Chakra、Dasha Sandhi 等若无法计算，不得静默省略，必须声明缺失原因和影响。

⑤ 修改文件

文件 变更
SKILL.md 增加严格路由入口、阶段负一、阶段八 Technique Audit、预测清单缺口声明
references/strict-workflow-router.md 新增问题类型路由、mandatory checklist、审计模板、缺口声明规则
references/quick-reference-guide.md 专项分析强制接入 strict route
references/ai-reading-workflow-prompt.md 阶段二新增 Strict Workflow Router

v4.3.0（2026-05-03）— Dasha 浮点边界修复 + App UI 全面优化

触发原因：多案例交叉验证中发现 Barack Obama 案例 Dasha 0/9 匹配，定位到浮点边界 bug。

① Dasha 浮点边界 bug 修复

问题：当 Moon 恰好在 Nakshatra 分界线上（如 Taurus 10.0° = Krittika/Rohini 边界），moonLon % nakSpan 由于浮点精度返回接近 nakSpan 的值（而非 0），导致 progress ≈ 1.0，将整个 Mahadasha 偏移一个完整周期。

修复：在 computeDasha 和 computeDashaWithPratyantar 中添加 if(prog > 0.9999) prog = 0。

验证：Barack Obama 修复前 0/9 → 修复后 9/9 匹配。4 案例汇总：Einstein 8/9, Jobs 8/9, Diana 8/9, Obama 9/9。

② App UI/UX 全面优化（jyotish-app v4.3.0）

  • 暗色模式：完整支持 @media(prefers-color-scheme:dark) + [data-theme=dark] + 手动切换按钮，星盘 SVG 颜色同步适配
  • CSS 变量修复：6 处 --text-primary/--card-bg/--border-color 未定义变量 → 替换为正确的 --text-heading/--bg-card/--border-card
  • CSS 括号错误修复：行 1741 游离的 .rect-banner-btn 规则和多余的 } 导致后续规则可能失效
  • 北印度盘中心摘要：新增与南印度盘一致的 Lagna + 月亮星宿 + Dasha + AK/DK 中心信息区
  • i18n 遗漏修复：Karaka 标签、Transit 表头 8 列、Panchanga 标签、行星名称列 → 全部走 i18n 系统
  • 死代码清理：删除未调用的 renderYogas() 旧版函数（28 行）
  • Toast 通知：4 处 alert() 替换为非阻塞式 Toast 组件（error/warning/success 三种样式）
  • 主题切换按钮：输入页和结果页各一个 🌙/☀️ 切换按钮，状态持久化到 localStorage

修改文件清单

文件 变更
jyotish-app/style.css 暗色模式变量 + Toast 样式 + 主题按钮样式 + 修复未定义变量/括号错误
jyotish-app/main.js Toast 系统 + 主题切换 + alert→toast + 删除死代码 + Transit 表头 i18n
jyotish-app/chart-renderer.js 动态主题获取 + 北印盘中心摘要 + THEME → _th 动态切换
jyotish-app/renderers.js Karaka 标签 i18n + 行星名称国际化 + Panchanga 标签 i18n
jyotish-app/index.html 主题切换按钮（输入页 + 结果页）
SKILL.md 版本 4.2.0 → 4.3.0
CHANGELOG.md 新增 v4.3.0 记录

v4.2.0（2026-04-27）— 强制外部验证门控（MEVG）

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

① 新增 MEVG 强制外部验证门控协议

问题：AI 的训练数据中包含大量印度占星知识，但存在流派偏差、断章取义、缺乏具体性、文化偏见等问题。每次分析都仅凭记忆输出，不搜索外部权威来源验证。

解决方案：新增 mandatory-verification-gate-protocol.md（完整协议），核心措施：

  • 三步验证法（V1→V2→V3）：
    • V1 构建查询：为每个主要解读点生成英文检索词
    • V2 执行检索：web_search 搜索权威来源（L2≥4次≥3来源，L3≥8次≥5来源）
    • V3 交叉验证：对比来源一致性，仲裁分歧
  • 权威来源优先级：经典文本 > 知名占星师 > 专业网站 > 综合博客
  • 强制输出格式：每个分析章节末尾附验证状态表
  • 门控通过/失败标准：≥80% 主要声明有≥2来源→通过；未通过→降级置信度

② 工作流新增 3 个门控步骤

SKILL.md 阶段描述更新：

  • 在强制工作流列表下方新增 v4.2.0 强制门控说明框

ai-reading-workflow-prompt.md 升级至 v5.0.0：

  • 新增核心原则 #7："不凭记忆"（与"不跳步"同级）
  • 新增 Step 3.11 MEVG-静态门控（验证所有静态解读声明）
  • 新增 Step 4.10 MEVG-动态门控（验证所有 Transit/Dasha 解读）
  • 新增 Step 5.5 MEVG-预测门控（100% 预测必须通过 5 项检查）
  • 更新一页纸流程图（标注 3 个 MEVG 门控位置）

③ 预测清单新增 3 条 MEVG 强制项

  • MEVG-静态门控（Step 3.11）
  • MEVG-动态门控（Step 4.10）
  • MEVG-预测门控（Step 5.5）

④ 执行纪律

  • ❌ 解读章节缺少验证状态表 → 判定为未完成
  • ❌ 主要声明无来源引用 → 判定为无效声明
  • ❌ 整个分析无 web_search → 判定为严重违反流程
  • ✅ 唯一豁免：纯数值计算

修改文件清单

文件 变更
references/mandatory-verification-gate-protocol.md ⭐ 新建
SKILL.md 版本 4.0.0→4.2.0 + 新增 MEVG 章节 + 更新预测清单 + 更新参考资料列表
references/ai-reading-workflow-prompt.md 版本 4.0.0→5.0.0 + 新增核心原则 + 3 个门控步骤 + 更新流程图
CHANGELOG.md 新增 v4.2.0 记录

v4.1.0（2026-04-27）— Transit Actionable Output 强制升级

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

① Transit Actionable Output 强制规范

问题：Transit分析后AI只输出星盘数据（如"Jupiter入Cancer"），用户不知道该做什么。

解决方案：新增 Transit Actionable Output 规范（插入位置：SKILL.md「⚠️ 过境分析强制规范」之前），强制要求：

  • 每条Transit预测输出三要素：时间段（精确到日/周/月）+ 具体行动类型（发布内容/跟进联系人/保持在线/推进谈判）+ 置信度（[A]=已验证/[B]=高概率/[C]=推断）
  • 行动基础：必须有真实案例参照，禁止纯理论推断

案例检索强制触发词：

  • "被发现"、"被赏识"、"被贵人"、"什么时候"、"应期"、"时机"
  • "合作"、"破圈"、"突破"、"升职"、"移民"、"搬迁"

② Phase5 应期输出强制嵌入案例检索

问题：应期预测直接给时间窗口，没有真实案例作为参照，预测质量无法验证。

解决方案：阶段五从"五层验证法→精确时间窗口"升级为"五层验证法→精确时间窗口→Actionable Output行动模块→案例检索"：

  • 动态预测（被发现/合作/应期/事件型）必须执行三步：
    1. 检索同类行星配置真实案例（celebrity --config ... 或 web_search）
    2. 对比D10/D9信号一致性
    3. 整合输出带案例参照的结论

③ 预测清单新增2条强制项

  • Transit Actionable Output：每条Transit预测必须输出时间段+行动类型+置信度+未验证声明；动态预测必须先检索案例再给结论
  • 案例检索：动态预测强制三步法；禁用未经案例支撑的理论推断

④ 阶段四/五版本标注

  • 阶段四：⭐ v4.1.0 Transit行动规范强制执行
  • 阶段五：⭐ v4.1.0 升级

踩坑经验记录（v4.1.0）

当用户追问"具体细节"时，说明Skill输出停留在"数据陈述"层——这是系统性问题，需要在SKILL.md的Phase规范中强制嵌入Actionable Output模块，而非在单次对话中修复。

v4.0.0（2026-04-27）— 质量保障四大升级

核心升级：从"功能堆叠"转向"质量治理"——解决DK摇摆、来源不透明、精度不一致、预测无标注四大痛点

① Karaka系统自动识别（Step 0.5 强制检测）

问题：DK身份在不同Karaka系统（7星/8星/Sanjay Rath 8星）之间反复摇摆，导致配偶画像不一致。

解决方案：在 ai-reading-workflow-prompt.md 的入口路由后、阶段二之前，新增Step 0.5 Karaka系统自动识别（🔴🔴🔴三级必读区）：

  • 三大主流Karaka系统对照表（K.N. Rao 7星/JH 8-Karaka/Sanjay Rath 8星）
  • 自动识别规则表（PDF含PiK → JH制/PDF有8无PiK → Sanjay Rath/引擎计算 → 7星默认）
  • 常见陷阱与纠正（JH的DK是第7低而非第1低、Sanjay Rath排除Mars作为DK候选）
  • 强制输出格式：每份报告开头必须声明Karaka系统+DK+数据来源

② 来源标签三级体系（96个references文件全部标注）

问题：古典铁律、现代大师教学、Skill原创演绎混在一起，用户无法区分来源可靠性。

解决方案：定义六级来源标签体系，批量更新所有references文件：

标签 含义 数量
【古典·千年传承】 BPHS/Jaimini Sutras/经典注释 7
【传统·现代大师】 B.V. Raman/K.N. Rao/Sanjay Rath/Marc Boney 8
【现代演绎·Skill整合】 Skill原创/统计归纳/AI工程化 20
【混合·古典+传统+现代】 多源混合内容 32
【工具/模板】 工作流/模板/桥接文件 13
【案例库】 纯案例数据文件 12

标签格式：> **来源标签**: 【类别】 — 简述，插入在每个文件头部的---分隔符之前。

同时将已有的6个旧格式标签统一为新标准（badhaka/marc-boney/raman/shasti-hayani/vp-goel/ai-reading-workflow）。

③ 统一精度边界声明表

问题：不同文件中的精度声明不一致（有的±2天，有的±2-3小时，SSD又承认±6-12小时）。

解决方案：在 ai-reading-workflow-prompt.md §5.1 新增统一精度边界声明表：

Dasha层级 精度范围 强制附注
Maha Dasha (MD) ±1-3个月 大方向趋势
Antar Dasha (AD) ±2-4周 年度能量走向
Pratyantar (PD) ±2-3天 月度活跃区间
Sookshma (SD) ±1-2天 周度参考
Prana SSD ±6-12小时 ⚠️非精确时刻，仅供参考

所有含时间预测的输出末尾必须附加"精度与诚实声明"段。

④ 预测强制[A/B/C]置信度+验证状态标注

问题：预测结论缺乏置信度标记和验证状态声明，用户无法判断可靠性。

解决方案：在 ai-reading-workflow-prompt.md §5.0 新增两维度强制标注：

置信度三级分类（引用precision-reading-methodology.md §五）：

  • ✅ [A] 已验证（倒推匹配度≥60%）
  • ⭐ [B] 强推断（3+独立维度一致，未经验证）
  • ⚡ [C] 假设（单一维度，缺多系统支撑）

验证状态三档声明：

  • [已验证·N/N事件吻合] — 可给相对精确窗口
  • [未经验证] — 必须降置信度至少一级，禁用[A]
  • [校准异常·需重新评估] — 停止预测

每条预测结论必须包含：结论+置信度+验证状态+依据+精度边界+矛盾说明。

⑤ Mangal Dosha两派观点注释

在 raman-house-judgment-methodology.md §3.3 补充学派争议注释：

  • 传统派（Raman）：Yogakaraka Mars → Dosha减轻
  • 另一派：Yogakaraka Mars → Dosha完全豁免
  • Skill默认采用Raman"减轻"说，同时标注"完全豁免"观点
  • 私有验证案例/用户反馈细节已移除（隐私保护）。

文件变更清单

文件 变更类型
ai-reading-workflow-prompt.md v3.0→v4.0 重大更新：+Step 0.5 Karaka识别、+§5.0置信度/验证状态标注、+§5.1精度边界表、更新§5.3输出模板
raman-house-judgment-methodology.md +Mangal Dosha两派观点注释（§3.3）
SKILL.md v3.13.1→v4.0.0：+新触发词(Karaka识别/DK身份/8-Karaka/来源标签/精度边界/SSD误差/未经验证标注)
96个references文件 批量添加来源标签（+6个旧标签格式统一）
dasha-transit-method.md +来源标签
multi-dasha-convergence-protocol.md +来源标签

版本跃迁说明

v3.x系列是"功能堆叠"阶段（从v3.7到v3.13，每次增加新模块/新文件）。v4.0.0标志着进入"质量治理"阶段——不再追求更多功能，而是确保已有功能的可靠性和透明度。这一转变的触发点是Kimi给出的优化方案审计，虽然其62%的问题诊断准确率不够理想，但确实暴露了四个真实痛点。

v3.13.1（2026-04-26）— 用户体验优化 + qin_ruisheng条目补描述 + 速查指南

qin_ruisheng_system.md 条目补描述

该文件自v3.3已存在于references/目录（754行），但SKILL.md参考列表中仅有"秦瑞生占星体系（华人占星师方法论）"一句话描述，与其他文件的描述质量严重不对齐。

v3.13.1将其扩展为完整内容摘要（恒星黄道vs回归黄道+27星宿+12宫+Kendra-Trikona+9星曜+5类Yoga+Vimshottari四层+四维一体预测+Gochara+8快速判断+12种Kaal Sarpa+金句12条），并更新section计数（4个→5个）。

实用速查指南新增

references/quick-reference-guide.md ⭐ v3.13.1 新增【实用入口·推荐优先阅读】

用途：用户提出问题时，快速定位到正确的分析路径和所需文件，不再迷失在96+个参考文件中。

内容结构（10大场景+引擎命令速查表）：

场景 触发条件
场景一：全面解盘 "帮我看盘" / "分析我的星盘"
场景二：婚姻应期 "什么时候结婚" / "感情应期"
场景三：单项分析 "事业" / "财运" / "学业"
场景四：PDF星盘 用户上传PDF文件
场景五：无出生时间 "没有出生时间" / "只有年月日"
场景六：Prashna问事 单个具体问题（无出生数据）
场景七：名人查询 "查一下XXX的星盘"
场景八：Double Transit 特定行星过境查询
场景九：深度分析 高精度综合分析
场景十：质量控制 所有分析完成后必做

每个场景包含：执行顺序 + 所需参考文件 + 引擎命令模板。

引擎版本对齐

scripts/jyotish_engine.py 头注释版本：v3.7.0 → v3.7.1（与SKILL.md记录一致）

SKILL.md变更

  • 版本：v3.13.0 → v3.13.1
  • 参考文件数：96 → 97（新增quick-reference-guide.md）
  • §1 AI解盘工作流：1个 → 2个（新增速查指南）
  • §16 高级技法与全球方法论：4个 → 5个（qin_ruisheng_system.md条目扩充）
  • qin_ruisheng_system.md #74：从一句话描述扩展为754行完整内容摘要

v3.13.0（2026-04-26）— 文件注册清理 + 单事件问事协议 + 婚姻四技法验证体系

核心工作：系统性审计与注册补全

通过全面审计发现3个文件存在于references/目录但未注册到SKILL.md参考列表，通过交叉验证确认均有效后完成注册。

新增注册文件（3个）

references/single-event-inquiry-protocol.md ⭐ Prashna问事·单问题快判

  • 用途：当用户提出单个具体问题（不提供出生数据）时，按十步断卦模板执行Prashna分析
  • 核心内容：输入信息收集表（5字段）+ 阶段一铸造星盘 + 阶段二十步AI执行（征象星对比+Tajika Yoga检查+Sphuta组合+阻碍排查+时间判断）+ 阶段三综合结论格式 + 特殊场景协议（失物/健康/是非判断KP补充）
  • 引擎集成：python3 scripts/jyotish_engine.py prashna --mode chart 铸造即时星盘

references/marriage-timing-validation-methodology.md ⭐ 婚姻应期·技法验证

  • 用途：为婚姻/感情应期分析提供四技法交叉验证框架，基于10案例统计校准置信度
  • 核心内容：
    • 四技法交叉验证：Double Transit + DK木星激活 + UL激活 + Dasha支持
    • 7星系统统计：DK命中率90%，Dasha支持70%，UL激活40%，DT 20%
    • 8星系统统计：DK命中率100%，UL激活60%，DT 40%
    • 关键修正1：DK Jaimini激活100%命中率存在虚命中（11/12星座被相位）→ 应作必要条件而非充分条件
    • 关键修正2：出生时间必须转世界时（UT），否则Moon偏移6-8°
    • 关键修正3：Double Transit应检验7宫/7主/功能DT/UL/DK多个目标组合
    • 关键修正4：7星/8星双轨并行，不排他——80%案例两系统给出不同DK
  • 来源：10个名人案例验证（奥巴马/克林顿/盖茨/特朗普/朱莉/贝克汉姆/乔丹/梅根/马斯克/凯特王妃）

references/marriage-timing-comprehensive-techniques.md（补注册）⭐ 婚姻应期·综合技法

  • 此前状态：文件自v3.7.3已存在于references/目录，但SKILL.md参考列表从未注册
  • 内容确认：KN Rao Double Transit精确规则 + VP Goel功能征象星 + Jaimini DK木星过境激活法 + Upapada Lagna完整体系 + Ketu期感情特征 + 木星入庙Cancer 2026影响

SKILL.md §14 Prashna体系升级

在Prashna问事占星区域新增两个能力区块：

  1. ⭐ 单事件问事协议：当用户提出单个具体问题（无出生数据）时，使用 single-event-inquiry-protocol.md 执行标准化十步断卦流程

  2. ⭐ 婚姻应期技法交叉验证体系：当分析婚姻/感情应期时，使用 marriage-timing-validation-methodology.md 执行四技法交叉验证，配合 marriage-timing-comprehensive-techniques.md 的KP/Rao/Dasha三层确认

SKILL.md 参考列表编号修正

操作 文件 旧编号 新编号
新增注册 single-event-inquiry-protocol.md — #83
新增注册 marriage-timing-validation-methodology.md — #84
补注册 marriage-timing-comprehensive-techniques.md — #85
顺延修正 bhrigu-chakra-paddhati.md #83 #86
顺延修正 high-status-spouse-yoga.md #84 #87
顺延修正 darakaraka-complete-guide.md #85 #88
顺延修正 yogi-avayogi-system.md #86 #89
顺延修正 tithi-lord-relationship-system.md #87 #90
顺延修正 rashi-tulya-navamsa-root-impulse.md #88 #91
顺延修正 bhrigu-pada-dasha-marriage-counting.md #89 #92
顺延修正 pancha-pakshi-nakshatra-systems.md #90 #93
顺延修正 badhaka-obstacle-planet-guide.md #91 #94
顺延修正 raman-house-judgment-methodology.md #92 #95
顺延修正 shasti-hayani-dasha-guide.md #93 #93（不变）
总计 — 96个 99个

注：原#93 shasti-hayani-dasha-guide.md在BCP章节，与Prashna/婚姻章节的三个新增文件不在同一section，因此编号不变。总文件数=96+3=99。

CHANGELOG编号对齐说明

CHANGELOG中"v3.8.0新增案例库（13个）→编号58-70"的记录基于v3.8.0的编号体系。v3.10.0引入高地位配偶Yoga等5个新文件后，案例库文件被顺延重编号至#63-70。v3.13.0又引入3个新文件，总编号体系已完全对齐，SKILL.md正文编号为规范引用。

触发词优化

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

SKILL.md变更

  • 版本：v3.12.1 → v3.13.0
  • 参考文件数：96 → 99（新增3个）
  • §14 Prashna区域新增：单事件问事协议能力描述 + 婚姻四技法验证体系描述
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • 参考列表：83→99重新编号完毕

v3.12.1（2026-04-26）— 精准解盘方法论集成

新增内容

新增参考文件（references/目录）：

  • precision-reading-methodology.md ⭐⭐⭐⭐⭐（#96）

核心内容： 基于6位顶级占星师的实践共识，整合出系统化的精准解盘方法论：

  1. 六大共识原则：

    • 功能吉凶因盘而异（V.K. Choudhry Systems' Approach）
    • 单一技法不做结论（Marc Boney / K.N. Rao）
    • 规则前提先查（Marc Boney）
    • 案例验证 > 经典引述（K.N. Rao）
    • 先整体后细节（Hart de Fouw / Rao PACDARES）
    • 先验证过去，再预测未来（Rao核心方法论）

  2. PACDARES本命盘分析框架（K.N. Rao）：

    • Position → Aspect → Conjunction → Dhana → Arishta → Raja → Exchange → Special Features
    • 8维度系统化分析，作为所有解读的地基

  3. 九层复合方法（L1-L9）：

    • L1 PACDARES → L2 分盘 → L3 矛盾检查 → L4 Vimshottari → L5 AV+Transit → L6 条件Dasha → L7 Jaimini → L8 其他Jaimini → L9 Tajika
    • 做到L6，平均85%预测成功率（Rao原话）

  4. L3矛盾检查协议：

    • 四类矛盾：D1 vs D9、吉Yoga vs 凶相位、DK vs 7宫主、静态 vs 推运
    • 矛盾不回避，记录→解释→降低置信度→如实告知用户

  5. 验证驱动分析流程：

    • 倒推验证协议（4步）：收集已知事件→Dasha映射→评估匹配度→校准偏差
    • 匹配度<60%必须停止预测，先解决校准问题

  6. 三级置信度系统：

    • ✅ [A] 已验证（倒推命中）/ ⭐ [B] 强推断（3+独立维度）/ ⚡ [C] 假设（单一维度）

  7. 10条常见教条失误及纠正

  8. 经典文献审慎使用（Shyamasundara Dasa BPHS考证）：

    • BPHS非原始文本，包含19-20世纪插入
    • 推荐文献优先级：Brihat Jataka > Saravali > Phaladipika > BPHS核心 > Jaimini Sutras

  9. 实战五步法：PACDARES → 分盘+矛盾 → 倒推验证 → 推运L4-L9 → 输出

SKILL.md 变更

  • 版本：v3.12.0 → v3.12.1
  • 参考文件数：95 → 96
  • 新增触发词：精准解盘、验证驱动、PACDARES、倒推验证、复合方法、教条纠错、案例验证、置信度分级、矛盾检查、先验后推
  • 新增"精准解盘方法论"section（核心方法论区域）
  • 元能力新增：精准解盘方法论

信息来源

  • K.N. Rao访谈（Journal of Astrology 2010年7/8月刊）
  • V.K. Choudhry：Systems' Approach to Interpreting Horoscopes
  • Shyamasundara Dasa："On the Authenticity of the BPHS"
  • Marc Boney：Case Studies in Vedic Astrology
  • Hart de Fouw & Robert Svoboda：Light on Life
  • Sanjay Rath：Bṛhaspati Jyotiṣa课程体系
  • Dr. A.K. Tripathi："True Astro Secrets"

v3.12.0（2026-04-25）— 10本PDF书籍知识集成 + Kimi审计报告验证

知识来源

基于10本经典印度占星PDF书籍的深度提取与集成：

  1. Ancient Hindu Astrology For Modern Western Astrologer — James Braha（187页，可提取）
  2. How to Judge a Horoscope Vol 1 (Houses I-VI) — B.V. Raman（310页，可提取）
  3. How to Judge a Horoscope Vol 2 (Houses VII-XII) — B.V. Raman（482页，可提取）
  4. Learn Successful Predictive Techniques of Hindu Astrology — K.N. Rao（159页，可提取）
  5. Light on Life: An Introduction to the Astrology of India — Hart de Fouw & Robert Svoboda（461页，可提取）
  6. Predict Effectively through Yogini Dasha — V.P. Goel（63页，⚠️ 扫描件，无法提取文字）
  7. Predicting through Jaimini Astrology — V.P. Goel（232页，可提取）
  8. Predicting through Jaimini's Chara Dasha — K.N. Rao（135页，可提取）
  9. Predicting Through Shasti Hayani Dasha — V.P. Goel（92页，⚠️ 扫描件，无法提取文字）
  10. Predicting Major Life Events: A Composite Approach — Marc Boney（465页，可提取）

PDF提取率：8/10（2本为扫描件，通过在线源补充关键内容）

Kimi审计报告验证

收到7项批评的Kimi审计报告，逐条与PDF书籍原文交叉验证：

# Kimi批评 验证结论 证据来源
1 "五系统混合有问题" ❌ 无效 Marc Boney全书 dedicate to K.N. Rao，"Composite Approach"即跨系统整合；V.P. Goel p.5："combines the two systems"；K.N. Rao 书中明确使用多系统
2 "7/8星Karaka混乱" ⚠️ 部分有效 K.N. Rao明确支持7星（"First time in thousands of years showing the use of seven Karakas"）；Skill双轨方案已正确
3 "宫位系统冲突" ❌ 无效 所有10本书统一使用Whole Sign（整宫制），Jyotish不存在Placidus/Koch
4 "现代创新未标注来源" ⚠️ 部分有效 建议对非古典技法标注来源等级
5 "Ayanamsa单点问题" ⚠️ 低优先级 全部作者统一使用Lahiri
6 "缺少Badhaka等模块" ✅ 有效 → 已创建 badhaka-obstacle-planet-guide.md
7 "Ashtottari条件检查自动化" ✅ 有效 引擎级别改进，待后续实现

新增参考文件（5个）

  • references/badhaka-obstacle-planet-guide.md：Badhaka障碍星系统完整指南

    • 12上升Badhaka Sthana+Badhakesh完整对照表：Movable→11宫，Fixed→9宫，Dual→7宫

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

    • 五步分析协议：确定Badhakesh→分析落宫/相位→检查Badhaka Sthana→评估关系→补救
    • 来源：【古典·BPHS】

  • references/raman-house-judgment-methodology.md：B.V. Raman宫位判断方法论

    • 12上升完整Benefic/Malefic/Yogakaraka表（B.V. Raman Vol 1 pp.16-18）
    • 六步宫位判断法：宫主星→Karaka→落宫→相位→合相→综合评估
    • 第七宫婚姻分析六维度（Vol 2 Ch.XI）
    • Maraka死亡指示系统：主Maraka=2宫主+7宫主，次级=Saturn，"生命宫"=3+8宫
    • Mangal Dosha完整规则
    • 来源：【古典·B.V. Raman】

  • references/shasti-hayani-dasha-guide.md：Shasti Hayani条件Dasha指南

    • 适用条件：太阳在1宫（Nakshatra-based条件Dasha）
    • 60年周期：8行星固定顺序，Jupiter→Sun→Mars→Moon→Mercury→Venus→Saturn→Rahu，各10年
    • 三级Antar结构：Antar→Pratyantar→Sookshma
    • 与其他条件Dasha对比（Shodashottari/Dwisaptati Sama/Shastihayani）
    • 来源：V.P. Goel书籍（扫描件）+ AstroNidan在线源

  • references/marc-boney-marriage-six-step.md：Marc Boney婚姻六步法

    • 六步法：Venus评估→三视角7宫→Navamsa确认→Vimshottari支持→Jaimini DK激活→Double Transit
    • 核心创新："三视角"7宫评估——从Lagna/Moon/Venus三个参考点看7宫
    • 同居vs正式婚姻区分：不同征象星组合指向不同关系类型
    • 跨系统验证立场：Marc Boney整本书 dedicate to K.N. Rao，明确使用Parashari+Jaimini+Transit整合
    • 来源：【现代创新·K.N. Rao学派】

  • references/vp-goel-jaimini-dasha-systems.md：V.P. Goel Jaimini Dasha系统概览

    • 10种Jaimini Dasha系统概览：Chara/Mandook/Sthira/Narayan/Navamsha/NSD/Trikon/Atmanadi等
    • 实现优先级：P0（Chara已实现）→P1（Mandook/Narayan/Navamsha）→P2（Sthira/NSD）→P3（Trikon/Atmanadi）
    • Argala四分之一度阻碍规则：BPHS原典，星座内4个四分之一度（0-7°30'/7°30'-15°/15°-22°30'/22°30'-30°）决定Virodha有效性
    • Jaimini星座相位规则：Movable↔Fixed，Dual↔Dual
    • 来源：【现代·V.P. Goel研究】

现有参考文件补充（未改文件内容，仅标注待升级）

  • argala-complete-guide.md：发现缺少四分之一度阻碍规则（V.P. Goel p.30/BPHS），建议后续升级
  • jaimini-complete-system.md：缺少K.N. Rao和V.P. Goel书籍引证，建议补充来源标注
  • condition-dasha-complete.md：缺少Shasti Hayani Dasha条目，建议后续补充
  • marriage-timing-comprehensive-techniques.md：缺少Marc Boney六步法交叉引用

综合审计报告

  • 审计报告文件：brain/372caffb.../10本PDF书籍知识审计报告.md
  • 10本PDF提取结果：8本成功提取，2本扫描件（Yogini Dasha/Shasti Hayani Dasha by V.P. Goel）
  • 新知识发现：10项（Badhaka系统/Raman方法论/Shasti Hayani/Argala四分之一度/Marc Boney六步法/三视角/V.P. Goel 10种Dasha/Maraka系统/7星立场确认/跨系统验证）
  • 现有文件冲突/错误：10项（缺Badhaka/缺Raman表/缺四分之一度/缺来源引证等）

SKILL.md 更新

  • 版本 v3.11.0 → v3.12.0
  • 参考文件总数：90 → 95（新增5个）
  • 新增 §17-§21 五个能力描述（Badhaka/Raman/Shasti Hayani/Marc Boney/V.P. Goel）
  • §1 静态分析 新增 Badhaka+Raman 交叉引用
  • §2 动态推运 新增 Shasti Hayani+V.P. Goel 交叉引用
  • §3 关系占星 新增 Marc Boney 六步法交叉引用
  • 触发词新增：Badhaka/障碍星/Badhakesh/宫位判断/Raman/Yogakaraka/每上升吉凶星/Shasti Hayani/60年周期/Marc Boney/婚姻六步法/三视角/V.P. Goel/10种Dasha/Mandook/Narayan/Maraka/死亡指示/生命宫/跨系统验证/多系统整合

v3.11.0（2026-04-25）— 多元技法系统（5篇参考文件）

知识来源

基于4篇外部公众号文章（非用户原创）的学习与集成：

  1. 「1印度占星」（~30,400字）：Tithi Lord 30历日关系系统 + Yogi/Ava Yogi入门 + 婚姻计数法 + Arudha Lagna关系分析 + Sanyasi组合
  2. 「2印度占星」（~17,700字）：Pancha Pakshi五鸟择时术 + Navamsa根源冲动 + Yogi/Ava Yogi Dasha/Transit应用 + 宝石激活
  3. 「3印度占星」（~28,800字）：Rashi Tulya Navamsa + Yogi/Ava Yogi综合分析（四因子）+ Nakshatra三计数体系 + Savya/Apasavya
  4. 「4印度占星」（~19,600字）：Bhrigu Pada Dasha + Narayana Dasha D9变体

新增参考文件（5个）

  • references/yogi-avayogi-system.md：Yogi/Ava Yogi/Duplicate Yogi行星系统完整指南

    • 计算方法：Yogi点（上升+93°20'）→ Nakshatra主星 → 三行星指派
    • 四大影响因子：财富领域 / 灵性距离 / 社交圈类型 / 支持者类型
    • 特殊判定：上升与Yogi同Nakshatra=天生富裕业力；Dasha/Transit激活机制
    • 宝石疗法：Yogi宝石→推荐；Ava Yogi宝石→严禁
    • Trump/查尔斯案例 + 与Tithi Lord/Dasha/Navamsa/Argala/AV整合

  • references/tithi-lord-relationship-system.md：Tithi Lord关系影响系统

    • 30 Tithi分配表（8行星循环，Ketu排除）
    • 8种关系模式：Sun=家庭支配型 / Moon=善变型 / Mars=热情独居矛盾型 / Mercury=青春智力型 / Jupiter=道德家庭型 / Venus=欲望美感型 / Saturn=延迟成熟型 / Rahu=非传统型
    • Sanjay Rath"水龙头"理论：Tithi Lord控制Jala（水元素）=情感流动模式
    • 整合：Yogi交叉 / Dasha配合 / Navamsa配合 / Arudha Lagna内外分析

  • references/rashi-tulya-navamsa-root-impulse.md：Rashi Tulya Navamsa与根源冲动系统

    • Rashi Tulya Navamsa：D1位置投射到D9坐标系，保持星座位置不变
    • 7行星根源冲动完整表：太阳→自尊激励 / 月亮→快乐来源 / 火星→愤怒触发 / 水星→学习动机 / 木星→智慧方向 / 金星→欲望模式 / 土星→恐惧责任
    • 经典组合：金星在火星Navamsa=无法满足的性欲 / 金星在土星Navamsa=孤独/同性倾向
    • Navamsa分类规则：火象→教育/孩子/名声；水象→不利健康/财富/名声

  • references/bhrigu-pada-dasha-marriage-counting.md：Bhrigu Pada Dasha与婚姻计数法

    • Bhrigu Pada Dasha：行星推进法（Progression），不同于BCP固定周期，专用于婚姻时机
    • Narayana Dasha D9变体：在D9上应用Narayana Dasha得到婚姻专用时间线
    • 婚姻计数法（Sanjay Rath秘传）：7宫主在D1的星座(A)→D9的星座(B)，从A数到B=关系数量
    • Parivartana特殊处理：行星交换需重新计算
    • "婚姻"定义：持续一年以上的认真关系

  • references/pancha-pakshi-nakshatra-systems.md：Pancha Pakshi五鸟择时术+Nakshatra三体系+Savya/Apasavya

    • Pancha Pakshi：泰米尔传统择时术（Sri K N Rao推荐），5种鸟×5时段×高/低振动频率
    • Nakshatra三计数体系：Ashwinādi（创造/Srishti）/ Krittikādi（维持/Sthiti，Vimshottari）/ Ardrādi（毁灭/Samhāra）
    • Savya/Apasavya：27 Nakshatra每3个一组交替顺行/逆行（Vishnu三步法则）
    • 三系统协同：日常择时/婚姻/创业/疾病场景的应用映射

SKILL.md 更新

  • 版本号：3.10.0 → 3.11.0（frontmatter + 更新记录 + 底部版本三处同步）
  • 参考文件计数：85 → 90
  • 新增 §16 多元技法系统（5个子节：Yogi系统 / Tithi Lord / RTN根源冲动 / Bhrigu Pada Dasha / Pancha Pakshi）
  • 触发词扩展：Yogi / Ava Yogi / Tithi Lord / 根源冲动 / Rashi Tulya Navamsa / Bhrigu Pada Dasha / 婚姻计数 / Pancha Pakshi / 五鸟择时 / Nakshatra计数体系 / Savya/Apasavya 等
  • 能力描述扩展：追加 Yogi/Ava Yogi行星系统 / Tithi Lord关系模式 / RTN根源冲动 / Bhrigu Pada Dasha婚姻推进法 / Pancha Pakshi五鸟择时术 / Nakshatra三计数体系 / Savya/Apasavya顺逆星宿

知识审计发现

  • P0 全新知识（7项）：Yogi/Ava Yogi行星系统、Pancha Pakshi五鸟择时术、Rashi Tulya Navamsa、Navamsa Root Impulse根源冲动、Bhrigu Pada Dasha、婚姻计数法、Nakshatra三计数体系
  • P1 需系统化（2项）：Tithi Lord关系影响、Savya/Apasavya星宿分组
  • P2 已覆盖（1项）：Sahams敏感点（v3.9.0 prashna-complete-guide.md 已覆盖）→ 无需新增

v3.10.0（2026-04-25）— BCP自然周期法 + 高地位配偶规则 + DK深度画像扩展

知识来源

基于3篇外部公众号文章（非用户原创）的学习与集成：

  1. Tajika占星术 + Bhrigu Chakra Paddhati (BCP) 自然周期法（~23,000字）
  2. 印度占星Jaimini系统的Darakaraka理解和说明（~19,500字）
  3. 高地位配偶与婚后命运积极转变的占星规则与组合（~4,400字）

新增参考文件（2个）

  • references/bhrigu-chakra-paddhati.md（~260行）：BCP自然周期法完整指南

    • 9大自然周期：Moon(0-12)→Mercury(13-24)→Venus(25-36)→Sun(37-48)→Mars(49-60)→Jupiter(61-72)→Saturn(73-84)→Rahu(85-96)→Ketu(97-108)
    • 双轨激活法：A轨（从上升起算对应宫位）+ B轨（从周期统治星位置起算），双轨交汇=最强激活点
    • 三要素解读法：宫位→领域 + 宫主星→表现方式 + Karaka→天然征象，三者联动缩窄事件范围
    • 快查表：年龄→宫位映射、周期主题速查
    • 与Dasha系统的关系：BCP是自然周期（固定），Dasha是业力周期（因人而异），两者互补

  • references/high-status-spouse-yoga.md（~180行）：高地位配偶Yoga判定规则

    • 3条核心规则：
      1. 7宫+7宫主力量 > 上升+上升主力量（D1和D9双盘验证）
      2. 7宫主在D9形成Rajyoga
      3. 从7宫起算的Upachaya宫（3/6/10/11）在D1/D9有行星占据
    • 关键区分：宫位=环境/背景，宫主星=人的实际能力
    • Upachaya创新视角：从7宫而非1宫起算Upachaya，男性凶星比吉星更有效（Rajas/Tamas原则）
    • Sonya Gandhi案例验证：D1 Cancer Lagna + D9 Aquarius Lagna
    • 整合映射：与 spouse-multi-layer-methodology.md 的6层分析衔接

扩展参考文件（1个）

  • references/darakaraka-complete-guide.md v1.0 → v1.1（332→~500行）
    • ⭐ §七 8颗行星DK深度画像：Sun/Moon/Mars/Mercury/Jupiter/Venus/Saturn/Rahu，每颗5维度（性格特质/关系动态/生活方式/挑战与修行/特殊备注+吉凶相位）
    • ⭐ §八 DK与财富的关系：5种财富模式（配偶财富支持/共享财务目标/财富来源与增长/伴侣财务态度/逆行DK财富挑战）+ 12宫DK财富速查表

配置审计修复

  • SKILL.md版本不一致修复：frontmatter=3.9.0但body两处仍写3.8.0 → 统一为3.10.0
  • 参考文件计数修复：声明82个实际更多 → 更新为85个（82+2新增+1补注册）
  • darakaraka-complete-guide.md补注册：该文件自v1.0起存在但从未注册到SKILL.md参考列表

SKILL.md 更新

  • 版本 v3.9.0 → v3.10.0
  • 新增 §15 BCP自然周期法能力描述（9大周期+双轨激活+三要素解读）
  • §3 关系占星 新增：高地位配偶Yoga判定 + darakaraka-complete-guide.md引用
  • 参考文件总数：82 → 85（新增bhrigu-chakra-paddhati.md #83 + high-status-spouse-yoga.md #84 + darakaraka-complete-guide.md #85补注册）
  • 触发词新增：BCP、Bhrigu Chakra Paddhati、自然周期、小限法、高地位配偶、Upachaya、DK画像、DK财富
  • 版本不一致修复：更新记录行 + 底部版本号统一为v3.10.0

知识盲区修复

  1. ❌ 不了解BCP系统 → ✅ 9大自然周期+双轨激活+三要素解读完整覆盖
  2. ❌ 缺少高地位配偶判定规则 → ✅ 3条核心规则+D1/D9验证+Upachaya创新视角
  3. ❌ DK分析停留在12宫位含义 → ✅ 8行星5维度深度画像+DK财富5种模式
  4. ❌ darakaraka-complete-guide.md未注册 → ✅ 补注册并扩展至v1.1

未修复的已知问题

  • cmd_dasha() 不使用 _add_chart_args()，需手动传 --moon-lon（已知设计问题，记录但未改动代码）
  • --birthdate 仅日期精度，无时/分（full-reading 已有内部绕过，独立 dasha 命令暂未改）
  • --nakshatra 模式使用近似进度（0.125步长）

v3.9.0（2026-04-25）— Prashna问事占星完整系统

新增参考文件（1个）

  • references/prashna-complete-guide.md：Prashna问事占星完整指南（十大核心计算：Arudha Lagna+Trisphuta/Catusphuta/Pancasphuta+Gulika+Prana/Deha/Mrityu Sphuta+35 Sahams+Kunda验证+Chor Graha失物+Mrityu Chakra死亡轮+十步断卦框架+8类问题专题）⭐⭐⭐⭐⭐

引擎集成

  • 新增 scripts/prashna.py 计算引擎
  • jyotish_engine.py 新增 prashna 子命令（支持 chart/arudha/sphutas/sahams/lost-item/life/kunda 模式）
  • SKILL.md §14 Prashna 问事占星系统（十步断卦框架+十大核心计算模块+适用场景）

SKILL.md 更新

  • 版本 v3.8.0 → v3.9.0
  • 参考文件总数：81 → 82（新增 prashna-complete-guide.md）
  • 触发词新增：Prashna问事占星、问事占星、时卦、卜卦占星、问卜、Horary、问事、提问占星、Arudha Lagna、映像上升、Trisphuta、三重合点、Sphuta、Gulika、古利卡、Saham、敏感点、失物查询、寻物、Chor Graha、盗贼星、Kunda验证、Prasna Marga、十步断卦

v3.8.0（2026-04-25）— 深度分析方法论体系：5篇实战经验总结

核心升级

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

新增参考文件（5个）

  • references/shadbala-interpretation-methodology.md：Shadbala六重力量实战解读方法论（约280行）

    • 五力量组合模式库：全面型/位置依赖型/关系依赖型/时间敏感型/运动受限型
    • Avastha联合诊断矩阵：外强内壮/外强内伤/外弱内壮/外弱内伤四象限
    • Bhava Bala实战解读：四维宫位力量矩阵（Shirshodaya/Dig/Drig/总Bala）
    • Vimsopaka分盘综合评分：四套权重体系解读阈值表
    • 行星力量综合排名法：Shadbala→Avastha修正→Vimsopaka修正→Bhava Bala关联→最终排名
    • 快速诊断口诀

  • references/multi-dasha-convergence-protocol.md：多Dasha收敛协议（约230行）

    • 六系统交叉验证：Vimshottari+Ashtottari+Yogini+Moola+Narayana+Kalachakra
    • 收敛等级量化：Level 0-4 概率提升（0%→85%）
    • 五步协议：目标定义→逐系统提取→交叉对比→收敛量化→Transit确认
    • PDF数据源提取指南：JH PDF页面映射+提取要点
    • 收敛冲突处理：三种冲突场景的处理方法
    • 实战输出模板：标准化表格格式

  • references/navamsa-marriage-deep-analysis.md：Navamsa婚姻深度分析协议（约300行）

    • D9婚姻五维分析法：D9上升/DK位置/Venus/7宫/DK-Lagna合相
    • Vargottama婚姻意义：19分盘频率分析+婚姻应用
    • Pushkara Navamsa婚姻解读：按元素分组的精确度数+婚姻分析应用

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

    • D9与D1矛盾处理：核心原则"D9>D1在婚姻分析中"

  • references/divisional-chart-deep-reading.md：分盘深度阅读工作流（约260行）

    • 三级方法论：Level 1关键分盘速查（5分钟）/Level 2领域专项（15分钟）/Level 3全19分盘（45分钟）
    • 行星频率分析核心技法：统计行星在19个分盘中的落座频率，≥40%=核心主题
    • Vargottama检测矩阵：D1-D9/多分盘/逆Vargottama/唯一Vargottama四种类型
    • 分盘组合阅读模式：三角验证/生命线追踪/财富链/关系链

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

  • references/deep-analysis-complete-workflow.md：综合深度分析完整工作流（约330行）

    • 12模块系统化方法：D1基础→特殊Lagna→Jaimini Karaka→Shadbala→Avastha→Bhava Bala→Vimsopaka→19分盘→AV→多Dasha收敛→Navamsa婚姻→综合结论
    • PDF 11页提取最佳实践：完整页面映射+数据完整性门（P0/P1/P2）
    • 引擎调用流程：full-reading+varga-full+shadbala+ashtakavarga
    • 报告生成：12章结构+HTML输出
    • 质量检查清单：数据准确性+分析完整性+解读质量

SKILL.md 更新

  • 版本 v3.7.4 → v3.8.0
  • 新增 §12.5 深度分析方法论能力描述
  • 参考文件总数：76 → 81（新增5个深度分析方法论文件）
  • 触发词新增：深度解盘、全面分析、星盘深度阅读、频率分析、收敛验证、婚姻深层分析、配偶画像、综合深度分析
  • 更新记录行更新至v3.8.0

方法论核心价值

这5篇文件的核心价值在于将"经验"转化为"可复用方法"：

  1. Shadbala不再是数字游戏——五力量组合模式让AI看到"行星的工作模式"而非仅看总分排名
  2. 多Dasha收敛从3系统升级到6系统——收敛概率从65%提升到85%+，且提供了PDF直接提取的路径
  3. Navamsa婚姻分析有了标准化8步旗标——不再是"凭感觉判断D9好坏"，而是绿/黄/旗量化评分
  4. 行星频率分析是新技法——统计行星在19个分盘中的落座频率，识别"核心主题"和"锚点行星"
  5. 12模块工作流是"解盘SOP"——从零散分析到系统化流程，每次解盘都有标准化的模块和检查清单

v3.7.4（2026-04-25）— P0: Ayanamsa模式修复 + 度数精度修正

核心修复

  • P0 #4：jyotish_engine.py — 从未设置Lahiri Ayanamsa模式

    • 根因：import swisseph 后没有调用 swe.set_sid_mode(swe.SIDM_LAHIRI)
    • Swiss Ephemeris默认使用非Lahiri模式，导致所有恒星黄道度数偏差约0.88°
    • 修复：在import后立即调用 swe.set_sid_mode(swe.SIDM_LAHIRI)
    • 影响：所有行星度数、Karaka度数、Transit匹配精度、Pushkara判断等均受影响
    • Karaka排序不受影响（排序顺序相同，但度数精度显著提升）

  • 私有验证案例/用户反馈细节已移除（隐私保护）。

行星 v3.7.3b（非Lahiri） v3.7.4（Lahiri） PDF数据 偏差修正
Mars Cancer 0.43° Cancer 1.32° 1°19'≈1.33° +0.89° → ✅
Sun Aries 2.62° Aries 3.51° 3°31'≈3.52° +0.89° → ✅
Jupiter Virgo 12.94° Virgo 13.82° — +0.88°
Venus Pisces 9.66° Pisces 10.54° — +0.88°
Moon Aquarius 10.89° Aquarius 11.78° — +0.89°
Mercury Pisces 7.65° Pisces 8.53° — +0.88°
Saturn Aquarius 3.40° Aquarius 4.29° — +0.89°
Rahu Scorpio 20.15° Scorpio 21.03° — +0.88°

参考文档同步更新

  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • darakaraka-complete-guide.md：Sun入庙→入旺术语修正

Karaka验证（v3.7.4 Lahiri修正后）

角色 7星 8星(S.Rath) 度数 PDF匹配
AK Jupiter Jupiter 13.82° ✅
DK Mars Sun 1.32°/3.51° ✅ Mars

v3.7.3b（2026-04-25）— Python引擎P0 Bug修复 + 参考文档4处数据修正

Python计算引擎修复（scripts/）

  • P0 #1：jyotish_engine.py — Chara Karaka 计算收到 0-360 完整经度而非 0-30 星座内度数
    • 新增 planet_degs dict（取 degree_in_sign），Karaka 计算用 0-30 度数，Navamsa/Chara Dasha 继续用完整经度
    • 影响：所有 Karaka 排名在修复前都是错误的（按黄道位置排序而非星座内度数）
  • P0 #2：jyotish_engine.py — DK 提取路径 ck7.get('DK', {}).get('planet', 'Moon') 永远 fallback 到 Moon
    • 改为 ck7['karaka_table']['Darakaraka']['planet'] 直接从结构化数据提取
    • 影响：Karakamsha 计算一直基于 Moon D9 而非 DK D9
  • P1：jaimini.py — Rahu 逆行边界 (30 - deg) % 30 当 deg=0 时得到 0 而非 30
    • 改为 30.0 - deg（不取模，保留边界值用于排序）
  • 术语修正：status 标签 "入庙(Exalted)" → "入旺(Exalted)"（入庙=Own Sign，入旺=Exalted）

参考文档修正（references/）

  1. vimshottari_dasha_guide.md：15° Aries 星宿边界错误（Ashwini → Bharani），补边界说明
  2. planetary-dignity-complete-reference.md：水星逆行燃烧度数 12° → 8°（Parashari 标准）
  3. marriage-timing-comprehensive-techniques.md：UL 计算公式重写，从混淆的模运算改为清晰的星座索引推导
  4. planets.md：燃烧表补充逆行变体注释

验证（v3.7.3b，仍使用非Lahiri Ayanamsa）

  • 私有验证案例/用户反馈细节已移除（隐私保护）。
Karaka 修复前(0-360排序) 修复后(degree_in_sign) PDF
AK Venus(339.66°)❌ Jupiter(12.94°)✅ Jupiter
DK 7星 Sun(2.62°)❌ Mars(0.43°)✅ Mars
DK 8星 Sun(2.62°)✅ Sun(2.62°)✅ Sun

其他更新

  • darakaraka-complete-guide.md：三系统DK判定更新
  • marriage-timing-validation-methodology.md：双轨验证数据更新

v3.7.3（2026-04-25）— 行星尊严与度数完整参考手册

新增参考文件（1个）

  • references/planetary-dignity-complete-reference.md：行星尊严与度数完整参考手册（约500行）
    • 精确旺衰度数表：7大行星入庙/落陷精确度数 + 渐变效应说明
    • Moolatrikona区间：7大行星的原始三方度数范围
    • 行星友敌关系：完整的五级友敌关系表
    • 行星生命阶段（Avastha）：奇数/偶数星座的度数-阶段对照表（婴儿/青年/成年/老年/衰退）
    • Sandhi交界点：0°和29°的不稳定性规则
    • 燃烧阈值表：6大行星精确燃烧度数（含逆行变体） + 燃烧减轻因素
    • Neecha Bhanga落陷取消：5大取消条件 + Parasara三法（逆行最强！） + Dusthana宫主特殊规则 + Neecha Bhanga Raja Yoga进阶条件
    • Sect昼夜区分完整规则：判定方法/两大阵营/各行星日夜盘角色变化/对配偶分析的影响/最强最弱公式
    • 丈夫征象星论证：木星vs火星的古典论证 + 多层分析权重分配建议
    • Pushkara Navamsha：按元素分组的精确度数范围 + Pushkara Bhaga极致恩典度数
    • Vargottama：各行星Vargottama的婚姻意义 + Gandanta例外
    • DK完整8步分析协议：从计算到合盘验证的完整流程
    • D9婚姻8步旗标算法：Rao金星测试 + 绿/黄/红旗系统 + 最终评分解读
    • 来源：PocketPandit / Celesian / Parasara Jyotish (P.V.R. Narasimha Rao) / StarMeet / Vedicmarga / omai.app / Jothishi

SKILL.md 更新

  • 版本 v3.7.2 → v3.7.3
  • 关系占星参考文件：2 → 3
  • 参考文件总数：75 → 76（注：编号48新增，后续48→75全部重编为49→76，但旧编号#47仍为配偶方法论）
  • 触发词新增：旺衰度数、行星燃烧、落陷取消、Neecha Bhanga、Sect昼夜、Pushkara、Vargottama、行星尊严、Moolatrikona、行星生命阶段、Avastha

知识盲区修复

此版本修复了此前分析中暴露的多个知识盲区：

  1. ❌ "女命看木星"单一判据 → ✅ 多层分析+昼夜区分
  2. ❌ 度数未精确到旺衰 → ✅ 精确度数+渐变效应+距离计算
  3. ❌ 不了解行星生命阶段 → ✅ Avastha完整度数表
  4. ❌ 燃烧影响未量化 → ✅ 6星阈值+减轻因素
  5. ❌ 落陷取消条件不完整 → ✅ 5条件+Parasara三法
  6. ❌ Sect对配偶分析的影响不清楚 → ✅ 完整Sect规则+对金/木/土/火的影响
  7. ❌ 不了解Pushkara/Vargottama → ✅ 精确度数+婚姻意义

v3.7.2（2026-04-25）— 配偶多层综合分析方法论

新增参考文件（1个）

  • references/spouse-multi-layer-methodology.md：配偶多层综合分析方法论 v1.0
    • 6层交叉确认法：DK（Jaimini，性别中立）+ 7宫主（婚姻运作）+ 金星（天然征象）+ 木星/月亮（传统Kalatra Karaka）+ 昼夜区分法（古典）+ Rahu辅助（8-Karaka DK）
    • 标准六步分析流程：确定DK→分析7宫主→分析金星→传统征象+昼夜区分→辅助征象→综合交叉确认
    • 置信度评估标准：4层确认=75%，5层以上=80%+
    • Dasha时机判断：三重共振法（Vimshottari + Chara Dasha + Transit）
    • 非传统关系适配：同性/跨文化关系的征象星重映射
    • 常见误判纠正：禁止"男命金星女命木星"单一判据
    • 来源：AstrologyForums / MysteryLores / 古典昼夜区分法（BPHS）+ Jaimini Sutras

SKILL.md 更新

  • 版本 v3.7.1 → v3.7.2
  • 关系占星部分新增"配偶多层综合分析"能力描述
  • 参考文件总数：74 → 75
  • 触发词新增：配偶分析、配偶星、配偶征象、婚姻分析、配偶画像、DK配偶星、多层配偶、昼夜区分

方法论核心原则

  1. DK描述"配偶是谁"——性别中立，只看度数
  2. 7宫主描述"婚姻怎么运作"——不受性别影响
  3. 金星描述"关系的品质"——所有人的天然征象
  4. 传统征象+昼夜区分是补充参考——不是唯一判据
  5. 多层交叉确认 > 单一判据——至少4层确认才达到75%置信度

v3.7.1（2026-04-25）— full-reading全自动综合解盘 + 三路径路由

引擎升级

  • scripts/jyotish_engine.py v3.7.0 → v3.7.1
  • 新增 full-reading 子命令：一条命令串起13个计算模块（chart/dasha/yoga/varga-full/aspects/jaimini/nakshatra-adv/argala/tajika/shadbala/ashtakavarga/validation/audit）
  • 测试结果：12模块全部计算成功，0错误，耗时0.02秒

工作流升级

  • references/ai-reading-workflow-prompt.md v1.0 → v3.0
  • 新增三条入口路径路由：
    • 路径A：精准出生信息 → full-reading 全自动计算
    • 路径B：PDF/文字星盘 → 提取文档数据直接推算
    • 路径C：时间不明确 → 互动式出生时间矫正 → 确认后走路径A

SKILL.md 更新

  • 版本 v3.7.0 → v3.7.1
  • 引擎子命令表更新：21 → 22（新增 full-reading）
  • 工作流部分重写为三路径路由结构

v3.7.0（2026-04-25）— 7大新模块：BPHS十六分盘+精确相位+Jaimini+高级Nakshatra+Argala+Tajika+合盘

新增模块（7个）

  • scripts/varga.py：BPHS Shodasavarga十六分盘完整计算

    • 支持全部16个分盘：D2/D3/D4/D7/D9/D10/D12/D16/D20/D24/D27/D30/D40/D45/D60
    • 每个分盘输出精确度数（非仅星座名）
    • D30 Trimsamsa 特殊不等宽映射
    • D9 含 Jaimini 分析（7宫/Venus/Jupiter/尊严状态）
    • D60 含业力分析（角宫吉凶星分布）

  • scripts/aspects.py：度数精确相位系统（Drishti）

    • 标准7宫对冲 + 火星4/7/8 + 木星5/7/9 + 土星3/7/10
    • Orb分类：tight(≤3°) / moderate(≤6°) / loose(≤10°)
    • 计算每个相位的入相位/出相位状态
    • 合相精度分析

  • scripts/jaimini.py：Jaimini系统完整实现

    • calc_chara_karaka_7()：7行星 Chara Karaka（AK→DK）
    • calc_chara_karaka_8()：8行星 Chara Karaka（含Rahu逆行度数处理）
    • calc_chara_dasha()：星座大运（基于上升奇偶性决定方向）
    • calc_karakamsha()：灵魂方向分析（DK的D9位置解读）

  • scripts/nakshatra_advanced.py：高级Nakshatra分析

    • 精确Nakshatra定位（名称/Pada/度数/Gana/元素）
    • calc_tara_bala()：9循环Tara关系分析
    • calc_sub_lord()：KP系统 Sub-Lord 计算
    • nakshatra_compatibility()：Tara+元素+Gana综合兼容性

  • scripts/argala.py：Argala门闩系统

    • 主Argala：2/4/11宫 → 财富/幸福/收益
    • 副Argala：5/8宫 → 权力/转化
    • Virodha（阻断）：12→2, 10→4, 3→11, 9→5, 2→8
    • 净评分计算和吉凶判定

  • scripts/tajika.py：Tajika/Varshaphala年运盘

    • calc_muntha()：年度上升进展
    • calc_year_lord()：年度守护星 + 辅助星（2/5/9/11宫主）
    • calc_mudda_dasha()：12个月比例大运
    • calc_tri_pataka()：三旗系统评估

  • scripts/synastry.py：合盘分析系统

    • Ashta Koota 36分制（8维度：Varna/Vashya/Tara/Yoni/Graha Maitri/Gana/Bhakuta/Nadi）
    • Mangal Dosha 检查（火星在1/2/4/7/8/12宫）
    • Papasamya 凶星抵消度评估
    • Dasha时间线兼容性分析
    • 自动生成化解建议

引擎升级（jyotish_engine.py）

  • 版本 v3.6.0 → v3.7.0
  • 新增7个CLI子命令：varga-full / aspects / jaimini / nakshatra-adv / argala / tajika / synastry
  • 总子命令数：14 → 21
  • 私有验证案例/用户反馈细节已移除（隐私保护）。

验证结果

私有验证案例信息已移除 隐私保护
varga varga-full ✅ D9 Navamsa 精确度数+尊严
aspects aspects ✅ 6个精确相位（Moon-Saturn合相等）
jaimini jaimini ✅ AK=Venus, DK=Mars, Chara Dasha序列
nakshatra nakshatra-adv ✅ 9行星Tara Bala, Sub-Lord
argala argala ✅ 9行星门闩分析
tajika tajika ✅ 33岁 Muntha=金牛座, YearLord=Venus
synastry synastry ✅ Ashta Koota 26/36 (72.2%)

v3.6.0（2026-04-24）— CNWU16二次借鉴：report_builder + R2b列校验 + P3/P8/冲突仲裁

新增文件

  • scripts/report_builder.py：MD→HTML报告生成器（羊皮纸主题）
    • 基于 CNWU16/vedic-astro-skills 的 report_builder.py 改编适配
    • 18项章节注册表，自动扫描多种 MD 命名模式
    • 羊皮纸CSS + 封面 + 目录 + A4打印优化
    • 中英文双语支持
    • 可通过 engine report 子命令调用
    • 浏览器打开后 Ctrl+P → Save as PDF

验证模块升级

  • scripts/validate.py：新增 R2b BAV列→SAV列校验
    • 每个星座的7行星BAV bindus列向量之和 = 该星座SAV分数
    • 交叉验证行总和(R2)和列总和的一致性

审计管线升级（jyotish_engine.py cmd_audit）

  • P3 仓库耦合（Warehouse Coupling）：
    • 双宫掌管=货物捆绑分析
    • 识别同时掌管两个宫位的行星（如水星同时掌管双子宫和处女宫）
    • 评估捆绑质量：凶吉混合/压力型/吉庆型/消耗型/中性
  • P8 年龄状态（Age Status）：
    • 基于行星在星座中的度数区间判定生命周期
    • 婴幼(0-10°)=辅助型，青壮(10-20°)=主动型，老年(20-30°)=自动执行型
  • 冲突仲裁3条规则（Conflict Arbitration）：
    • 规则1: P1清理者+P7入旺 = "带毒高价值资产"（禁止说逢凶化吉）
    • 规则2: P5凶宫+BAV高 = "乱世出英雄"
    • 规则3: P1吉+P2受损 = "空有雄心无着力点"

子命令升级

  • 新增 report 子命令：调用 report_builder.py 生成 HTML 报告
    • 用法: python3 jyotish_engine.py report <folder> --name "名字" --lagna "上升" --lang cn
  • 总子命令数：11 → 14

v3.5.0（2026-04-24）— BPHS完整表校准 + R1-R10验证 + P1-P12审计 + 验前事

  • 重写 scripts/ashtakavarga.py v1.0 → v2.0：
    • 从简化 BAV_BASE + EXTRA_BINDHU（SAV=94❌）升级为完整 BPHS 8×8 贡献矩阵
    • 每颗行星的 BAV 从所有 8 个来源（7行星+Lagna）获得贡献，非仅自贡献
    • BPHS 校正：月亮 BAV 木星贡献去12宫→49，金星 BAV 水星贡献加12宫→52
    • SAV 总和 = 337 ✅（7行星 BAV 之和），含 Lagna 完整总分 = 386
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • 新增 scripts/validate.py：R1-R10 数学验证模块
    • R1: SAV 总和 = 337
    • R2: 各 BAV 行常数校验（Sun=48, Moon=49, ...）
    • R3: 水星延伸角 ≤ 28°
    • R4: 金星延伸角 ≤ 47°
    • R5: Rahu-Ketu 严格 180° 对冲
    • R6: 逆行合法性（太阳/月亮不逆行，Rahu/Ketu永远逆行）
    • R7: Dasha 大运年限链总和 = 120 年
    • R8: 行星完整性（7行星 + Rahu + Ketu + Lagna）
    • R9: 星座度数范围 [0, 30)
    • R10: 宫位连续性（1-12宫无断点）
  • 升级 scripts/jyotish_engine.py v3.4.0 → v3.5.0：
    • 11 → 13 个子命令（新增 validate/audit）
    • chart --validate：星盘计算附加 R1-R10 验证
    • validate 子命令：独立运行 R1-R10 校验
    • audit 子命令：P1-P12 行星审计管线（Identity/Health/Resource SAV/Road Condition/Exit SAV/Dignity/Shadbala/Aspects/Nakshatra/Yogas）
    • predict --past-verify：验前事模式（推断2-4个高信号历史时段，避免冷读效应）
  • 来源：CNWU16/vedic-astro-skills 仓库分析 + ZODIAQ BPHS 完整表

v3.4.0（2026-04-24）— 高级计算引擎 + Hermes集成 + EventPredictionModel

  • 新增 scripts/shadbala.py：Shadbala六重力量计算模块
    • v6.0.11复核：当前为内部一致的六力近似实现，含 Sthana（位置）、Dig（方向）、Kala（时间）、Chesta（运动）、Naisargika（天然）、Drik（相位）；外部绝对值校准前不再称为完整 Parashara 实现
    • 输出每颗行星的六维得分、总Virupas/Rupas、Ishta Bala百分比、强度等级（极强/强/充足/略弱/弱/极弱）
    • 行星力量排名
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • 新增 scripts/ashtakavarga.py：Ashtakavarga八分法计算模块
    • BAV（Bhinna Ashtakavarga）8源独立贡献表
    • SAV（Sarva Ashtakavarga）聚合评分 + 吉凶评估（极吉/吉利/中等/挑战）
    • Shodhya Pinda简化计算
    • ⚠️ 已知限制：SAV总分未达标准337（BAV_BASE表为简化版，需后续校准为完整Parashara表）
  • 新增 scripts/hermes_memory_core.py + scripts/hermes_bridge.py：Hermes Agent中间件
    • 零外部依赖（纯Python stdlib: sqlite3, json, os, re, datetime, hashlib）
    • FTS5全文搜索 + 6张SQLite表
    • 记忆存储/检索/上下文构建
  • 新增 scripts/event_prediction_model.py：事件预测规则引擎
    • 替代LAM深度学习模型（原0.17%准确率）
    • 三层验证法：静态星盘征象 + Dasha激活 + Transit触发
    • 覆盖婚姻/职业/财富/健康/教育/子女/旅行/灵性8大领域
    • Prediction dataclass：概率评分 + 风险等级 + 时机 + 关键因素 + 建议
  • 升级 scripts/jyotish_engine.py v3.3.1 → v3.4.0：
    • 8 → 11个子命令（新增 shadbala/ashtakavarga/memory）
    • 提取 compute_chart_data() 公共函数（chart/shadbala/ashtakavarga共用）
    • predict 子命令增强：优先使用 EventPredictionModel，降级到简化版
    • memory 子命令：store/search/context/stats 四种操作
    • _add_chart_args() 公共参数函数消除CLI定义重复
    • 行星数据增加 speed 字段（Shadbala Chesta Bala需要）
  • SKILL.md v3.4.0：版本号+触发词（Shadbala/六重力量/Ashtakavarga/八分法/事件预测/记忆系统）+11子命令表+工作流增加步骤4-5/8/10

v3.3.1（2026-04-24）— 计算引擎集成

  • 新增 scripts/jyotish_engine.py：印度占星统一计算引擎入口
    • 基于 Swiss Ephemeris 天文计算库（Lahiri Ayanamsa 恒星黄道标准）
    • 8大子命令：chart（星盘计算）、dasha（大运时间线）、yoga（格局识别）、predict（三层验证法）、varga（分盘D9/D10）、celebrity（名人案例查询）、db-stats（数据库统计）、transit（过境查询）
    • 自动连接外部数据源：验证数据库（15,840条）、名人CSV（15,807条）、过境配置（2026-2028）
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • SKILL.md v3.3.1：新增 §13 计算引擎集成说明 + 触发词增加（算星盘/排盘/计算星盘/查名人）
  • 已知限制：LAM深度学习模型（75.84MB）和 Hermes Agent 中间件未集成（超出 CLI 脚本能力范围）

v3.2.0（2026-04-24）— Argala+AI工作流+Dasa Convergence实操化

  • 新增 argala-complete-guide.md：Argala行星干预体系完整指南
    • 四类型Argala（主Argala 2/4/11宫 + 次Argala 5/8宫 + Virodha反干预 + 特殊规则）
    • 12宫位完整Argala矩阵（主Argala + Virodha对照）
    • 10核心领域Argala分析模板（婚姻/事业/财富/子女/健康等）
    • Argala链追踪高级技法
    • PAC-DARES整合位置
  • 新增 ai-reading-workflow-prompt.md：AI解盘工作流Prompt工程
    • 7阶段完整执行引擎（PDF提取→意图路由→静态分析10步→动态推运7步→应期输出→补救→现代措辞包装）
    • 每个阶段的严格输出模板
    • 质量门Pass/Limited/Fail规则
    • 完整工作流一页纸速查
  • 升级 dasa-convergence-methodology.md v2.0：
    • 新增§〇 JH PDF数据源对照表（9大Dasha系统的PDF可提取性一目了然）
    • 新增§七 轻量Convergence三系统法（Vimsottari+Yogini+Chara，无需外部工具）
    • Yogini Dasha完整手工推算表（8位女神+年数+Nakshatra分组+定位公式）
    • Chara Dasha简化推算法（方向判断+Rashi Drishti速查）
    • 轻量Convergence实战模板（标准表格格式）
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • SKILL.md v3.2.0：新增2个参考文件注册（66文件总数）+Argala能力描述+AI工作流描述+预测清单增加Argala检查项和Dasa Convergence轻量法+触发词增加Argala/Yogini/Chara Dasha/AI解盘

v3.1.0（2026-04-24）— 多Dasa收敛+技法补齐+案例库整合

  • 新增 dasa-convergence-methodology.md：Dasa Convergence多系统大运交叉验证方法论
    • 9大Dasha系统独立性对照表（Vimsottari/Yogini/Kalachakra/Sudasa/Chara/Narayana/Nadi/Ashtottari/Shodashottari）
    • Convergence五步法：目标领域→提取Dasha→逐系统检查→寻找重叠→Transit确认
    • Convergence等级量化：Level 0-3 概率提升公式
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • 新增 navatara-kantaka-shani-guide.md：双技法合并文件
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • 私有验证案例/用户反馈细节已移除（隐私保护）。
  • 整合 famous-case-library.md v2.0：
    • 从"1个案例"升级为"24个案例统一入口"
    • 分级索引：A级（AA级验证12个）、B级（1个，梦露⚠️）、C级（比对级11个）
    • 6大核心验证结论（100%支持率）
  • 技法覆盖率提升：58%→83%→补齐后约88%（M19 Navatara+M22 Kantaka Shani已覆盖）
  • SKILL.md v3.1.0：新增2个参考文件注册（63文件总数）+Dasa Convergence能力描述+版本号更新

v3.0.0（2026-04-24）— 管线重写：PDF→解盘→应期全链路

  • 核心定位重定义：Skill使命明确为"PDF输入→严谨解盘→精确推运应期输出"
  • 重写 pdf-chart-reading-guide.md v3.0（从v1.0升级）：
    • 补全9个P0数据断层：AL/UL/HL/GL特殊Lagna、Jaimini七Karakas、Shadbala六力量、Ashtakavarga BAV/SAV、Yoga清单、逆行/燃烧/战争标记、行星Drishti相位
    • 精确11页JH PDF页面映射
    • 数据完整性门（Quality Gate）：P0数据缺失时禁止完整分析
    • 交叉校验规则：D1 NK↔D9、SAV=337、Moon NK↔Dasha起始
    • 完整JSON Schema覆盖全量数据
    • 管线桥接：提取字段→分析方法→参考文件完整映射
  • 升级 timing-prediction-template.md v2.0（从v1.0升级）：
    • 五层验证法：本命征象→Dasha激活（五级Maha→Prana）→Transit触发（四参考点+Double Transit）→Jaimini+KP交叉确认→Varshaphala年运盘确认
    • 应期精度：主窗口（月级）+次窗口（周级）+关键触发日
    • 确认/延迟/取消信号系统
    • 五大事件专属应期公式（婚姻/事业/财富/子女/健康）
  • 新增 data-bridge-mapping.md：PDF提取字段→方法论需求全量对照表+外部数据依赖处理
  • SKILL.md v3.0.0：加入PDF-first强制工作流+核心定位说明+新文件注册

v2.1.2（2026-04-23）— 瘦身+质量修复

  • 删除空占位符 api_reference.md、example_asset.txt
  • 修复4个死链引用
  • SKILL.md瘦身130+行：更新记录移至CHANGELOG.md

v2.1.1（2026-04-23）— 资料审计修复

  • 删除空占位符 api_reference.md、example_asset.txt
  • 修复4个死链引用：planetary-configurations→planets.md、yoga-patterns→yoga_list.md、nakshatra-guide→nakshatra_deities.md、birth-time-rectification(基础)→birth-time-rectification-cases.md
  • 补注册26个遗漏文件，修复4处编号重复
  • 按逻辑重组为11个分类，60个文件全部添加引用路径
  • 扩充 kp-astrology-complete-system.md v2.0：从4.5KB扩充至完整体系
  • SKILL.md瘦身：更新记录移至本文件，精简核心优势列表

v2.1.0（2026-04-23）— Yoga Timing + 静态解读最后一环

  • 新增 yoga-phala-timing-guide.md：五大方法预测Yoga结果时机
  • 新增 retrograde-combustion-war-guide.md：逆行/燃烧/行星战争深度指南
  • 预测清单升级：加入逆行/燃烧/战争检查+Yoga Phala Timing步骤

v2.0.0（2026-04-23）— 五大核心技法完整化

  • 新增 ketu-dual-nature-guide.md：Ketu双重属性框架
  • 新增 shadbala-complete-methodology.md：六种力量完整计算
  • 新增 tajika-yoga-complete-guide.md：10种Tajika Yoga完整审计
  • 新增 pratyantar-calculation-guide.md：Pratyantar精确计算
  • 升级 ashtakavarga-complete-system.md v2.0

v1.9.0（2026-04-23）— 多参考点过境分析强制规范

  • 新增 transit-multi-reference-guide.md
  • 修正：Chandra Lagna提升为强制基准
  • 根因：实际分析中遗漏Chandra Lagna视角导致预测偏差

v1.8.0 及更早（2026-04-20 ~ 2026-04-23）

  • 新增过境综合实战、关系占星、Varshaphala年运盘、综合解盘工作流、27 Nakshatra中文速查
  • 新增Jaimini完整体系、KP占星体系、补救措施体系、Ashtakavarga体系
  • 新增常见误判纠错、现代措辞解读、PDF星盘读取、自动出生时间矫正
  • 新增名人案例库、九层分盘体系、三系统协同分析、行星力量速查
Reference in New Issue View Git Blame Copy Permalink