dsh-metaphysics 0.18.4 → 0.19.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 版本按「一组可感知的改动」发，README 与市场条目描述随能力同步。
 
+## 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,7 +18,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **奇门遁甲**：时家转盘，拆补 / 超神接气 / 置闰三流派取局；九宫、值符值使、空亡驿马、门迫与宫制门严格区分
 - **合盘**：八字或紫微双盘对照（日主、夫妻宫、五行互补 / 互落宫、四化引动）
 - **塔罗**：78 张全牌、1/3/5 张牌阵，逐牌牌位义 + 整体解读，体系与逆位口径写明
-- **速查九件**：黄历（四柱/建除/宜忌/冲煞/节气）、择日（13 类事项排序，冲属相排除）、称骨（骨重 + 称骨歌原文 + 释义）、
+- **速查十件**：黄历（四柱/建除/宜忌/冲煞/节气 + 值日十二神/时辰吉凶/二十八宿/胎神/吉神方位/纳音/六合三合）、农历（公农历互转）、择日（27 类事项、按五组归类、冲属相排除）、称骨（骨重 + 称骨歌原文 + 释义）、
   小六壬（时间/报数起课）、星座（档案 + 当日基调）、生命数字（生命路径/生日/态度数）、人生 K 线（逐年分与形态）、
   风水（八宅命卦/大游年/流年紫白/门主灶）、起名（喜用五行匹配，未收录如实标注）——口径与边界各自写明
 - 全部本地计算，不收集数据；结果供文化娱乐参考，不作医疗、投资、法律或生死判断
@@ -80,13 +80,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 +108,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **追问**：工具参数 `ask`、面板与独立页的追问输入框——围绕**已算好的盘**回答「2027 年事业怎么样」「财运如何」这类问题；只取盘面已有字段（流年/大运/宫位/分节），不重排、不猜测；年份超出已排范围或没识别到方面时，明确说找不到并给出可问范围
 - **八字 × 紫微 交叉验证**：工具参数 `cross`（或面板勾选）会用同一份出生信息再排另一套盘，对事业/财富/感情/身体/节奏五项并列对照，标注「同向 / 有张力 / 互补」；只作对照，不把两套体系折算成同一个分数
 - **量化口径**：只量化引擎已有数据（十神权重、大运/流年档位、宫位与四化计数），**不换算金额、不给健康诊断**；报告里有「量化口径」分节写明这条边界
-- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、59 个测试文件/1668 条断言、七道闸、口径与已知边界），离线可开
+- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、60 个测试文件/1682 条断言、七道闸、口径与已知边界），离线可开
 - **夏令时校正（0.18 新增）**：1986–1991 年中国夏令时期间的钟面时间在排盘前自动减 1 小时（跨日回退），八字/紫微/合盘/验前事/生时校正统一生效；出生证已是真实太阳口径时可用 `dst: false` 关闭
 - **合婚明细层（0.18 新增）**：合盘新增属相六合/三合/六冲/相害/相刑、天干五合、双向十神、跨盘地支、年命纳音与吉凶象计数分档；只作明细，不改原总分
 - **晚子时开关**：面板与独立页都能切「23:00 后算次日/当日」；奇门另可切「归当日/归次日」——这是排盘口径，不是结果重算
@@ -170,9 +171,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 +264,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