dsh-metaphysics 0.65.0 → 0.66.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## 0.66.0（2026-11-10，已发布）
+
+> 本段主题：八字神煞对拍《问真神煞大全》+ **DeepSeek 派口径裁决**——17 条缺失神煞补齐（规则 42 → 59），并对四处历代分歧口径给出取舍与理由，另修一处「学堂/词馆从未生效」的真 bug。
+
+### DeepSeek 派口径裁决（本版价值核心）
+读了 55 章神煞古诀与 33 篇命理知识后，不再「照抄某一派」，凡遇分歧自行裁定并写明理由。四条裁决：
+
+1. **羊刃取十二长生帝旺本位**（阳干沿用历代无争议的甲卯丙午戊午庚酉壬子）。旧表把阴干记作「禄前一位」（乙辰丁未己未辛戌癸丑），但那一位在十二长生里是**衰**，不是帝旺——宋以后禄命家把阳干式硬套阴干留下的错位。今改阴干为帝旺位：乙寅、丁巳、己巳、辛申、癸亥。飞刃不再手写表，直接由羊刃逐干取六冲推得（甲酉、乙申、丙子、丁亥、戊子、己亥、庚卯、辛寅、壬午、癸巳），免两表再度走散。
+2. **福星贵人 丁 取亥**。本表所引《甲丙相邀入虎乡歌》原文作「戊猴己未丁宜亥」，旧表却写丁酉——与自家引的歌诀打架，属后世把「丁酉」这个干支名误当查法。改从歌诀，旧说保留在 rule 文本里备查。其余九干不动。
+3. **天罗地网两支成对即算 + 纳音法并行**。旧实现要求「戌亥俱全」（四支里必须同时出现戌与亥），而问真两法都不这么严：法一以年支/日支查余三支，戌见亥即算；法二以年柱纳音查日支（火命见戌亥为天罗，水土命见辰巳为地网，金木无）。旧实现漏掉大半命中。今两法并列，命中的起查柱与应柱都标出来，读盘时能追溯成因。
+4. **童子煞季节法与纳音法并行**。口诀「金木马卯合，水火鸡犬多，土命逢辰巳」是独立一法，旧实现只做季节法、把纳音法写成「流派多歧仅作参考」，等于漏了一半查法。今两法取并集。
+5. **年柱旬空单立一项（年空）**，与日柱旬空并标，不互相冒充。古法多取日柱旬空，年柱旬空另有一派，两派所据都是「本旬无支可用」，逻辑同构，故并列而不取此舍彼。
+
+### 修复：学堂/词馆在真实排盘里从未命中
+`nayin(idx)` 返回的是纳音**名**（字符串），旧代码却写 `nayin(yearIdx).element`，恒为 `undefined`。后果是学堂、词馆（纳音长生/临官）与童子纳音法在**真实排盘**里一条都没生效过；单测没暴露，是因为它们直接给 `computeBaziShensha` 喂了 `yearNayinElement`。改为 `nayinOf(yearIdx).element`，并以端到端断言钉死（土命见申必出学堂，换成木命必不出）。
+
+### 神煞大全 55 章对拍补缺（17 条新增）
+- 口径全部按《问真神煞大全》55 章实读钉死（问真课堂 www.iwzbz.com）。新增：天德合、血刃、勾绞煞（按性别取勾/绞位）、红艳煞、孤鸾煞、元辰（按性别取阳男阴女/阴男阳女位）、天转、地转、丧门、吊客、披麻、十灵日、八专、九丑、学堂（年纳音长生查法）、词馆（年纳音临官查法）、拱禄（五日五时日时虚拱）。
+- `engine/shensha.js`：`computeBaziShensha(pillars, kongwang, opts)` 增第三参 `{ gender, yearNayinElement, yearKongwang }`——gender 供勾绞煞/元辰辨阴阳男女，yearNayinElement 供学堂/词馆/童子纳音法/天罗地网纳音法，yearKongwang 供年空。`engine/bazi.js` 调用时传 `gender`、年柱纳音五行、年柱旬空。
+- 新测试 `test/shensha-wenzhen.test.mjs`：17 条逐条命中 + 学堂/词馆不查年支本身 + 元辰性别取位 + RULE_TABLE 注册齐 + 真实命例回归，42 PASS。
+- 新测试 `test/school-rulings.test.mjs`：55 PASS，逐条钉住上述五条裁决——包括反证断言（乙日见辰不再算羊刃、丁日见酉不再算福星、金木命不因纳音见亥而误报天罗），以及 rule 文本必须写明取舍理由。
+- 断言基线 9019 → 9074（167 个文件）。
+
 ## 0.65.0（2026-11-10，已发布）
 
 > 本段主题（2026-11-10）：文墨未渲染数据补渲染——运曜/流曜、来因宫、限流十二神、日干四化、非节气四柱、太极点转换落地；「显示设置」扩到 17 项。