Add Nexa BaZi naming contract checker

references/nexa-forbidden-names.md

@@ -0,0 +1,38 @@
+# Nexa 禁用/兼容命名表
+
+本表供 `scripts/check_nexa_bazi_contract.py` 读取。`error` 表示新代码不应出现；`warn` 表示需要迁移或人工确认；`review` 表示可能是已发布兼容字段，改动前必须查影响面。
+
+| severity | current | preferred | concept | reason |
+|---|---|---|---|---|
+| error | Day_Master | day_master | 日主 | Nexa JSON/API/prompt 字段使用 snake_case |
+| error | DayMaster | day_master | 日主 | JSON/API 字段不要用 PascalCase 或拼接式 camel |
+| error | DayMaster_Stem | day_master_stem | 日主天干 | mixed case 不适合接口契约 |
+| error | dayMasterStem | day_master_stem | 日主天干 | JSON/API 字段使用 snake_case；JS 局部变量除外 |
+| error | Primary_Favorite_Element | primary_favorite_element | 第一喜用元素 | mixed case 不适合接口契约 |
+| error | Secondary_Favorite_Element | secondary_favorite_element | 第二喜用元素 | mixed case 不适合接口契约 |
+| error | Favorite_Element | favorite_element | 喜用元素 | mixed case 不适合接口契约 |
+| error | Element_Strengths | element_strengths | 五行强度 | mixed case 不适合接口契约 |
+| error | Dominant_Deity | dominant_ten_god | 主导十神 | 十神不是 deity |
+| error | dominant_deity | dominant_ten_god | 主导十神 | 十神不是 deity |
+| error | deity | ten_god | 十神 | 接口字段不要用 deity 表示十神 |
+| error | useGod | useful_god | 用神 | 不要把 Useful God 写成动词短语 |
+| error | usefulGod | useful_god | 用神 | Nexa JSON/API 字段使用 snake_case |
+| error | primary_useful_god | primary_favorite_element | 喜用元素 | 喜用元素不等同用神 |
+| error | dayOwner | day_master | 日主 | 日主标准术语是 Day Master |
+| error | dayLord | day_master | 日主 | 日主标准术语是 Day Master |
+| error | skyStem | heavenly_stem | 天干 | 标准术语是 Heavenly Stem |
+| error | groundBranch | earthly_branch | 地支 | 标准术语是 Earthly Branch |
+| error | fortuneColumn | luck_pillar | 大运 | 大运是 Luck Pillar，不是 column |
+| error | fortune_column | luck_pillar | 大运 | 大运是 Luck Pillar，不是 column |
+| error | big_luck | luck_pillar | 大运 | 新接口使用 luck_pillar |
+| error | annual_pillar | annual_luck | 流年 | 避免和本命 year_pillar 混淆 |
+| error | monthly_pillar | monthly_luck | 流月 | 避免和本命 month_pillar 混淆 |
+| error | daily_pillar | daily_luck | 流日 | 避免和本命 day_pillar 混淆 |
+| warn | flowing_year | annual_luck | 流年 | 直译味过重，优先 annual_luck |
+| warn | flowing_month | monthly_luck | 流月 | 直译味过重，优先 monthly_luck |
+| warn | flowing_day | daily_luck | 流日 | 若表示干支请用 daily_stem_branch |
+| warn | daily_fortune_insights | daily_luck_insights | 日运洞察模块 | 新八字模块 key 优先用 luck；已发布则兼容迁移 |
+| review | key_astral_event | key_bazi_event | 今日关键八字事件 | 八字模块避免 astral；若已发布需迁移 |
+| review | astral_event | bazi_event | 八字事件 | astral 属占星语境，八字事实链不要混用 |
+| review | provider_visual_tags | provider_bazi_tags | Provider 标签 | 若标签全是八字来源，名称应体现 bazi |
+| review | provider_visual_tag_detail | provider_bazi_tag_detail | Provider 标签详情 | 若标签全是八字来源，名称应体现 bazi |