zxsun2022/ziwei-iztro-reader

Ziwei Iztro Reader

按以下顺序执行，保证日期与解读层级一致。

1. 收集并标准化输入

先收集这些字段：

• 出生信息确认：birth.confirmed = true
• 出生日期类型：solar（公历）或 lunar（农历）
• 出生日期：YYYY-M-D
• 出生时辰索引：0..12（见 references/time-index.md）
• 性别：male 或 female
• 出生地（非空文本）
• 当前所在地时区（IANA，如 Asia/Shanghai）

执行规则：

• 先明确用户说的出生日期是公历还是农历，未确认时不得排盘。
• 未满足"出生信息已确认"时，停止输出并只返回缺失项。
• 本命盘直接使用"出生地当地民用出生时间"语义，不额外做真太阳时修正。
• 当用户问"今天/本月/未来某天"时，先按"当前所在地时区"确定公历日期，再计算流运。
• 回答里同时写出公历日期和对应农历日期，避免相对时间歧义。

2. 生成盘面数据

1. 进入 scripts/ 并安装依赖：npm install
2. 构造输入 JSON（见 references/input-schema.md，可复制 scripts/example.input.json）
3. 运行：node iztro_runner.mjs input.json
4. 读取输出 JSON：
   • natalSummary：命盘元数据（命主、身主、五行局、干支、星座、生肖等）
   • currentDetailed：当前日期的逐宫详细快照（推荐用于完整输出）
   • futureDetailed[]：未来日期的逐宫详细快照

3. 日期处理守卫规则（强制）

日期相关信息必须从脚本输出中提取，严禁自行推算。这是防止日期错误的核心规则。

3.1 星期几

• 必须使用输出中的 dayOfWeek 字段（如 "Wednesday"）。
• 严禁在回答中自行计算或猜测星期几。
• 如果输出中缺少 dayOfWeek（旧版脚本），使用 bash 命令 date -d "YYYY-MM-DD" +%A 获取。

3.2 农历日期

• 必须使用输出中的 targetLunarDate 字段（如 "二〇二六年正月十六"）。
• 严禁自行将公历转换为农历。
• 如需确认某个公历日期属于哪个农历月份，排盘后从 monthly 层数据中读取。

3.3 流月/流日天干

• 必须使用输出中的 dateSummary.monthlyHeavenlyStem 和 dateSummary.dailyHeavenlyStem 字段。
• 严禁自行用"五虎遁"或"五鼠遁"口诀推算流月/流日天干。
• 注意：iztro 的流月天干排法可能与某些传统口诀存在口径差异，以 iztro 输出为准。

3.4 四化对应

• 流月四化从 monthly.mutagen 数组读取，流日四化从 daily.mutagen 数组读取。
• 四化数组的顺序固定为 [化禄星, 化权星, 化科星, 化忌星]。
• 严禁自行根据天干推算四化飞星——直接使用脚本输出。

3.5 日期确认模板

回答中引用日期时，使用以下格式确认：

公历 YYYY年M月D日（星期X）| 农历 [lunarDate] | [dailyGanZhi]日

示例：

公历 2026年3月4日（星期三）| 农历二〇二六年正月十六 | 丁丑日

4. 按层级解读

解读必须遵循层级依赖：

• 解读流年：基于 本命 + yearly 层数据
• 解读流月：基于 本命 + yearly + monthly 层数据
• 解读流日：基于 本命 + yearly + monthly + daily 层数据

对未来时间段：

• 用 futureDetailed[] 做对比，强调趋势与时间窗口，不替代本命结构。

5. 输出格式（强制深度解读合同）

默认输出档位：full。除非用户明确要求"简版/一句话"，不得降级成摘要式回答。

按以下结构输出（固定模板）：

1. 输入确认：公历/农历、出生信息、时区、参考日期（公历+农历+星期几）
2. 口径声明：默认使用 byRole（宫位角色映射）
3. 本命盘：12宫完整明细（主星/辅星/杂曜/12神）
4. 流年：12宫完整明细 + 四化 + 流星
5. 流月：12宫完整明细 + 四化 + 流星
6. 流日：12宫完整明细 + 四化 + 流星
7. 未来辅助信息：未来日期对比与建议
8. 固定免责声明：文化研究与娱乐参考，默认未做真太阳时修正

硬性质量门槛：

• 禁止仅输出"星盘 + 一句话评价"。默认必须输出分层结论与证据。
• 默认遍历 currentDetailed.palaces[] 输出 12 宫，不得跳过宫位只给总评。
• 明细优先包含：主星、辅星、杂曜、长生十二神、博士十二神、岁前十二神、将前十二神、各层流星（大限/小限/流年/流月/流日/流时）与四化标签。
• 不可省略 tags（如 本命禄、大限权、流年科、流月忌），除非该星没有标签。
• 默认只使用 flowStarsByRole 进行解读；仅在开发调试时才读取 flowStarsByIndex。
• 必须给出证据链：每条关键判断都要写清"宫位/星曜组合/四化或 tags/落点领域/推断结论"。
• 必须按层级归因：本命、流年、流月、流日分开陈述，禁止跨层归因。
• 若平台输出长度受限：分批连续输出（如"第1部分/第2部分"），不得改成极简一句话。

6. 解读参考

以下是辅助解读的核心知识点，用于保证解读一致性。

6.1 十四主星简要性质

| 主星 | 关键词 | 核心特质 | |------|--------|----------| | 紫微 | 帝王、尊贵、主导 | 领导力强，好面子，喜掌控全局，适合决策与管理角色 | | 天机 | 智慧、变动、谋略 | 思维敏捷善谋划，但易多虑犹豫，适合幕僚与策划型工作 | | 太阳 | 光明、博爱、付出 | 热心助人不求回报，男命主贵，女命利父利夫，庙旺时光芒四射 | | 武曲 | 财星、刚毅、果断 | 理财能力强，性格刚直，重效率轻情感，适合金融与技术领域 | | 天同 | 福星、温和、享受 | 性格随和知足常乐，缺乏冲劲但晚运佳，适合服务与文化行业 | | 廉贞 | 次桃花、政治、复杂 | 精明能干，感情复杂，善于公关，入庙可掌权，陷地易生是非 | | 天府 | 财库、稳健、保守 | 温厚踏实，善于守成理财，安全感强，不喜冒险 | | 太阴 | 田宅、阴柔、细腻 | 感性细致，重内在美感，女命端庄，适合文艺与不动产领域 | | 贪狼 | 桃花、欲望、多才 | 交际广泛多才多艺，物质精神欲望并重，善变但适应力强 | | 巨门 | 口舌、是非、研究 | 口才好但容易招惹是非，适合研究分析、律师、教师等口才行业 | | 天相 | 印星、辅佐、协调 | 为人正派善协调，适合辅佐与行政角色，受邻宫影响大 | | 天梁 | 荫星、贵人、化解 | 逢凶化吉的能力强，适合公职医疗教育，好为人师 | | 七杀 | 将星、开创、孤克 | 魄力十足敢闯敢拼，人生波折大但成就也大，宜军警商界 | | 破军 | 耗星、变革、破旧立新 | 不满现状喜改变，先破后立，人生起伏大，适合创业与改革 |

6.2 四化解读要点

四化含义：

• 禄（化禄）：顺利、收获、增加、缘分到来
• 权（化权）：掌控、竞争、主导、有力度
• 科（化科）：名声、贵人、学业、小幅改善
• 忌（化忌）：执念、阻碍、损耗、需注意的功课

四化落宫解读原则：

• 四化落入哪个宫位，就在该宫位的领域产生作用
• 本命四化代表一生的基本格局；流年/月/日四化代表该时段的重点变化
• 忌不等于坏，而是代表执念与关注点——该宫位是此时需要花精力处理的领域
• 禄忌同宫时，表示该领域"有得有失"，关注先后顺序

多层四化叠加：

• 同一颗星被不同层级同时化禄/权/科/忌时，效果叠加放大
• 例如：武曲本命禄 + 流月禄 = "双禄"，财运能量显著增强
• 例如：廉贞流年忌 + 流日忌 = "双忌"，该日该领域压力极大
• 叠加分析时，标注来源层级：如"武曲（本命禄+流月禄）"

6.3 常见星曜格局

• 紫微天府同宫/对照：帝王与宰相搭配，格局大气，适合大规模管理
• 杀破狼（七杀、破军、贪狼三方会照）：人生变动大、开创力强，适合创业但过程波折
• 机月同梁（天机、太阴、天同、天梁会照）：适合公职体系或稳定的行政文化工作
• 日月同宫/对照：太阳太阴搭配，理性感性兼具，但需注意庙旺陷落
• 府相朝垣：天府天相会照，稳健有序，利于守成
• 巨门化忌：口舌是非加重，该时期沟通需格外谨慎
• 火贪格 / 铃贪格：贪狼在辰戌丑未四墓宫遇火星或铃星，主"横发"。贪狼不在墓宫时不算严格的火贪格，效果打折。

6.4 星曜组合效应

单颗星的性质会被同宫星曜显著修正。解读时必须考虑组合：

主星 + 煞星/空曜组合：

• 破军 + 地劫：开创力被"空"住，行事犹豫反复，内在能量大但释放困难
• 破军 + 天刑：自我约束极强，冲突面前倾向压抑而非爆发
• 武曲天府 + 地空/天空：理财能力被空曜干扰，"想好了再动"但永远觉得没想好；天府见空曜不为佳
• 天同 + 陀罗：被动拖延、缓慢消磨，不肯发生明面冲突但也不果断解决
• 廉贞 + 擎羊：刚烈性加重，感情或事业上容易激化冲突
• 贪狼 + 火星（非墓宫）：有投机性和突发机遇，但不构成严格"火贪格"，需看宫位和庙旺

辅星修正效应：

• 左辅/右弼：增加助力和贵人缘，但也可能增加"被人推着走"的被动性
• 文昌/文曲：增加才华和表达，但化忌时主文书错误、口舌是非
• 天魁/天钺：贵人星，逢凶化吉的缓冲；天魁为阳贵（主动求助有用），天钺为阴贵（被动获助）
• 禄存：财星、稳定，但同时带擎羊陀罗夹宫，有"禄存独坐则孤"的隐忧

6.5 身宫解读（重要补充）

身宫代表后天努力的方向和人生关注重心，与命宫同等重要。

解读原则：

• 身宫的宫位名称指示后天侧重领域。例如身宫在夫妻宫，后天努力方向围绕伴侣关系和合作。
• 身宫中的星曜影响后天的行为模式和发展路径。
• 流年/流月四化冲击身宫时需特别注意——这直接影响当事人后天努力的核心领域。
• 身宫兼命宫（身命同宫）：先天后天重合，性格和努力方向一致，影响集中。
• 身宫在他宫时：命宫看先天格局，身宫看后天侧重。

身宫在不同宫位的含义： | 身宫位置 | 后天侧重 | |----------|----------| | 命宫 | 自我实现、个人发展 | | 夫妻宫 | 伴侣关系、婚姻经营 | | 财帛宫 | 赚钱理财、物质追求 | | 迁移宫 | 外出发展、社交拓展 | | 事业宫 | 职业成就、事业追求 | | 福德宫 | 精神生活、内心修养 |

6.6 空宫借星规则

当某宫位没有十四主星坐守时，称为"空宫"。空宫的解读方式：

1. 借对宫主星：空宫借用对宫（180°）的主星来论断。例如命宫空宫，对宫迁移有紫微天相，则命宫借紫微天相来论。
2. 借星效力打折：借来的星力量弱于原坐，约为原坐的六到七成。
3. 空宫本身的特质：空宫主人"无主见"、"受环境影响大"、"随遇而安但缺乏主导力"。
4. 流运命宫落空宫：该时期方向感较弱，容易迷茫，需要借力（贵人、环境）来推动。
5. 空宫仍看杂曜和流星：虽然没有主星，但宫内的杂曜、辅星、流星仍然生效。

6.7 本命与流运叠加原则

1. 本命为底：本命盘是一生的基本盘，流运是阶段性叠加
2. 层级递进：本命 → 大限（10年）→ 流年 → 流月 → 流日，越靠后影响越短暂
3. 吉凶叠加：
   • 本命吉 + 流运吉 = 强烈利好
   • 本命吉 + 流运凶 = 有底气但需注意
   • 本命凶 + 流运吉 = 暂时改善但根基不稳
   • 本命凶 + 流运凶 = 该领域此时需格外小心
4. 不可跨层归因：流月的问题不能归结于本命，反之亦然
5. 大限是中期底色：大限定义了十年的基调。同一个流年，在不同大限中的表现可能完全不同。解读流年前必须先看大限格局。

6.8 十二宫位核心领域

| 宫位 | 核心领域 | |------|----------| | 命宫 | 性格、外在表现、整体格局 | | 兄弟宫 | 兄弟姐妹、平辈关系、合伙人 | | 夫妻宫 | 婚姻、伴侣关系、合作对象 | | 子女宫 | 子女、下属、创作产出 | | 财帛宫 | 收入方式、理财能力、金钱观 | | 疾厄宫 | 健康体质、灾厄、情绪状态 | | 迁移宫 | 外出运、社交场合表现、异地发展 | | 交友宫（仆役） | 朋友圈、同事关系、下属助力 | | 事业宫（官禄） | 工作类型、职业发展、事业方向 | | 田宅宫 | 不动产、家庭环境、生活品质、动产（车辆等） | | 福德宫 | 精神状态、兴趣嗜好、内心满足感、投资心态 | | 父母宫 | 父母关系、长辈缘分、教育背景、学习运 |

6.9 解读心法

从星盘到现实的映射原则：

1. 星曜组合描述的是"能量模式"，不是宿命判定。同一组合在不同人生阶段、不同社会环境下的具体表现不同。
2. 解读时应结合当事人的实际背景（职业、年龄、所处环境）来"落地"星盘信息，而不是套用教科书式的结论。
3. 化忌不等于灾难，化禄不等于发财——需要看宫位、看组合、看层级。
4. 关键判断应做"多重验证"：如果一个结论只有一个宫位支持，可能性较低；如果多个宫位的信息指向同一方向，可靠性显著提高。

实用建议的给出原则：

1. 星盘指出的是"容易遇到的心理模式和能量场"，帮助当事人在关键时刻保持觉察。
2. 建议应具体可执行，不能只说"注意"而不说怎么注意。
3. 命理是参考框架，不应成为拖延行动的借口。"这个月不好"不等于"什么都不能做"。
4. 后天人事有决定命运的力量——命盘定义的是倾向和挑战，不是不可改变的结局。

7. 失败处理

• 缺少关键字段时，明确列出缺失项并停止解读。
• 日期解析失败时，要求用户提供明确格式（YYYY-M-D）。
• iztro 未安装时，提示先在 scripts/ 目录运行 npm install。

参考：

• references/time-index.md
• references/input-schema.md
• references/interpretation-template.md