feat: add comprehensive xuanxue knowledge base (bazi + shensha) and expand SKILL.md

Author: kaliwuang

SKILL.md

@@ -19,131 +19,294 @@ triggers:
 # 玄照 · XuanZhao — AI 玄学群体智能技能
 
 > 玄学为体，照见为用。**无需 API Key，纯本地运行。**
+> 知识来源：《八字理论精华宝典》OCR精读至P294/647，累计98个知识点。
 
 ## 概述
 
 玄照是一个 **面向 AI Agent 的命理分析技能**。当用户提供出生信息时：
 
 1. **八字排盘** — 基于 `lunar_python` 计算四柱、十神、纳音、藏干、空亡、大运
-2. **视角引擎** — 108 个跨学科视角（含20个手写深度视角 + 76个模板视角 + 12个浅层视角），每个视角基于五行分布、十神力量、大运相位、冲刑害合等数据做结构化评分
-3. **AI 解读** — **你（AI Agent）** 读取结构化数据并用你的能力进行综合解读。无需外部 LLM API。
+2. **视角引擎** — 108 个跨学科视角，基于五行分布、十神力量、大运相位、冲刑害合等数据做结构化评分
+3. **AI 解读** — 你读取结构化数据并综合知识库进行解读
 
-**关键设计：不是让 xuanzhao 去调 API，而是让 AI Agent 成为解读引擎。**
+**关键设计：你的玄学知识 + 视角引擎的结构化数据 = 真正有深度的命理分析。**
 
-## 安装
+---
 
-```bash
-git clone https://github.com/kaliwuang/xuanzhao.git
-cd xuanzhao
-pip install lunar-python
-```
+## 📖 八字核心知识库
+
+### 一、五行旺衰体系
+
+| 五行 | 季节 | 方向 | 脏器 | 颜色 | 个性 | 长生 | 帝旺 | 墓库 |
+|------|------|------|------|------|------|------|------|------|
+| 木 | 春 | 东 | 肝胆/目 | 青 | 仁慈/正直 | 亥 | 卯 | 未 |
+| 火 | 夏 | 南 | 心脏/小肠 | 红 | 礼/热情 | 寅 | 午 | 戌 |
+| 土 | 季夏 | 中 | 脾胃/口 | 黄 | 信/稳重 | 申 | 子 | 辰 |
+| 金 | 秋 | 西 | 肺/大肠/鼻 | 白 | 义/果断 | 巳 | 酉 | 丑 |
+| 水 | 冬 | 北 | 肾/膀胱/耳 | 黑 | 智/柔韧 | 申 | 子 | 辰 |
+
+### 二、十神空亡详解（P145-153）
+
+这是分析命局"缺失""遗憾""课题"的核心工具。有视作无——空亡的五行不起旺衰平衡作用。
+
+| 十神 | 空亡核心含义 |
+|------|-------------|
+| 正财 | 与父无缘,因欺诈损失财物,肠病,阳日与妻缘尽,阴日在情人身上发生,节俭变挥霍 |
+| 偏财 | 与父无缘,性不耐静,色情之象,与祖父/岳父不合,需走动型职业 |
+| 正印 | 与母无缘/离乡,毁约背信,横刀夺爱,考试运差,名誉受损 |
+| 偏印 | 爱幻想,不眠/精神衰弱,与继母无缘,心浮气躁,动中破财 |
+| 正官 | 男不受益于上司,女丈夫调职/分居/婚缘不佳 |
+| 七杀 | 军政界权旁落,常人可免受病痛,性格好勇斗狠或畏首畏尾 |
+| 比肩 | 谋职创业受阻,服务业/自由职业反能有成就 |
+| 劫财 | 狡诈 |
+| 建禄 | 虚名虚利,学而无成,一生破散 |
+| 桃花 | 情缘困扰,情祸,感情失落 |
+| 贵人 | 演艺/歌星/舞女/文艺创作者 |
+
+**空亡互换核心断语：**
+- 年柱与大运互换空亡 → 不利长亲（祖坟多空败）
+- 月柱与大运互换空亡 → 女不利夫,男不利父母兄弟
+- 日柱与大运互换空亡 → 主配偶不利
+- 时柱与大运互换空亡 → 主子女不利
+- 流年与大运互换空亡 → 一事无成
+
+**空亡六大规则：**
+① 遇六合不为空 ② 逢冲以吉论（纳音相生更好） ③ 不起旺衰平衡作用 ④ 大运空流年不空 ⑤ 同类型相冲极凶（如丁酉运丁卯年） ⑥ 逢六合不论空
+
+### 三、调候用神体系（P163-187）
+
+每个日干在十二个月令下需要不同调候用神。分四层：四柱/格局/月令/大运。
+
+**速记口诀：**
+- 甲生寒月（亥子丑）用丙戊庚
+- 乙生暖月（巳午未）用丙丁癸
+- 丙生燥月（巳午未）用壬庚癸
+- 丁生寒月用甲庚壬
+- 戊己生寒月用丙甲癸
+- 庚辛生暖月用壬癸辛
+- 壬癸生暖月用庚辛丙
+
+**十日主逐月用神表（精简版）：**
+
+甲日主：寅丙癸 卯庚丙丁 辰庚壬 巳癸庚丁 午癸 未癸庚丁 申丙丁壬 酉甲癸 戌辛壬 亥庚丙丁 子丙 丑丙
+乙日主：寅丙 卯丙癸 辰丙癸戊 巳癸 午癸 未癸丙 申丙癸 酉辛 戌癸辛 亥丙戊 子丙 丑丙
+丙日主：寅壬庚 卯庚己 辰壬甲 巳壬庚 午癸 未癸庚 申壬戊 酉壬癸 戌甲壬 亥壬甲 子壬戊 丑壬甲
+丁日主：寅甲庚 卯庚甲 辰庚癸 巳甲壬庚 午癸 未癸庚 申甲壬庚 酉壬癸 戌甲壬 亥甲壬 子甲壬 丑甲壬
+戊日主：寅丙甲癸 卯丙癸 辰丙癸 巳丙癸庚 午丙癸 未癸丙 申丙甲癸 酉丙癸 戌甲癸 亥丙甲癸 子丙甲癸 丑丙甲癸
+己日主：寅丙甲癸 卯甲癸 辰丙癸 巳癸丙 午癸丙 未癸丙 申癸丙 酉癸丙 戌甲癸丙 亥甲丙 子甲丙 丑甲丙
+庚日主：寅丙甲 卯丁甲 辰丁甲 巳壬丙戊 午壬 未丁甲 申丁甲 酉丁丙 戌甲壬 亥甲丙 子壬丙 丑丙己
+辛日主：寅壬庚 卯丁甲 辰丁甲 巳壬辛丙 午壬辛 未丁甲 申壬辛丁 酉壬辛 戌壬辛 亥壬辛 子壬辛 丑壬辛
+壬日主：寅庚丙 卯戊辛 辰丙辛 巳庚辛 午庚辛壬 未庚辛壬 申庚丙丁 酉庚辛 戌庚辛壬 亥庚壬 子庚辛 丑庚辛
+癸日主：寅丙庚 卯辛 辰丙辛 巳辛丙 午庚辛壬 未庚辛壬 申庚辛 酉辛丙 戌辛壬 亥辛丙 子辛丙 丑辛丙
+
+### 四、神煞断流年体系（P271-P294）
+
+**核心发现：全书存在至少四套平行的神煞-星曜分配表。**
+
+以下为神煞判词精华——用于流年分析：
+
+| 神煞 | 判词精华 | 注意点 |
+|------|---------|--------|
+| 太岁 | "俗谓太岁当头坐,无福便有祸" | 易判断错误造成投资损失;易失神引起交通事故 |
+| 太阳 | "太阳高照万事皆吉" | 利男不利女 |
+| 丧门 | "主孝服凶灾" | 附属神煞有三版变体(地丧/地雕→地棍/地裕) |
+| 太阴 | "利女不利男" | 女命太阴:无精打采心发闷,体格软弱常失眠 |
+| 五鬼 | "主口舌是非" | 考运佳! 制五鬼运财可化凶为财 |
+| 死符 | "主病灾" | 小耗=小事破财,月德=吉神 |
+| 岁破 | "岁破即冲太岁,诸事不利" | 忌动土;如完婚易破缘 |
+| 龙德 | "贵人高照,利升官求财" | 生意兴隆,远行有利 |
+| 白虎 | "主血光外伤" | 女有喜则吉;防朋友失信/倒会/借钱不还 |
+| 福德 | "心烦意乱" | 易受外界磁场干扰 |
+| 病符 | "主病灾虚惊" | 勿探望病人,谋事难如意 |
+| 天狗 | "口舌损伤" | 从事政治或商业人士易犯官非;忌夜远行 |
+| 八座 | "利于考试此年" | 全书唯一考试直接相关神煞 |
+
+**四表核心差异：**
+- 第一表(P279-282): 11组神煞,金星/太阴/水星/木星等星曜分配
+- 第二表(P283-286): 星曜全重组,男女互换规律
+- 第三表(P287-290): 月德独立获诗决,九曜三组稳定组
+- 第四表(P291-294): 第一表复刻修订版,新增岁劫杀,天狗组变异
+
+**第四表独创发现：**
+- 附属神煞修订规律: 天→危(吉转凶)、卷→德(凶转吉)、丧→棍(中性→打击)
+- 职业限定判词首现: 天狗"从事政治或商业人士"
+- 制五鬼运财化解法首次进入神煞判词
+
+### 五、断语精华
+
+**铁口直断口诀：**
+- 全阴克父,全阳克母;比劫重重父早亡
+- 年月空亡父母不全,月令伤官父母不全
+- 配偶星在墓库=克自己或绿自己;官杀被合=二次婚
+- 偏才多好色多妻妾;官杀混杂=官情人同时在场
+- 日时无配偶星=分床睡/聚少离多
+- 配偶宫空/星空/星入墓=同性恋倾向
+- 时柱印枭全=女命子女无缘;食伤自刑=精神问题/堕胎/孩子有问题
+- 水旺=肾功能好欲望强;身旺劫旺男命好色
+- 食伤坐沐浴=直播/擦边;金水旺无印无官杀=无底线
+- 年头月胸日腹时脚;禄临空亡或被伤=不见血光必遭秧
+- 年月冲=15岁前一劫;月日冲=16-32岁;日时冲=33-50岁
+
+**行业五行分类：**
+- 金: 金融/证券/银行/五金/珠宝/矿业/医疗/律师/汽车
+- 水: 贸易/商业/水产/物流/旅游/网络/IT/广告
+- 木: 教育/文化/学术/出版/纺织/造纸/园林/服装
+- 火: 能源/电力/照明/燃气/石油/化妆品/餐饮/娱乐
+- 土: 建筑/房地产/农业/仓储/政府/陶瓷/珠宝
+
+---
+
+## 🧠 紫微斗数核心知识
+
+### 14主星与疾病对应
+
+| 主星 | 五行 | 健康对应 | 特质 |
+|------|------|---------|------|
+| 紫微 | 己土 | 脾胃肠道 | 帝王/权威/厚重 |
+| 天机 | 乙木 | 肝胆/神经 | 智慧/思虑/变动 |
+| 太阳 | 丙火 | 心脑血管 | 光明/热情/显贵 |
+| 武曲 | 辛金 | 肺/骨骼 | 财富/刚毅/财经 |
+| 天同 | 壬水 | 泌尿/内分泌 | 福气/温和/享受 |
+| 廉贞 | 丁火/甲木 | 血液/肝胆 | 复杂/次桃花/政治 |
+| 天府 | 戊土 | 脾胃/消化 | 财库/稳重/包容 |
+| 太阴 | 癸水 | 妇科/内分泌 | 美丽/温柔/田宅 |
+| 贪狼 | 甲木 | 肝胆/性病/皮肤病 | 桃花/欲望/才艺 |
+| 巨门 | 癸水/己土 | 口舌/消化 | 口才/是非/暗星 |
+| 天相 | 壬水 | 泌尿/体液 | 辅助/协调/印章 |
+| 天梁 | 戊土 | 脾胃/长寿 | 荫星/清高/医药 |
+| 七杀 | 辛金 | 肺/筋骨 | 将星/杀伐/开创 |
+| 破军 | 癸水 | 肾/膀胱/骨骼 | 破坏/变革/先锋 |
+
+### 12宫含义
+
+命宫(人格)→兄弟(手足)→夫妻(感情)→子女(子嗣)→财帛(财富)→疾厄(健康)→迁移(外出)→交友(人际)→官禄(事业)→田宅(家宅)→福德(精神)→父母(长辈)
+
+**疾厄宫看健康核心要点：**
+- 只看疾厄宫不够,必须联合对宫(父母宫决定治疗效果)和三合(兄弟宫看体质)
+- 羊陀夹疾厄 → 慢性病; 火铃在疾厄 → 突发/急性病; 空劫在疾厄 → 奇难杂症
+- 五行局影响: 水二局肾弱、火六局心血管倾向、金四局肺弱、木三局敏感、土五局消化负担
+
+### 四化表（生年天干）
+
+| 天干 | 化禄 | 化权 | 化科 | 化忌 |
+|------|------|------|------|------|
+| 甲 | 廉贞 | 破军 | 武曲 | 太阳 |
+| 乙 | 天机 | 天梁 | 紫微 | 太阴 |
+| 丙 | 同 | 机 | 廉 | 武 |
+| 丁 | 太阴 | 天同 | 天机 | 巨门 |
+| 戊 | 贪狼 | 太阴 | 右弼 | 天机 |
+| 己 | 武曲 | 贪狼 | 天梁 | 文曲 |
+| 庚 | 太阳 | 武曲 | 太阴 | 天同 |
+| 辛 | 巨门 | 太阳 | 文曲 | 文昌 |
+| 壬 | 天梁 | 紫微 | 左辅 | 武曲 |
+| 癸 | 破军 | 巨门 | 太阴 | 贪狼 |
+
+---
+
+## 🔮 其余五术要点
+
+### 奇门遁甲
+- 三奇: 乙(日奇)、丙(月奇)、丁(星奇)
+- 八门: 休/生/伤/杜/景/死/惊/开
+- 九星: 天蓬/天芮/天冲/天辅/天禽/天心/天柱/天任/天英
+- 八神: 值符/腾蛇/太阴/六合/白虎/玄武/九地/九天
+- 用神取用: 日干为主,时干为事,值符为总体
+
+### 六爻纳甲
+- 八宫六十四卦: 乾坎艮震巽离坤兑
+- 六亲: 父母/兄弟/妻财/子孙/官鬼/世应
+- 六兽: 青龙/朱雀/勾陈/腾蛇/白虎/玄武
+- 用神分类: 占财看妻财,占官看官鬼,占病看子孙
+
+### 大六壬
+- 十二天将: 贵/蛇/雀/合/勾/龙/空/虎/常/玄/阴/后
+- 四课三传: 日干为本人,日支为事体
+- 神煞: 驿马/劫煞/亡神/天喜/月破/天赦
+- 毕法赋核心: 前后引从升迁吉,首尾相见始终宜
+
+### 太乙神数
+- 十六宫间: 君基/臣基/民基/五福/大游/小游/四神/天乙/地乙/直符/飞符/始击/计神/太乙/文昌/主大将/客大将
+- 主客关系: 主算=自身,客算=外部
+- 太乙积年: 从公元前计算的年份
+
+### 西洋占星
+- 十大行星: 太阳(自我)/月亮(情绪)/水星(思维)/金星(爱情)/火星(行动)/木星(幸运)/土星(压力)/天王(变革)/海王(梦幻)/冥王(重生)
+- 十二星座: 白羊到双鱼,火土风水分组
+- 十二宫位: 命宫到玄秘宫
+- 相位: 合/六合/刑/冲/三合
+
+---
 
 ## 使用工作流
 
 ### 第一步：命盘分析
 
-当用户给出出生信息，运行分析获取结构化数据：
-
 ```bash
-cd /path/to/xuanzhao
 python xuanzhao.py analyze --birth "2005-06-09 11:50" --location "呼和浩特" --gender male --format json
 ```
 
-输出 JSON 包含：
-- `bazi` — 四柱、纳音、十神、藏干、空亡、大运
-- `features` — 命局核心特征（子午冲、七杀透干等）
-- `tiaohou` — 调候用神
-- `perspectives` — 108 个视角的结构化评分
-  - 每个视角有：`score`(0-100)、`dimensions`(多维评分)、`key_insights`、`warnings`、`advice`
-- `astrology` — 西洋占星数据（如可用）
+### 第二步：AI 解读
 
-### 第二步：AI 自行解读
+运行后读取JSON输出,按以下框架解读：
 
-读取 JSON 输出后，**你作为 AI 需要做**：
+1. **命盘总论** — 八字组合、日主强弱、五行分布
+2. **视角共识分析** — 哪些视角评分高/低,共识模式
+3. **综合解读** — 将结构化数据 + 知识库转化为有温度的命理报告
+4. **行动建议** — 大运相位和视角建议
 
-1. **命盘总论** — 根据八字组合、日主强弱、五行分布给出核心判断
-2. **视角共识分析** — 查看哪些视角评分较高/较低，找出共识模式
-3. **综合解读** — 将结构化数据转化为有温度、有洞察的自然语言报告
-4. **行动建议** — 基于大运相位和视角建议给出可操作的建议
+**解读时如何调用知识库：**
+- 分析十神时 → 参照"十神空亡"判断缺失
+- 分析流年时 → 参照"神煞判词"给出当年吉凶
+- 分析调候时 → 参照"调候用神表"判断用神是否到位
+- 分析健康时 → 参照"主星疾病对应"和"疾厄宫三方四正"
+- 下断语时 → 参照"铁口直断口诀"
 
-**解读框架：**
+---
 
-```
-报告结构建议：
-1. 命盘总论（一句话概括核心特质）
-2. 五行分析（什么元素过旺/过弱？意味着什么？）
-3. 核心矛盾（基于features字段和视角disagreement）
-4. 多视角共识（哪些视角对同一问题持相似看法？）
-5. 大运展望（当前大运的影响和未来关键节点）
-6. 综合建议（具体可操作的建议）
-```
+## 视角引擎
+
+### 20个手写深度视角
 
-## 视角引擎详解
-
-### 20个手写深度视角（最高质量）
-
-每个视角有自己的独立计算逻辑，不是模板：
-
-| 视角 | 类型 | 评分依据 |
-|------|------|---------|
-| 诸葛亮 | 战略全局 | 五行均衡度 + 用神到位 + 大运配合 |
-| 袁天罡 | 命运分段 | 身强弱 + 大运吉凶 + 年龄阶段 |
-| 费曼 | 简化机制 | 核心矛盾数量 + 印星食伤 |
-| 荣格 | 心理分析 | 最强/最弱五行=面具vs阴影 + 冲=整合契机 |
-| 芒格 | 逆向思维 | 十神组合识别陷阱 + 印星学习力 |
-| Taleb | 反脆弱 | 冲象=反脆弱土壤 + 七杀=压力测试 |
-| Naval | 长期主义 | 印星=特定知识 + 财星=杠杆 |
-| 老子 | 道法自然 | 用神到位 + 水性柔韧 + 反者道之动 |
-| 王阳明 | 知行合一 | 印星vs比劫 = 知vs行 |
-| 斯多葛 | 控制二分法 | 可控(印比) vs 不可控(官财) |
-| 克劳利 | 意志法则 | 七杀=意志 + 印星=仪式感 |
-| 萨满 | 灵魂能量 | 水=灵性通道 + 力量动物匹配 |
-| 孙子 | 五事七计 | 道天地将法五项评分 |
-| 鬼谷子 | 捭阖之道 | 食伤=捭 + 印星=阖 + 水=洞察 |
-| 刘伯温 | 微兆预警 | 冲刑害计数 + 空亡 + 大运阶段 |
-| 弗洛伊德 | 潜意识 | 藏干数量 + 冲=压抑 + 食伤=升华 |
-| 尼采 | 权力意志 | 七杀=斗志 + 食伤=创造 + 水火=酒神日神 |
-| 巴菲特 | 价值投资 | 生扶比=内在价值 + 印比=安全边际 |
-| 赫尔墨斯 | 七原则 | 七条对应法则活跃度 |
-| 张一鸣 | 认知迭代 | 印=输入 + 食伤=输出 + 财印=延迟满足 |
+每个视角有独立计算逻辑：
+
+| 视角 | 评分依据 | 知识调用点 |
+|------|---------|-----------|
+| 诸葛亮 | 五行均衡+用神到位 | 用神到位分析 |
+| 袁天罡 | 大运吉凶+年龄阶段 | 大运断流年 |
+| 费曼 | 核心矛盾+印星食伤 | 简化机制 |
+| 荣格 | 五行=面具vs阴影 | 心理分析 |
+| 芒格 | 十神陷阱+学习力 | 逆向思维 |
+| Taleb | 冲象=反脆弱 | 七杀=压力测试 |
+| 老子 | 用神+水性+反者道之动 | 道法自然 |
+| 王阳明 | 印星vs比劫=知vs行 | 知行合一 |
 
 ### 76个模板视角
 
-覆盖中国哲学(10)、玄学命理(8)、西方哲学(15)、心理学(4)、科学创新(10)、商业领导力(12)、管理学家(5)、艺术家(5)、军事家政治家(8)。每个模板视角共享一套分析引擎，权重配比和解读文案各不相同。
+覆盖中国哲学(10)、玄学命理(8)、西方哲学(15)、心理学(4)、科学创新(10)、商业领导力(12)、管理学家(5)、艺术家(5)、军事家政治家(8)。
 
-## 重要注意事项
+**各视角调用知识库的方式（示例）：**
+- 孔子: 参照"十神空亡"判断命主德行
+- 凯撒: 参照"七杀"和"冲象"判断魄力
+- 笛卡尔: 参照"印星"和"偏印"判断怀疑精神
+- 范蠡: 参照"财星"和"调候用神"判断商道
+- 丘吉尔: 参照"官杀"和"大运"判断坚韧
 
-1. **所有分析基于数据计算，不是玄学迷信** — 透明可验证
-2. **置信度说明** — 每个视角有 confidence 字段(0-1)，代表该视角在此命局上的适用性
-3. **视角分歧是信息** — 不同视角评分差异大时，说明命局在不同维度上存在矛盾，这是最有价值的分析点
-4. **大运动态** — 大运数据会随时间变化，建议在报告中注明"基于当前时间点"
-5. **语言要求** — 用户是中文使用者，解读报告用中文书写
+---
 
 ## 相关文件
 
-- `xuanzhao.py` — CLI 入口 + 八字排盘引擎
-- `perspectives_engine.py` — 深度视角引擎（20个手写视角）
-- `perspectives_templates.py` — 模板视角数据（76个）
+- `xuanzhao.py` — CLI入口
+- `debate_engine.py` — 辩论引擎(45K)
+- `perspectives/` — 96个视角skill
+- `data/` — 视角数据YAML
+- `data/knowledge_base/` — 知识库文件(bazi.yaml/shensha.yaml等)
 - `DEMO.md` — 输出示例
 
-## 场景示例
-
-### 用户说："帮我看看八字"
-
-```
-1. 问出生信息（时间、地点、性别）
-2. python xuanzhao.py analyze --birth "..." --location "..." --gender 男 --format json
-3. 读取 JSON 输出
-4. 基于结构化数据进行综合解读
-5. 输出自然语言报告
-```
-
-### 用户说："2005年6月9日11点50分呼和浩特出生的男的八字怎么样"
+## 重要注意事项
 
-```
-1. 直接运行分析
-2. python xuanzhao.py analyze --birth "2005-06-09 11:50" --location "呼和浩特" --gender male --format json
-3. 从输出中提取关键数据
-4. 结合视角评分进行解读
-5. 输出完整报告
-```
+1. **所有分析基于数据计算** — 透明可验证
+2. **置信度说明** — 每个视角有confidence字段(0-1)
+3. **视角分歧是信息** — 不同视角评分差异大时,是最有价值的分析点
+4. **大运动态** — 基于当前时间点
+5. **语言要求** — 中文书写
+6. **知识库完整性** — 《八字理论精华宝典》OCR学习至P294/647,后续持续补充