By name: ziwei-iztro-reader description: 使用 iztro 生成紫微斗数排盘并输出分层解读。适用于用户要求基于出生日期、出生时辰、出生地与性别进行本命盘分析，或要求流年/流月/流日/未来时间段推演时。支持先确认出生日期是公历或农历，再生成对应盘面并按"本命→流年→流月→流日"层级解读。
Ziwei Iztro Reader
按以下顺序执行，保证日期与解读层级一致。
1. 收集并标准化输入
先收集这些字段：
- 出生信息确认：
birth.confirmed = true - 出生日期类型：
solar（公历）或lunar（农历） - 出生日期：
YYYY-M-D - 出生时辰索引：
0..12（见references/time-index.md） - 性别：
male或female - 出生地（非空文本）
- 当前所在地时区（IANA，如
Asia/Shanghai）
执行规则：
- 先明确用户说的出生日期是公历还是农历，未确认时不得排盘。
- 未满足"出生信息已确认"时，停止输出并只返回缺失项。
- 本命盘直接使用"出生地当地民用出生时间"语义，不额外做真太阳时修正。
- 当用户问"今天/本月/未来某天"时，先按"当前所在地时区"确定公历日期，再计算流运。
- 回答里同时写出公历日期和对应农历日期，避免相对时间歧义。
2. 生成盘面数据
- 进入
scripts/并安装依赖：npm install - 构造输入 JSON（见
references/input-schema.md，可复制scripts/example.input.json） - 运行：
node iztro_runner.mjs input.json - 读取输出 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。除非用户明确要求"简版/一句话"，不得降级成摘要式回答。
按以下结构输出（固定模板）：
- 输入确认：公历/农历、出生信息、时区、参考日期（公历+农历+星期几）
- 口径声明：默认使用
byRole（宫位角色映射） - 本命盘：12宫完整明细（主星/辅星/杂曜/12神）
- 流年：12宫完整明细 + 四化 + 流星
- 流月：12宫完整明细 + 四化 + 流星
- 流日：12宫完整明细 + 四化 + 流星
- 未来辅助信息：未来日期对比与建议
- 固定免责声明：文化研究与娱乐参考，默认未做真太阳时修正
硬性质量门槛：
- 禁止仅输出"星盘 + 一句话评价"。默认必须输出分层结论与证据。
- 默认遍历
currentDetailed.palaces[]输出 12 宫，不得跳过宫位只给总评。 - 明细优先包含：主星、辅星、杂曜、长生十二神、博士十二神、岁前十二神、将前十二神、各层流星（大限/小限/流年/流月/流日/流时）与四化标签。
- 不可省略
tags（如本命禄、大限权、流年科、流月忌），除非该星没有标签。 - 默认只使用
flowStarsByRole进行解读；仅在开发调试时才读取flowStarsByIndex。 - 必须给出证据链：每条关键判断都要写清"宫位/星曜组合/四化或 tags/落点领域/推断结论"。
- 必须按层级归因：本命、流年、流月、流日分开陈述，禁止跨层归因。
- 若平台输出长度受限：分批连续输出（如"第1部分/第2部分"），不得改成极简一句话。
6. 解读参考
以下是辅助解读的核心知识点，用于保证解读一致性。
6.1 十四主星简要性质
| 主星 | 关键词 | 核心特质 |
|---|---|---|
| 紫微 | 帝王、尊贵、主导 | 领导力强，好面子，喜掌控全局，适合决策与管理角色 |
| 天机 | 智慧、变动、谋略 | 思维敏捷善谋划，但易多虑犹豫，适合幕僚与策划型工作 |
| 太阳 | 光明、博爱、付出 | 热心助人不求回报，男命主贵，女命利父利夫，庙旺时光芒四射 |
| 武曲 | 财星、刚毅、果断 | 理财能力强，性格刚直，重效率轻情感，适合金融与技术领域 |
| 天同 | 福星、温和、享受 | 性格随和知足常乐，缺乏冲劲但晚运佳，适合服务与文化行业 |
| 廉贞 | 次桃花、政治、复杂 | 精明能干，感情复杂，善于公关，入庙可掌权，陷地易生是非 |
| 天府 | 财库、稳健、保守 | 温厚踏实，善于守成理财，安全感强，不喜冒险 |
| 太阴 | 田宅、阴柔、细腻 | 感性细致，重内在美感，女命端庄，适合文艺与不动产领域 |
| 贪狼 | 桃花、欲望、多才 | 交际广泛多才多艺，物质精神欲望并重，善变但适应力强 |
| 巨门 | 口舌、是非、研究 | 口才好但容易招惹是非，适合研究分析、律师、教师等口才行业 |
| 天相 | 印星、辅佐、协调 | 为人正派善协调，适合辅佐与行政角色，受邻宫影响大 |
| 天梁 | 荫星、贵人、化解 | 逢凶化吉的能力强，适合公职医疗教育，好为人师 |
| 七杀 | 将星、开创、孤克 | 魄力十足敢闯敢拼，人生波折大但成就也大，宜军警商界 |
| 破军 | 耗星、变革、破旧立新 | 不满现状喜改变，先破后立，人生起伏大，适合创业与改革 |
6.2 四化解读要点
四化含义：
- 禄（化禄）：顺利、收获、增加、缘分到来
- 权（化权）：掌控、竞争、主导、有力度
- 科（化科）：名声、贵人、学业、小幅改善
- 忌（化忌）：执念、阻碍、损耗、需注意的功课
四化落宫解读原则：
- 四化落入哪个宫位，就在该宫位的领域产生作用
- 本命四化代表一生的基本格局；流年/月/日四化代表该时段的重点变化
- 忌不等于坏，而是代表执念与关注点——该宫位是此时需要花精力处理的领域
- 禄忌同宫时，表示该领域"有得有失"，关注先后顺序
多层四化叠加：
- 同一颗星被不同层级同时化禄/权/科/忌时，效果叠加放大
- 例如：武曲本命禄 + 流月禄 = "双禄"，财运能量显著增强
- 例如：廉贞流年忌 + 流日忌 = "双忌"，该日该领域压力极大
- 叠加分析时，标注来源层级：如"武曲（本命禄+流月禄）"
6.3 常见星曜格局
- 紫微天府同宫/对照：帝王与宰相搭配，格局大气，适合大规模管理
- 杀破狼（七杀、破军、贪狼三方会照）：人生变动大、开创力强，适合创业但过程波折
- 机月同梁（天机、太阴、天同、天梁会照）：适合公职体系或稳定的行政文化工作
- 日月同宫/对照：太阳太阴搭配，理性感性兼具，但需注意庙旺陷落
- 府相朝垣：天府天相会照，稳健有序，利于守成
- 巨门化忌：口舌是非加重，该时期沟通需格外谨慎
- 火贪格 / 铃贪格：贪狼在辰戌丑未四墓宫遇火星或铃星，主"横发"。贪狼不在墓宫时不算严格的火贪格，效果打折。
6.4 星曜组合效应
单颗星的性质会被同宫星曜显著修正。解读时必须考虑组合：
主星 + 煞星/空曜组合：
- 破军 + 地劫：开创力被"空"住，行事犹豫反复，内在能量大但释放困难
- 破军 + 天刑：自我约束极强，冲突面前倾向压抑而非爆发
- 武曲天府 + 地空/天空：理财能力被空曜干扰，"想好了再动"但永远觉得没想好；天府见空曜不为佳
- 天同 + 陀罗：被动拖延、缓慢消磨，不肯发生明面冲突但也不果断解决
- 廉贞 + 擎羊：刚烈性加重，感情或事业上容易激化冲突
- 贪狼 + 火星（非墓宫）：有投机性和突发机遇，但不构成严格"火贪格"，需看宫位和庙旺
辅星修正效应：
- 左辅/右弼：增加助力和贵人缘，但也可能增加"被人推着走"的被动性
- 文昌/文曲：增加才华和表达，但化忌时主文书错误、口舌是非
- 天魁/天钺：贵人星，逢凶化吉的缓冲；天魁为阳贵（主动求助有用），天钺为阴贵（被动获助）
- 禄存：财星、稳定，但同时带擎羊陀罗夹宫，有"禄存独坐则孤"的隐忧
6.5 身宫解读（重要补充）
身宫代表后天努力的方向和人生关注重心，与命宫同等重要。
解读原则：
- 身宫的宫位名称指示后天侧重领域。例如身宫在夫妻宫，后天努力方向围绕伴侣关系和合作。
- 身宫中的星曜影响后天的行为模式和发展路径。
- 流年/流月四化冲击身宫时需特别注意——这直接影响当事人后天努力的核心领域。
- 身宫兼命宫（身命同宫）：先天后天重合，性格和努力方向一致，影响集中。
- 身宫在他宫时：命宫看先天格局，身宫看后天侧重。
身宫在不同宫位的含义：
| 身宫位置 | 后天侧重 |
|---|---|
| 命宫 | 自我实现、个人发展 |
| 夫妻宫 | 伴侣关系、婚姻经营 |
| 财帛宫 | 赚钱理财、物质追求 |
| 迁移宫 | 外出发展、社交拓展 |
| 事业宫 | 职业成就、事业追求 |
| 福德宫 | 精神生活、内心修养 |
6.6 空宫借星规则
当某宫位没有十四主星坐守时，称为"空宫"。空宫的解读方式：
- 借对宫主星：空宫借用对宫（180°）的主星来论断。例如命宫空宫，对宫迁移有紫微天相，则命宫借紫微天相来论。
- 借星效力打折：借来的星力量弱于原坐，约为原坐的六到七成。
- 空宫本身的特质：空宫主人"无主见"、"受环境影响大"、"随遇而安但缺乏主导力"。
- 流运命宫落空宫：该时期方向感较弱，容易迷茫，需要借力（贵人、环境）来推动。
- 空宫仍看杂曜和流星：虽然没有主星，但宫内的杂曜、辅星、流星仍然生效。
6.7 本命与流运叠加原则
- 本命为底：本命盘是一生的基本盘，流运是阶段性叠加
- 层级递进：本命 → 大限（10年）→ 流年 → 流月 → 流日，越靠后影响越短暂
- 吉凶叠加：
- 本命吉 + 流运吉 = 强烈利好
- 本命吉 + 流运凶 = 有底气但需注意
- 本命凶 + 流运吉 = 暂时改善但根基不稳
- 本命凶 + 流运凶 = 该领域此时需格外小心
- 不可跨层归因：流月的问题不能归结于本命，反之亦然
- 大限是中期底色：大限定义了十年的基调。同一个流年，在不同大限中的表现可能完全不同。解读流年前必须先看大限格局。
6.8 十二宫位核心领域
| 宫位 | 核心领域 |
|---|---|
| 命宫 | 性格、外在表现、整体格局 |
| 兄弟宫 | 兄弟姐妹、平辈关系、合伙人 |
| 夫妻宫 | 婚姻、伴侣关系、合作对象 |
| 子女宫 | 子女、下属、创作产出 |
| 财帛宫 | 收入方式、理财能力、金钱观 |
| 疾厄宫 | 健康体质、灾厄、情绪状态 |
| 迁移宫 | 外出运、社交场合表现、异地发展 |
| 交友宫（仆役） | 朋友圈、同事关系、下属助力 |
| 事业宫（官禄） | 工作类型、职业发展、事业方向 |
| 田宅宫 | 不动产、家庭环境、生活品质、动产（车辆等） |
| 福德宫 | 精神状态、兴趣嗜好、内心满足感、投资心态 |
| 父母宫 | 父母关系、长辈缘分、教育背景、学习运 |
6.9 解读心法
从星盘到现实的映射原则：
- 星曜组合描述的是"能量模式"，不是宿命判定。同一组合在不同人生阶段、不同社会环境下的具体表现不同。
- 解读时应结合当事人的实际背景（职业、年龄、所处环境）来"落地"星盘信息，而不是套用教科书式的结论。
- 化忌不等于灾难，化禄不等于发财——需要看宫位、看组合、看层级。
- 关键判断应做"多重验证"：如果一个结论只有一个宫位支持，可能性较低；如果多个宫位的信息指向同一方向，可靠性显著提高。
实用建议的给出原则：
- 星盘指出的是"容易遇到的心理模式和能量场"，帮助当事人在关键时刻保持觉察。
- 建议应具体可执行，不能只说"注意"而不说怎么注意。
- 命理是参考框架，不应成为拖延行动的借口。"这个月不好"不等于"什么都不能做"。
- 后天人事有决定命运的力量——命盘定义的是倾向和挑战，不是不可改变的结局。
7. 失败处理
- 缺少关键字段时，明确列出缺失项并停止解读。
- 日期解析失败时，要求用户提供明确格式（
YYYY-M-D）。 iztro未安装时，提示先在scripts/目录运行npm install。
参考：
references/time-index.mdreferences/input-schema.mdreferences/interpretation-template.md