dsh-metaphysics 0.60.0 → 0.61.1

package/engine/zeri.js

@@ -1,7 +1,11 @@
-// 择日：逐日按黄历「建除简表宜忌」+ 建除神适配 + 冲属相排除打分排序。
-// 口径透明：这是排序引导，不是吉凶断语；未收录逐日神煞，冲煞按日支对生肖。
+// 择日：逐日按《协纪辨方书》卷十一「用事」命中宜忌，再用卷十「宜忌」六等与德神制化定吉凶方向，
+// 叠冲属相排除后排序。口径透明：这是排序引导，不是吉凶断语。
 import { fromJDN, toJDN } from './calendar.js';
 import { buildAlmanac, SHENGXIAO } from './almanac.js';
+import {
+  computeDayShensha, taskShenshaHits, xingHitText, gradeDay,
+  ZERI_SHENSHA_BASIS, ZERI_JUAN10_BASIS,
+} from './zeri-shensha.js';
 import { fail } from './fail.js';
 
 // 择日的入参错误一律带 E_INPUT：裸 new Error 到工具层只剩 [E_INTERNAL]，
@@ -65,20 +69,40 @@ const ZHIXING_FAVOR = {
   medical: ['除', '开'],
 };
 
-const VERDICT = (score, ctx) => {
+const VERDICT_RANK = { 推荐: 3, 可用: 2, 平平: 1, 回避: 0 };
+
+/** 由卷十「六等」与德神制化判定的决断，映射到界面用语。 */
+const verdictOf = (grade, ctx) => {
   if (ctx.chongSelf) {
     return { verdict: '回避', text: `当日冲${ctx.chongSelf}（当事人属相）：传统择日径直排除，不进推荐与可用名单。`, excluded: true };
   }
-  if (score >= 3) return { verdict: '推荐', text: '宜项与建除相配，此日对所问事项顺遂。', excluded: false };
-  if (score >= 1) {
+  const basis = `${grade.label}（${grade.doctrine}）→ ${grade.decision}`;
+  const tally = `吉 ${grade.ji}、凶 ${grade.xiong}`;
+  if (grade.forced.length) {
     return {
-      verdict: '可用',
-      text: ctx.jiHit.length ? `可考虑，但当日忌${ctx.jiHit.join('、')}：宜项加分、忌项减分，未抵消干净。` : '未见冲克，可用；若有更好的日子，优先取推荐日。',
+      verdict: '回避',
+      text: `卷十 ${grade.label}，但所问事项正在德神亦不解的余忌之列（${grade.forced.map((g) => g.name).join('、')}）：${grade.doctrine}，故仍忌。`,
       excluded: false,
     };
   }
-  if (score >= 0) return { verdict: '平平', text: ctx.jiHit.length ? `当日忌${ctx.jiHit.join('、')}，宜项不相干，不作首选。` : '宜忌不相干，无助力也无冲克。', excluded: false };
-  return { verdict: '回避', text: ctx.jiHit.length ? `当日忌${ctx.jiHit.join('、')}，对所问事项不宜。` : '减分项多于加分项，此日不宜。', excluded: false };
+  if (grade.decision === '从宜不从忌') {
+    if (grade.score >= 2) {
+      return { verdict: '推荐', text: `卷十作 ${basis}；${tally}，宜项足以胜忌。`, excluded: false };
+    }
+    return { verdict: '可用', text: `卷十作 ${basis}；${tally}，可用但助力不厚。`, excluded: false };
+  }
+  if (grade.decision === '从宜亦从忌') {
+    return { verdict: '可用', text: `卷十作 ${basis}；${tally}，宜忌并见，择时仍须避开忌项。`, excluded: false };
+  }
+  if (grade.decision === '不宜不忌') {
+    return { verdict: '平平', text: `卷十作 ${basis}；${tally}，无所助也无所忌。`, excluded: false };
+  }
+  if (grade.decision === '从忌不从宜') {
+    const why = ctx.avoidText.length ? `忌项：${ctx.avoidText.join('、')}。` : '';
+    return { verdict: '回避', text: `卷十作 ${basis}；${tally}，${why}此日对所问事项不宜。`, excluded: false };
+  }
+  const why = ctx.avoidText.length ? `忌项：${ctx.avoidText.join('、')}；` : '';
+  return { verdict: '回避', text: `卷十作 ${basis}；${tally}，${why}传统作诸事皆忌。`, excluded: false };
 };
 
 /**
@@ -160,21 +184,33 @@ export function buildZeri(input) {
 
   const makeRow = (p) => {
     const a = buildAlmanac(p);
-    let score = 0;
+    const monthBranch = a.ganzhi.month.slice(-1);
+    const dayInfo = computeDayShensha({
+      monthBranch,
+      dayGz: a.ganzhi.day,
+      xing: a.zhiXing,
+      lunarDay: a.lunar.day,
+    });
+    const hits = taskShenshaHits(task, dayInfo);
+
+    const grade = gradeDay(hits, dayInfo);
+    const favor = zhixingSet.includes(a.zhiXing);
+    const score = grade.score;
+
     const reasons = [];
-    const yiHit = spec.yi.filter((w) => a.yi.includes(w));
-    if (yiHit.length) { score += 2; reasons.push(`宜${yiHit.join('、')}（+2）`); }
-    const relHit = spec.related.filter((w) => a.yi.includes(w));
-    if (relHit.length) { score += 1; reasons.push(`关联宜项${relHit.join('、')}（+1）`); }
-    const jiHit = [...spec.yi, ...spec.related].filter((w) => a.ji.includes(w));
-    if (jiHit.length) { score -= 3; reasons.push(`忌${jiHit.join('、')}（-3）`); }
+    // 建除适配是现代简表，只作同分参考，不进卷十吉凶轻重。
+    if (favor) reasons.push(`建除${a.zhiXing}神利${task}（现代简表，参考不计分）`);
+    if (grade.good.length) reasons.push(`宜项：${grade.good.map((g) => `${g.name}(${g.w})`).join('、')}，合吉 ${grade.ji}`);
+    if (grade.remains.length) reasons.push(`忌项：${grade.remains.map((g) => `${g.name}(${g.w})`).join('、')}，合凶 ${grade.xiong}`);
+    if (grade.resolved.length) reasons.push(`德神可解：${grade.resolved.map((g) => g.name).join('、')}`);
+    if (grade.forced.length) reasons.push(`德神犹忌（所问正在余忌）：${grade.forced.map((g) => g.name).join('、')}`);
+    reasons.push(`卷十 ${grade.label}：${grade.doctrine}，${grade.decision}`);
+
     const chongSelf = shengXiao && a.chong.shengXiao === shengXiao ? shengXiao : null;
-    if (chongSelf) { score -= 2; reasons.push(`冲${shengXiao}（当事人属相，径直排除）`); }
-    if (zhixingSet.includes(a.zhiXing)) { score += 1; reasons.push(`建除${a.zhiXing}神利${task}（+1）`); }
-    if (a.zhiXing === '破' && spec.category !== 'burial') { score -= 1; reasons.push('破日（-1）'); }
-    if (a.zhiXing === '危' && spec.category !== 'travel' && spec.category !== 'worship') { score -= 1; reasons.push('危日（-1）'); }
+    if (chongSelf) reasons.push(`冲${shengXiao}（当事人属相，径直排除）`);
 
-    const v = VERDICT(score, { chongSelf, jiHit });
+    const avoidText = grade.remains.map((g) => g.name);
+    const v = verdictOf(grade, { chongSelf, avoidText });
     return {
       date: a.meta.date,
       weekday: a.meta.weekday,
@@ -185,9 +221,44 @@ export function buildZeri(input) {
       ji: a.ji,
       chong: a.chong.shengXiao,
       score,
+      favor,
       reasons,
       verdict: v.verdict,
       verdictText: v.text,
+      grade: {
+        key: grade.key,
+        label: grade.label,
+        doctrine: grade.doctrine,
+        decision: grade.decision,
+        withDe: grade.withDe,
+        de: grade.de,
+        ji: grade.ji,
+        xiong: grade.xiong,
+        ratio: grade.ratio,
+        resolved: grade.resolved.map((g) => g.name),
+        remains: grade.remains.map((g) => g.name),
+        forced: grade.forced.map((g) => g.name),
+        ...(grade.allJiCombo ? { combo: '月厌叠月破/灾煞：虽遇德仍诸事皆忌' } : {}),
+        note: grade.note,
+      },
+      shensha: {
+        monthBranch,
+        xing: dayInfo.xing,
+        names: dayInfo.names,
+        use: {
+          xing: hits.use.xing.map((h) => xingHitText(h)),
+          shensha: hits.use.shensha,
+          day: hits.use.day,
+          lunar: hits.use.lunar,
+        },
+        avoid: {
+          xing: hits.avoid.xing.map((h) => xingHitText(h)),
+          shensha: hits.avoid.shensha,
+          day: hits.avoid.day,
+          lunar: hits.avoid.lunar,
+        },
+        ...(hits.unsupported.length ? { unsupported: hits.unsupported } : {}),
+      },
       ...(v.excluded ? { excluded: true } : {}),
     };
   };
@@ -196,7 +267,10 @@ export function buildZeri(input) {
     ? candidates.map(makeRow)
     : Array.from({ length: days }, (_, i) => makeRow(fromJDN(toJDN(start.year, start.month, start.day) + i)));
 
-  const ranked = list.slice().sort((x, y) => y.score - x.score || (x.date < y.date ? -1 : 1));
+  // 先按卷十决断排（推荐 > 可用 > 平平 > 回避），同档再按吉凶差分，最后用建除适配作同分参考。
+  const rankOf = (d) => (d.excluded ? -1 : (VERDICT_RANK[d.verdict] ?? 0));
+  const ranked = list.slice().sort((x, y) => rankOf(y) - rankOf(x) || y.score - x.score
+    || Number(y.favor) - Number(x.favor) || (x.date < y.date ? -1 : 1));
   const startDate = candidates
     ? candidates.slice().sort((x, y) => (ymd(x) < ymd(y) ? -1 : 1)).map(ymd)[0]
     : ymd(start);
@@ -217,7 +291,7 @@ export function buildZeri(input) {
         ties: pool.filter((d) => d.score === top.score).map((d) => d.date),
       } : null,
       spread: Math.max(...scores) - Math.min(...scores),
-      note: '候选日只在这几天里比：分数来自建除宜忌与冲煞，胜出只表示更合所问事项，不代表「好多少」。',
+      note: '候选日只在这几天里比：先按卷十「六等」与德神制化定宜忌方向，再以吉凶权重差分；胜出只表示更合所问事项，不代表「好多少」。',
     };
   }
 
@@ -230,9 +304,7 @@ export function buildZeri(input) {
       days: list.length,
       shengXiao,
       ...(candidates ? { candidates: candidates.map(ymd) } : {}),
-      scope: shengXiao
-        ? `宜忌按建除简表；已给当事人属相（${shengXiao}），凡当日冲该属相径直排除。评分仅用于排序引导。`
-        : '宜忌按建除简表；未给当事人属相，未做冲属相排除。评分仅用于排序引导。',
+      scope: `宜忌按《协纪辨方书》卷十一「用事」逐条神煞，吉凶轻重按卷十「宜忌」六等与德神制化；${shengXiao ? `已给当事人属相（${shengXiao}），凡当日冲该属相径直排除。` : '未给当事人属相，未做冲属相排除。'}六等阈值为本仓校准（吉凶权重比 3/2、1、2/3、1/2），非古籍常数；卷十等第表的逐月逐日单元格未全量编码。评分仅用于排序引导。`,
     },
     best: ranked.filter((d) => d.verdict === '推荐' && !d.excluded).slice(0, 5).map((d) => d.date),
     usable: ranked.filter((d) => d.verdict === '可用' && !d.excluded).slice(0, 5).map((d) => d.date),
@@ -240,7 +312,33 @@ export function buildZeri(input) {
     days: list,
     ...(compare ? { compare } : {}),
     excludedCount: list.filter((d) => d.excluded).length,
-    sources: ['宜忌：建除十二神通行简表', '建除适配与冲煞：传统通行口径', '排序：宜忌加减分 + 属相排除（确定性）'],
-    disclaimer: '择日为传统黄历口径的本地计算，属民俗参考；评分只用于排序，不构成择日结论。',
+    shenshaRef: {
+      text: ZERI_SHENSHA_BASIS.text,
+      edition: ZERI_SHENSHA_BASIS.edition,
+      volumes: ZERI_SHENSHA_BASIS.volumes,
+      unsupported: ZERI_SHENSHA_BASIS.unsupported,
+      note: ZERI_SHENSHA_BASIS.note,
+      juan10: {
+        text: ZERI_JUAN10_BASIS.text,
+        corpusLines: ZERI_JUAN10_BASIS.corpusLines,
+        note: ZERI_JUAN10_BASIS.note,
+        thresholdsNote: ZERI_JUAN10_BASIS.thresholdsNote,
+        grades: ZERI_JUAN10_BASIS.grades.map((g) => ({
+          key: g.key, label: g.label, doctrine: g.doctrine, withDe: g.withDe, withoutDe: g.withoutDe,
+        })),
+        ping: ZERI_JUAN10_BASIS.ping,
+        deRules: ZERI_JUAN10_BASIS.deRules.map((r) => ({
+          name: r.name, cls: r.cls, anyOf: r.anyOf, residualEntries: r.residualEntries,
+        })),
+      },
+    },
+    sources: [
+      '宜忌：建除十二神通行简表（黄历层，逐日 yi/ji 原样保留）',
+      '神煞宜忌：《钦定协纪辨方书》卷十一「用事」逐条',
+      '吉凶轻重：卷十「宜忌」六等与德神制化（遇德/不遇德）',
+      '神煞起法：卷四建除、卷五/卷六义例、卷九立成',
+      '排序：卷十决断 + 吉凶权重差分 + 属相排除（确定性）',
+    ],
+    disclaimer: '择日为传统黄历口径的本地计算，属民俗参考；神煞依卷十一逐条宜忌，吉凶轻重依卷十「六等」与德神制化，六等阈值为本仓校准，逐月逐日等第表未逐格数字化。评分只用于排序，不构成择日结论。',
   };
 }

package/engine/ziwei-zuoyao.js

@@ -0,0 +1,313 @@
+// 紫微杂曜安星库（H4）：全表里通行、但本插件默认盘不排的十二颗杂曜。
+// 每条给：定宫依据、安星诀原文、逐宫查表或公式、五行与基本义、出处与互核情况。
+//
+// 口径（三条硬规矩）：
+//  ① 只收「至少两处独立来源给出同一张表」的星；查不到的宁可不收，不凭记忆补一格。
+//  ② 诀文逐字照抄来源，转抄例子与诀文冲突时以诀文为准，冲突本身写进 note（例：天才的
+//     网络例子自相矛盾，见该条）。
+//  ③ 异名不合并：年支系的「蜚廉」与博士十二神的「飞廉」是两颗星，同名不同宫；
+//     「解神」按月安（月解），另有按年安的「年解」，两者都收、都标依据，不互相替换。
+// 龙德／月德同样按年支可安，但与岁前十二神的龙德同名而异宫，本库不另立（见 SKIPPED）。
+
+import { BRANCHES } from './calendar.js';
+
+const fix = (i) => ((i % 12) + 12) % 12;
+
+// ── 逐宫查表（键 = 依据值，值 = 地支序 0=子） ──────────────────
+
+// 解神（月解）：正二在申、三四在戌、五六在子、七八在寅、九十在辰、十一十二在午。
+// 另一写法「单月冲宫觅解神，双月还依单月辰」——按月建（正月起寅）取对冲，
+// 正月建寅冲申、三月建辰冲戌……与上表逐格相同，故两式互核通过。
+export const TABLE_JIESHEN = { 1: 8, 2: 8, 3: 10, 4: 10, 5: 0, 6: 0, 7: 2, 8: 2, 9: 4, 10: 4, 11: 6, 12: 6 };
+
+// 天巫：正五九月在巳、二六十月在申、三七十一月在寅、四八十二月在亥（巳申寅亥四生位轮十二月）。
+export const TABLE_TIANWU = { 1: 5, 5: 5, 9: 5, 2: 8, 6: 8, 10: 8, 3: 2, 7: 2, 11: 2, 4: 11, 8: 11, 12: 11 };
+
+// 天月：一犬二蛇三在龙，四虎五羊六兔宫，七猪八羊九在虎，十马冬犬腊寅中。
+export const TABLE_TIANUE = { 1: 10, 2: 5, 3: 4, 4: 2, 5: 7, 6: 3, 7: 11, 8: 7, 9: 2, 10: 6, 11: 10, 12: 2 };
+
+// 阴煞：正七月在寅、二八月在子、三九月在戌、四十月在申、五十一月在午、六十二月在辰。
+export const TABLE_YINSHA = { 1: 2, 7: 2, 2: 0, 8: 0, 3: 10, 9: 10, 4: 8, 10: 8, 5: 6, 11: 6, 6: 4, 12: 4 };
+
+// 天官贵人（生年干）：甲羊乙龙壬犬宜，丙蛇丁虎己辛鸡，戊兔庚猪癸宜马。
+// 天福贵人（生年干）：甲爱金鸡乙爱猴，丁猪丙鼠己虎头，戊寻玉兔庚壬马，辛癸逢蛇爵禄荣。
+// 另有合并诀「甲喜羊鸡乙龙猴……」把两星排在同一行，逐干拆开与本表全同；
+// 戊年两星同在卯宫（合并诀只举「戊玉兔」一格，两诀合看才知道是同居）。
+export const TABLE_TIANGUAN = { 甲: 7, 乙: 4, 丙: 5, 丁: 2, 戊: 3, 己: 9, 庚: 11, 辛: 9, 壬: 10, 癸: 6 };
+export const TABLE_TIANFU = { 甲: 9, 乙: 8, 丙: 0, 丁: 11, 戊: 3, 己: 2, 庚: 6, 辛: 5, 壬: 6, 癸: 5 };
+
+// 天厨（生年干）：甲丁食蛇口，乙戊辛马方，丙从鼠口得，己食于猴房，庚食虎头上，壬鸡癸猪堂。
+// 另一传本「甲丁蛇位号天厨，丙鼠壬鸡癸伴猪，乙戊辛干皆向马，己猴庚虎福神殊」——字面不同、
+// 逐干落宫相同；另有排盘文直接列出十干表，三处一致。
+export const TABLE_TIANCHU = { 甲: 5, 乙: 6, 丙: 0, 丁: 5, 戊: 6, 己: 8, 庚: 2, 辛: 6, 壬: 9, 癸: 11 };
+
+// 蜚廉（生年支）：「蜚廉分方顺年移，西南东北各轮之」——子年起申宫，按西方（申酉戌）、
+// 南方（巳午未）、东方（寅卯辰）、北方（亥子丑）四组顺轮十二年支。
+export const TABLE_FEILIAN = { 子: 8, 丑: 9, 寅: 10, 卯: 5, 辰: 6, 巳: 7, 午: 2, 未: 3, 申: 4, 酉: 11, 戌: 0, 亥: 1 };
+
+// 天德／年解（生年支）：「天德星君起酉宫，顺至生年定其踪；年解戌宫逆行去，数至生年可解凶。」
+export const TIANDE_START = 9;   // 酉起子，顺行
+export const NIANJIE_START = 10; // 戌起子，逆行
+
+// ── 库（顺序即面板与全文的展示顺序） ──────────────────────────
+
+export const ZUOYAO_LIB = [
+  {
+    name: '解神',
+    basis: '生月',
+    type: '吉星',
+    wuxing: '阴水（一说属土，通行表不取五行断）',
+    verse: '正二在申三四在戍，五六在子七八在寅，九十月坐于辰宫，十一十二在午宫。\n（另一式：单月冲宫觅解神，双月还依单月辰。）',
+    table: TABLE_JIESHEN,
+    meaning: '消灾解厄：灾厄临身前先有感应，逢凶化吉之力。与按生年安的「年解」不是同一颗星。',
+    temple: null,
+    refs: ['https://m.yi958.com/ziwei/posts/15175', 'http://www.360doc.cn/article/6029610_1149007117.html', 'https://wk.baidu.com/view/2d750d65783e0912a2162a58'],
+    check: '三源同表；两式（查表法／月建对冲法）逐月互核一致',
+    note: '解神即「月解」，网络转抄常与年解混为一条，本库分列两星。',
+  },
+  {
+    name: '天巫',
+    basis: '生月',
+    type: '吉星',
+    wuxing: '阳土',
+    verse: '正五九月在巳，二六十月在申，三七十一在寅，四八十二在亥。\n（另一式：巳申寅亥天巫位，分轮十二月星君。）',
+    table: TABLE_TIANWU,
+    meaning: '升迁与香火：主地位提升、近宗教玄学；会吉星则名声显。',
+    temple: null,
+    refs: ['https://m.yi958.com/ziwei/posts/15175', 'http://www.360doc.cn/article/6029610_1149007117.html', 'https://wk.baidu.com/view/2d750d65783e0912a2162a58'],
+    check: '三源同表（四生位轮十二月，两式同一）',
+    note: '',
+  },
+  {
+    name: '天月',
+    basis: '生月',
+    type: '煞星',
+    wuxing: '阴土',
+    verse: '一犬二蛇三在龙，四虎五羊六兔宫，七猪八羊九在虎，十马冬犬腊寅中。',
+    table: TABLE_TIANUE,
+    meaning: '病符之星：主小病缠身、体弱，也主与世无争、缺主见。',
+    temple: null,
+    refs: ['https://m.yi958.com/ziwei/posts/15175', 'http://www.360doc.cn/article/6029610_1149007117.html', 'https://zhidao.baidu.com/question/252564654384154444.html'],
+    check: '三源逐字同诀（八月在未、十二月在寅两处最易抄错，三源皆同）',
+    note: '',
+  },
+  {
+    name: '阴煞',
+    basis: '生月',
+    type: '煞星',
+    wuxing: '阴土',
+    verse: '正七月在寅，二八月在子，三九月在戍，四十月在申，五十一在午，六十二在辰。\n（另一式：寅子戌，申午辰，分六月，阴煞临。）',
+    table: TABLE_YINSHA,
+    meaning: '疑心与暗耗：主多疑、易受小人拖累，也主自我约束反省。',
+    temple: null,
+    refs: ['https://m.yi958.com/ziwei/posts/15175', 'http://www.360doc.cn/article/6029610_1149007117.html', 'https://m.meipian.cn/58g6z14p'],
+    check: '三源同表（隔六月同宫，正七寅、二八子……）',
+    note: '',
+  },
+  {
+    name: '天官',
+    basis: '生年干',
+    type: '吉星',
+    wuxing: '阳土',
+    verse: '甲羊乙龙壬犬宜，丙蛇丁虎己辛鸡，戊兔庚猪癸宜马，其人贵显可先知。',
+    table: TABLE_TIANGUAN,
+    meaning: '主贵显、清闲：喜入命宫或官禄宫；与天同、天梁庙地同宫主尊荣高寿，余者平常。',
+    temple: ['寅', '申', '巳', '卯'],
+    refs: ['https://ziweiscience.com/index.php/2024-06-25/anxingfa/', 'https://m.yi958.com/ziwei/posts/15175', 'https://www.daowen.com/book/content/226294168/14993368.html'],
+    check: '两诀（分立式／合并式）逐干互核一致；入庙四宫另见专论',
+    note: '己、辛同年干落酉，属原表如此，不是抄重。',
+  },
+  {
+    name: '天福',
+    basis: '生年干',
+    type: '吉星',
+    wuxing: '阳土',
+    verse: '甲爱金鸡乙爱猴，丁猪丙鼠己虎头，戊寻玉兔庚壬马，辛癸逢蛇爵禄荣。',
+    table: TABLE_TIANFU,
+    meaning: '主爵禄、吉祥：乐于助人、爱享受，运限逢之受人注目。',
+    temple: ['寅', '申', '巳', '卯'],
+    refs: ['https://ziweiscience.com/index.php/2024-06-25/anxingfa/', 'https://m.yi958.com/ziwei/posts/15175', 'https://www.daowen.com/book/content/226294168/14993368.html'],
+    check: '两诀逐干互核一致；庚、壬同年干落午，戊年与天官同居卯宫',
+    note: '合并诀「壬犬马癸马蛇游」把壬午、癸巳排在一起，与分立式同。',
+  },
+  {
+    name: '天厨',
+    basis: '生年干',
+    type: '吉星',
+    wuxing: '阴土',
+    verse: '甲丁食蛇口，乙戊辛马方，丙从鼠口得，己食于猴房，庚食虎头上，壬鸡癸猪堂。\n（另传：甲丁蛇位号天厨，丙鼠壬鸡癸伴猪，乙戊辛干皆向马，己猴庚虎福神殊。）',
+    table: TABLE_TIANCHU,
+    meaning: '俸禄与口福：主食禄、公职，也主厨艺与鉴赏；会天才更显烹饪之资。',
+    temple: null,
+    refs: ['https://m.yi958.com/ziwei/posts/15175', 'http://www.360doc.cn/article/6029610_1149007117.html', 'https://m.bilibili.com/opus/1015667810277261321', 'https://baijiahao.baidu.com/s?id=1841437745877521371'],
+    check: '两字面不同的诀 + 一处十干明表，四处逐干全同',
+    note: '甲丁同居巳，乙戊辛同居午，是原表同宫而非抄重。',
+  },
+  {
+    name: '蜚廉',
+    basis: '生年支',
+    type: '煞星',
+    wuxing: '阴火',
+    verse: '蜚廉分方顺年移，西南东北各轮之。\n（释：子年起申宫，十二年支先西方申酉戌、次南方巳午未、续东方寅卯辰、最后北方亥子丑。）',
+    table: TABLE_FEILIAN,
+    meaning: '口舌是非：主小人、诽谤、虚惊，宜静不宜争。',
+    temple: null,
+    refs: ['http://www.360doc.cn/article/6029610_1149007117.html', 'https://m.bilibili.com/opus/1015667810277261321'],
+    check: '两源同诀同释（王亭之中州派讲义与安星口诀本），四方位轮年支的落宫逐支一致',
+    note: '与博士十二神的「飞廉」同名异星：飞廉按禄存起、随大限顺逆，蜚廉只按生年支，两不相代。',
+  },
+  {
+    name: '天德',
+    basis: '生年支',
+    type: '吉星',
+    wuxing: '阳火',
+    verse: '天德星君起酉宫，顺至生年定其踪。',
+    formula: (c) => fix(TIANDE_START + c.yearBranch),
+    meaning: '福佑之星：主逢凶化吉、有扶助，与岁前十二神的「天德」同名异宫。',
+    temple: null,
+    refs: ['http://www.360doc.cn/article/6029610_1149007117.html', 'https://m.bilibili.com/opus/1015667810277261321'],
+    check: '两源同诀（酉宫起子顺行）',
+    note: '岁前十二神里也有「天德」（太岁起顺数第十位），本盘两处都会出现，同名不同星，不可互换。',
+  },
+  {
+    name: '年解',
+    basis: '生年支',
+    type: '吉星',
+    wuxing: '阳水',
+    verse: '年解戌宫逆行去，数至生年可解凶。',
+    formula: (c) => fix(NIANJIE_START - c.yearBranch),
+    meaning: '一生灾厄的总闸：与按生月安的「解神（月解）」分属两颗，年解管大事、月解管当期。',
+    temple: null,
+    refs: ['http://www.360doc.cn/article/6029610_1149007117.html', 'https://m.bilibili.com/opus/1015667810277261321'],
+    check: '两源同诀（戌宫起子逆行）',
+    note: '',
+  },
+  {
+    name: '天才',
+    basis: '命宫＋生年支',
+    type: '杂曜',
+    wuxing: '阳木',
+    verse: '命宫起子天才顺。\n（释：自命宫起子年，顺数至本生年支安之。）',
+    formula: (c) => fix(c.soulIndex + c.yearBranch),
+    meaning: '才智与技艺：主聪明、有专长，会天厨增烹饪之资，会主星庙旺方显。',
+    temple: null,
+    refs: ['https://ziweiscience.com/index.php/2024-06-25/anxingfa/', 'http://www.360doc.cn/article/6029610_1149007117.html', 'https://m.meipian.cn/58g6z14p'],
+    check: '三源同诀（命宫起子顺数生年支）',
+    note: '360doc 转抄的例子自相矛盾：说命宫在午、戌年生人，按诀数到辰（该盘夫妻宫正在辰），却写成「巳宫安天才」。以诀文为准，例子判为笔误。',
+  },
+  {
+    name: '天寿',
+    basis: '身宫＋生年支',
+    type: '杂曜',
+    wuxing: '阳土',
+    verse: '身宫起子天寿堂。\n（释：自身宫起子年，顺数至本生年支安之。）',
+    formula: (c) => fix(c.bodyIndex + c.yearBranch),
+    meaning: '寿年与长者缘：主稳重、近长辈，与天才对看（一按命宫、一按身宫）。',
+    temple: null,
+    refs: ['https://ziweiscience.com/index.php/2024-06-25/anxingfa/', 'http://www.360doc.cn/article/6029610_1149007117.html', 'https://m.meipian.cn/58g6z14p'],
+    check: '三源同诀；转抄例子「亥年生人身宫在卯→寅宫」与公式复算一致',
+    note: '',
+  },
+];
+
+// 按年支可安、但本库刻意不另立的星：写清楚为什么不留，免得日后「顺手补上」造成同名双宫。
+export const ZUOYAO_SKIPPED = [
+  {
+    name: '龙德',
+    reason: '「龙德起羊（未）」按年支可安，但岁前十二神已有同名「龙德」（太岁起顺数第八位），两处同名异宫会让面板与断语打架。岁前那一套已在宫位神煞里呈现，故不另立。',
+    refs: ['https://m.bilibili.com/opus/1015667810277261321'],
+  },
+  {
+    name: '月德',
+    reason: '「月起巳」按年支安月德；只见于「年支六曜诀」一条脉络，且与神煞体系无对应，收进来会给出无法验证的庙旺断，故不收。',
+    refs: ['https://m.bilibili.com/opus/1015667810277261321', 'http://www.360doc.cn/article/6029610_1149007117.html'],
+  },
+];
+
+export const ZUOYAO_NAMES = ZUOYAO_LIB.map((s) => s.name);
+
+/** 全表统计：供面板与测试核对「收了几颗、几颗有庙、几颗有明表」 */
+export const ZUOYAO_STATS = Object.freeze({
+  total: ZUOYAO_LIB.length,
+  byBasis: Object.freeze(ZUOYAO_LIB.reduce((acc, s) => {
+    acc[s.basis] = (acc[s.basis] || 0) + 1;
+    return acc;
+  }, {})),
+  withTable: ZUOYAO_LIB.filter((s) => s.table).length,
+  withFormula: ZUOYAO_LIB.filter((s) => s.formula).length,
+  withTemple: ZUOYAO_LIB.filter((s) => s.temple && s.temple.length).length,
+  byType: Object.freeze(ZUOYAO_LIB.reduce((acc, s) => {
+    acc[s.type] = (acc[s.type] || 0) + 1;
+    return acc;
+  }, {})),
+  skipped: ZUOYAO_SKIPPED.map((s) => s.name),
+});
+
+/** 单颗星的落宫（表格优先，公式其次）；依据缺字段时返回 null，不猜宫。 */
+export function zuoyaoBranch(star, ctx) {
+  if (star.table) {
+    const key = star.basis === '生月' ? ctx.lunarMonth
+      : star.basis === '生年干' ? ctx.yearStem
+        : star.basis === '生年支' ? BRANCHES[fix(ctx.yearBranch)]
+          : null;
+    if (key === null || key === undefined) return null;
+    const v = star.table[key];
+    return typeof v === 'number' ? fix(v) : null;
+  }
+  if (star.formula) {
+    // 四颗公式曜全都要生年支；天才另要命宫、天寿另要身宫。少一个就整颗不排。
+    if (typeof ctx.yearBranch !== 'number') return null;
+    if (star.basis === '命宫＋生年支' && typeof ctx.soulIndex !== 'number') return null;
+    if (star.basis === '身宫＋生年支' && typeof ctx.bodyIndex !== 'number') return null;
+    const v = star.formula(ctx);
+    return typeof v === 'number' && Number.isFinite(v) ? fix(v) : null;
+  }
+  return null;
+}
+
+/**
+ * 安十二颗杂曜。ctx = { lunarMonth, yearStem, yearBranch, soulIndex, bodyIndex }
+ * 返回 [{ name, type, branch, basis, verse }]，branch 为地支序。
+ * 任何一颗算不出宫位（例如没传命宫）就整颗跳过，绝不安到默认宫。
+ */
+export function placeZuoyao(ctx = {}) {
+  const out = [];
+  for (const star of ZUOYAO_LIB) {
+    const branch = zuoyaoBranch(star, ctx);
+    if (branch === null) continue;
+    out.push({
+      name: star.name,
+      type: star.type,
+      branch,
+      basis: star.basis,
+      verse: star.verse,
+      meaning: star.meaning,
+      ...(star.temple && star.temple.length ? { temple: star.temple } : {}),
+      ...(star.temple && star.temple.includes(BRANCHES[branch]) ? { inTemple: true } : {}),
+    });
+  }
+  return out;
+}
+
+/** 一行摘要：全表收了哪些星、按什么定宫 */
+export function zuoyaoBriefText() {
+  const groups = [];
+  for (const [basis, n] of Object.entries(ZUOYAO_STATS.byBasis)) {
+    groups.push(`${basis} ${ZUOYAO_LIB.filter((s) => s.basis === basis).map((s) => s.name).join('、')}（${n}）`);
+  }
+  return groups.join('　');
+}
+
+/**
+ * 安星诀全文（逐颗一行：星名＋定宫依据＋诀文＋互核情况）。
+ * 面板、独立页与「复制提问」共用这一段：外部模型只拿到盘面星名是不够的，
+ * 得知道这一颗是怎么定宫的，才不会把杂曜当成随意摆放的装饰。
+ */
+export function zuoyaoVerseBlock(list) {
+  const rows = (list && list.length ? list : ZUOYAO_LIB);
+  return rows.map((s) => {
+    const star = ZUOYAO_LIB.find((x) => x.name === s.name) || s;
+    const at = typeof s.branch === 'number' ? `（本盘落${BRANCHES[fix(s.branch)]}宫）` : '';
+    return `${star.name}｜${star.basis}${at}｜${String(star.verse || '').replace(/\n/g, '')}｜互核：${star.check || '—'}`;
+  }).join('\n');
+}

package/engine/ziwei.js

@@ -6,6 +6,7 @@ import { applyDst } from './dst.js';
 import { assertCivil } from './validate.js';
 import { nayinOf } from './nayin.js';
 import { resolveAddress } from './geo.js';
+import { placeZuoyao, zuoyaoVerseBlock, ZUOYAO_SKIPPED } from './ziwei-zuoyao.js';
 
 const fix = (i) => ((i % 12) + 12) % 12;
 
@@ -78,6 +79,8 @@ export const MUTAGEN = {
 // 默认值对齐本插件既有盘面：亮度用内置通行表，庚干用阳武阴同，
 // 天马按年支、魁钺用全书理解一、天使天伤不换、长生按现有五行局表、
 // 晚子时仍算当日；天空/截空旬空默认不排（旧盘没有这两组星，保持 49 颗）。
+// 全表十二颗杂曜同样默认不排：星数一多，旧盘的句柄与存档会静默变盘，
+// 所以 zuoyaoSchool 默认 minimal，要 61 颗的通行全表得显式打开。
 // 其余选项只在显式指定时改变盘面，不影响默认输出。
 export const ZIWEI_SCHOOL_DEFAULTS = Object.freeze({
   brightnessSchool: 'default',
@@ -90,6 +93,7 @@ export const ZIWEI_SCHOOL_DEFAULTS = Object.freeze({
   changshengSchool: 'yin-yang-shun-ni',
   lateZishi: 'current-day',
   shenzhuSchool: 'common',
+  zuoyaoSchool: 'minimal',
 });
 
 export const ZIWEI_SCHOOL_OPTIONS = Object.freeze({
@@ -103,6 +107,7 @@ export const ZIWEI_SCHOOL_OPTIONS = Object.freeze({
   changshengSchool: ['yin-yang-shun-ni', 'shui-tu', 'huo-tu'],
   lateZishi: ['current-day', 'next-day', 'all-current', 'day-cur-time-next'],
   shenzhuSchool: ['common', 'verse'],
+  zuoyaoSchool: ['minimal', 'full'],
 });
 
 export function ziweiSchoolsOf(input = {}) {
@@ -457,6 +462,7 @@ export function buildZiwei(input) {
       if (b) star.brightness = b;
     }
     starsByBranch[idx].push(star);
+    return star;
   };
 
   for (const s of ZIWEI_GROUP) put(ziwei + s.offset, s.name, '主星');
@@ -543,6 +549,17 @@ export function buildZiwei(input) {
   put(soulIndex - (swapTianshi ? 5 : 7), '天伤', '杂曜');
   put(soulIndex - (swapTianshi ? 7 : 5), '天使', '杂曜');
 
+  // 全表杂曜（默认不排，zuoyaoSchool: 'full' 才加十二颗）
+  // 每颗都带安星诀依据，落宫由 engine/ziwei-zuoyao.js 的查表/公式复算，不硬编宫位。
+  let zuoyaoPlaced = [];
+  if (schools.zuoyaoSchool === 'full') {
+    zuoyaoPlaced = placeZuoyao({ lunarMonth, yearStem, yearBranch: yb, soulIndex, bodyIndex });
+    for (const s of zuoyaoPlaced) {
+      const star = put(s.branch, s.name, s.type);
+      if (s.inTemple) star.inTemple = true;
+    }
+  }
+
   // 生年四化（庚干按所选变体）
   const mutagenMap = mutagenOf(yearStem, schools);
   for (const list of starsByBranch) {
@@ -742,6 +759,22 @@ export function buildZiwei(input) {
     ziwei: BRANCHES[ziwei],
     tianfu: BRANCHES[tianfu],
     changqu,
+    // 杂曜全表的这一层只写「这一盘怎么定宫」：面板、独立页与「复制提问」共用。
+    // 默认（minimal）时 placed 为空，但 skipped 照旧给出，说明为什么少了两颗。
+    zuoyao: {
+      mode: schools.zuoyaoSchool,
+      starTotal: schools.zuoyaoSchool === 'full' ? 61 : 49,
+      placed: zuoyaoPlaced.map((s) => ({
+        name: s.name,
+        branch: BRANCHES[s.branch],
+        palace: palaceNames[s.branch],
+        basis: s.basis,
+        meaning: s.meaning,
+        ...(s.inTemple ? { inTemple: true } : {}),
+      })),
+      verses: schools.zuoyaoSchool === 'full' ? zuoyaoVerseBlock(zuoyaoPlaced) : '',
+      skipped: ZUOYAO_SKIPPED.map((s) => `${s.name}：${s.reason}`),
+    },
     palaces,
     liunian,
     daxian: {
@@ -757,7 +790,10 @@ export function buildZiwei(input) {
     rules: {
       ziweiPlacement: '借数法：局数除日数取商，商数自寅宫顺行，借数奇逆偶顺',
       mutagen: '生年四化用中州派常用表；庚干可按流派切换（默认阳武阴同，另有同科阴忌、府科、府科相忌、同科相忌）',
-      schools: `流派开关：亮度 ${schools.brightnessSchool}、庚干四化 ${schools.gengYearSihua}、天马 ${schools.tianmaSchool}、天空 ${schools.tiankongSchool}、截空 ${schools.jiekongSchool}、魁钺 ${schools.kuiyueSchool}、天伤天使 ${schools.tianshiTianshang}、长生 ${schools.changshengSchool}、晚子时 ${schools.lateZishi}、身主 ${schools.shenzhuSchool}（common 子午皆火星 / verse 子铃午火）；庚干四化只作用于生年四化`,
+      schools: `流派开关：亮度 ${schools.brightnessSchool}、庚干四化 ${schools.gengYearSihua}、天马 ${schools.tianmaSchool}、天空 ${schools.tiankongSchool}、截空 ${schools.jiekongSchool}、魁钺 ${schools.kuiyueSchool}、天伤天使 ${schools.tianshiTianshang}、长生 ${schools.changshengSchool}、晚子时 ${schools.lateZishi}、身主 ${schools.shenzhuSchool}（common 子午皆火星 / verse 子铃午火）、杂曜 ${schools.zuoyaoSchool}（minimal 49 颗 / full 61 颗）；庚干四化只作用于生年四化`,
+      zuoyao: schools.zuoyaoSchool === 'full'
+        ? `全表十二颗已安：生月 解神、天巫、天月、阴煞；生年干 天官、天福、天厨；生年支 蜚廉、天德、年解；命宫＋生年支 天才、身宫＋生年支 天寿。蜚廉与博士十二神的飞廉同名异星，年解与月解（解神）分列，天德与岁前十二神的天德同名异宫。`
+        : `本盘按 49 颗的通行简盘安星，未排全表杂曜。开 zuoyaoSchool: "full" 追加十二颗：解神、天巫、天月、阴煞（生月）、天官、天福、天厨（生年干）、蜚廉、天德、年解（生年支）、天才（命宫＋生年支）、天寿（身宫＋生年支），每颗都带安星诀。`,
       leapMonth: '闰月默认按日切分（1–15 归本月、16 起归次月，主流排盘口径）；可传 leapMonth: next（整月归次月）或 prev（整月归本月），leapAsNext: true 等同 next',
       auxStars: '火铃按年支三合起点顺数至生时；羊陀夹禄存；魁钺按年干；地空亥起子时逆行、地劫顺行；三台八座随辅弼；恩光天贵随昌曲退一位；台辅封诰按时支',
       shensha: '长生、博士随大限顺逆；将前、岁前恒顺行；天伤恒在交友、天使恒在疾厄',

package/index.js

@@ -180,7 +180,7 @@ export function apply(ctx) {
         system: {
           type: 'string',
           enum: ['bazi', 'ziwei', 'liuyao', 'tarot', 'meihua', 'daliuren', 'hepan', 'qimen', 'almanac', 'zeri', 'chenggu', 'xiaoliuren', 'star', 'numerology', 'mbti', 'trend', 'fengshui', 'name', 'convert'],
-          description: 'bazi = 四柱八字（含调候寒暖与《穷通宝鉴》120 格用神）；ziwei = 紫微斗数；liuyao = 六爻（纳甲、卦体关系、用神落位与月建日辰旺衰）；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬；hepan = 合盘（合婚），需同时给 partner；qimen = 奇门遁甲（时家转盘，拆补法）；almanac = 黄历（某日宜忌/冲煞/建除/节气）；zeri = 择日（某事项在日期区间内逐日打分排序）；chenggu = 袁天罡称骨（骨重 + 通行本称骨歌原文 + 白话释义）；xiaoliuren = 小六壬（时间或报数起课）；star = 星座当日基调；numerology = 生命数字；mbti = 十六型人格（MBTI 风格 24 题问卷：给 answers 出类型，不给则先返回题目）；trend = 人生 K 线（大运/流年走势可视化）；fengshui = 风水（八宅命卦/流年飞星/门主灶布局/玄空下卦，action 三选一）；name = 起名（391 字库的用字五行评估与候选生成；未收录字可传 charElements 指定五行）；convert = 公农历互转（solar2lunar 公历转农历 / lunar2solar 农历转公历）。',
+          description: 'bazi = 四柱八字（含调候寒暖与《穷通宝鉴》120 格用神）；ziwei = 紫微斗数；liuyao = 六爻（纳甲、卦体关系、用神落位与月建日辰旺衰）；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬；hepan = 合盘（合婚），需同时给 partner；qimen = 奇门遁甲（时家转盘，拆补法）；almanac = 黄历（某日宜忌/冲煞/建除/节气）；zeri = 择日（某事项在日期区间或候选日内逐日打分排序；宜忌依《协纪辨方书》卷十一「用事」逐条神煞，轻重依卷十「宜忌」六等与德神制化）；chenggu = 袁天罡称骨（骨重 + 通行本称骨歌原文 + 白话释义）；xiaoliuren = 小六壬（时间或报数起课）；star = 星座当日基调；numerology = 生命数字；mbti = 十六型人格（MBTI 风格 24 题问卷：给 answers 出类型，不给则先返回题目）；trend = 人生 K 线（大运/流年走势可视化）；fengshui = 风水（八宅命卦/流年飞星/门主灶布局/玄空下卦，action 三选一）；name = 起名（391 字库的用字五行评估与候选生成；未收录字可传 charElements 指定五行）；convert = 公农历互转（solar2lunar 公历转农历 / lunar2solar 农历转公历）。',
         },
         datetime: {
           type: 'string',
@@ -440,6 +440,11 @@ export function apply(ctx) {
           enum: ['common', 'verse'],
           description: '紫微斗数：身主安法（只影响子/午年生人）。common（默认，通行表）子午皆火星；verse 按安身主诀「子午安身铃火宿」逐字取子铃星、午火星。',
         },
+        zuoyaoSchool: {
+          type: 'string',
+          enum: ['minimal', 'full'],
+          description: '紫微斗数：杂曜取盘。minimal（默认，通行简盘 49 颗，与旧盘和存档一致）；full 另按安星诀补入十二颗杂曜（解神、天巫、天月、阴煞、天官、天福、天厨、蜚廉、天德、年解、天才、天寿），共 61 颗。诀文属近代通行辑本并核，非《紫微斗数全书》原文。',
+        },
         action: {
           type: 'string',
           enum: ['natal', 'advise', 'xuankong', 'assess', 'generate'],