dsh-metaphysics 0.62.2 → 0.62.3

package/CHANGELOG.md

@@ -1,5 +1,25 @@
+## 0.62.3（2026-11-06，待发布）
+
+> 本段主题：复查 0.62.2 发布后的三处「看不见的错」——对拍报告把 127 条没有起卦日的卦例标成「旬空一致」（其实拿今天算、每换一旬页面就变），README 说「每个体系都有解析」而实际只有 7 个体系有，以及徽章只挂「0 处不符」、把「127 项未核」这个口径藏在了报告里。
+
+> 续（同日）：以 tyme4ts（寿星天文历）为外部基准做玄学口径对拍，修掉三处会算错的——月令取格按柱位而非藏干位阶、黄历拿当日正午比交节时刻、「巳」的中气/余气颠倒；并把风水命卦/月紫白的立春界统一到同一口径。
+
+- **月令取格：按藏干位阶（本气→中气→余气），不再按柱位先遇上谁用谁**（`engine/geju.js` 的 `monthPattern`）：原实现 `['year','month','hour'].find(k => cands.some(...))` 取第一个透出藏干的**柱**，于是年干透余气会把月干透本气挤掉。实测 `戊戌 甲寅 丙子 癸巳`（2018-02-13 10:00）排「食神格」、理由写「余气戊透于年干」，而月干甲是寅的本气、丙火的偏印，明明贴着月令却被跳过。抽样 1,502 盘：19.5% 有两处以上不同藏干并透，改前其中七成以上取到的不是最高位阶——即约每十盘就有一盘的格局名不同，而格局是用神、喜忌、行运评分与解读文案的输入。现按「本气透则取本气，不透再取中气、余气」遍历，同一藏干多柱并透时报「月」优先。
+- **黄历：交节按「日」判，不再拿当日正午比时刻**（`engine/almanac.js` 的 `buildAlmanac`）：黄历按日出版，却用 `jdNoon`（当日 12:00）去比交节时刻。交节若在午后，正午还没交节，整天仍算上个月。以 2020-02-04（立春 17:03）为例：旧输出月柱丁丑、建日、朱雀，通行黄历为戊寅月、闭日、明堂；同一页的「下一个节气」还写着「立春（今天）」，自相矛盾。每年 12 个「节」约一半落在午后 → 每年约 6 天月柱、建除、值日神全错，且 `zeri.js` 逐日调用 `buildAlmanac`，择日整块继承。现统一比「节气所在日序」（`Math.floor(jd + 0.5) <= jdn`），年柱、月柱、上一/下一节气同理；八字侧仍按精确到分的交节时刻判月柱，两者不共用这一层。对拍 2015–2035 逐日 7,670 天，建除 / 值日星神 / 二十八宿 / 年柱与基准 **0 差异**（改前交节日及次日 264 天里错 69 天）。
+- **「巳」藏干改为丙庚戊**（`engine/bazi.js` 的 `HIDDEN_STEMS`、`engine/geju.js` 的 `HIDDEN`）：原写「丙戊庚」，把中气给了戊土（0.5）、余气给了庚金（0.3）。按本仓库自己的 `RENYUAN_TABLE`（巳月：戊 5 日 → 庚 9 日 → 丙 16 日，与藏干互为倒序）以及「长生=中气」的同构写法（寅甲丙戊、申庚壬戊、亥壬甲），应为丙（本）庚（中）戊（余）；寿星天文历亦作丙庚戊。影响：见巳的盘五行由土 +0.2 / 金 −0.2 纠正（`1990-05-12 14:30` 输出由 土3.0/金2.6 变为 土2.8/金2.8），庚辛或戊己的通根分随之 ±0.2～0.24。连带一处状态翻转：`1962-11-05` 的炎上格因财由 1.8 升到 2.0、越过「财 >1.8 耗旺气」的破格线，从「待定」转「破格」（已单钉一条断言，见下）。
+- **风水：立春界与月紫白跟黄历对齐**（`engine/fengshui.js`）：`guaYearOf` 的注释原来写着「按正午判，与黄历一致」，而黄历这轮已改成按日——两者会差一天。现统一按日（立春当日即算新年；命卦只按出生年取，同一天出生的人不因生在 16:27 前后换卦）。`timeFlyingOf` 原来无条件用正午比节气，给了时刻也一样：14:30 出生、当天 17:03 才立春，本应还在上月，却被算成新月的年与月。现按「给了时刻用时刻、只给日期用日」，且年紫白与月紫白共用同一个基准——否则立春当天会出现「年已甲辰、月还是丑月」的自相矛盾。另清掉黄历里算了却不用的 `nextJie`。
+- **回归锁**：`test/geju.test.mjs` 新增「本气甲透月干 → 偏印格」「取格依据点名本气与月干」，并加一条结构不变量（抽样 80 盘：本气透出时月令格必须取本气，劫财按月劫论）；`test/bazi.test.mjs` 新增「巳藏干为丙庚戊 / 角色序 / 金 2.8 土 2.8」三条；`test/tools.test.mjs` 把原来那条「立春当日按正午判尚未交节（已知日界口径）」改成「立春当日即换年柱甲辰、月柱丙寅」，并补 2020-02-04 三件套与「下一个节气不再是自己」；`test/bazi-special.test.mjs` 的待定样本换成 1951-07-25，另加「财过线即破格」；`test/classic-quotes.test.mjs` 的炎上格样本换成 1951-07-25（破格不配专章）；`test/yongshen-neutral.test.mjs` 的中性样本换成 1983-12-06（原样本的金来自巳、已按中气计 0.5，不再属于「近零」）；`test/fengshui-tigua-zibai.test.mjs` 补 5 条立春当日断言（12:00 仍癸卯/丑月、20:00 转甲辰/立春、只给日期与给 20:00 同盘）。
+
+- **对拍报告：没有起卦日就标「旬空未核」，不再拿今天充数**（`tools/verification.mjs`、`test/verification.test.mjs`）：《卜筮正宗》128 条卦例里只有 1 条记了起卦日，其余 127 条的 `dayOf(ex.date)` 返回 `undefined`，传给 `buildLiuyao` 后引擎按「今天」补日干支；而 `if (ex.kong && dayOf(ex.date))` 又把旬空比对整个跳过。结果就是页面上「期望 空辰巳 / 引擎 空午未」还标「一致」，而且每换一旬报告内容就变一次——`check-verification` 的「与源码逐字节一致」注定在某天变红（0.62.2 发布次日即复现）。现：无起卦日 → 期望写「空辰巳（未核）」、引擎写「空—（未核）」、对拍项写「旬空（未核：原表无起卦日）」、行上带 `unchecked: true`，汇总与页面卡片单列「未核 127 项」；同时给引擎传固定占位日（甲子），保证报告与系统日期完全无关。
+- **徽章把「127 项未核」写在脸上，宽度随内容自适应**（`tools/verification.mjs`、`README.md`、`test/verification.test.mjs`）：徽章原来只有「0 处不符｜128 例 · 5 剔除 · 312 紫微 · 20 奇门 · 12 交运」，看的人会以为 128 条都核过了；现补一段「· 127 未核」（`unchecked` 为 0 时不写，不挂「0 未核」的废话）。为容纳新增文字，宽度不再写死 470，改由 `badgeTextWidth()` 按内容估算（中文/全角 1em、数字与字母 0.65em、空格 0.32em、其余符号 0.45em，两侧各留 18px），数字位数变长（如 127 → 1270）时徽章自动变宽，字不会被顶出彩色面板。README 的徽章 alt 同步改成「0 处不符（127 项未核）」。
+- **回归锁**（`test/verification.test.mjs`）：新增「未核行不给旬空值 / 期望与对拍项都写明未核 / 未核行仍按其余四项判一致」三条；用唯一带日期的「申月甲午日」用例锁「有起卦日照旧核旬空、改坏会被抓」；并新增「跨日期渲染逐字节一致」（把 `Date` 冻结到 2026-11-06 与 2027-03-19 各渲染一次比对），锁住「跨旬重建 → 报告与源码不一致 → CI 红」那类回归。徽章另加 6 条：含「127 未核」、未核数与 `totals` 同源、总宽＝左栏 62 + 右栏、估算宽度 + 两侧留白 ≤ 右栏、数字变长时徽章跟着变宽、未核为 0 时不出现「0 未核」。
+- **解析范围：README 与工具说明改成准确的 7 个体系**（`README.md`、`engine/index.js`）：原文「每个体系的排盘结果下方都会跟一个『解析与详解』模块」与实际不符——实测只有 bazi / ziwei / liuyao / meihua / daliuren / qimen / tarot 产出 `interpret`；hepan 有自己的逐项对照详批、trend 有自己的阶段报告、name 有自己的五格与音韵评估，其余速查类（黄历 / 择日 / 称骨 / 小六壬 / 星座 / 生命数字 / 人格 / 公农历互转）不附解析。`withInterpret` 的 schema 说明与工具长描述同步点名范围，免得模型对速查类白传。
+- **ΔT 远年外推：2100 年后改用抛物线公式**（`engine/calendar.js` 的 `deltaTSeconds`）：原实现 2100 年后返回常数 110 秒，未考虑地球自转长期减慢的二次效应。Morrison & Stephenson (2004) 抛物线为 **ΔT ≈ 32 × ((year − 1820)/100)² 秒**（括号里是世纪）；本实现以 2100 端点 110s 接续增长率，保证 2100→2101 连续：2101 约 112s、2200 约 321s、2400 约 936s。**发版前复查抓到的单位错误**：初版写成 `32 × (year − 1820)²`，2400 年得到 1076 万秒（约 124 天），节气与朔望会整体推后几个月（CI 里 2400 年农历、朔望全部错位）；现按世纪平方修正，并加「量级 < 3600s、2100 连续、2100→2400 单调」回归锁。影响范围：`termInstantJd` 求节气时刻、`newMoonJd` 求合朔时刻均经此函数修正 TT→UT，远年农历置闰与节气定位随之纠正。
+
 ## 0.62.2（2026-11-05）
 
+> 已发布：npm `dsh-metaphysics@0.62.2`，shasum `13ca04fb9ad703addf3bc40ea01a7e26ff9a9bdb`，102 个文件；tag `v0.62.2` 已推，GitHub release 已建，tarball 已下载核对。
+
 > 本段主题：复查 0.62.1 的静默错值——开关与数字的「盘面 / 句柄」口径不一致、brief 的 12KB 闸门量错了单位、以及闸门本身有早退与预留不足；随后按使用方要求把这道体积闸门整个移除，只保留表格行数限制。
 
 - **开关口径：字符串布尔与真布尔排同一张盘**（新增 `engine/bool.js` 的 `canonicalFlags()`、`engine/index.js` 入口、各引擎读值）：`trueSolar:"false"` 以前由 `!== false` 读到「开」，盘按真太阳时排，句柄却照着原文写 `false`——同一张盘两个身份，影子盘对拍、深链回放、跨版本 diff 全部错位；`lateZi` / `dst` / `isLeapMonth` / `leapAsNext` 同理，`withInterpret:"false"` 也照旧附解析。现入口一次归一成真布尔，18 个体系的开关读值统一走 `bool()`（`chenggu / daliuren / diff / fengshui / hepan / meihua / name / rectify / trend / xiaoliuren / ziwei` 一并改），合盘 `partner` / `partner2` 里的同名开关同样归一；空串 / 空白串按「没给」剔除，避免 `lateZi:""` 被折成全局缺省 true、把奇门（缺省 same-day）与紫微（缺省 current-day）排成另一张盘。

package/README.md

@@ -1,6 +1,6 @@
 # dsh-metaphysics · 命理排盘
 
-[![公开对拍：0 处不符](docs/assets/verification-badge.svg)](docs/verification.html)
+[![公开对拍：0 处不符（127 项未核）](docs/assets/verification-badge.svg)](docs/verification.html)
 
 Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): BaZi (Four Pillars), Zi Wei Dou Shu, LiuYao, MeiHua YiShu, Da Liu Ren, Qi Men Dun Jia, relationship compatibility, Tarot, plus quick-reference tools — almanac, date selection, bone-weight fortune, Xiao Liu Ren, horoscope, numerology, an MBTI-style 16-type questionnaire, life-curve, feng shui and name analysis.
 
@@ -141,7 +141,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **起名 `name`**：1062 字自建字库（常用名用字，按五行分段，每字带**拼音/声调/康熙笔画**），另有**姓氏库 998 姓 + 82 复姓**（`engine/surname-data.js`，逐姓康熙笔画 + 读音；笔画由三份资料互证 + Unihan 部首结构值复算，25 个分歧字逐个裁定并把理由写在模块头）；评估时**逐字**给五行、释义、来源与是否合喜用，未收录的字不猜五行但给**同喜用五行的可换字**（也可用 `charElements` 自行指定）；**五格剖象**按康熙字典繁体笔画算天格/人格/地格/外格/总格，配通行本 81 数理（超 81 按 −80 回绕）与三才五行，任一字缺笔画就整体返回「算不了」并点名缺哪个字，可用 `strokeOverrides`（逐字）/`surnameStrokes`（按姓）补；多音姓（覃/查/尉…）**主读照算、又读并列显示**，只考证得出笔画的 71 个姓不猜读法、音韵直接落空；**音韵**只做机械检查——全名同调、相邻同声母/同韵母、叠字撞音，判「顺口/略拗/拗口」，**不做语义谐音**；生成候选名按「合喜用 → 两字异行 → 常用字优先 → 五格格数 → 性别倾向 → 字库序」排序，只是排序不是「吉名」判定
 
 ### 解析与详解（interpret）
-每个体系的排盘结果下方都会跟一个「解析与详解」模块，帮你把盘面翻译成能看懂、能照着做的事。对话工具里加 `withInterpret: true` 即可一并返回。
+「解析与详解」把盘面翻译成能看懂、能照着做的事，覆盖**八字、紫微、六爻、梅花、大六壬、奇门、塔罗**这 7 个体系：结果下方跟一个解析模块，对话工具里加 `withInterpret: true` 即可一并返回。合盘有自己的逐项对照详批、人生 K 线有自己的阶段报告、起名有自己的五格与音韵评估，都不再套一层解析；黄历、择日、称骨、小六壬、星座、生命数字、十六型人格、公农历互转属速查类，也不附解析——对这些体系传 `withInterpret` 不会多出这一段（结果里也不会有 `interpretTier`）。
 
 - **结构化输出**：`{ moduleType, system, title, lead, dimensions[], sections[], disclaimer }`；`moduleType` 为 `natal`（命盘）/ `divination`（卦象）/ `card`（牌阵），`dimensions` 固定五个维度；`sections` 可带 `tone`（`good`/`watch`/`bad`），面板据此上色
 - **分层结构与逐宫（0.43 新增）**：紫微多出**命身底色**（命宫主星 + 亮度 + 双星组合 + 身宫落点）、**逐宫分析**（十二宫各一条：宫位取象 + 主星亮度 + 吉星/煞星 + 四化，下接一句读法）与**三层格局**（有利格局 / 结构提示 / 忌格提醒，每条写名称、人话、依据与做法）；八字多出**命局框架**（日主/用神/格局 + 一句命局基调）、**正面画像**（外在取象 / 性格底色 / 事业与家庭）、**流年时间轴**（近三年逐条给档位与理由）与**专业建议**（喜用落地 / 忌神自觉 / 地支关系 / 调候）。措辞取自两份独立词库 `engine/ziwei-words.js`、`engine/bazi-words.js`——引擎只出事实，词库只出说法，词库里没有任何判断条件