dsh-metaphysics 0.66.0 → 0.67.0

package/CHANGELOG.md

@@ -1,3 +1,37 @@
+## 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。