dsh-metaphysics 0.69.0 → 0.70.0

package/CHANGELOG.md

@@ -1,3 +1,45 @@
+## 0.70.0（2026-11-12，已发布）
+
+> 本段主题：太乙补齐五层
+
+- **太乙神数：四计 ＋ 格局全解 ＋ 古法吉凶**（`engine/taiyi.js`、`engine/index.js`、`engine/plain-summary.js`、`src/panel-kit.js`、`src/app.js`、`test/taiyi.test.mjs`）：
+
+> 上一版做到「太乙、八门、文昌、计神、始击、主客算与四将」。这一版按《太乙金镜式经》（四库全书本）卷一补齐月计、日计、时计，并把格局判据按《淘金歌》改正；另加一层「古法吉凶」，只照卷一《推太公考时法》的位置判据说话。
+
+### 新增
+- 月计：积月 = ⌊积年 × 章月 8726 ÷ 章岁 657⌋；太乙按积月取 24 局余推宫（三年一宫、不入中五），天目按积月 mod 18 起武德顺行十六神，计神按积月 mod 60 从寅逆数。
+- 日计：积日 = ⌊积月 × 月法 2447 ÷ 日法 49⌋，太乙、天目、计神同上换成积日。
+- 时计：以上年冬至为天正，时实 =（冬至积日 − 1）× 12 + 时辰序；阳遁计神起寅逆、阴遁起申逆。用现代节气定冬夏至，不用唐代气法常数，与卷一古历口径差几日，文案里写明。
+- 卦象吉凶：用卷一《推太公考时法》的原词分四档——**大吉**（阴阳和顺、八种相犯全无，且八门值开/休/生，即卷一所谓「吉道」）、**吉**（和顺、无相犯，八门不在开休生）、**不和**（无相犯但有一算落重阳/重阴）、**凶**（命中掩、击、格、对、提、迫、囚、关任何一犯）。只报符号与一句依据，不写「成 / 不成」，也不解释现实结果。卷一另有「大利」「利以行兵」「先吉后凶」，要五将与神将同参，这一层没有做，卡片上写明。
+- 定目：「为客最难详定计，便以合神加太岁」——把与太岁六合的那一支搬到太岁宫，天目（文昌）随盘整体位移，落点即定目。
+- 三基：君基三十年一移、臣基三年一移，都从午起；民基一年一移，从戌起，顺行十二支。
+- 五福：四十五年移一位，上元甲子起一宫，次序 乾一 → 艮三 → 巽九 → 坤七 → 中五。
+- 大游：三十六年移一位，上元甲子起七宫，逆数 七 → 六 → 四 → 三 → 二 → 一 → 九 → 八。
+- 十精其余五位：天乙、地乙、直符、四神（九宫接绛宫、明堂、玉堂共十二位）、小游，都三年一移。
+- 阴阳数和：八、三、四、九为阳宫，二、七、六、一为阴宫；阳宫得奇数为重阳、阴宫得偶数为重阴，都属不和；另判上和（14、18）、次和（23、29、32）、下和（12、16、27、34、38）。
+- 格局由五种扩到八种：掩、击、格、对、提、迫、囚、关；「关」只判主客之间相犯。
+- 盘面多四行——定目与三基、五福与大游与十精、数和、月日时三计与吉凶判定。
+- 盘面正下方加白话总解：一句主句（太乙在哪、值什么门、判什么档）+ 三句读法（太乙是主的位置、门管三十年、为什么判这一档），落宫/八门/四计等术语细目收进 `<details>`，默认折叠；八种格局各配一句白话。
+- `panel-kit` 的 `PP.CSS` 补齐 `mp-ty` / `mp-wl` / `mp-cs` 三套结果卡样式（此前只写在面板的 `CSS` 里，独立页拿到的是无样式的竖排文本）。
+- 神将层：《推太乙当时法》借六壬十二神看四将落位，按日干起贵人（甲戊庚丑未、乙己子申、丙丁亥酉、壬癸巳卯、辛午寅），卯至申用昼贵、酉至寅用夜贵，贵人临亥子丑寅卯辰顺行、临巳午未申酉戌逆行；四将与文昌、始击按后天八卦取生支查神，再与位置层合成原书判辞——凶 / 不和 / 吉 / 大吉 / 大利 / 先吉后凶。
+- 阴阳遁改按交节判：冬至到次年夏至为阳遁，夏至到冬至为阴遁。此前固定阳遁，夏至之后半年的落宫与文昌都会错。。
+
+### 修正
+- 「迫」改为「文昌或四将在太乙前后」（原实现按始击在太乙下一宫，那其实是「击」）。
+- 「格」改为「太乙与始击相望」（对宫），不再按客参将落对宫判。
+- 新增「对」（文昌冲太乙宫）与「提」（客大将与文昌同宫）。
+- 古例对拍口径统一到本引擎积年（604 年 = 10154521），两套积年差 8217360，能被 18 / 24 / 60 / 72 / 360 整除，同余。
+
+### 测试
+- `test/taiyi.test.mjs`（168 → 264 条）：月计积月与落宫、日计积日与天目、时计阳阴遁、四计不落中五、吉凶四档（凶 / 不和 / 吉 / 大吉，皆为卷一原词）与文案不含成败断语、定目六合表、三基位移、五福与大游次序、十精五位、阴阳数与三张数表、八种格局构造用例、渲染层四行、引擎文案六行。
+
+### 已知
+- 按冬至夏至交节判，冬至 / 夏至交节判遁没做（`dunOf` 仍返回 `'yang'`）。
+- 时计用现代节气定冬夏至，不用卷一的气法常数（33193 / 辰法 3682），与古历口径有几天差。
+- 四神只给位次，没有拆成本身与绛宫、明堂、玉堂的十二位全序。
+- 胜负断辞、三旗五将不做；吉凶按卷一位置判据给原词四档（凶 / 不和 / 吉 / 大吉），不是预测，也不写成成败断语；「大利」「利以行兵」「先吉后凶」要五将与神将同参，未做。
+- 将落中五时只标数、不加宫名（中五无对宫）。
+
 ## 0.69.0（2026-11-12）
 
 > 本段主题：首屏做减法——二十二套还在，但分组只推荐 20 个，每组只露 4 个

package/README.md

@@ -143,7 +143,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 
 - **中医体质 `constitution`**：九种体质（平和 / 气虚 / 阳虚 / 阴虚 / 痰湿 / 湿热 / 血瘀 / 气郁 / 特禀）各 5 题的自评问卷，共 45 题，按 1（没有）到 5（总是）打分。先不带 `answers` 调一次拿到题目，再把 45 个分数按顺序传回（跳过的传 `null`，别缩短数组）。转化分 = (原始分 − 题数) / (题数 × 4) × 100：偏颇质 ≥ 40 判「是」、30–39「有倾向」，平和质要 ≥ 60 且其余八种都 < 30 才算；结果给主质、兼夹、九条横条与调养方向。**不是医学诊断**，只用来对照自己的日常状态。
 - **五运六气 `wuyunliuqi`**：按「大寒」分运气年（与八字按立春定年柱不同），十干化运定中运太过 / 不及（五音太少），年支定司天与在泉，再切出主运五步（73.05 日一运）、客运五步、主气六步（60.875 日一气）、客气六步，标出此刻落在哪一运哪一气、客主加临属同气 / 顺 / 泄 / 逆 / 从，并判天符 / 岁会 / 同天符 / 同岁会 / 太乙天符。只要一个日期（省略补今天），不用生辰也不看性别；结果第一块是运气年与九步时刻表，当前那一步高亮。气候、脏腑与常见不适都是传统说法的转述，**不是诊断**，也不当天气预报用。
-- **太乙神数 `taiyi`**：年家太乙，按积年推局——积年 = 公元年 + 10153917，残年取 360 的余数，再取 72 的余数得局数；局数二十四局一周、**三年一宫、不入中五宫**，阳遁自乾一宫顺行八宫（1→2→3→4→6→7→8→9）、阴遁自巽九宫逆行（9→8→7→6→4→3→2→1），每宫理天 / 理地 / 理人各一年。另配八门（三十年一转，1954 年休门起）与文昌（积年取 18 的余数，阳局自申起、阴局自寅起，路上遇乾、坤各数两次）。只要一个日期，不用生辰也不看性别；结果第一块是九宫地盘（南上北下），太乙那格高亮、文昌带标记。只算到太乙、八门、文昌三个落点：计神 / 始击 / 定目、主算与客算、主客大小将、三基五福十精、掩迫关囚击格都**未收录**，盘面上不显示，也不按它们解读。
+- **太乙神数 `taiyi`**：年家太乙，按积年推局——积年 = 公元年 + 10153917，残年取 360 的余数，再取 72 的余数得局数；局数二十四局一周、**三年一宫、不入中五宫**，阳遁自乾一宫顺行八宫（1→2→3→4→6→7→8→9）、阴遁自巽九宫逆行（9→8→7→6→4→3→2→1），每宫理天 / 理地 / 理人各一年。另配八门（三十年一转，1954 年休门起）与文昌（积年取 18 的余数，阳局自申起、阴局自寅起，路上遇乾、坤各数两次）。第二层再往下推：**计神**（积年取 60 的余数，从寅起逆数）、**始击**（计神加和德之宫，天目随之移）、**主算与客算**（从文昌 / 始击所在沿九宫环顺行累加宫数，天目在正宫按本数、在间神先计一，数到太乙宫前一位）、**大小将与参将**（大将取算数个位、整十归一，参将取大将乘三的个位），以及**掩、击、格、对、提、迫、囚、关**八种位置关系（掩＝始击同宫，击＝始击在太乙左右，格＝太乙望始击，对＝文昌冲太乙宫，提＝客大将与文昌同宫，迫＝文昌或四将在太乙前后，囚＝将与太乙同宫，关＝主客将同一位）。只要一个日期，不用生辰也不看性别；结果第一块是九宫地盘（南上北下），太乙那格高亮，始击、文昌各带一枚标记。第三层再补齐：**定目**（淘金歌「以合神加太岁」，天目随移）、**三基**（君基三十年一移、臣基三年一移、民基一年一移；君与臣起午、民起戌，顺行十二支）、**五福**（四十五年一位，乾一→艮三→巽九→坤七→中五）、**大游**（三十六年一位，七→六→四→三→二→一→九→八）、**十精**其余五位（天乙、地乙、直符、四神、小游）与**阴阳数和**（八三四九为阳宫、二七六一为阴宫，阳宫得奇为重阳、阴宫得偶为重阴，都属不和；另有上和十四与十八、次和二十三与二十九与三十二、下和十二与十六与二十七与三十四与三十八）。第四层：**月计、日计、时计**（积月 = ⌊积年 × 章月 8726 ÷ 章岁 657⌋，积日 = ⌊积月 × 月法 2447 ÷ 日法 49⌋，时以上年冬至为天正、时实 =（冬至积日 − 1）× 12 + 时辰序；太乙、天目、计神各按自己的周期推宫），以及一层**卦象吉凶**——照卷一《推太公考时法》的位置判据，用原书用词分四档：**大吉**（阴阳和顺、八种相犯全无，且八门值开/休/生，即卷一所谓「吉道」）、**吉**（和顺、无相犯，八门不在开休生）、**不和**（无相犯但有一算落重阳或重阴）、**凶**（命中掩、击、格、对、提、迫、囚、关任何一犯）。只报符号与一句依据，不写「成 / 不成」，也不解释现实结果，**不是预测**；卷一另有「大利」「利以行兵」「先吉后凶」，要五将与天乙十二神同参，这一层没有做，盘面与文案都写明。仍未收录：交节判遁（按冬至夏至交节判）、四神拆成绛宫明堂玉堂的十二位全序、胜负断辞与三旗五将；时计用现代节气定冬夏至，与卷一的气法常数差几日。这些盘面上不显示，也不按它们解读。
 
 ### 解析与详解（interpret）
 「解析与详解」把盘面翻译成能看懂、能照着做的事，覆盖**八字、紫微、六爻、梅花、大六壬、奇门、塔罗**这 7 个体系：结果下方跟一个解析模块，对话工具里加 `withInterpret: true` 即可一并返回。合盘有自己的逐项对照详批、人生 K 线有自己的阶段报告、起名有自己的五格与音韵评估，都不再套一层解析；黄历、择日、称骨、小六壬、星座、生命数字、十六型人格、公农历互转属速查类，也不附解析——对这些体系传 `withInterpret` 不会多出这一段（结果里也不会有 `interpretTier`）。