dsh-metaphysics 0.18.2 → 0.18.3

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 版本按「一组可感知的改动」发，README 与市场条目描述随能力同步。
 
+## 0.18.3（已发布）
+
+K 线的第二轮打磨（0.18.2 之后的可读性修正）：
+
+- 大运段名从图顶挪到图下的条纹带里，不再和「最高/最低岁」标记抢位置；段名居中，条带随大运交替着色
+- 5 年 / 10 年均线在右缘标出末端数值，两条贴太近时自动上下错开
+- 纵轴补 0/25/50/75/100 刻度，横轴补「年龄（岁）」与「每岁一分 · 满分 100」；影线用 `clipPath`
+  夹在绘图区内，贴边的影线不再溢出
+- 新增统计条：全段均值、最好大运、最差大运、波动幅度。旺衰落在换档阈值附近时只给均值与波动，不给
+  「最好/最差大运」的顺位
+- 图高由 300 提到 322，给刻度与段名条留位
+- `test/kline.test.mjs` 增到 29 条（段名条、均线末端值、纵轴刻度、统计条、最好/最差大运）
+- 统计：58 个测试文件 / 1650 条断言
+
 ## 0.18.2（已发布）
 
 人生 K 线从「等宽文本 + ASCII」升级成真正的蜡烛图，并嵌进八字结果：

package/README.md

@@ -91,7 +91,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **小六壬 `xiaoliuren`**：时间起课（农历月/日/时三掐）与报数起课（三个 1–99），六宫吉凶与白话断语；缺时辰会明确要求补，不默认某个时辰
 - **星座 `star`**：太阳星座档案（四象、守护星、关键词、契合星座）+ 当日四维基调；基调由日期哈希确定性生成，明写「不是随机数」，纯娱乐向
 - **生命数字 `numerology`**：生命路径数 / 生日数 / 态度数，11/22/33 主数保留；与八字口径不同，混问时会说明两套不可互相印证
-- **人生 K 线 `trend`**：复用八字的旺衰、大运与流年十神，按固定计分表给出 1–100 岁逐年分与最佳/最差年份；面板与独立页画的是**蜡烛图**（实体＝相对上一岁的涨跌、影线＝±4 分，叠 5/10 年均线、大运分界与最高/最低岁标记），并直接嵌在八字结果底部，与「人生运势曲线」（大运阶梯 + 流年折线）互补：曲线看趋势，K 线看逐年涨跌。旺衰正好落在换档阈值（±0.3）时只提示、不给顺位结论
+- **人生 K 线 `trend`**：复用八字的旺衰、大运与流年十神，按固定计分表给出 1–100 岁逐年分与最佳/最差年份；面板与独立页画的是**蜡烛图**（实体＝相对上一岁的涨跌、影线＝±4 分，叠 5/10 年均线并在右缘标末端值、大运条纹带与分界虚线、最高/最低岁标记），图下再给全段均值 / 最好大运 / 最差大运 / 波动幅度，并直接嵌在八字结果底部，与「人生运势曲线」（大运阶梯 + 流年折线）互补：曲线看趋势，K 线看逐年涨跌。旺衰正好落在换档阈值（±0.3）时只提示、不给顺位结论
 - **风水 `fengshui`**：八宅命卦（1900s/2000s 男女公式、立春界）、大游年四吉四凶、流年九宫飞白、24 山门主灶布局倾向、命宅配调停文案；`scope` 明写**不含**玄空各运盘与现场勘舆
 - **起名 `name`**：评估现有名字或按喜用五行生成候选名；241 字自建字库，未收录的字如实标「未收录」；**不做五格剖象**（需康熙字典笔画）与音韵判断
 
@@ -107,7 +107,7 @@ Chinese metaphysics (玄学 / xuanxue) for [DeepSeek Harness](https://github.com
 - **追问**：工具参数 `ask`、面板与独立页的追问输入框——围绕**已算好的盘**回答「2027 年事业怎么样」「财运如何」这类问题；只取盘面已有字段（流年/大运/宫位/分节），不重排、不猜测；年份超出已排范围或没识别到方面时，明确说找不到并给出可问范围
 - **八字 × 紫微 交叉验证**：工具参数 `cross`（或面板勾选）会用同一份出生信息再排另一套盘，对事业/财富/感情/身体/节奏五项并列对照，标注「同向 / 有张力 / 互补」；只作对照，不把两套体系折算成同一个分数
 - **量化口径**：只量化引擎已有数据（十神权重、大运/流年档位、宫位与四化计数），**不换算金额、不给健康诊断**；报告里有「量化口径」分节写明这条边界
-- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、58 个测试文件/1644 条断言、七道闸、口径与已知边界），离线可开
+- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、58 个测试文件/1650 条断言、七道闸、口径与已知边界），离线可开
 - **夏令时校正（0.18 新增）**：1986–1991 年中国夏令时期间的钟面时间在排盘前自动减 1 小时（跨日回退），八字/紫微/合盘/验前事/生时校正统一生效；出生证已是真实太阳口径时可用 `dst: false` 关闭
 - **合婚明细层（0.18 新增）**：合盘新增属相六合/三合/六冲/相害/相刑、天干五合、双向十神、跨盘地支、年命纳音与吉凶象计数分档；只作明细，不改原总分
 - **晚子时开关**：面板与独立页都能切「23:00 后算次日/当日」；奇门另可切「归当日/归次日」——这是排盘口径，不是结果重算

package/client.js

@@ -746,7 +746,7 @@ function resolveAddress(input) {
 
 const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
-const USER_AGENT = 'dsh-metaphysics/0.18.2 (+https://github.com/xuanfu-web/dsh-metaphysics)';
+const USER_AGENT = 'dsh-metaphysics/0.18.3 (+https://github.com/xuanfu-web/dsh-metaphysics)';
 
 async function onlineLookup(text, { timeoutMs = 2500 } = {}) {
   if (typeof fetch !== 'function') return null;
@@ -9668,6 +9668,17 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 .mp-kline .kl-seg{fill:var(--label);font-size:8.5px;font-family:system-ui,sans-serif;paint-order:stroke;stroke:var(--card);stroke-width:2.2px;stroke-linejoin:round}
 .mp-kline .kl-lbl{fill:var(--muted);font-size:8px;font-family:system-ui,sans-serif}
 .mp-kline .kl-lbl.age{font-size:8.5px}
+.mp-kline .kl-lbl.axis{font-size:8px;letter-spacing:.02em;opacity:.85}
+.mp-kline .kl-stripband{fill:var(--ink);opacity:.06;rx:2}
+.mp-kline .kl-ma-lbl{font-size:8.5px;font-family:system-ui,sans-serif;paint-order:stroke;stroke:var(--card);stroke-width:2.4px;stroke-linejoin:round;fill:var(--muted)}
+.mp-kline .kl-ma-lbl.m5{fill:var(--quan)}
+.mp-kline .kl-ma-lbl.m10{fill:var(--ke);opacity:.9}
+.mp-kline .kl-stats{display:flex;gap:14px;flex-wrap:wrap;margin-top:6px;font-size:11px;color:var(--muted);font-family:system-ui,sans-serif}
+.mp-kline .kl-stats span{display:inline-flex;align-items:baseline;gap:5px}
+.mp-kline .kl-stats em{font-style:normal;font-size:10.5px;color:var(--dim)}
+.mp-kline .kl-stats b{font-size:12px;font-weight:600;color:var(--ink2);font-variant-numeric:tabular-nums}
+.mp-kline .kl-stats b.hi{color:var(--ji)}
+.mp-kline .kl-stats b.lo{color:var(--lu)}
 .mp-kline .kl-c.up line{stroke:var(--ji);stroke-width:.8;opacity:.8}
 .mp-kline .kl-c.up rect{fill:var(--ji);opacity:.92}
 .mp-kline .kl-c.down line{stroke:var(--lu);stroke-width:.8;opacity:.8}
@@ -10705,13 +10716,14 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
     </div>`;
   };
 
+  let klineSeq = 0;
   pp.trendChart = function (r) {
     const pts = r && Array.isArray(r.points) ? r.points : [];
     if (pts.length < 2) return '';
     const segs = r && Array.isArray(r.segments) ? r.segments : [];
     const num = (v) => (typeof v === 'number' && isFinite(v) ? v : 0);
-    const W = 720, H = 300;
-    const M = { t: 36, r: 14, b: 30, l: 34 };
+    const W = 720, H = 322;
+    const M = { t: 34, r: 46, b: 66, l: 36 };
     const pw = W - M.l - M.r, ph = H - M.t - M.b;
     const n = pts.length;
     const step = pw / n;
@@ -10719,6 +10731,9 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
     const Y = (v) => M.t + ph - (Math.max(0, Math.min(100, v)) / 100) * ph;
     const bodyW = Math.max(1.1, Math.min(10, step * 0.62));
     const sc = (p) => num(p.score);
+    const yb = M.t + ph;
+    const stripTop = yb + 20, stripH = 22;
+    const clipId = `klclip${(klineSeq += 1)}`;
 
     const bands = segs.map((s, i) => {
       const i0 = Math.max(0, s.startAge - 1);
@@ -10726,11 +10741,15 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
       if (i1 < i0) return '';
       const x = M.l + i0 * step;
       const w = Math.max(0.6, (i1 - i0 + 1) * step);
-      const rect = i % 2 === 1
-        ? `<rect class="kl-band" x="${x.toFixed(1)}" y="${M.t}" width="${w.toFixed(1)}" height="${ph}"/>` : '';
+      const tint = i % 2 === 1;
+      const rect = tint
+        ? `<rect class="kl-band" x="${x.toFixed(1)}" y="${M.t}" width="${w.toFixed(1)}" height="${ph}"/>`
+        + `<rect class="kl-stripband" x="${x.toFixed(1)}" y="${stripTop}" width="${w.toFixed(1)}" height="${stripH}"/>` : '';
       const line = i === 0 ? ''
-        : `<line class="kl-segline" x1="${x.toFixed(1)}" y1="${M.t}" x2="${x.toFixed(1)}" y2="${M.t + ph}"/>`;
-      return rect + line + `<text class="kl-seg" x="${(x + 3).toFixed(1)}" y="${M.t - 8}">${esc(s.ganZhi)}</text>`;
+        : `<line class="kl-segline" x1="${x.toFixed(1)}" y1="${M.t}" x2="${x.toFixed(1)}" y2="${yb}"/>`;
+      const cx = Math.min(Math.max(M.l + ((i0 + i1 + 1) / 2) * step, M.l + 22), M.l + pw - 22);
+      return rect + line
+        + `<text class="kl-seg" x="${cx.toFixed(1)}" y="${(stripTop + 15).toFixed(1)}" text-anchor="middle">${esc(s.ganZhi)}</text>`;
     }).join('');
 
     const grid = [0, 25, 50, 75, 100].map((v) =>
@@ -10739,7 +10758,7 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 
     const candles = pts.map((p, i) => {
       const k = p.kline || {};
-      const o = num(k.open), c = num(k.close), hi = num(k.high), lo = num(k.low);
+      const o = num(k.open), c = num(k.close), hi = Math.min(100, num(k.high)), lo = Math.max(0, num(k.low));
       const up = c >= o;
       const yO = Y(o), yC = Y(c);
       const top = Math.min(yO, yC);
@@ -10751,16 +10770,35 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
         + `<rect x="${(x - bodyW / 2).toFixed(2)}" y="${top.toFixed(1)}" width="${bodyW.toFixed(2)}" height="${h.toFixed(1)}" rx="0.7"/></g>`;
     }).join('');
 
-    const maPath = (win) => {
-      const seg = [];
+    const maSeries = (win) => {
+      const out = [];
       for (let i = 0; i < n; i++) {
         if (i + 1 < win) continue;
         let sum = 0;
         for (let j = i + 1 - win; j <= i; j++) sum += sc(pts[j]);
-        seg.push(`${seg.length ? 'L' : 'M'}${X(i).toFixed(1)} ${Y(sum / win).toFixed(1)}`);
+        out.push({ i, v: sum / win });
       }
-      return seg.join(' ');
+      return out;
+    };
+    const maPath = (win) => maSeries(win)
+      .map((q, k) => `${k ? 'L' : 'M'}${X(q.i).toFixed(1)} ${Y(q.v).toFixed(1)}`).join(' ');
+    const maLabel = (win, cls) => {
+      const s = maSeries(win);
+      if (!s.length) return '';
+      const last = s[s.length - 1];
+      return { cls, y: Y(last.v), text: `<text class="kl-ma-lbl ${cls}" x="${M.l + pw + 5}" y="${Y(last.v).toFixed(1)}" text-anchor="start">${last.v.toFixed(0)}</text>` };
     };
+    const lab10 = maLabel(10, 'm10'), lab5 = maLabel(5, 'm5');
+    const maLabels = (() => {
+      if (!lab5 || !lab10) return `${lab10 ? lab10.text : ''}${lab5 ? lab5.text : ''}`;
+      let y5 = lab5.y, y10 = lab10.y;
+      if (Math.abs(y5 - y10) < 10) {
+        const top = Math.min(y5, y10), bot = Math.max(y5, y10);
+        y5 = top - 6; y10 = bot + 6;
+      }
+      return `<text class="kl-ma-lbl m10" x="${M.l + pw + 5}" y="${y10.toFixed(1)}" text-anchor="start">${maSeries(10).slice(-1)[0].v.toFixed(0)}</text>`
+        + `<text class="kl-ma-lbl m5" x="${M.l + pw + 5}" y="${y5.toFixed(1)}" text-anchor="start">${maSeries(5).slice(-1)[0].v.toFixed(0)}</text>`;
+    })();
 
     let hiP = pts[0], loP = pts[0];
     for (const p of pts) {
@@ -10779,8 +10817,9 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 
     const tickStep = n > 60 ? 10 : 5;
     const ages = pts.filter((p) => p.age % tickStep === 0).map((p) =>
-      `<text class="kl-lbl age" x="${X(pts.indexOf(p)).toFixed(1)}" y="${M.t + ph + 14}" text-anchor="middle">${p.age}</text>`).join('');
-    const xNote = `<text class="kl-lbl" x="${M.l + pw / 2}" y="${H - 4}" text-anchor="middle">年龄（岁）</text>`;
+      `<text class="kl-lbl age" x="${X(pts.indexOf(p)).toFixed(1)}" y="${(yb + 14).toFixed(1)}" text-anchor="middle">${p.age}</text>`).join('');
+    const xNote = `<text class="kl-lbl axis" x="${M.l}" y="${(H - 6).toFixed(1)}">年龄（岁）</text>`
+      + `<text class="kl-lbl axis" x="${M.l + pw}" y="${(H - 6).toFixed(1)}" text-anchor="end">每岁一分 · 满分 100</text>`;
 
     const legend = `<div class="kl-legend"><span><i class="up"></i>阳线：比上一岁高</span>`
       + `<span><i class="down"></i>阴线：比上一岁低</span>`
@@ -10789,8 +10828,13 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 
     return `<div class="mp-kline-fig">
       <svg viewBox="0 0 ${W} ${H}" role="img" aria-label="人生K线：1 到 ${n} 岁的逐年评分蜡烛图">
-        ${bands}${grid}${candles}
-        <path class="kl-ma m10" d="${maPath(10)}"/><path class="kl-ma m5" d="${maPath(5)}"/>
+        <defs><clipPath id="${clipId}"><rect x="${M.l}" y="${M.t}" width="${pw}" height="${ph}"/></clipPath></defs>
+        ${bands}${grid}
+        <g clip-path="url(#${clipId})">
+          ${candles}
+          <path class="kl-ma m10" d="${maPath(10)}"/><path class="kl-ma m5" d="${maPath(5)}"/>
+        </g>
+        ${maLabels}
         ${mark(hiP, 'hi', -8)}${mark(loP, 'lo', 12)}
         ${ages}${xNote}
       </svg>${legend}</div>`;
@@ -10809,9 +10853,27 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
     const worst = (Array.isArray(hl.worst) ? hl.worst : []).map((x) => `<div class="kl-hl lo">${esc(x)}</div>`).join('');
     const note = meta.boundaryNote ? `<div class="mp-kline-note">${esc(meta.boundaryNote)}</div>`
       : (hl.suppressed ? `<div class="mp-kline-note">${esc(hl.suppressed)}</div>` : '');
+    const pts = Array.isArray(r.points) ? r.points : [];
+    const scoreOf = (p) => (typeof p.score === 'number' && isFinite(p.score) ? p.score : 0);
+    const scores = pts.map(scoreOf);
+    const mean = scores.length ? scores.reduce((a, b) => a + b, 0) / scores.length : 0;
+    const span = scores.length ? Math.max(...scores) - Math.min(...scores) : 0;
+    const segAvg = segs.map((s) => {
+      const inside = pts.filter((p) => p.age >= s.startAge && p.age <= s.endAge).map(scoreOf);
+      return { ganZhi: s.ganZhi, v: inside.length ? inside.reduce((a, b) => a + b, 0) / inside.length : 0 };
+    }).filter((x) => x.v > 0).sort((a, b) => b.v - a.v);
+    const blocked = !!(st.boundary || hl.suppressed);
+    const statCells = [`<span><em>全段均值</em><b>${mean.toFixed(0)}</b></span>`];
+    if (!blocked && segAvg.length) {
+      statCells.push(`<span><em>最好大运</em><b class="hi">${esc(segAvg[0].ganZhi)} ${segAvg[0].v.toFixed(0)}</b></span>`);
+      statCells.push(`<span><em>最差大运</em><b class="lo">${esc(segAvg[segAvg.length - 1].ganZhi)} ${segAvg[segAvg.length - 1].v.toFixed(0)}</b></span>`);
+    }
+    statCells.push(`<span><em>波动幅度</em><b>${span.toFixed(0)}</b></span>`);
+    const stats = `<div class="kl-stats">${statCells.join('')}</div>`;
     return `<section class="mp-kline" aria-label="人生K线结果">
       <div class="mp-kline-h"><b>人生 K 线</b><span>${esc(meta.birth || '')}　日主 ${esc(meta.dayMaster || '')}　${esc(st.level || '')}${st.score ? `（${st.score}）` : ''}</span></div>
       ${chart}
+      ${stats}
       ${chips ? `<div class="kl-segs">${chips}</div>` : ''}
       ${best || worst ? `<div class="kl-hls">${best}${worst}</div>` : ''}
       ${note}

package/engine/geo.js

@@ -143,7 +143,7 @@ const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
 /** OpenStreetMap Nominatim：免密钥、支持中文。失败返回 null。
  *  UA 按 OSM 使用政策要求写明应用与联系方式（改版本时同步这里）。 */
-const USER_AGENT = 'dsh-metaphysics/0.18.2 (+https://github.com/xuanfu-web/dsh-metaphysics)';
+const USER_AGENT = 'dsh-metaphysics/0.18.3 (+https://github.com/xuanfu-web/dsh-metaphysics)';
 
 async function onlineLookup(text, { timeoutMs = 2500 } = {}) {
   if (typeof fetch !== 'function') return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.18.2",
+  "version": "0.18.3",
   "type": "module",
   "description": "命理排盘（玄学 xuanxue）for DeepSeek Harness: seventeen systems — eight chart systems (BaZi four pillars, Zi Wei Dou Shu, LiuYao, MeiHua, Da Liu Ren, Qi Men Dun Jia, compatibility charts, Tarot) plus nine quick references (almanac, date selection, bone-weight fortune, Xiao Liu Ren, horoscope, numerology, life-curve, feng shui, name analysis); ask-driven interpretation, report layer with evidence and confidence, DST correction for 1986–1991. All computed locally, networking off by default — as an agent tool plus a Web panel.",
   "keywords": [