dsh-metaphysics 0.20.0 → 0.22.0

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 版本按「一组可感知的改动」发，README 与市场条目描述随能力同步。
 
+## 0.22.0（已发布）
+
+起名不再只是「未收录」三个字：逐字给出五行、判定与可换字。
+
+- 字库 190 → **391 字**（常用名用字为主，按木/火/土/金/水五行分段）：丰（火）、秋（金，秋收成熟）、林（木）这类常见字不再掉「未收录」。
+- **逐字判定**：`assessName` 每个字返回五行、释义、性别倾向、来源（`lib` 自建字库 / `user` 你传入的 `charElements` / `none` 未收录）、是否合喜用；未收录的字不猜五行，但会给出**同喜用五行的可换字**（如「秋」不合喜用 → 可换坤（土）、垚（土））。
+- **不替用户下判断**：没给生辰时 `favorable` 返回 `null`（不判合不合），结论分「无生辰 / 全未收录 / 全合 / 部分合 / 全不合」五档，并把统计（几个字、几个已知、几个合喜用、字库共几字）写出来。
+- **候选去同质化**：`generateNames` 三轮选名（新字 + 新五行组合 → 新字 → 放开）× 字库顺序打散 × 两字异行优先，避免「清一色梓桐」。同一盘 8 个候选示例：李炎梓（火木）、李坤桐（土木）、李楠灿（木火）、李楷垚（木土）、李培炫（土火）、李炜城（火土）、李柏松（木木）、李煜烨（火火）。
+- **面板**新增起名卡（`pp.nameHTML`）：逐字大字 + 五行 chip + 来源徽标 + 合/不合喜用 + 可换字、八字与喜用一行、结论；生成卡按「名 + 五行 chips + 释义」逐行排，不再是纯文本块。
+- 工具参数新增 `charElements`（`{字: 木|火|土|金|水}`，自定义字五行，未收录字也能参与判定）；`name` 的出生信息允许省 `datetime` 用 `year/month/day`。
+- 测试新增 `test/names.test.mjs` 39 条（字库规模与去重、丰秋林逐字判定、未收录字 + 可换字、charElements 生效与非法忽略、无生辰不判、候选全合喜用、面板结构与接线）；统计 **63 个测试文件 / 1784 条断言**。
+
+## 0.21.0（已发布）
+
+《穷通宝鉴》120 格逐条入库：同一「日主 + 月令」该取什么，书上怎么写的，全都摆出来。
+
+- 新增 `engine/qiongtong.js`：十天干 × 十二月令共 120 格，每格含用神顺序（首取在前）、原文摘句、出处章号；
+  - 用神顺序据通行整理表（knowyourbazi 整理表，首格为首选），原文摘句照录 [luckclub.cn](https://www.luckclub.cn/bazi/004/)《穷通宝鉴》每章首段（去掉「徐乐吾曰」评注）；
+  - 数据里的 `quoteStems` 是「原文首段依次提到的天干」，与整理表首取不同处可对照阅读（如正月庚金：表首取戊，原文先举丙）；
+  - 原文全章未见某用神字时（丁酉缺「丙」、癸未缺「壬」）直接写 note「按整理表录入，待以善本核对」，不替它圆场。
+- **取用**：调候优先时，寒暖判定定「这一盘缺什么」，穷通宝鉴定「这一格书上取什么」；两者不同向时以调候为先，界面与解释层把两套并列写出，不悄悄合并。
+- **评分**：流年天干正落在该格首取时 +0.3，次取 +0.15，理由写明「天干丙正是丑月乙日的首取（穷通宝鉴）」；该干属忌神时不给这笔分。
+- **解释层**新增「穷通宝鉴」一节：格（「乙日生于十二月」）+ 用神与首取 + 原文摘句 + 章号；「未纳入」一栏同步改成「已录 120 格，整理表口径、异文处已标 note」。
+- **面板**寒暖卡下新增穷通宝鉴块：用神 chips（首取高亮）、原文引句、章号；文本摘要「寒暖：」一行后追加「穷通：十二月乙取丙（首取丙）」。
+- 新增 `tools/qiongtong-scrape.mjs`（抓 113 章原文，缓存不入库）与 `tools/qiongtong-build.mjs`（生成 `engine/qiongtong.js`），数据可复现。
+- 测试 `test/qiongtong.test.mjs` 31 条：120 格齐全、用神字合法、原文摘句非空、月令月名一致、定值（乙丑取丙、庚寅首取戊/原文先举丙、丁酉与癸未的 note、未知输入返回 null）、1996 寒湿盘接入（detail/评分/解释/面板）。
+- 统计：62 个测试文件 / 1745 条断言；client.js 44 模块。
+
 ## 0.20.0（已发布）
 
 调候（寒暖燥湿）不再是脚注：从「扶抑为主 + 一句提示」改成「调候优先 + 扶抑校验」的判定层。

package/README.md

@@ -20,7 +20,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **塔罗**：78 张全牌、1/3/5 张牌阵，逐牌牌位义 + 整体解读，体系与逆位口径写明
 - **速查十件**：黄历（四柱/建除/宜忌/冲煞/节气 + 值日十二神/时辰吉凶/二十八宿/胎神/吉神方位/纳音/六合三合）、农历（公农历互转）、择日（27 类事项、按五组归类、冲属相排除）、称骨（骨重 + 称骨歌原文 + 释义）、
   小六壬（时间/报数起课）、星座（档案 + 当日基调）、生命数字（生命路径/生日/态度数）、人生 K 线（逐年分与形态）、
-  风水（八宅命卦/大游年/流年紫白/门主灶）、起名（喜用五行匹配，未收录如实标注）——口径与边界各自写明
+  风水（八宅命卦/大游年/流年紫白/门主灶）、起名（391 字库、逐字判定与可换字）——口径与边界各自写明
 - 全部本地计算，不收集数据；结果供文化娱乐参考，不作医疗、投资、法律或生死判断
 
 ### 报告化与可核验（0.16 / 0.17 / 0.18 / 0.20 新增）
@@ -33,7 +33,8 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **验前事**：列出过去几年流年信号，自评准/不准/不确定后算贴合度；只读，不改盘
 - **生时校正**：给定过去 2–3 件大事，对候选时辰逐一排盘打分排序；只缩小范围，不替代出生记录
 - **导出**：`.md`（盘面 + 解析）与 PNG 摘要长图（Canvas 直出，零依赖）；独立页支持打印/存 PDF
-- **调候解释**：解释层新增「寒暖燥湿」一节，文本摘要加「寒暖：」一行
+- **调候解释**：解释层新增「寒暖燥湿」一节，文本摘要加「寒暖：」一行
+- **《穷通宝鉴》120 格**：十天干 × 十二月令逐格录入用神顺序与原文摘句（「十二月乙木，木寒宜丙」这类原句照录），调候卡里直接给出「这一格书上取什么」与出处章号
 - **方法与验证页**：独立页内置静态页，写明对拍数据、测试与闸门、口径与已知边界
 
 ## 功能
@@ -43,7 +44,8 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **十二长生**：地势（日干对各支）、自坐（各柱干对本支）
 - **神煞（42 星，7 类）**：贵人（天乙、太极、天德、月德、月德合、福星、天官、国印、天厨、天医）、文星（文昌、德秀）、婚姻（桃花、红鸾、天喜、孤辰、寡宿、金舆）、性情（华盖、羊刃、飞刃、魁罡、童子煞、六秀日、日德、日贵）、事业（禄神、将星、驿马）、凶煞（劫煞、灾煞、亡神、空亡、十恶大败、阴差阳错、四废日、流霞、天罗、地网）、格局（天赦日、金神、三奇贵人）。天干类双查年干与日干，三合类双查年支与日支；每颗星附查法依据，界面悬停可见
 - **日主旺衰**：月令权重 + 通根 + 天干帮扶，量化分档，并给出依据（季节权重、通根地支、帮扶/耗泄明细）
-- **寒暖燥湿（调候优先）**：月令温度 + 全局火水比例 + 湿土燥土判定气候，给出调候所取（寒湿取丙火、燥热取壬水）与所忌、温度/燥湿标尺、按日主五行的体感白话；流年大运评分接入调候（寒局再逢水加重扣权）；面板在「用神」下有寒暖卡
+- **寒暖燥湿（调候优先）**：月令温度 + 全局火水比例 + 湿土燥土判定气候，给出调候所取（寒湿取丙火、燥热取壬水）与所忌、温度/燥湿标尺、按日主五行的体感白话；流年大运评分接入调候（寒局再逢水加重扣权）；面板在「用神」下有寒暖卡
+- **《穷通宝鉴》120 格**：按「日主 + 月令」查到该格用神顺序（如乙木丑月取丙），附原文摘句与章号；寒暖卡里与调候判定并列显示，两者不同向时以调候为先（「书里的取用」与「这一盘的气候」各自摆出来，不悄悄合并）
 - **格局与用神**：月令取格（建禄/阳刃/月劫/十神格）＋特格（化气、专旺、从格）＋十神组合（官印、杀印、食伤生财、财官、伤官配印、伤官见官、羊刃驾杀），每条附判定依据；用神按「调候优先 + 扶抑校验」：先判寒暖燥湿（寒/寒湿/寒燥/湿滞/平/燥/燥热/温热，附温度与燥湿量化值与依据），调候所需与扶抑冲突时显式仲裁并说明理由，不冲突时注明同向；再列喜忌十神
 - **行运吉凶**：大运、流年按喜忌五行与十神加权评分，分大吉/吉/平/忌/大忌五档，悬停可看逐项理由
 - **干支关系**：五合、相冲、相克；六合、三合半合、三会半会拱会、冲、害、破、刑
@@ -88,7 +90,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 速查结果用等宽文本卡渲染，不套命盘模板。**全部本地确定性计算**：同一天、同一输入永远同一结果。
 
 - **黄历 `almanac`**：农历、四柱干支（年柱按立春、月柱按节）、建除十二神、宜忌简表、冲煞、上一/下一节气、每日一卦，以及**值日十二神（黄道/黑道）、十二时辰吉凶（五鼠遁干支 + 时家十二神）、二十八宿、胎神、财神/喜神/福神/阳贵/阴贵方位、日柱纳音、六合三合吉配生肖**；值日神/二十八宿/胎神/吉神方位与 lunar-javascript 逐日对拍。`scope` 明写未收录逐日全量吉凶神煞与彭祖百忌
-- **择日 `zeri`**：27 类事项（婚嫁类领证/提亲/收送聘金/满月酒，生活类旅行/访亲友/入学，建造类动土/装修建造/试车买车，工商类交易/投资/签订合同/纳财/赴任等）按「常用 / 婚嫁 / 生活 / 建造 / 工商」五组归类 × 建除适配逐日打分，分「推荐 / 可用 / 回避」，当事人属相冲煞日直接排除且每条回避带理由；这是**排序引导**，不是吉凶断语
+- **择日 `zeri`**：27 类事项（婚嫁类领证/提亲/收送聘金/满月酒，生活类旅行/访亲友/入学，建造类动土/装修建造/试车买车，工商类交易/投资/签订合同/纳财/赴任等）按「常用 / 婚嫁 / 生活 / 建造 / 工商」五组归类 × 建除适配逐日打分，分「推荐 / 可用 / 回避」，当事人属相冲煞日直接排除且每条回避带理由；这是**排序引导**，不是吉凶断语
 - **公农历互转 `convert`**：公历 → 农历（农历年月日、是否闰月、干支四柱、生肖）与农历 → 公历（需显式指定闰月，小月无三十会报错），往返自洽；只知道农历生日时可先转公历再排盘
 - **称骨 `chenggu`**：年/月/日/时四项骨重求和，按总重查**通行本《称骨歌》原文**（二两一钱…七两二钱共 52 首），并给白话释义与分档批语（如 1990-08-15 巳时 = 五两六钱，歌诀「此格推来礼义通…」）；骨重表对拍公开黄历页，不采信其他插件的表
 - **小六壬 `xiaoliuren`**：时间起课（农历月/日/时三掐）与报数起课（三个 1–99），六宫吉凶与白话断语；缺时辰会明确要求补，不默认某个时辰
@@ -96,7 +98,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **生命数字 `numerology`**：生命路径数 / 生日数 / 态度数，11/22/33 主数保留；与八字口径不同，混问时会说明两套不可互相印证
 - **人生 K 线 `trend`**：复用八字的旺衰、大运与流年十神，按固定计分表给出 1–100 岁逐年分与最佳/最差年份；面板与独立页画的是**蜡烛图**（实体＝相对上一岁的涨跌、影线＝±4 分，叠 5/10 年均线并在右缘标末端值、大运条纹带与分界虚线、最高/最低岁标记），图下再给全段均值 / 最好大运 / 最差大运 / 波动幅度，并直接嵌在八字结果底部，与「人生运势曲线」（大运阶梯 + 流年折线）互补：曲线看趋势，K 线看逐年涨跌。旺衰正好落在换档阈值（±0.3）时只提示、不给顺位结论
 - **风水 `fengshui`**：八宅命卦（1900s/2000s 男女公式、立春界）、大游年四吉四凶、流年九宫飞白、24 山门主灶布局倾向、命宅配调停文案；`scope` 明写**不含**玄空各运盘与现场勘舆
-- **起名 `name`**：评估现有名字或按喜用五行生成候选名；241 字自建字库，未收录的字如实标「未收录」；**不做五格剖象**（需康熙字典笔画）与音韵判断
+- **起名 `name`**：391 字自建字库（常用名用字，按五行分段），评估时**逐字**给五行、释义、来源与是否合喜用，未收录的字不猜五行但给**同喜用五行的可换字**（也可用 `charElements` 自行指定）；生成候选名按「两字异行优先 + 字库顺序打散 + 三轮去重」避免清一色同字；**不做五格剖象**（需康熙字典笔画）与音韵判断
 
 ### 解析与详解（interpret）
 每个体系的排盘结果下方都会跟一个「解析与详解」模块，帮你把盘面翻译成能看懂、能照着做的事。对话工具里加 `withInterpret: true` 即可一并返回。
@@ -110,7 +112,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **追问**：工具参数 `ask`、面板与独立页的追问输入框——围绕**已算好的盘**回答「2027 年事业怎么样」「财运如何」这类问题；只取盘面已有字段（流年/大运/宫位/分节），不重排、不猜测；年份超出已排范围或没识别到方面时，明确说找不到并给出可问范围
 - **八字 × 紫微 交叉验证**：工具参数 `cross`（或面板勾选）会用同一份出生信息再排另一套盘，对事业/财富/感情/身体/节奏五项并列对照，标注「同向 / 有张力 / 互补」；只作对照，不把两套体系折算成同一个分数
 - **量化口径**：只量化引擎已有数据（十神权重、大运/流年档位、宫位与四化计数），**不换算金额、不给健康诊断**；报告里有「量化口径」分节写明这条边界
-- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、61 个测试文件/1714 条断言、七道闸、口径与已知边界），离线可开
+- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、63 个测试文件/1784 条断言、七道闸、口径与已知边界），离线可开
 - **夏令时校正（0.18 新增）**：1986–1991 年中国夏令时期间的钟面时间在排盘前自动减 1 小时（跨日回退），八字/紫微/合盘/验前事/生时校正统一生效；出生证已是真实太阳口径时可用 `dst: false` 关闭
 - **合婚明细层（0.18 新增）**：合盘新增属相六合/三合/六冲/相害/相刑、天干五合、双向十神、跨盘地支、年命纳音与吉凶象计数分档；只作明细，不改原总分
 - **晚子时开关**：面板与独立页都能切「23:00 后算次日/当日」；奇门另可切「归当日/归次日」——这是排盘口径，不是结果重算
@@ -269,6 +271,8 @@ NPM_CLI=/path/to/npm-cli.js NPM_TOKEN=... npm run release   # 本机没有 npm C
 本插件的十套速查体系（农历互转为自有实现）在**能力范围**上参考了同生态的 [dsh-xuanji（玄机阁）](https://github.com/huangziyuan-general/dsh-xuanji)（MIT）：黄历、择日、称骨、小六壬、星座、生命数字、人生 K 线、风水、起名。
 **实现是独立的**：没有拷贝对方源码，也没有引入它的依赖（iztro / lunar-javascript），全部按行为规格用本项目的 calendar / lunar / dst 模块重写，并逐项与公开通行表或 lunar-javascript 对拍（称骨表的初版错误就是这样查出来的）。特此致谢。
 
+《穷通宝鉴》120 格的原文摘句取自 [luckclub.cn](https://www.luckclub.cn/bazi/004/)（古籍，public domain），用神顺序参考 [knowyourbazi.com](https://knowyourbazi.com/zh-hans/qiongtong/) 的整理表；两者逐格对读，原文全章未见某个用神字时（如八月丁火的「丙」），数据里直接标了 note 说明「按整理表录入、待以善本核对」，没有替它圆场。
+
 ## License
 
 MIT