naming-studio-bazi

name	naming-studio-bazi
description	Run the eight-characters five-elements (八字五行) analysis for a Naming Studio request. Use when a naming plan step references naming-studio-bazi, or when a user provides a birth date/time and wants bazi-informed Chinese name candidates.

Naming Studio Bazi

This skill turns a birth date/time into a verifiable five-elements profile that constrains name generation. Every step below is deterministic reasoning — no external API, no key. It is invoked as a plan step; naming-studio-generate owns writing results back to the GUI.

Algorithm

1. 历法归一

• 输入为农历时先换算为公历（注意闰月：闰月按其所属正月计），时间按东八区北京时间处理。
• 若用户只给日期没给时间，仍排年、月、日三柱，时柱标注"未知"，后续强弱判断降低权重。

2. 排四柱

• 年柱：以立春为界，不以正月初一为界。立春前出生用上一年干支。
• 月柱：以节气（节，非中气）为界划分月份，月干由年干按五虎遁推出。
• 日柱：按干支纪日连续推算。
• 时柱：两小时一个时辰（23:00-00:59 为子时），时干由日干按五鼠遁推出。子时跨日按晚子时处理并注明。
• 出生时间落在节气交界 ±1 天时，在 analysis 中注明排盘存在不确定性。

3. 五行统计（加权，非简单计数）

• 天干每字直接计入其五行，权重 1.0。
• 地支按藏干加权计入：本气 0.6、中气 0.3、余气 0.1。这比只数地支本气更接近命局真实力量。
• 汇总为五行力量表，输出 distribution 时四舍五入为整数（合计约等于 8）。

4. 日主强弱

三者合参，不以单一维度定论：

• 得令：月令五行是否生扶日主（权重最高）。
• 得地：日主在四柱地支中是否有通根（本气根 > 中气根 > 余气根）。
• 得势：天干中比劫、印绶的数量。

5. 喜用神推导

• 基线：扶抑——身弱者，喜生扶（印、比劫）；身强者，喜克泄耗（官杀、食伤、财）。
• 调候优先修正：冬月（亥子丑）生者喜火暖局，夏月（巳午未）生者喜水润局，与扶抑冲突时调候优先。
• 两行相战时考虑通关之神。
• 明确输出：喜用神（1-2 个五行）、忌神，并一句话说明推导理由。

6. 用字五行判定

判定候选字的五行属性，优先级：部首表意 > 字义 > 音韵。

• 部首明确的直接定性：氵冫雨→水，木艹竹→木，火日灬→火，土山石→土，金钅玉→金。
• 部首不表五行的看字义：如"安"（宀+女，安定属土）、"知"（智慧属火/水依语境）。
• 一字多性时取主属性并在 analysis 中注明。避免民间"按笔画数五格剖象定五行"的做法——不采用五格剖象法。

7. 补益策略

• 三字姓名（两字 given）：首选"两字均为喜用神"或"一字喜用 + 一字通关"，忌神字直接排除。
• elements 回填每个候选字的五行；complement 与喜用神一致。
• metrics 第一项（八字五行，满分 25）按补益质量打分：两字皆喜用 22-25，一喜用一中性 18-21，仅一字喜用 14-17。

Output

Feed these fields into each candidate for save_naming_product_result:

{
  "elements": ["木", "火"],
  "distribution": [["木", 2], ["火", 2], ["土", 1], ["金", 0], ["水", 1]],
  "branches": [["年柱", "甲辰", ["木", "土"]], ["月柱", "己巳", ["土", "火"]], ["日柱", "己卯", ["土", "木"]], ["时柱", "己巳", ["土", "火"]]],
  "analysis": "日主X，生于X月，得令/失令，通根情况，喜用神为X（理由），此名以X补益。"
}

branches 四柱与 distribution 全部候选共享同一命盘；elements 与 analysis 逐候选给出。

Constraints

If the request's plan says bazi is skipped (useBazi: false), do not run this skill at all — leave elements empty and distribution/branches null. Never fabricate a chart when the birth time is missing or implausible; state the limitation in analysis instead.