| name | ziwei-bazi-reading |
| description | Use when the user asks for 紫微斗数 / Zi Wei Dou Shu chart reading, 八字 / 四柱 / BaZi destiny analysis, 命盘分析, 批命, 算命, 推命, 定时辰 / 定盘, or any Chinese metaphysics fortune-telling. Trigger keywords: 命盘, 流年, 大限, 大运, 十神, 四化, 星曜, 八字排盘, 紫微排盘, 喜用神. |
紫微斗数与八字命理推演
中国传统术数命理推演技能。包含两套完全独立的体系：紫微斗数（三合/飞星/河洛/钦天四化）与八字命理（子平四柱）。可各自独立推演，也可用"应事法"做时辰校验（定盘）。
何时使用
用户出现以下任一情况时调用：
- 要求分析紫微斗数命盘（给出安星码 / 排盘数据 / 十二宫星曜）
- 要求批八字 / 四柱推命（给出年月日时四柱）
- 要求定盘 / 定时辰（两个相邻时辰二选一，用已发生事件反推）
- 询问命运、运势、流年、婚姻、事业、财运、健康等命理维度并提供了生辰
- 要求合盘 / 婚配 / 合作配对（提供双方生辰，看感情婚姻或事业合作契合度）
- 要求把命理分析输出为 HTML / Markdown 文档
核心铁律（不可违背）
这是术数推演，不是代码——但严谨性要求与代码同等：
-
只基于用户提供的数据推演：所有星曜落宫、十神、四化、宫干，必须严格从用户给的排盘/四柱中得出。不得凭空捏造星曜位置、十神关系或四化落点。推演前先核对数据自洽性（如生年四化落宫是否与命盘标注一致）。
-
绝不编造命主经历：分析"应事"时，只能用用户明确告知的真实事件去验证命盘；不得臆测命主"应该"经历过什么来迎合结论。
-
每条判断附依据与置信度：重要结论标注依据来源（某宫星曜组合 / 某十神喜忌 / 某流年四化），并用 🟢高 / 🟡中 / 🔴低 标注置信度。吉凶判断给出时间范围与影响程度。术数断语尽量标注来源类型（[古诀]/[命理共识]/[倪海厦视角]/[某派]），便于用户判断派别属性；详见各 method 文件的标注规范小节。
-
剔除营销与绝对化表述：禁用"百分百准""必发财""命中注定离婚"等夸大断语；命理是概率性推断，用"倾向于""需注意""概率较高"等留有余地的表达。
-
必加免责声明：任何命理产出（无论 HTML/MD/对话）结尾必须附免责声明，说明仅限文化研究/娱乐、非科学、不替代专业决策。固定文本见文末。
-
两套体系独立：若用户要求分别用紫微和八字分析，两份产出互不引用对方术语——紫微文档不提十神/大运/喜用神；八字文档不提宫位/星曜/四化/大限。定盘时可分别得出结论后对照。
-
定用神须四参合（八字）：定真用神须「旺衰 + 格局 + 调候 + 流通」四参合（见 methods/bazi-method.md 第五节），禁止单一旺衰机械判忌——「缺五行不即忌」，缺/近缺的五行常是补缺、通关、泄秀所需之用（非忌）。引擎 scripts/bazi_core.js 的 BAZI_SIHE 开关（默认 on）即此四参合复核机制，可 off 对照旧旺衰。
-
趋吉避凶·正向引导（产出口径·机制化）：命理旨在给人希望与出路，非堆砌凶象。吉凶按原理如实推演，但解析必须给"转化路径"——凶运指出该往哪发力、为喜用运蓄什么力（婚姻凶转攻事业、财运凶深耕技术韬光养晦、官杀凶以技术学识化杀），每个凶配一条出路；禁绝对化与凶吓表述（用"需注意/宜 X"替代"大凶/必破"）。详见 methods/bazi-method.md 第十五节 与 methods/ziwei-method.md 第十一节。机制化落实：data/empower.json 积极赋能语料层（7 类：interpret/geju/palace_sihua/bazi_trait/dayun/liunian/heming）提供每条象的 {judgment(如实断)+transform(转化)+action[](行动)+mindset(心态)}，scripts/_empower.js 的 lookup(category,key) 供 gen_*.js 与 LLM prompt 查询；所有 gen 产出对每个凶/特质/运势节点必须查 empower 配出路，查不到走通用转化模板兜底。详见 docs/specs/2026-06-26-积极赋能改造-design.md。
-
定盘多维度合参·应事三层引动：定盘须综合人生经历多维度（学业/财运烈度/职业）+ 本人特征（体貌/六亲/健康），禁凭单一事件/单一宫位下定盘结论（印星有根是学业/技术/扛财的根本）。应事须看原局（体）+ 大限 + 流年三层引动（流年走宫/化忌入主星/害刑动六亲星），单看原局宫位会误判（如原局子女宫吉不排除流年化忌破）。详见 methods/dingpan-logic.md。
标准推演流程
digraph flow {
"收到命理请求" [shape=box];
"数据齐全?" [shape=diamond];
"要求HTML/MD输出?" [shape=diamond];
"时辰确定?" [shape=diamond];
"紫微 or 八字?" [shape=diamond];
"应事法定盘\n(两盘分别推演后对照)" [shape=box];
"调用 methods/ziwei-method.md\n紫微推演" [shape=box];
"调用 methods/bazi-method.md\n八字推演" [shape=box];
"附依据+置信度\n附时间范围+影响程度" [shape=box];
"加免责声明" [shape=box];
"输出(HTML/MD/对话)" [shape=doublecircle];
"收到命理请求" -> "数据齐全?";
"数据齐全?" -> "要求HTML/MD输出?" [label="是"];
"数据齐全?" -> "向用户索要生辰/排盘" [label="否,缺生辰"];
"要求HTML/MD输出?" -> "时辰确定?" [label="是"];
"时辰确定?" -> "紫微 or 八字?" [label="是"];
"时辰确定?" -> "应事法定盘\n(两盘分别推演后对照)" [label="否(两时辰二选一)"];
"紫微 or 八字?" -> "调用 methods/ziwei-method.md\n紫微推演" [label="紫微斗数"];
"紫微 or 八字?" -> "调用 methods/bazi-method.md\n八字推演" [label="八字命理"];
"应事法定盘\n(两盘分别推演后对照)" -> "附依据+置信度\n附时间范围+影响程度";
"调用 methods/ziwei-method.md\n紫微推演" -> "附依据+置信度\n附时间范围+影响程度";
"调用 methods/bazi-method.md\n八字推演" -> "附依据+置信度\n附时间范围+影响程度";
"附依据+置信度\n附时间范围+影响程度" -> "加免责声明";
"加免责声明" -> "输出(HTML/MD/对话)";
}
合盘分支：当用户要求合盘/婚配/合作配对（提供双方生辰）时，按需 Read methods/heming-method.md（紫微合盘或八字合婚，依用户体系选择）→ 双方各自独立推演后对照合参。不并入单盘推演流程，仅在合盘请求时触发。
目录结构
ziwei-bazi-reading/
├── SKILL.md # 本文件：入口 / 铁律 / 流程
├── methods/ # 推演方法论（紫微、八字各自独立，互不引用术语）
│ ├── ziwei-method.md
│ ├── bazi-method.md
│ ├── bazi-classics.md # 八字古籍深论(格局/形性/寿元/女命/太岁/纳音/空亡·按需Read)
│ ├── ziwei-classics.md # 紫微古籍深论(庙旺12宫/赋文/形性/格局成败/小限斗君·按需Read)
│ └── heming-method.md # 合盘/婚配/合作配对专题（按需 Read）
├── corpus/ # 天纪倪师原话语料库 + 通识古诀（按需 Read，引用时溯源）
│ ├── verified/ # 倪师《天纪》原话（带集数出处）
│ ├── traditional/ # 紫微通识古诀（非倪师独创）
│ └── sources.md # 资料来源清单
├── templates/ # 产出模板
│ └── ziwei-chart.html
├── scripts/ # 排盘脚本（紫微+八字均已接入，均 vendor 离线）
│ ├── paipan_ziwei.js # 紫微(iztro v2.5.8)
│ ├── bazi.js # 八字静态盘(tyme4ts + 关系层 + 神煞层)
│ ├── bazi_core.js # 八字核心引擎(排盘+旺衰+流年,共用模块)
│ ├── bazi_liunian.js # 八字流年逐年断 → JSON
│ ├── ziwei_liunian.js # 紫微流年十维度 → JSON
│ ├── gen_liunian_html.js # [已废弃]八字运势HTML—命书gen_bazi_full已一站式含运势,不再单独输出
│ ├── gen_ziwei_liunian_html.js # [已废弃]紫微运势HTML—命书gen_ziwei_full已一站式含运势,不再单独输出
│ ├── gen_bazi_full_html.js # 八字【完整命书】HTML(命盘+藏干+纳音+五行+喜用+刑冲克害+神煞+LLM解读注入+大运+流年+折线图)
│ ├── gen_ziwei_full_html.js # 紫微【完整命书】HTML(环形盘面+格局成格/凶格卡+疾厄脏腑卡+LLM解读注入+大限+流年)
│ ├── gen_heming_ziwei_html.js # 紫微合盘HTML(双方关键宫联参+太阳太阴+四化互参+LLM五步法)
│ ├── gen_heming_bazi_html.js # 八字合盘HTML(双方四柱+日主十神+纳音生克+神煞对比+LLM合婚)
│ ├── vendor/ # iztro+tyme4ts+自研层+运行时依赖 内置(离线,见 vendor/README.md)
│ └── README.md
└── data/ # 静态查表（藏干/四化/节气，两套共用）
├── canggan.json
├── sihua.json
└── jieqi.json
全流程数据流（紫微 + 八字均已打通）：生辰 → scripts/paipan_ziwei.js（紫微 / iztro）或 scripts/bazi.js（八字 / tyme4ts+自研关系·神煞层）→ 结构化命盘 JSON → methods/*（推演）→ templates/*（渲染）。两引擎均已 vendor 内置、离线可用；脚本缺失时由用户提供排盘数据。按需 Read methods/ 与 corpus/ 对应文件，勿全量加载。引用倪师原话或古诀时查 corpus/verified/（倪师《天纪》原话，带集数出处）与 corpus/traditional/（通识古诀），确保引述准确、出处可溯。
- 紫微斗数推演：
methods/ziwei-method.md（独立体系，含十二宫、四化、大限流年、六维分析、格局速查）
- 八字命理推演：
methods/bazi-method.md（独立体系，含四柱十神、旺衰喜用、大运流年、应吉应凶、六亲对应；定用神四参合见第五节）
📂 workspace 工作目录（产出统一管理）
所有生成产出（命书/运势/合盘 HTML + 解读 JSON）默认写入 workspace 工作目录，集中管理、不散落、不入 git（.gitignore 已忽略 workspace/ 与 scripts/_*.json）。
路径解析优先级（高 → 低，见 scripts/_workspace.js）：
- 环境变量
ZIWEI_WORKSPACE
- 项目级：技能根下
.ziwei-workspace（纯文本，一行路径）
- 用户级：
~/.ziwei-workspace（纯文本，一行路径）
- 默认：
<技能根>/workspace（项目级未配置时，在当前项目下创建）
配置方法：
- 临时/全局：
ZIWEI_WORKSPACE=/path/to/ws node scripts/gen_*.js ...
- 项目级：技能根建
.ziwei-workspace 文件，写一行路径（相对路径相对技能根）
- 用户级：
~/.ziwei-workspace 写一行路径（多项目共用同一 workspace 时用）
使用：跑 gen_*_html 脚本无需传输出路径，默认自动入 workspace；解读 JSON 也建议放 workspace（ensureWorkspace() 自动建目录）。示例：
node scripts/gen_bazi_full_html.js 2000 8 16 14 30 男 1994 2080 "" workspace/_interp.json workspace/_liunian.json
应事法定时辰（通用核心）
当出生时辰在两个相邻时辰间不确定时（常见于记录模糊、真太阳时卡边界），用已发生且记忆明确的人生事件反推哪个命盘能对上。最强应事维度（按区分度排序）：
| 维度 | 紫微看什么 | 八字看什么 |
|---|
| 父亲 | 父母宫主星＋煞星（武曲擎羊火星主血光刑伤） | 偏财（父星）喜忌；父星忌年应凶 |
| 本人性格外貌 | 命宫主星组合 | 日主旺衰＋喜用（用印=技术内敛，用食伤=外向口才） |
| 健康/外伤 | 疾厄宫（七杀主手术，空宫主慢性） | 日主受克耗程度（甲木受耗=神经衰弱） |
| 事业类型 | 官禄宫主星（机梁=技术清高，机巨=口才成名） | 喜用神方向（用印=专业，用财官=经营） |
| 人生重心 | 身宫所在宫位 | 时柱十神（印=学业母缘，财=务实） |
双向验证法：对每个候选时辰，分别推演"某关键流年应吉还是应凶"，与命主真实事件对照——方向一致则该时辰成立，矛盾则排除。多组方向性验证同时成立，即为该时辰（非巧合）。
输出格式
HTML（美观，推荐用于完整命盘报告）
单文件内联 CSS，中国风配色（紫微用朱红宣纸、八字用青蓝水墨以示区分）。必备区块：基本信息 → 排盘/十二宫 → 核心格局 → 六维详析 → 大限/大运 → 流年逐年表 → 综合建议 → 免责声明。吉凶用颜色编码。
紫微盘面布局：十二宫按地支顺时针排成环形（4×4 井字形外圈，中央 2×2 放命主信息）。直接套用 templates/ziwei-chart.html——已内置环形 grid、四化徽章、特殊宫位（命宫/身宫/来因宫）高亮、中央信息区，替换数据即可。文件顶部注释有套用 4 步说明。
Markdown（轻量，用于对话内或快速报告）
同级标题分节，表格呈现流年/宫位，要点列表呈现建议。结尾附免责声明。
LLM 解读 JSON（_interp）生成指导（prompt 固化）
gen_*_full 接收 _interp 解读 JSON（由 LLM 生成、命令行第 6/9 参数注入，注入后命书"命主总论/格局/宫象"等区块才有内容）。生成 _interp 时遵循积极赋能四要点：
- 双轨：每条命理判断含
judgment（如实断，不粉饰）+ transform（转化路径）+ action（行动指引）+ mindset（心态），与 data/empower.json 条目结构一致。
- 积极基调：凶象转"功课/守成期"、吉象转"顺势窗口"；禁凶吓（"必凶/死局/家破"），用"需注意/宜 X/课题在 X"。
- 引 empower.json：查
data/empower.json 对应象（interpret/geju/palace_sihua/bazi_trait/dayun/liunian/heming）的转化语，保持口径一致；查不到走通用转化模板（_empower.genericTransform）。
- 结构：
_interp = {命主身主, 格局, 五行局, 生年四化, 命主总论, 宫象:{各宫双轨}, 疾厄} 等，每条双轨。
注：gen 代码层已机制化兜底——即使 _interp 仅含 judgment，gen 的 interpret/interpretLN 会自动对凶查 empower.interpret 配转化；但 _interp 本身双轨更佳（命主总论/格局等 LLM 区块也积极）。
免责声明（固定文本，产出必附）
本分析基于所提供的命盘/四柱数据，运用中国传统命理技法推演。命理学属于传统文化，并非实证科学，不具备经过科学验证的预测能力。所有吉凶判断、时间范围与建议，仅适用于文化研究、自我觉察与娱乐参考，不能替代专业医疗诊断、心理咨询、法律意见、投资理财或婚姻决策。命运由先天禀赋与后天选择共同塑造，理性看待、积极生活。如有实际困扰，请咨询专业持证人士。
常见误区
| 误区 | 正解 |
|---|
| 编造命主经历来"证明"某结论 | 只能用用户提供的真实事件验证，没提供就问，不要编 |
| 用绝对化断语（"必定""一定"） | 命理是概率推断，用"倾向于""需注意" |
| 紫微八字术语混用 | 两套独立，分别产出时互不引用 |
| 定盘只看单一事件 | 至少 3 组以上独立应事交叉验证，且含"方向性"（吉凶对错）验证 |
| 省略免责声明 | 任何命理产出结尾必加，无例外 |
