// 奇门遁甲排盘、解盘、择时、方位判断与理论教学技能。用户明确提到奇门遁甲、时家奇门、 奇门排盘、奇门解盘、奇门择吉、方位选择、趋吉避凶，或要求“用奇门”分析一件具体事情时， 必须使用本技能。正式排盘前先做结构化访谈，再调用脚本完成固定计算，最后再做解读与建议。
四柱八字专业排盘与解盘技能。当用户提到八字、四柱、天干地支、日主、十神、 大运流年、喜用神、格局、伤官配印、食神生财、五行旺衰、命局分析等相关内容时 触发此技能。也适用于用户想了解自己的命运、性格、事业、婚姻、财运等， 且明确要求或暗示使用八字体系的场景。包含完整的排盘、格局判断、十神分析、 大运流年推演等能力。
紫微斗数专业排盘与解盘技能。当用户提到紫微斗数、紫微排盘、紫微命盘、命宫、 十二宫、主星、四化、大限、流年、斗数格局、飞星、三方四正、紫微星、天机星、 太阳星、武曲星、天同星、廉贞星、天府星、太阴星、贪狼星、巨门星、天相星、 天梁星、七杀星、破军星等相关内容时触发此技能。也适用于用户想了解自己的命运、 性格、事业、婚姻、财运等，且明确要求或暗示使用紫微斗数体系的场景。包含完整的 排盘、宫位解读、四化分析、大限流年推演等能力。
| name | qimen-dunjia |
| description | 奇门遁甲排盘、解盘、择时、方位判断与理论教学技能。用户明确提到奇门遁甲、时家奇门、 奇门排盘、奇门解盘、奇门择吉、方位选择、趋吉避凶，或要求“用奇门”分析一件具体事情时， 必须使用本技能。正式排盘前先做结构化访谈，再调用脚本完成固定计算，最后再做解读与建议。 |
| compatibility | Requires Python 3.11+, lunar_python, and tzdata; run scripts/qimen_cli.py for all fixed calculations. |
本技能面向普通求测者，默认使用 mainline-cn-v1 规则集。工作方式是：
不要跳过访谈，不要在信息不完整时硬算，也不要把完整内部推理链直接展示给用户。
以下场景应使用本技能：
以下场景不要直接进入正式排盘：
mainline-cn-v1，不要在正式排盘路径里混用其他流派。scripts/qimen_cli.py。当前内置规则固定如下：
Asia/Shanghai详细规则见 references/ruleset-mainline.md。
如果用户明确要求别的流派：
mainline-cn-v1。正式排盘前，必须先做两段式访谈。
先问第一轮核心问题，语言要直白：
第二轮按条件追问：
访谈模板见 references/interview.md。
只有在以下信息确认后，才进入正式排盘：
如果没收齐，只继续追问，不要先排盘。
如果用户只是想学习理论：
references/examples.md 做教学。前置：确认依赖已安装
执行正式排盘前先检查依赖。如果未安装，先运行：
pip install "lunar_python>=1.4.8,<2" "tzdata>=2024.1"
执行脚本
脚本路径以仓库根目录为基准：
python "qimen-dunjia/scripts/qimen_cli.py" \
--input "tmp/qimen_input.json" \
--output "tmp/qimen_output.json"
先把输入 JSON 写入 tmp/qimen_input.json，再执行上述命令，读取 tmp/qimen_output.json。tmp/ 也可以替换成任意可写的临时目录。
输入 JSON 最低字段：
{
"question_type": "",
"question_goal": "",
"time_input": "",
"calendar_type": "solar|lunar|now",
"location": {
"country": "",
"city": "",
"timezone": ""
},
"ruleset": "mainline-cn-v1"
}
使用要求：
重点读取以下字段：
| 字段 | 用途 |
|---|---|
normalized_input | 确认时间、时区、事项被正确解析 |
calendar | 公历/农历对照、当前节令 |
ganzhi | 年月日时干支、日旬、时旬（用于定旬首/旬空） |
chart.dun_type | 阴遁/阳遁 |
chart.yuan | 上元/中元/下元 |
chart.ju_number | 局数（1-9） |
chart.xunshou | 旬首（如"甲子"） |
chart.hidden_yi | 旬首奇仪（寄宫的隐干，如"戊"）——不可遗漏 |
chart.kongwang | 旬空地支（如["寅","卯"]） |
chart.kongwang_palaces | 旬空对应宫位编号 |
chart.time_stem_visible | 时干（代表用户当前状态，取用神的关键参考） |
chart.zhifu | 值符：{ palace, star, ... } 嵌套对象，读 palace（宫位）和 star（星名） |
chart.zhishi | 值使：{ palace, door, ... } 嵌套对象，读 palace（宫位）和 door（门名） |
chart.palaces | 9 宫完整数组，每宫含 palace、earth_stem、sky_stem、star、door、god、is_center、hosts_center |
warnings | 边界提醒、寄宫提醒等 |
注意事项：
chart.palaces 中 5 号宫（中宫）door 和 god 为 null，星为 天禽，不参与常规用神判断。hosts_center: true，中宫寄坤时此宫承载中宫信息。chart.time_stem_visible 是时干的明干（显干），用于判断用户本人在盘中的代表位置。warnings 里出现边界提示、中宫寄宫提示，要在解读里明确说明。正式排盘响应统一按这个结构：
用直白语言复述：
必须写明：
mainline-cn-v1Asia/Shanghai只讲关键计算结果，不堆砌无意义术语：
必要时可列出简洁宫位摘要，不要求把每一步内部推演全展示出来。
按事项取用神，优先参考 references/yongshen.md。
写法要求：
不要堆一串术语而不解释。
要回答用户最关心的问题，比如：
不要故意模糊。
把盘理转换成可执行建议，例如：
高风险话题必须额外提醒现实专业路径。
每次正式解盘结尾都附上：
温馨提示：奇门遁甲属于传统文化中的术数模型，本次解读用于辅助观察与思考，不代替医疗、法律、财务等专业意见。涉及重大决策时，请同时结合现实信息理性判断。
references/examples.md。references/ruleset-mainline.md：默认规则说明references/interview.md：访谈问题库与追问条件references/yongshen.md：取用神顺序和事项映射references/geju.md：格局与常见组合的简明解释references/examples.md：示例输出