dsh-metaphysics 0.18.1 → 0.18.3

package/CHANGELOG.md

@@ -2,14 +2,42 @@
 
 版本按「一组可感知的改动」发，README 与市场条目描述随能力同步。
 
-## 0.18.1（未发布）
-
-元数据与检索入口同步，**无运行时行为变化**：
-
-- 把「玄学 / 算命 / 占卜 / 运势」加进 `package.json` 关键词与描述、`locale/*.json`、市场条目描述、README 与工具描述——之前只写「命理排盘」，用户搜「玄学」搜不到；现在搜「玄学」应能命中
-- 工具描述补一条触发条件：用户只搜「玄学」或问「有什么玄学工具」时也应介绍本插件
-- 排盘逻辑、输出与测试断言不变；仅 UA 随版本号更新（`dsh-metaphysics/0.18.1`）
-
+## 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」升级成真正的蜡烛图，并嵌进八字结果：
+
+- 新增 `PP.trendChart` / `PP.trendHTML`：实体＝该岁相对上一岁的涨跌、影线＝±4 分；叠 5 年 / 10 年均线、
+  大运交替底色与分界虚线（段名标顶部）、0–100 固定量程网格、年龄刻度、最高/最低岁标记；悬停看逐年
+  「多少岁 / 哪一年 / 什么干支 / 多少分 / 落在哪步大运」。颜色全走 CSS 变量，深浅色与打印跟随
+- 「人生K线」tab 不再输出纯文本摘要，直接给图 + 大运分段 chips + 高低年份；数据不足或空值时安全退回文本
+- **八字结果底部直接嵌同一张 K 线**（面板与独立页在排八字时顺带算一次 `trend`），与原有的
+  「人生运势曲线」（大运阶梯 + 流年折线）并存：曲线看趋势形态，K 线看逐年涨跌
+- 新增 `test/kline.test.mjs`（23 条）：结构、坐标不越界、无 NaN、空/单点安全、旺衰边界不出高低结论、
+  两处嵌入点都在源码里
+- 统计：58 个测试文件 / 1644 条断言
+
+## 0.18.1（已发布）
+
+元数据与检索入口同步，**无运行时行为变化**：
+
+- 把「玄学 / 算命 / 占卜 / 运势」加进 `package.json` 关键词与描述、`locale/*.json`、市场条目描述、README 与工具描述——之前只写「命理排盘」，用户搜「玄学」搜不到；现在搜「玄学」应能命中
+- 工具描述补一条触发条件：用户只搜「玄学」或问「有什么玄学工具」时也应介绍本插件
+- 排盘逻辑、输出与测试断言不变；仅 UA 随版本号更新（`dsh-metaphysics/0.18.1`）
+
 ## 0.18.0（已发布）
 
 吸收同生态另一款命理插件「玄机阁」（dsh-xuanji，MIT）的能力：**按行为规格独立实现，不 vendor 源码、

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 岁逐年分、K 线形态、分大运 ASCII 走势与最佳/最差年份；旺衰正好落在换档阈值（±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 条卦例对拍、57 个测试文件/1621 条断言、七道闸、口径与已知边界），离线可开
+- **方法与验证**：独立页内置同页「方法与验证」（体系、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.1 (+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;
@@ -9656,6 +9656,57 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 .mp-curve .cv-legend i{display:inline-block;width:14px;height:2px;vertical-align:3px;margin-right:4px}
 .mp-curve .cv-tip{font-size:11px;color:var(--muted);line-height:1.6;margin-top:4px}
 @media (max-width:520px){.mp-curve .cv-lbl.age{font-size:9px}}
+.mp-kline{margin-top:10px;border:1px solid var(--line);border-radius:8px;background:var(--card);padding:10px 12px 9px}
+.mp-kline-h{display:flex;align-items:baseline;gap:10px;flex-wrap:wrap;font-size:12px;color:var(--label);font-family:system-ui,sans-serif;margin-bottom:2px}
+.mp-kline-h b{font-size:12.5px;color:var(--ink);font-weight:600}
+.mp-kline-h span{font-size:11.5px;color:var(--muted)}
+.mp-kline-fig svg{display:block;width:100%;height:auto;overflow:visible}
+.mp-kline .kl-band{fill:var(--ink);opacity:.045}
+.mp-kline .kl-grid{stroke:var(--line);stroke-width:.5;stroke-dasharray:1 4;opacity:.7}
+.mp-kline .kl-grid.mid{stroke-width:.8;stroke-dasharray:3 3;opacity:.9}
+.mp-kline .kl-segline{stroke:var(--dimline);stroke-width:.6;stroke-dasharray:2 3;opacity:.8}
+.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}
+.mp-kline .kl-c.down rect{fill:var(--lu);opacity:.92}
+.mp-kline .kl-c:hover rect{opacity:1}
+.mp-kline .kl-ma{fill:none;stroke-linejoin:round;stroke-linecap:round}
+.mp-kline .kl-ma.m5{stroke:var(--quan);stroke-width:1.3}
+.mp-kline .kl-ma.m10{stroke:var(--ke);stroke-width:1;opacity:.85}
+.mp-kline .kl-mark circle{fill:var(--quan)}
+.mp-kline .kl-mark.lo circle{fill:var(--ke)}
+.mp-kline .kl-mark .ring{fill:none;stroke:currentColor;stroke-width:.6;opacity:.5}
+.mp-kline .kl-mark text{fill:var(--ink2);font-size:9px;font-family:system-ui,sans-serif;paint-order:stroke;stroke:var(--card);stroke-width:2.4px;stroke-linejoin:round}
+.mp-kline .kl-legend{display:flex;gap:12px;flex-wrap:wrap;margin-top:6px;font-size:11px;color:var(--muted);font-family:system-ui,sans-serif}
+.mp-kline .kl-legend i{display:inline-block;width:9px;height:9px;vertical-align:-1px;margin-right:4px;border-radius:1px}
+.mp-kline .kl-legend i.up{background:var(--ji)}
+.mp-kline .kl-legend i.down{background:var(--lu)}
+.mp-kline .kl-legend i.m5{height:2px;background:var(--quan);vertical-align:3px}
+.mp-kline .kl-legend i.m10{height:2px;background:var(--ke);vertical-align:3px}
+.kl-segs{display:flex;flex-wrap:wrap;gap:4px 6px;margin-top:8px;font-family:system-ui,sans-serif}
+.kl-chip{font-size:11px;color:var(--ink2);border:1px solid var(--hair);border-radius:99px;padding:1px 8px;background:var(--band)}
+.kl-chip em{font-style:normal;color:var(--muted);margin-left:5px;font-size:10.5px}
+.kl-hls{display:flex;flex-direction:column;gap:3px;margin-top:8px;font-size:11.5px;font-family:system-ui,sans-serif;color:var(--ink2)}
+.kl-hl{border-left:2px solid var(--line);padding-left:7px;line-height:1.6}
+.kl-hl.hi{border-color:var(--quan)}
+.kl-hl.lo{border-color:var(--ke)}
+.mp-kline-note{font-size:11px;color:var(--red);line-height:1.6;margin-top:6px}
+.mp-kline-tip{font-size:11px;color:var(--muted);line-height:1.6;margin-top:5px}
+@media print{.mp-kline{break-inside:avoid}}
 .mp-tt{padding:16px}
 .mp-tt-head{font-size:12.5px;color:var(--muted);margin-bottom:12px;letter-spacing:.04em}
 .mp-tt-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(172px,1fr));gap:10px}
@@ -10665,6 +10716,171 @@ 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 = 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;
+    const X = (i) => M.l + (i + 0.5) * step;
+    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);
+      const i1 = Math.min(n - 1, s.endAge - 1);
+      if (i1 < i0) return '';
+      const x = M.l + i0 * step;
+      const w = Math.max(0.6, (i1 - i0 + 1) * step);
+      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="${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) =>
+      `<line class="kl-grid${v === 50 ? ' mid' : ''}" x1="${M.l}" y1="${Y(v).toFixed(1)}" x2="${M.l + pw}" y2="${Y(v).toFixed(1)}"/>`
+      + `<text class="kl-lbl" x="${M.l - 6}" y="${(Y(v) + 3).toFixed(1)}" text-anchor="end">${v}</text>`).join('');
+
+    const candles = pts.map((p, i) => {
+      const k = p.kline || {};
+      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);
+      const h = Math.max(0.8, Math.abs(yO - yC));
+      const x = X(i);
+      const title = `${p.age}岁（${p.year}年 ${p.ganZhi}）${c}分${p.dayunGanZhi ? ` · ${p.dayunGanZhi}运` : ''}`;
+      return `<g class="kl-c${up ? ' up' : ' down'}"><title>${esc(title)}</title>`
+        + `<line x1="${x.toFixed(2)}" y1="${Y(hi).toFixed(1)}" x2="${x.toFixed(2)}" y2="${Y(lo).toFixed(1)}"/>`
+        + `<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 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]);
+        out.push({ i, v: sum / win });
+      }
+      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) {
+      if (sc(p) > sc(hiP)) hiP = p;
+      if (sc(p) < sc(loP)) loP = p;
+    }
+    const mark = (p, cls, dy) => {
+      const i = pts.indexOf(p);
+      const x = X(i), y = Y(sc(p));
+      const tx = Math.min(Math.max(x, M.l + 26), M.l + pw - 26);
+      const d = cls === 'hi' ? (y - 8 < M.t + 6 ? 14 : dy) : (y + 12 > M.t + ph - 2 ? -8 : dy);
+      return `<g class="kl-mark ${cls}"><circle cx="${x.toFixed(1)}" cy="${y.toFixed(1)}" r="2"/>`
+        + `<circle class="ring" cx="${x.toFixed(1)}" cy="${y.toFixed(1)}" r="4.6"/>`
+        + `<text x="${tx.toFixed(1)}" y="${(y + d).toFixed(1)}" text-anchor="middle">${p.age}岁 ${sc(p)}</text></g>`;
+    };
+
+    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="${(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>`
+      + `<span><i class="m5"></i>5 年均线</span><span><i class="m10"></i>10 年均线</span>`
+      + '<span>虚线＝大运交界</span></div>';
+
+    return `<div class="mp-kline-fig">
+      <svg viewBox="0 0 ${W} ${H}" role="img" aria-label="人生K线：1 到 ${n} 岁的逐年评分蜡烛图">
+        <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>`;
+  };
+
+  pp.trendHTML = function (r) {
+    if (!r) return '';
+    const chart = pp.trendChart(r);
+    if (!chart) return pp.quickHTML(r);
+    const segs = Array.isArray(r.segments) ? r.segments : [];
+    const hl = (r.highlights && typeof r.highlights === 'object') ? r.highlights : {};
+    const meta = r.meta || {};
+    const st = meta.strength || {};
+    const chips = segs.map((s) => `<span class="kl-chip">${esc(s.ganZhi)}<em>${s.startAge}–${s.endAge}</em></span>`).join('');
+    const best = (Array.isArray(hl.best) ? hl.best : []).map((x) => `<div class="kl-hl hi">${esc(x)}</div>`).join('');
+    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}
+      <div class="mp-kline-tip">逐岁分数由大运与流年十神按固定表确定性计分（1–100），只表五行力量的顺逆，不预测具体事件；旺衰落在换档阈值附近时，不出高低年份结论。</div>
+    </section>`;
+  };
+
   pp.baziHTML = function (r) {
     const cols = [['year', '年柱'], ['month', '月柱'], ['day', '日柱'], ['hour', '时柱']];
     const SHORT = { year: '年', month: '月', day: '日', hour: '时' };
@@ -11326,6 +11542,19 @@ function App() {
         }
       }
       const r = Engine.compute(args);
+      let trend = null;
+      if (k === 'bazi') {
+        try {
+          trend = Engine.compute({
+            system: 'trend', datetime, gender: genderV, toAge: 100,
+            trueSolar, lateZi,
+            ...(args.dst !== undefined ? { dst: args.dst } : {}),
+            ...(args.address ? { address: args.address } : {}),
+            ...(typeof args.longitude === 'number' ? { longitude: args.longitude } : {}),
+            ...(args.geo ? { geo: args.geo } : {}),
+          });
+        } catch (e) { trend = null; }
+      }
       const ask = (needAsk(k) || k === 'qimen')
         ? { question: needAsk(k) ? question.trim() : '', direction }
         : undefined;
@@ -11334,7 +11563,7 @@ function App() {
         it.sections = [...(it.sections || []), { key: 'crossSystem', label: '八字 × 紫微 交叉验证', text: Engine.crossText(r.cross) }];
       }
       const timed = kindOf(k) === 'cast' && (k !== 'meihua' || mh === 'time');
-      setResult({ kind: k, r, it, at: dt, timed });
+      setResult({ kind: k, r, it, at: dt, timed, trend });
       setFx(null); setFit(null); setPastMarks({}); setRectRes(null);
       setError('');      setCopied('');
       if (k !== 'tarot') {
@@ -11761,14 +11990,15 @@ function App() {
       dangerouslySetInnerHTML: {
         __html: castAtHTML(result) + PP.resultWithInterpret(
           result.kind === 'ziwei' ? PP.ziweiHTML(result.r)
-            : result.kind === 'bazi' ? PP.baziHTML(result.r)
+            : result.kind === 'bazi' ? (PP.baziHTML(result.r) + (result.trend ? PP.trendHTML(result.trend) : ''))
               : result.kind === 'meihua' ? PP.meihuaHTML(result.r)
                 : result.kind === 'daliuren' ? PP.daliurenHTML(result.r)
                   : result.kind === 'qimen' ? (PP.qimenHTML(result.r) + PP.qimenFactsHTML(result.r))
                   : result.kind === 'hepan' ? (result.r.chart === 'ziwei' ? PP.ziweiHepanHTML(result.r) : PP.hepanHTML(result.r))
                   : result.kind === 'tarot' ? PP.tarotHTML(result.r)
                     : result.kind === 'liuyao' ? PP.liuyaoHTML(result.r)
-                      : PP.quickHTML(result.r),
+                      : result.kind === 'trend' ? PP.trendHTML(result.r)
+                        : PP.quickHTML(result.r),
           result.it,
           { folded: defaultFolded() },
         ),

package/engine/geo.js

@@ -143,7 +143,7 @@ const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
 /** OpenStreetMap Nominatim：免密钥、支持中文。失败返回 null。
  *  UA 按 OSM 使用政策要求写明应用与联系方式（改版本时同步这里）。 */
-const USER_AGENT = 'dsh-metaphysics/0.18.1 (+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.1",
+  "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": [