dsh-metaphysics 0.65.0 → 0.67.0

package/CHANGELOG.md

@@ -1,3 +1,60 @@
+## 0.67.0（2026-11-11，已发布）
+
+> 本段主题：八字新接三块——天干合化成功四条件判定、财库开闭与三平衡富贵层次，全部按问真口径实读裁决。
+
+### 合化成功四条件（`engine/hehua.js`，185 行）
+- 问真《基础知识·干支中》四条件：天干紧挨、被化天干无同类帮扶、月令有引化物、引化物不被克；隔合、遥合、争合、妒合一律不化。
+- 被化干只算同类（比劫）不算印——问真唯一完整例 `己酉 甲戌 壬戌 丁未` 里己土有丁火为印却仍判化成功，把印计进生扶会与它自己的例子冲突。
+- 引化物被克只查月干/日干 + 月支本气；年干/时干出现克化神五行不挡化，但文案会补「被化神隔开，不挡化」。
+- 日元即使合化成功仍以原五行论，只表现形式变；五合未必以日元为主。
+- `buildRelations` 返回对象新增 `hehua` 键，`stems` 原文案（『化X待定』）一字未改。
+
+### 财库（`engine/geju.js` 新增 `caiKuOf`，挂 `frame.caiKu`）
+- 问真表：水木日主库在戌、火在丑、土在辰、金在未；「开库才发」——财为喜用且不弱时库被冲开才主发，财为忌时开库反主破财。
+- 裁决按「日主所克五行之墓」自推：木辰/火丑/土辰/金未/水戌（与问真表只在木日主不同：辰 vs 戌；其余四格一致，推测问真「水木戌」是传抄把「水戌」误并）。rule 里写明推演与差异。
+- 财星入库（财星本气藏库支）≠ 财库，分本气/余气两档标注。
+- 八档结论：无财库 / 开库主发 / 开库反主破财 / 开库发而不厚 / 开库吉凶待引动 / 库闭财弱 / 库闭待冲开 / 库闭未开。
+
+### 三平衡定富贵层次（`engine/geju.js` 新增 `balanceOf`，挂 `frame.balance`）
+- 五行平衡（占比极差/缺项）、阴阳平衡（天干奇偶 + 地支藏干本气，子午论阴、亥巳论阳）、寒暖燥湿平衡（调候之物是否在位）。
+- 三者全备=大富大贵、两备=中富中贵、一备=小富小贵；格局法定贵贱十式另立，不混入。
+- 阈值为本插件折算口径（非古法原数）：五行 spread<=22 且最低>=4；阴阳 3..5；调候权重>=0.3。
+- 新增 `branchYinYang(branch)`，不改 `isYangStem`（连带影响十神与十二长生）。
+
+### 只读并列与占位
+- 三块全部只读并列：不改 `strength.score`/`yongshen.favor`/`yongshen.avoid`/`relations.stems`。
+- hourUnknown 分支各自打 placeholder：caiKu 分「库冲已落在年月日三支（robust）」与「可能受时支影响」两档 note；balance 与 hehua 也补说明。
+- 断言基线 9117 → 9352（167 → 170 文件）。
+
+### 测试
+- `test/bazi-hehua.test.mjs`：65 PASS（参考例 + 隔合/遥合/争合/妒合/帮扶/无引/被克 七组反证 + 日元不变 + 只读 + hourUnknown + 解析层 + BAN 扫描）。
+- `test/bazi-caiku.test.mjs`：79 PASS（五格映射 + 无库/见冲 + 入库深浅 + 8% 门槛 + 六真实盘 + 中性分支 + 只读 + hourUnknown + 解析层 + brief）。
+- `test/bazi-balance.test.mjs`：91 PASS（spread/缺项边界 + 阴阳纯阳纯阴 + 气候权重 + 四档 tier + 五真实盘 + 只读 + hourUnknown + 解析层 + brief）。
+- 四次变异验证（改坏 `unrescued`/`CAIKU_WEAK_PCT`/`BRANCH_YINYANG`/`BALANCE_SPREAD_MAX`）全部确认断言真会红。
+
+## 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 项。