dsh-metaphysics 0.57.0 → 0.59.0

package/engine/bridge.js

@@ -0,0 +1,211 @@
+// C3 对话桥替代方案：深链 / 复制 / 结构化参数。
+//
+// 背景：面板原本靠会话槽位 conversation.input.right 拿 inputActions，再把提问写进输入框。
+// 那个槽位不稳定（宿主改过名、也可能根本没声明），桥一断用户就没有路把盘送进对话。
+// 这里给三条不依赖宿主的通道，桥能用时仍然优先用桥：
+//
+//   1. 深链：把「排这张盘用的参数」编码进 URL 片段（#mp=<handle>&q=<问题>）。
+//      打开链接的人（换台机器、发给朋友、自己收藏）能还原同一张盘，不必重报出生信息。
+//   2. 复制：两档现成文本——完整提问（含盘面摘要与回答骨架）与一句话精简版。
+//   3. 结构化参数：一段 JSON，助手可以直接拿 args 去调 compute，不必解析自然语言。
+//
+// 约定：
+//   * 深链里用的是 C1 句柄（mc1.<body>.<校验位>），所以截断/改字会明确报错，不会静默排成另一张盘；
+//   * 链接只带「排盘参数 + 一句问题」，不带摘要、不带解析——摘要可能有好几 KB，URL 装不下；
+//   * 这里只做编解码与文案拼装，不排盘、不调用模型，node 与浏览器都能跑（不依赖 Buffer / btoa）。
+import { encodeHandle, decodeHandle, HANDLE_PREFIX } from './handle.js';
+import { askPrompt } from './followup.js';
+
+/** 问题进链接前截断的长度：再长就交给「复制完整提问」那一档 */
+export const LINK_MAX_QUESTION = 200;
+/** 精简版里问题的截断长度 */
+const BRIEF_MAX_QUESTION = 60;
+
+const SYSTEM_LABEL = {
+  bazi: '八字', ziwei: '紫微', liuyao: '六爻', meihua: '梅花', daliuren: '大六壬',
+  qimen: '奇门', hepan: '合盘', tarot: '塔罗', almanac: '黄历', zeri: '择日',
+  chenggu: '称骨', xiaoliuren: '小六壬', star: '星座', numerology: '生命数字',
+  mbti: '人格', trend: '人生K线', fengshui: '风水', name: '起名', convert: '农历',
+};
+
+const labelOf = (system) => SYSTEM_LABEL[system] || system || '未知体系';
+
+/** 只保留 URL 片段能用的一段：去掉已有 hash，其余原样 */
+function baseOf(base) {
+  const s = String(base || '');
+  const i = s.indexOf('#');
+  return i < 0 ? s : s.slice(0, i);
+}
+
+function encodeQuestion(q) {
+  try { return encodeURIComponent(q); } catch (e) { return ''; }
+}
+
+function decodeQuestion(s) {
+  try { return decodeURIComponent(s); } catch (e) { return String(s || ''); }
+}
+
+/**
+ * 参数 → 深链。没有可编码的参数（或参数里只有输出开关）时返回 ''。
+ *
+ * askLink({ system: 'bazi', datetime: '1990-05-12T14:30', gender: 'female' }, { question: '2027 年事业', base: url })
+ *   → '<url>#mp=mc1.xxx.yyy&q=2027%20%E5%B9%B4%E4%BA%8B%E4%B8%9A'
+ *
+ * 也接受现成句柄：askLink({ handle: r.handle }, { question, base })。
+ */
+export function askLink(args = {}, opts = {}) {
+  const o = opts || {};
+  const raw = String(o.handle || (args && args.handle) || '').trim();
+  const handle = raw || encodeHandle(args || {});
+  if (!handle || !handle.startsWith(HANDLE_PREFIX)) return '';
+  const q = String(o.question || '').trim().slice(0, LINK_MAX_QUESTION);
+  const parts = [`mp=${handle}`];
+  if (q) parts.push(`q=${encodeQuestion(q)}`);
+  return `${baseOf(o.base)}#${parts.join('&')}`;
+}
+
+/**
+ * 深链 → 参数。任何不合法都不抛异常，返回 { ok:false, code, message }，由调用方决定是
+ * 静默忽略还是提示一句——分享出去的老链接、被聊天软件截断的链接都会走到这里。
+ *
+ * 认这几种写法：完整 URL、只有片段（#mp=…）、只有查询串（?mp=…）、裸的 mp=…
+ */
+export function parseAskLink(text) {
+  const raw = String(text || '').trim();
+  if (!raw) return { ok: false, code: 'E_LINK', message: '没有链接内容：请粘贴带 #mp= 的完整链接' };
+
+  // 片段的优先级高于查询串：链接里同时有时，以片段为准（那是本插件自己写的）
+  let body = '';
+  const hashAt = raw.indexOf('#');
+  if (hashAt >= 0 && raw.slice(hashAt + 1).trim()) body = raw.slice(hashAt + 1).trim();
+  else {
+    const qAt = raw.indexOf('?');
+    if (qAt >= 0 && raw.slice(qAt + 1).trim()) body = raw.slice(qAt + 1).trim();
+    else if (/^mp=/.test(raw)) body = raw;
+  }
+  if (!body) return { ok: false, code: 'E_LINK', message: '链接里没有 #mp= 片段：这不是本插件生成的深链' };
+
+  const fields = {};
+  for (const seg of body.split('&')) {
+    if (!seg) continue;
+    const eq = seg.indexOf('=');
+    if (eq <= 0) continue;
+    const k = seg.slice(0, eq);
+    const v = seg.slice(eq + 1);
+    if (k === 'mp') fields.mp = v;
+    else if (k === 'q') fields.q = v;
+  }
+  if (!fields.mp) return { ok: false, code: 'E_LINK', message: '链接里没有 mp 参数（只有问题没有盘）：无法还原盘面' };
+
+  let args;
+  try {
+    args = decodeHandle(fields.mp);
+  } catch (e) {
+    return { ok: false, code: (e && e.code) || 'E_HANDLE', message: (e && e.message) || '句柄无法解析' };
+  }
+  const question = fields.q ? decodeQuestion(fields.q).slice(0, LINK_MAX_QUESTION) : '';
+  return {
+    ok: true,
+    handle: fields.mp,
+    args,
+    question,
+    system: args.system || '',
+    label: labelOf(args.system),
+  };
+}
+
+const splitDateTime = (dt) => {
+  const m = /^(\d{4}-\d{1,2}-\d{1,2})[T ](\d{1,2}:\d{2})/.exec(String(dt || '').trim());
+  if (!m) return { date: '', time: '' };
+  const [y, mo, d] = m[1].split('-');
+  return { date: `${y}-${String(mo).padStart(2, '0')}-${String(d).padStart(2, '0')}`, time: m[2].padStart(5, '0') };
+};
+
+/**
+ * 这些参数能原样填回表单；其余（partner / candidates / answers / mode / upper …）
+ * 由调用方提示「未还原」——只报真的填回去的，不假装全还原了。
+ */
+const FORM_KEYS = ['gender', 'address', 'trueSolar', 'lateZi', 'lines'];
+
+/**
+ * 深链 → 表单初值。面板与独立页共用一份，避免两边各自猜字段名。
+ * 返回 { tab, date, time, ... , question, restored[], rest{} }；rest 是没还原的参数，用于如实提示。
+ */
+export function formOf(parsed) {
+  const p = parsed && parsed.ok ? parsed : null;
+  const args = (p && p.args) || {};
+  const dt = splitDateTime(args.datetime);
+  const out = {
+    tab: args.system || '',
+    date: dt.date,
+    time: dt.time,
+    question: (p && p.question) || '',
+    restored: [],
+    rest: {},
+  };
+  if (out.tab) out.restored.push('system');
+  if (dt.date) out.restored.push('datetime');
+  for (const k of FORM_KEYS) {
+    if (args[k] === undefined || args[k] === null) continue;
+    out[k] = args[k];
+    out.restored.push(k);
+  }
+  // 问题不是盘面参数，但它跟着链接走，单独记一笔
+  if (out.question) out.restored.push('question');
+  for (const [k, v] of Object.entries(args)) {
+    if (k === 'system' || k === 'datetime' || FORM_KEYS.includes(k)) continue;
+    out.rest[k] = v;
+  }
+  return out;
+}
+
+/** 未还原参数的提示文案：空对象返回 ''（不打扰） */
+export function restNote(form) {
+  const keys = Object.keys((form && form.rest) || {});
+  if (!keys.length) return '';
+  return `链接里还有 ${keys.length} 项没填回表单（${keys.join('、')}）：这些只在引擎调用里生效，页面上按默认值显示。`;
+}
+
+/**
+ * 一张盘 → 三档复制文本 + 深链。
+ *
+ *   full       完整提问（与桥发出去的是同一份，含盘面摘要、层次与回答骨架）
+ *   brief      一句话版：体系 + 句柄 + 问题，够助手认出是哪张盘
+ *   structured 结构化参数（JSON），助手可直接照 args 调 compute
+ *   link       深链（没有句柄时为空）
+ */
+export function askPackages(result, opts = {}) {
+  const o = opts || {};
+  const r = result || {};
+  const system = r.system || '';
+  const label = labelOf(system);
+  const question = String(o.question || '').trim();
+  const handle = String(r.handle || '').trim();
+
+  let full = '';
+  try {
+    const p = askPrompt(r, { question, interpret: o.interpret });
+    full = (p && p.text) || String(r.summary || '');
+  } catch (e) {
+    full = String(r.summary || '');
+  }
+
+  const briefQ = question
+    ? (question.length > BRIEF_MAX_QUESTION ? `${question.slice(0, BRIEF_MAX_QUESTION)}…` : question)
+    : '（未填问题：按摘要讲主线）';
+  const brief = handle
+    ? `【命理追问】${label}｜${handle}｜问：${briefQ}`
+    : `【命理追问】${label}｜问：${briefQ}`;
+
+  const args = {};
+  if (handle) args.handle = handle;
+  if (system) args.system = system;
+  if (question) args.question = question;
+  const structured = JSON.stringify({ tool: 'metaphysics', v: 1, args }, null, 2);
+
+  const link = handle ? askLink({ handle }, { question, base: o.base }) : '';
+
+  return { system, label, handle, question, full, brief, structured, link };
+}
+
+export default askPackages;

package/engine/citations.js

@@ -25,6 +25,11 @@ export const CITATION_BOOKS = {
     author: '佚名',
     base: 'https://www.diancang.xyz/xuanxuewushu/qiongtongbaojian/',
   },
+  daliuren: {
+    name: '大六壬大全',
+    author: '明·郭载騋校（四库全书本）',
+    base: 'https://zh.wikisource.org/wiki/六壬大全',
+  },
   qimen: {
     name: '奇门遁甲统宗',
     author: '旧题诸葛亮（传）',
@@ -35,6 +40,11 @@ export const CITATION_BOOKS = {
     author: '宋·邵雍（传）',
     base: 'https://www.diancang.xyz/xuanxuewushu/meihuayishu/',
   },
+  ditian: {
+    name: '滴天髓',
+    author: '明·京图（通行本）',
+    base: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/',
+  },
   liuyao: {
     name: '增删卜易',
     author: '清·野鹤老人',
@@ -437,6 +447,87 @@ export const CITATIONS = [
     plain: '应期先分动静：静爻在逢值或逢冲之日应，动爻在逢合或逢值之日应；其余按入墓、旬空、月破等逐条推。',
     url: 'https://zh.wikisource.org/wiki/增刪卜易/26又3',
   },
+  {
+    id: 'dl-jigong',
+    book: 'daliuren',
+    chapter: '卷一·起例（十干寄宫）',
+    quote: '甲课寅兮乙课辰，丙戊课巳不须论。丁己课未庚申上，辛戌壬亥是其真。癸课原来丑宫坐，分明不用四正神。',
+    plain: '十干寄宫是四课起手：甲寄寅、乙寄辰、丙戊寄巳、丁己寄未、庚寄申、辛寄戌、壬寄亥、癸寄丑；丙戊、丁己各同宫，子午卯酉四个正位不寄。',
+    url: 'https://zh.wikisource.org/wiki/六壬大全/1',
+  },
+  {
+    id: 'dl-zeike',
+    book: 'daliuren',
+    chapter: '卷一·起例（贼克法）',
+    quote: '取课先从下贼呼，如无下贼上克初。初传之上名中次，中上加临是末居。三传既定天盘将，此是入式法第一。',
+    plain: '九宗门取初传先看下贼上，没有下贼再看上克下；初传定后，中传取初传所乘之神，末传再顺取一位，三传齐了才布天盘天将。',
+    url: 'https://zh.wikisource.org/wiki/六壬大全/1',
+  },
+  {
+    id: 'dl-yuejiang',
+    book: 'daliuren',
+    chapter: '卷二·神将释（月将）',
+    quote: '逆布者谓之月将，其实即十二神也。',
+    plain: '月将就是十二支神，按太阳过宫排：以登明为首逆布十二宫；起课时把月将加在占时上，顺布成天盘。',
+    url: 'https://zh.wikisource.org/wiki/六壬大全/2',
+  },
+  {
+    id: 'dt-yiqi-tonggen',
+    book: 'ditian',
+    chapter: '干支总论',
+    quote: '天全一气，不可使地德莫之载。地全三物，不可使天道莫之容。',
+    plain: '四柱天干同属一气，还得地支能承载它；地支所藏三干若不透到天干，也显不出用处——通根与透出是一件事的两面。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+    // 2026-11-01 复核：这一句是《子平真诠》论十干十二支注文里明确引作《滴天髓》的话，
+    // 在滴天髓底本（干支总论）里能逐字对上，所以才是「通根透干」可核的原文。
+    note: '《子平真诠》卷一论十干十二支注文引作《滴天髓》语，底本干支总论原文可核。',
+  },
+  // ── 滴天髓·下篇六亲论（2026-11-01 从底本逐字录入，同一页：153092.html）
+  {
+    id: 'dt-liuqin-fuqi',
+    book: 'ditian',
+    chapter: '六亲论·夫妻',
+    quote: '夫妻因缘宿世来，喜神有意傍天财。',
+    plain: '看夫妻，落点在「喜神」与「财星」的相对位置：财是妻星，喜神是能护住用神的那一位。配偶这件事，看的是财星有没有被喜神照到，不是看盘里有没有财。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153092.html',
+    // 底本此篇为韵语提纲，各家注解分歧很大；这里只录原文，不把某家注解当原文引用。
+    note: '本句是六亲论的提纲韵语，正文各家用注解发挥，取义不一，故只作「有这一说」的原文凭据。',
+  },
+  {
+    id: 'dt-liuqin-zinv',
+    book: 'ditian',
+    chapter: '六亲论·子女',
+    quote: '子女根枝一世传，喜神看与杀相连。',
+    plain: '子女星取官杀，但成不成器要看喜神与杀的关系：有杀无喜，是压力；有喜有杀，才谈得上传承。单见官杀不作吉断。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153092.html',
+  },
+  {
+    id: 'dt-liuqin-fumu',
+    book: 'ditian',
+    chapter: '六亲论·父母',
+    quote: '父母或降与或替，岁月所关果非细。',
+    plain: '父母看年月两柱：位置定了，还要看这两柱是「降」（受制）还是「替」（得代），差别不小。这是把六亲落到宫位上，而不是只看印星。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153092.html',
+  },
+  {
+    id: 'dt-nvming-shensha',
+    book: 'ditian',
+    chapter: '六亲论·女命章',
+    quote: '论夫论子要安详，气静平和妇道章，三奇二德虚好语，咸池驿马半推详。',
+    plain: '这句是古籍自己在批神煞：三奇、二德这类吉神被叫作「虚好语」（空口说好话），咸池（桃花）、驿马只能「半推详」（顶多参考一半）。反对滥用神煞不是今人的意见，原文里就有。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153092.html',
+    // 2026-11-01 录入：这句是本插件「神煞显示但不参与判断」最直接的原文依据，
+    // 而且是《滴天髓》自己说的，比后人转述有力。注意「三奇二德」指三奇、天德月德一类吉神。
+    note: '「三奇二德虚好语，咸池驿马半推详」是滴天髓原文对神煞的贬语，可直接支撑「神煞不主吉凶」。',
+  },
+  {
+    id: 'dt-hezhi-fugui',
+    book: 'ditian',
+    chapter: '六亲论·何知章',
+    quote: '何知其人富，财气通门户。何知其人贵，官星有理会。何知其人贫，财神反不真。何知其人贱，官星还不见。',
+    plain: '富看财有没有「通门户」（财能流通到日主），贵看官星有没有「理会」（有制有化、有人承接）。反过来，贫是财星不真（有财而无用），贱是官星不见或不理。判词是四个可查的条件，不是形容词。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153092.html',
+  },
 ];
 
 const BOOK_OF = {
@@ -462,18 +553,28 @@ export const CARD_CITATIONS = {
   'bazi-geju': { refs: ['zp-yongshen'] },
   'bazi-suiyun': { refs: ['smt-suiyun'] },
   'bazi-sanming-duizhao': { refs: ['zp-zhenguan', 'smt-guansha-liu'] },
-  'bazi-geju-chengbai': { refs: ['zp-chengbai'] },
+  'bazi-geju-chengbai': { refs: ['zp-chengbai', 'dt-hezhi-fugui'] },
   'bazi-huagi-bianhua': { refs: ['zp-bianhua'] },
   'bazi-zaji-quyong': { refs: ['zp-zaji'] },
   'bazi-zhuanwang-yuanwen': { refs: ['smt-quzhi', 'smt-yanshang', 'smt-congge', 'smt-runxia', 'smt-jiasi'] },
   'bazi-congge-yuanwen': { refs: ['smt-congsha', 'smt-congcai'] },
   'bazi-tongguan': { refs: ['dt-tongguan'] },
   // ── 八字：通行说，暂未定位单一条文
-  'bazi-tonggen-tougan': { status: 'general', book: '滴天髓', chapter: '通神论', reason: '原文为「天干得一比肩，不如得支中一墓库」一路的取象，未定位到单一整句' },
+  'bazi-tonggen-tougan': {
+    refs: ['dt-yiqi-tonggen'],
+    // 通行说法（「地支所藏之干，本静以待用…干以通根为美，支以透出为贵」）常被署成《滴天髓》，
+    // 2026-11-01 核过：滴天髓底本与《子平真诠》沈孝瞻原文（论十干十二支）里都查不到这句，
+    // 它出现在《子平真诠》评注本该章的注文（附支藏人元图、人元司令表之后的按语）。
+    // 注文自身引的《滴天髓》「天全一气…」才是原本，故本卡只引可核的那句，注文只作说明不冒充原文。
+    note: '通行说两句出自《子平真诠》卷一注文，非《滴天髓》正文；注文所引的滴天髓句见本条。',
+  },
   'bazi-wangxiang': { refs: ['smt-wangxiang'] },
-  'bazi-shensha': { refs: ['smt-shensha'] },
+  // 神煞：三命通会条列名目，滴天髓女命章直接贬为「虚好语」「半推详」——两书合看才是全貌：
+  // 神煞是有的，只是不主吉凶。只引三命通会会让人以为本插件在给神煞背书。
+  'bazi-shensha': { refs: ['smt-shensha', 'dt-nvming-shensha'] },
   'bazi-tiaohou': { refs: ['qt-tiaohou'] },
-  'bazi-liuqin': { refs: ['smt-liuqin'] },
+  // 六亲：星宫同参，落点分别是夫妻（财与喜神）、子女（杀与喜神）、父母（年月宫位）
+  'bazi-liuqin': { refs: ['smt-liuqin', 'dt-liuqin-fuqi', 'dt-liuqin-zinv', 'dt-liuqin-fumu'] },
   'bazi-kongwang': { refs: ['smt-kongwang'] },
   'bazi-xingchong': { refs: ['smt-xingchong'] },
   'bazi-dayun-jiaoqi': { refs: ['smt-dayun-qiyun'] },
@@ -503,11 +604,13 @@ export const CARD_CITATIONS = {
   'liuyao-fuyin': { refs: ['zs-fuyin'] },
   'liuyao-jintui': { refs: ['zs-jintui'] },
   'liuyao-yingqi': { refs: ['zs-yingqi'] },
-  'liuyao-jintui-yong': { status: 'general', book: '增删卜易', chapter: '進神退神章、用神章', reason: '底本把进退落在「動而化」的吉凶喜忌与应期上，未见单列「用神化進／化退」条；按用神与忌神分档是本插件引申，不冒充原文' },
+  // 2026-11-01 复核：底本卷二·進神退神章第二十九原文「所喜者宜於化進，所忌者宜化退神」
+  // 已经把喜忌落在进退上，可作本条依据；把「喜／忌」具体落到用神／忌神两档仍是本插件的引申（见知识卡 note）
+  'liuyao-jintui-yong': { refs: ['zs-jintui'] },
   'liuyao-yingqi-exact': { status: 'todo', book: '增删卜易', chapter: '各門類應期總注章', reason: '逐条应期尚未实现，等 20+ 条有应验日期的卦例' },
   // ── 其他体系
   'meihua-tiyong': { refs: ['mh-tiyong'] },
-  'daliuren-sike': { status: 'general', book: '大六壬大全', chapter: '九宗门取传法', reason: '原文待录入；本环境无稳定可核验的公有领域章页' },
+  'daliuren-sike': { refs: ['dl-jigong', 'dl-zeike'] },
   'qimen-yinyang': { refs: ['qm-yinyang'] },
   'qimen-jixing': { refs: ['qm-jixing'] },
   'qimen-rumu': { refs: ['qm-rumu'] },

package/engine/diff.js

@@ -353,3 +353,57 @@ export const CALIBER_SWITCHES = {
     },
   ],
 };
+
+/**
+ * 口径并排：把「换口径后哪几条结论变了」抽成两列表格。
+ * 只读结果里的既有字段，不重算、不判定哪套更准；字段缺省时留空，不编值。
+ */
+export const CALIBER_VIEWS = {
+  bazi: [
+    { path: 'pillars.day.ganzhi', label: '日柱' },
+    { path: 'pillars.hour.ganzhi', label: '时柱' },
+    { path: 'strength.level', label: '旺衰' },
+    { path: 'frame.primaryName', label: '格局' },
+    { path: 'frame.yongshen.favor', label: '喜用' },
+    { path: 'dayun.jiao.at', label: '起运' },
+  ],
+  ziwei: [
+    { path: 'soul.ganzhi', label: '命宫' },
+    { path: 'body.branch', label: '身宫支' },
+    { path: 'bureau.name', label: '五行局' },
+    { path: 'bodyMaster', label: '身主' },
+    { path: 'daxianList.0.ages', label: '起大限' },
+  ],
+  qimen: [
+    { path: 'siZhu.day', label: '日柱' },
+    { path: 'ju', label: '局数' },
+    { path: 'zhiFu.star', label: '值符' },
+    { path: 'zhiShi.gate', label: '值使' },
+  ],
+};
+
+function pickPath(obj, path) {
+  let cur = obj;
+  for (const seg of String(path).split('.')) {
+    if (cur === null || cur === undefined) return undefined;
+    cur = cur[seg];
+  }
+  return cur;
+}
+
+/** 并排单元格：数组用「、」串起，缺省留空，不把 undefined 写成字符串 */
+export function viewCell(value) {
+  if (value === undefined || value === null) return '—';
+  if (Array.isArray(value)) return value.join('、');
+  if (typeof value === 'object') return '—';
+  return String(value);
+}
+
+export function viewRows(system, current, alt) {
+  const defs = CALIBER_VIEWS[system] || [];
+  return defs.map((d) => {
+    const a = viewCell(pickPath(current, d.path));
+    const b = viewCell(pickPath(alt, d.path));
+    return { key: d.path, label: d.label, current: a, alt: b, changed: a !== b };
+  });
+}