Liki — Professional AI Astrologer

八宅排盘：由已校准 subject 推导出生年与性别，排命卦、四吉四凶方与出生年紫白飞星。subject 必须来自用户确认事实或 subject_candidates；时间或性别非法时返回错误，不猜测出生时辰。住宅风水评估、命卦方位吉凶类问题调用；门/主/灶配合改用 bazhai_layout。八宅不与八字四柱合参。

八宅门主灶配合：评估命卦与门/主/灶卦的游年九星、方向与吉凶。门/主/灶卦必须来自建筑方位或用户确认事实，本工具不反推方位。已由 bazhai_chart 得到命卦后调用；输出是八宅学派确定性参考判断，不是施工或安全建议；玄空飞星用 xuankong 工具。

八字合盘返回确定性关系事实，不做合婚评级。a/b 必须来自用户确认事实或 subject_candidates 归一化候选；非法、不完整或未确认的模糊 subject 直接报错。用户询问合婚、合作、亲子等关系并需要八字侧证据时调用；需要紫微宫位主星对照用 ziwei_bond，两者常配合使用。

排八字本命盘并返回确定性结构事实。subject 可由用户明确事实组装，也可取自用户确认后的 subject_candidates 候选；时间模糊或多候选时先归一化并确认。需要四柱、大运、十神、藏干、神煞、刑冲合会、扶抑/调候或格局证据时调用。只要原始本命盘，不用八字紫微合参断语；后者用 natal_query，紫微宫位细节用 ziwei_chart。

八字流盘：按 scope 返回 liu_nian/liu_yue/liu_ri/liu_shi/xiao_yun 对应领域数组，字段见 output schema。按粒度选择：逐年用 liu_nian，逐月用 liu_yue，具体日期用 liu_ri，具体时辰用 liu_shi，童年或小运趋势用 xiao_yun。count=1 单层，count>1 连续批量；liu_ri/liu_shi 必须带经度，非法 scope/count/time 或缺失必需经度直接报错。只返回确定性流盘事实，不做断语；本命盘用 bazi_chart，八字紫微逐年合参断语用 natal_liunian_query。

schema 合法的已归一化出生主体 → 确定性唯一用神裁决。subject 可由用户明确事实组装，也可取自用户确认后的 subject_candidates；时间模糊或多候选时先归一化并确认。返回 status、selected_yongshen、conflicts、命中规则、格局上下文与裁决证据；conflicts 非空或 status 需复核时不静默改选。只要原始八字盘时用 bazi_chart；起名只消费 selected_yongshen.yong。

根据城市名返回城市信息候选（内置表，不访问外链）：每项含名称、行政区、层级、经纬度、IANA 时区与可选经度范围；locale 只本地化名称展示，不改变匹配集合。长度 1 可直接使用；多于 1（同名区县等）必须由用户确认，不得静默取第一个。未命中时请询问附近大城市，或让用户直接提供经纬度和时区。

黄历择日查日。用户询问某事项宜忌日期、某日吉凶或黄历宜忌事实时调用；从 standard_time 起返回连续 count 天，指定 event 时逐日附适配结论与判定依据，范围内无适配日也不报错。命理合参（八字/紫微本命、流年）不走本工具，改用对应排盘与查询工具。

一次完成六爻起卦、排盘和结构化解读，适用于以卦象断事的问询（吉凶、成败、得失）。casting=auto 时会新起一卦，同一事禁止自动重试或重复调用；后续追问基于本次 Reading 解释，卦象事实按 schema 原样使用。需要时空方位决策时改用 qimen_ask。

按精确单字查询起名字库事实：字频、五行、笔画、部首、拼音、声调。不做繁简/异体折叠，不接受多字或空白变体；未收录时 character 为 null。适用于核对单字属性；取字池用 naming_pick，组合候选名用 naming_compose，整名评估用 naming_check。

独立评估整名，不生成候选名；生成用 naming_compose，取字池用 naming_pick。接受 1-200 个去重候选名，逐个返回 evaluations：invalid 不中断批量，以 valid=false 与结构化 errors 说明长度、字库、禁用/必含字或音律问题。selected_yongshen 直接使用八字裁决对象且仅接受 resolved/partial；省略时不做五行角色评估。

将已收录且非禁用的字组合为候选名：单名=first_chars 单字，双名=first_chars×second_chars 两字组合；按 first_chars 顺序生成并在 max_names 处截断。输入字池须来自 naming_pick，重复字会被拒绝。组合后的候选名评估用 naming_check，单字事实查询用 naming_character。

按用/喜五行角色取字池：selected_yongshen 直接使用八字用神裁决返回；first_role 与 second_role 选择字位角色，second_role 省略表示单名；生成阶段不提供 ji 字池。字池产出后组合候选名用 naming_compose，组合前查单字事实用 naming_character。

按发音匹配候选姓氏：源姓必须是 Latin 拼音/英文拼写，匹配前会 trim、lowercase 并折叠常见拉丁变体；按 pinyin_exact / romanization_exact / phonetic_close 排序，无匹配时按百家姓顺序回退。max_candidates 是硬上限。仅处理姓氏；取字池用 naming_pick，整名评估用 naming_check。

schema 合法出生主体 + start_year/year_count/life_topics → 八字与紫微逐年流年合参断语。subject 必须来自用户确认事实或 subject_candidates；时间模糊先归一化确认。服务端内部计算因子；失败年保留结构化 error，不中断整批。只要单个原始流盘用 bazi_liupan / ziwei_liupan；本命断语用 natal_query。

schema 合法的出生主体 + 人生问题 → 八字与紫微本命合参断语。subject 可由用户明确事实组装，也可取自用户确认后的 subject_candidates 候选；时间模糊或多候选时先归一化并确认。只要原始本命盘时改用 bazi_chart / ziwei_chart；逐年流年断语用 natal_liunian_query。因子计算由服务端内部完成，不对外返回。

一次完成奇门起局、因子投影和结构化解读，适用于需要时空方位信息的决策类问题（出行、谈判、寻物、择时方位等）。longitude 必填，城市需先转换；subject 与金函玉镜不兼容，非法组合在解读前失败。同一事禁止重新排局，后续追问基于本次 Reading 解释；起卦问事（得卦象而非方位盘）改用 liuyao_ask。

把民用时间事实归一化为 canonical subject 候选：接受公历/农历壁钟、时辰或同日区间；longitude_range 可选，表示地点边界不确定性。返回候选列表，input 候选恒定第一，边界派生候选按时间排序，每个候选附 reasons；longitude_range 省略时只用精确 longitude，非法时间、时区或范围直接报错。时间明确时直接组装下游 subject；模糊或触及时辰、日界、交节、夏令时边界时先调用本工具并等待确认。地点未知先用 city_info，不得静默选择候选或编造缺失时间/地点。

按 IANA 时区返回服务端当前标准时间（无 DST）；空值、无效或未知 timezone 直接报错。所有「现在/今天/当前年份」运算以本返回值为唯一时间基准。用户出生时间不走本工具：民用/农历/时辰/日界模糊时先用 subject_candidates；地点或时区未知先用 city_info；黄历择日用 huangli_days。

玄空飞星起盘：按宅体事实日期（建成、入住或改宅）与二十四山坐向，排九宫飞星盘。评估阳宅固定风水格局时调用；流年飞星变化改用 xuankong_liunian。注意起盘日期不是命主出生时间。

玄空流年飞星：在宅运盘上叠加指定年份，返回流年飞星盘；count=1（默认）单年，count>1 连续批量。评估阳宅某一年风水变化时调用；固定格局用 xuankong_chart，尚未起宅运盘的也先调用 xuankong_chart。

紫微合盘原始事实。a/b 必须是用户确认事实或 subject_candidates 归一化后的主体，不得手造模糊时间。用户询问两人关系并需要紫微侧证据时调用；八字干支与十神视角改用 bazi_bond，两者常配合使用。并排返回双方命宫、夫妻宫、子女宫主星；不做跨盘投射和合婚评级。

紫微斗数排本命盘并返回确定性宫位事实。subject 可由用户明确事实组装，也可取自用户确认后的 subject_candidates 候选；时间模糊或多候选时先归一化并确认。需要十二宫主星、亮度、四化、杂曜、长生博士十二神、小限或大限时调用。两人合盘用 ziwei_bond，流盘用 ziwei_liupan，八字紫微断语合参用 natal_query。

紫微流盘：按 scope 返回 liu_nian/liu_yue/liu_ri/liu_shi 对应的领域数组，字段见 output schema。count=1（默认）单层，count>1 连续批量；standard_time 为当地标准时间，liu_shi 必须带经度。只返回确定性流盘事实，不做断语；本命盘用 ziwei_chart，八字紫微逐年合参断语用 natal_liunian_query。