dsh-metaphysics 0.18.4 → 0.20.0

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 版本按「一组可感知的改动」发，README 与市场条目描述随能力同步。
 
+## 0.20.0（已发布）
+
+调候（寒暖燥湿）不再是脚注：从「扶抑为主 + 一句提示」改成「调候优先 + 扶抑校验」的判定层。
+
+- 新增 `engine/tiaohou.js`：按月令基础温度、全局火水比例、湿土燥土给出 **寒 / 寒湿 / 寒燥 / 湿滞 / 平 / 燥 / 燥热 / 温热** 八档气候，附温度与燥湿量化值和依据（如「季冬丑月、火0、水1.8、湿土2处」）；由此定调候所取（寒湿取丙火、燥热取壬水）与所忌。偏寒偏燥明显时判「调候优先」，否则「扶抑为主」。
+- **用神仲裁**：调候所需与扶抑喜忌冲突时显式裁决并说明理由（「寒暖失衡时再补强弱也难受」），不冲突时写「两套取法同向，不必取舍」；`method` 字段改成「调候优先 + 扶抑校验」/「扶抑为主 + 调候校验」，读得出来用了哪套。
+- **评分接入调候**：流年/大运评分里，调候优先时天干地支合调候所需加权，合所忌扣权，寒局再逢水再扣（「地支子水加重寒湿」）。以 1996-01-19 盘为例：2020 庚子由「平 0.5」改为「忌 −0.8」并写明水助寒湿；2026 丙午「大吉 4.0」写明「寒湿之局得丙火，解冻」。
+- **解释层**新增「寒暖燥湿」一节：气候判定 + 体感白话（按日主五行各写一句）+ 调候取忌 + 仲裁；八字文本摘要加「寒暖：」一行。
+- **面板**在「用神」下新增寒暖卡：气候标签、调候优先徽标、寒—平—热标尺、调候取/忌/依据、白话叙述；独立页与面板共用。
+- 口径：调候由月令与全局寒暖燥湿判定，未逐条录入《穷通宝鉴》120 条；调候与扶抑的优先级各家有争论，界面与文档都写明采用的是「调候优先、扶抑校验」。
+- 测试新增 `test/tiaohou.test.mjs`（32 条：寒/热两盘、仲裁同向与冲突、评分方向与上下限、解释节、摘要行、面板卡）；统计 61 个测试文件 / 1714 条断言。
+
+## 0.19.0（已发布）
+
+黄历、择日、公农历互转三处按「吉历」的用法补齐（只吸收合适的那部分，不搬它的小工具）：
+
+- **黄历增强**：值日十二神（黄道/黑道）、十二时辰吉凶（五鼠遁定干支 + 时家十二神，逐时标吉凶）、二十八宿（吉凶/七政/禽/宫）、胎神、财神/喜神/福神/阳贵/阴贵方位、日柱纳音、六合三合吉配生肖；值日神/二十八宿/胎神/吉神方位与 lunar-javascript 逐日对拍（60 天仅交节当日 1 处日界差异，已注明口径）。
+- **择日扩充**：事项从 13 类扩到 27 类（领证/提亲/收送聘金/满月酒/交易/投资/签订合同/搬家入宅/装修建造/试车买车/旅行/赴任/访亲友/入学…），面板与独立页按「常用 / 婚嫁 / 生活 / 建造 / 工商」五组下拉归类；打分与冲属相排除口径不变。
+- **公农历互转 `convert`**：新增体系。公历 → 农历（农历年月日、闰月、干支四柱、生肖）与农历 → 公历（闰月须显式指定，小月无三十报错），往返自洽；只知道农历生日时可先转公历再排盘。工具层与面板、独立页都已接入。
+- 面板与独立页 tab 由 17 个扩到 **18 个**；黄历 tab 有专属卡片（值日徽标、宜忌、四格、吉神方位、十二时辰吉凶网格）。
+- 测试新增 `test/tools3.test.mjs`（14 条：黄历新增字段定值、五鼠遁、十二时辰吉凶、公农历往返/闰月/报错、择日分组与冲属相排除、渲染与接线）。
+
 ## 0.18.4（已发布）
 
 称骨补上**称骨歌原文**与白话释义（此前只有自撰的分档批语）：

package/README.md

@@ -2,13 +2,13 @@
 
 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, life-curve, feng shui and name analysis.
 
-给 DeepSeek Harness 用的**玄学命理**插件：**四柱八字、紫微斗数、六爻纳甲、梅花易数、大六壬、奇门遁甲、合盘、塔罗牌**八大排盘体系，外加**黄历、择日、称骨、小六壬、星座、生命数字、人生K线、风水、起名**九套速查，同时提供 Agent 工具与 Web 面板。
+给 DeepSeek Harness 用的**玄学命理**插件：**四柱八字、紫微斗数、六爻纳甲、梅花易数、大六壬、奇门遁甲、合盘、塔罗牌**八大排盘体系，外加**黄历、农历（公农历互转）、择日、称骨、小六壬、星座、生命数字、人生K线、风水、起名**十套速查，同时提供 Agent 工具与 Web 面板。
 
 > 传统命理与占卜属文化娱乐用途，不构成医疗、投资、法律或生死判断的依据。
 
 ## 插件市场备注
 
-**命理排盘（玄学）· 八字 / 紫微 / 六爻 / 梅花 / 六壬 / 奇门 / 合盘 / 塔罗 + 黄历 / 择日 / 称骨 / 小六壬 / 星座 / 生命数字 / 人生K线 / 风水 / 起名** —— 一个插件把十七套体系装进 Harness：对话里说一句就排盘，侧栏还有可视化面板。
+**命理排盘（玄学）· 八字 / 紫微 / 六爻 / 梅花 / 六壬 / 奇门 / 合盘 / 塔罗 + 黄历 / 农历 / 择日 / 称骨 / 小六壬 / 星座 / 生命数字 / 人生K线 / 风水 / 起名** —— 一个插件把十八套体系装进 Harness：对话里说一句就排盘，侧栏还有可视化面板。
 
 - **八字**：42 颗神煞（分吉凶七类，天干星双查年干与日干、三合星双查年支与日支，悬停看查法）、日主旺衰量化并给出依据、格局与用神（月令取格 + 化气/专旺/从格 + 十神组合，每条附判定依据）、大运流年按喜忌五行与十神打分（大吉/吉/平/忌/大忌，可看逐项理由）
 - **紫微**：十四主星与 49 星曜（主星带**庙旺得利平不陷**亮度标注）、四层十二神、生年四化与宫干自化、34 条格局（标吉/忌倾向与依据）、大限一览、流年四化落宫；本命/大限/流年三视图一键切换，命宫红框、三方四正浅底标出；竖屏与窄侧栏保持 4×4 宫盘（宫位相对位置不丢）
@@ -18,12 +18,12 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **奇门遁甲**：时家转盘，拆补 / 超神接气 / 置闰三流派取局；九宫、值符值使、空亡驿马、门迫与宫制门严格区分
 - **合盘**：八字或紫微双盘对照（日主、夫妻宫、五行互补 / 互落宫、四化引动）
 - **塔罗**：78 张全牌、1/3/5 张牌阵，逐牌牌位义 + 整体解读，体系与逆位口径写明
-- **速查九件**：黄历（四柱/建除/宜忌/冲煞/节气）、择日（13 类事项排序，冲属相排除）、称骨（骨重 + 称骨歌原文 + 释义）、
+- **速查十件**：黄历（四柱/建除/宜忌/冲煞/节气 + 值日十二神/时辰吉凶/二十八宿/胎神/吉神方位/纳音/六合三合）、农历（公农历互转）、择日（27 类事项、按五组归类、冲属相排除）、称骨（骨重 + 称骨歌原文 + 释义）、
   小六壬（时间/报数起课）、星座（档案 + 当日基调）、生命数字（生命路径/生日/态度数）、人生 K 线（逐年分与形态）、
   风水（八宅命卦/大游年/流年紫白/门主灶）、起名（喜用五行匹配，未收录如实标注）——口径与边界各自写明
 - 全部本地计算，不收集数据；结果供文化娱乐参考，不作医疗、投资、法律或生死判断
 
-### 报告化与可核验（0.16 / 0.17 / 0.18 新增）
+### 报告化与可核验（0.16 / 0.17 / 0.18 / 0.20 新增）
 
 - **一页读懂 + 三张表**：整体/事业/财富/感情/节奏五条摘要；大运表、流年表、触发事件表（紫微是大限/流年/触发）
 - **证据卡 + 置信度**：每条维度结论可展开到逐条盘面事实与所用技法，置信度按证据条数分强/中/弱
@@ -33,6 +33,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **验前事**：列出过去几年流年信号，自评准/不准/不确定后算贴合度；只读，不改盘
 - **生时校正**：给定过去 2–3 件大事，对候选时辰逐一排盘打分排序；只缩小范围，不替代出生记录
 - **导出**：`.md`（盘面 + 解析）与 PNG 摘要长图（Canvas 直出，零依赖）；独立页支持打印/存 PDF
+- **调候解释**：解释层新增「寒暖燥湿」一节，文本摘要加「寒暖：」一行
 - **方法与验证页**：独立页内置静态页，写明对拍数据、测试与闸门、口径与已知边界
 
 ## 功能
@@ -42,7 +43,8 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **十二长生**：地势（日干对各支）、自坐（各柱干对本支）
 - **神煞（42 星，7 类）**：贵人（天乙、太极、天德、月德、月德合、福星、天官、国印、天厨、天医）、文星（文昌、德秀）、婚姻（桃花、红鸾、天喜、孤辰、寡宿、金舆）、性情（华盖、羊刃、飞刃、魁罡、童子煞、六秀日、日德、日贵）、事业（禄神、将星、驿马）、凶煞（劫煞、灾煞、亡神、空亡、十恶大败、阴差阳错、四废日、流霞、天罗、地网）、格局（天赦日、金神、三奇贵人）。天干类双查年干与日干，三合类双查年支与日支；每颗星附查法依据，界面悬停可见
 - **日主旺衰**：月令权重 + 通根 + 天干帮扶，量化分档，并给出依据（季节权重、通根地支、帮扶/耗泄明细）
-- **格局与用神**：月令取格（建禄/阳刃/月劫/十神格）＋特格（化气、专旺、从格）＋十神组合（官印、杀印、食伤生财、财官、伤官配印、伤官见官、羊刃驾杀），每条附判定依据；用神取扶抑为主 + 简化调候提示，并列出喜忌十神
+- **寒暖燥湿（调候优先）**：月令温度 + 全局火水比例 + 湿土燥土判定气候，给出调候所取（寒湿取丙火、燥热取壬水）与所忌、温度/燥湿标尺、按日主五行的体感白话；流年大运评分接入调候（寒局再逢水加重扣权）；面板在「用神」下有寒暖卡
+- **格局与用神**：月令取格（建禄/阳刃/月劫/十神格）＋特格（化气、专旺、从格）＋十神组合（官印、杀印、食伤生财、财官、伤官配印、伤官见官、羊刃驾杀），每条附判定依据；用神按「调候优先 + 扶抑校验」：先判寒暖燥湿（寒/寒湿/寒燥/湿滞/平/燥/燥热/温热，附温度与燥湿量化值与依据），调候所需与扶抑冲突时显式仲裁并说明理由，不冲突时注明同向；再列喜忌十神
 - **行运吉凶**：大运、流年按喜忌五行与十神加权评分，分大吉/吉/平/忌/大忌五档，悬停可看逐项理由
 - **干支关系**：五合、相冲、相克；六合、三合半合、三会半会拱会、冲、害、破、刑
 - 大运、流年（含与原局地支的关系）、真太阳时（按出生地经度修正）
@@ -80,13 +82,14 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - 每张牌给编号、牌阶级、核心义与牌阵位义；解读 6–8 段（逐牌、大阿卡纳占比、五行分布、宫廷牌、正逆位比例、关键牌、建议）
 - 明确标注体系：RWS 编号、黄金黎明元素归属、逆位取「弱化/未顺/内化」而非凶断
 
-### 速查九件（almanac / zeri / chenggu / xiaoliuren / star / numerology / trend / fengshui / name）
+### 速查十件（almanac / convert / zeri / chenggu / xiaoliuren / star / numerology / trend / fengshui / name）
 
-九套轻量体系，输入都只要一到几个字段，结果走同一套面板与独立页（tab 由 8 个扩到 17 个），
+十套轻量体系，输入都只要一到几个字段，结果走同一套面板与独立页（tab 由 8 个扩到 18 个），
 速查结果用等宽文本卡渲染，不套命盘模板。**全部本地确定性计算**：同一天、同一输入永远同一结果。
 
-- **黄历 `almanac`**：农历、四柱干支（年柱按立春、月柱按节）、建除十二神、宜忌简表、冲煞、财神/喜神方位、上一/下一节气、每日一卦。`scope` 明写未收录的神煞、二十八宿与彭祖百忌
-- **择日 `zeri`**：13 类事项（嫁娶/订婚/开业/入宅/搬家/动土/装修/安葬/出行/祭祀/签约/求医/纳财）× 建除适配逐日打分，分「推荐 / 可用 / 回避」，当事人属相冲煞日直接排除且每条回避带理由；这是**排序引导**，不是吉凶断语
+- **黄历 `almanac`**：农历、四柱干支（年柱按立春、月柱按节）、建除十二神、宜忌简表、冲煞、上一/下一节气、每日一卦，以及**值日十二神（黄道/黑道）、十二时辰吉凶（五鼠遁干支 + 时家十二神）、二十八宿、胎神、财神/喜神/福神/阳贵/阴贵方位、日柱纳音、六合三合吉配生肖**；值日神/二十八宿/胎神/吉神方位与 lunar-javascript 逐日对拍。`scope` 明写未收录逐日全量吉凶神煞与彭祖百忌
+- **择日 `zeri`**：27 类事项（婚嫁类领证/提亲/收送聘金/满月酒，生活类旅行/访亲友/入学，建造类动土/装修建造/试车买车，工商类交易/投资/签订合同/纳财/赴任等）按「常用 / 婚嫁 / 生活 / 建造 / 工商」五组归类 × 建除适配逐日打分，分「推荐 / 可用 / 回避」，当事人属相冲煞日直接排除且每条回避带理由；这是**排序引导**，不是吉凶断语
+- **公农历互转 `convert`**：公历 → 农历（农历年月日、是否闰月、干支四柱、生肖）与农历 → 公历（需显式指定闰月，小月无三十会报错），往返自洽；只知道农历生日时可先转公历再排盘
 - **称骨 `chenggu`**：年/月/日/时四项骨重求和，按总重查**通行本《称骨歌》原文**（二两一钱…七两二钱共 52 首），并给白话释义与分档批语（如 1990-08-15 巳时 = 五两六钱，歌诀「此格推来礼义通…」）；骨重表对拍公开黄历页，不采信其他插件的表
 - **小六壬 `xiaoliuren`**：时间起课（农历月/日/时三掐）与报数起课（三个 1–99），六宫吉凶与白话断语；缺时辰会明确要求补，不默认某个时辰
 - **星座 `star`**：太阳星座档案（四象、守护星、关键词、契合星座）+ 当日四维基调；基调由日期哈希确定性生成，明写「不是随机数」，纯娱乐向
@@ -107,7 +110,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **追问**：工具参数 `ask`、面板与独立页的追问输入框——围绕**已算好的盘**回答「2027 年事业怎么样」「财运如何」这类问题；只取盘面已有字段（流年/大运/宫位/分节），不重排、不猜测；年份超出已排范围或没识别到方面时，明确说找不到并给出可问范围
 - **八字 × 紫微 交叉验证**：工具参数 `cross`（或面板勾选）会用同一份出生信息再排另一套盘，对事业/财富/感情/身体/节奏五项并列对照，标注「同向 / 有张力 / 互补」；只作对照，不把两套体系折算成同一个分数
 - **量化口径**：只量化引擎已有数据（十神权重、大运/流年档位、宫位与四化计数），**不换算金额、不给健康诊断**；报告里有「量化口径」分节写明这条边界
-- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、59 个测试文件/1668 条断言、七道闸、口径与已知边界），离线可开
+- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、61 个测试文件/1714 条断言、七道闸、口径与已知边界），离线可开
 - **夏令时校正（0.18 新增）**：1986–1991 年中国夏令时期间的钟面时间在排盘前自动减 1 小时（跨日回退），八字/紫微/合盘/验前事/生时校正统一生效；出生证已是真实太阳口径时可用 `dst: false` 关闭
 - **合婚明细层（0.18 新增）**：合盘新增属相六合/三合/六冲/相害/相刑、天干五合、双向十神、跨盘地支、年命纳音与吉凶象计数分档；只作明细，不改原总分
 - **晚子时开关**：面板与独立页都能切「23:00 后算次日/当日」；奇门另可切「归当日/归次日」——这是排盘口径，不是结果重算
@@ -170,9 +173,9 @@ dsh plugin install ./dsh-metaphysics-0.17.0.tgz
 
 ### 面板
 
-重启后侧栏出现**太极图标**，点开是排盘面板：紫微 / 八字 / 六爻 / 梅花 / 六壬 / 奇门 / 合盘 / 塔罗八个排盘 tab，另有黄历 / 择日 / 称骨 / 小六壬 / 星座 / 生命数字 / 人生K线 / 风水 / 起名九个速查 tab。奇门 tab 里「换局规则」可选拆补、超神接气、置闰；盘面下方用键值表列出局数、值符值使、空亡驿马等事实，与解读区的结论分开。
+重启后侧栏出现**太极图标**，点开是排盘面板：紫微 / 八字 / 六爻 / 梅花 / 六壬 / 奇门 / 合盘 / 塔罗八个排盘 tab，另有黄历 / 农历 / 择日 / 称骨 / 小六壬 / 星座 / 生命数字 / 人生K线 / 风水 / 起名十个速查 tab。奇门 tab 里「换局规则」可选拆补、超神接气、置闰；盘面下方用键值表列出局数、值符值使、空亡驿马等事实，与解读区的结论分开。
 
-> 独立页（`命理排盘.html`）同样是这十七个 tab：速查 tab 在左侧展开对应小表单（择日的起算日/事项/天数/属相、小六壬的时间或报数、风水的命卦或坐向、起名的评估或生成）；合盘要填双方出生信息、可选八字/紫微两种合盘；奇门用「换局规则」单选组（拆补/超神接气/置闰）与「询问方向」定用神。两份文件是**各自生成**的：重新构建后要单独同步你在用的那份拷贝（见「开发」里的 `--out`）。
+> 独立页（`命理排盘.html`）同样是这十八个 tab：速查 tab 在左侧展开对应小表单（择日的起算日/事项/天数/属相、农历的转换方向/农历日期/闰月、小六壬的时间或报数、风水的命卦或坐向、起名的评估或生成）；合盘要填双方出生信息、可选八字/紫微两种合盘；奇门用「换局规则」单选组（拆补/超神接气/置闰）与「询问方向」定用神。两份文件是**各自生成**的：重新构建后要单独同步你在用的那份拷贝（见「开发」里的 `--out`）。
 
 ### 深色与导出
 
@@ -263,7 +266,7 @@ 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 线、风水、起名。
+本插件的十套速查体系（农历互转为自有实现）在**能力范围**上参考了同生态的 [dsh-xuanji（玄机阁）](https://github.com/huangziyuan-general/dsh-xuanji)（MIT）：黄历、择日、称骨、小六壬、星座、生命数字、人生 K 线、风水、起名。
 **实现是独立的**：没有拷贝对方源码，也没有引入它的依赖（iztro / lunar-javascript），全部按行为规格用本项目的 calendar / lunar / dst 模块重写，并逐项与公开通行表或 lunar-javascript 对拍（称骨表的初版错误就是这样查出来的）。特此致谢。
 
 ## License