中华命理预测（八字·紫微·象数）
一套「技术排盘 + 人文底盘」双引擎的命理分析工作流。技术上用本技能内置的八字/紫微双盘引擎（scripts/）做排盘；方法上以《子平真诠》《四言独步》定格局、以《易魂》八卦象数断当下；价值观上以曾仕强、南怀瑾、 袁了凡等人的「命有定数、运由己造」为底色，把「算准」导向「赋能」。
本技能为自包含包，无需依赖外部 ming-pro。目录结构：
- scripts/compute.py — 八字排盘引擎（四柱、大运、真太阳时、十神、藏干）
- scripts/ziwei.py — 紫微斗数排盘引擎（十二宫、十四主星、四化）
- references/ — 经典文献摘录、大运规则、时辰表、太阳时、五行表、紫微表
- assets/ — 国风报告 HTML 模板（可直接套用生成报告）
- README.md — 引擎用法说明
一、命理体系全景（集百家之长，不单腿走路）
传统术数以「阴阳、五行、天干地支、八卦」为共同底层，分四大支：
- 命理（定命）：四柱八字（徐子平奠基，沈孝瞻《子平真诠》、万民英《三命通会》、陈素庵《命理约言》、韦千里《千里命稿》、张神峰《神峰通考》）、紫微斗数（托名陈抟）、七政四余/铁板神数。
- 占卜（决疑）：梅花易数（邵雍《梅花易数》）、六爻纳甲（京房）、奇门遁甲、大六壬。
- 相术：麻衣/柳庄相法、骨相。
- 原则：至少会两种以上，互相佐证——八字配梅花/六爻，紫微配相学，避免「一条腿走路」。本技能以八字＋紫微为默认技术底座，象数作补充视角。
二、古籍核心用法
- 《子平真诠》（清·沈孝瞻）：格局派奠基，核心「月令取格、看用神与相神成败」。论富贵贫贱、六亲、功名、婚姻，不重神煞、不重纳音。
- 《四言独步》（《渊海子平》口诀篇）：四字口诀，涵盖格局、用神、行运、夫妻、贫富；信息密度高，需配全书读，多为「先财后印」之类通则。
- 《易魂·八卦象数预测法》（黄鉴）：现代象数派，脱胎梅花易数，主张「法无定法、以象直读、不用神煞」，适合断当下具体抉择（势之「机」）。
- 《滴天髓》《三命通会》《命理约言》《千里命稿》：旺衰用神、统计归纳、现代心理融合，可作进阶校验。
三、近代名家命理观（人文底盘，决定「怎么讲」）
这些是「怎么交付」的价值观，不是技法，但决定了结果要不要被说成「注定」。交付时必须在报告中用独立小节把以下观点落到「对这张盘该怎么看、该怎么做」上，不能压成一行注脚：
- 黄鉴（易魂·八卦象数，现代）：「法无定法、法外无法、我心为法」「以象直读、不用神煞」。主张活泼灵动，不拘泥古法，直接对当下时空取象。落点：象数用于「具体抉择」（换工作/签约/择校），不在出生盘里代替趋势判断。
- 曾仕强（中国台湾）：「命有定数、运由己造」——命是先天局限（剧本），运是后天选择（演出）；三分天注定、七分靠打拼；不迷信、不频繁算（命越算越薄）；改命靠修德修心修习惯；援引《了凡四训》「命由我作，福自己求」。落点：把「身旺印强」讲成「底子聪明但要自己用对地方」。
- 南怀瑾：「善易者不卜」——真通易者不依赖占卜；八字是「依通小术」，最高约 60%（极致 98%），终究有漏；「修德进业」才是改命；外相顺遂≠内心安稳，享福即消福。落点：与其纠结算得准，不如修好「择友、进业」这些功课（呼应太阴忌在交友）。
- 袁了凡《了凡四训》：功过格、立命之学——命可改，靠持续修持而非术数调整。落点：让「喜金水」变成可操作的日常环境选择。
- 韦千里《千里命稿》（民国）：以「强弱—格局—用神」三步骤简化推命，融入心理学，是现代命理教材范式。
- 陆致极《命运的求索》：用现代科学重新实证「时空影响生命」的传统假说，可作学术化表达支撑。
共同结论：命理是「趋势与概率」，不是「注定」；交付时必须把「命该如此」转成「你可以这么做」。
四、排盘（两步，调用本技能内置引擎）
# 八字：四柱 + 大运 + 真太阳时 + 十神 + 藏干 + 纳音 + 五行强弱
python "C:/Users/<用户名>/.workbuddy/skills/bazi-dual-advanced/scripts/compute.py" \
--year 出生年 --month 月 --day 日 --hour 时 --minute 分 \
--gender 男/女 --city 城市 --json
# 紫微：十二宫 + 十四主星 + 四化（真太阳时复用八字引擎口径）
python "C:/Users/<用户名>/.workbuddy/skills/bazi-dual-advanced/scripts/ziwei.py" \
--year 出生年 --month 月 --day 日 --hour 时 --minute 分 \
--gender 男/女 --json
<用户名> 替换为实际用户名（本机为 Administrator）。Windows 下必须用正斜杠 C:/... 或不带盘符前缀的路径，避免解释器把路径误判为 c:\c\...。Unix/macOS 可用 $HOME/.workbuddy/...。
内置引擎输出字段（JSON）：
- 八字 四柱 每柱含 干支 与 纳音（如「乙巳 覆灯火」）；新增 五行强弱（天干 + 地支本气统计，供格局判断直接用）。
- 紫微含 五行局、命宫、十二宫、四化。两引擎真太阳时口径已统一，临界时辰一致。
> 关于 ming-pro 本体：本技能已内置 scripts/ 引擎副本（从 ming-pro 复制并改进），不改动 ~/.workbuddy/skills/ming-pro__skillhub/ 市场技能本体，以免与其后续更新冲突。改进内容：新增纳音/五行统计、统一真太阳时、修正起运按「节」计算。
五、关键陷阱（必读，否则必错）
- 大运起运必须用「节」，不是「气」：十二节 = 立春 / 惊蛰 / 清明 / 立夏 / 芒种 / 小暑 / 立秋 / 白露 / 寒露 / 立冬 / 大雪 / 小寒。夏至、冬至是「中气」，绝不能用于起运。公式：出生到下一个「节」的天数 ÷ 3 = 起运岁数（余数×4 = 月数）。例：6月16日生，下一节为7月小暑，约21天 → 7岁起运。
- 夜子时（23:00–23:59）：引擎已按「日柱顺推至次日、时柱取次日日干起子」处理，真太阳时跨日需留意。
- 倒推时辰不可证伪：若用户先给结果再要「定位时辰」，必须标注「时柱为反推、存疑，仅作参考」，只论年月日三柱＋紫微，不判具体流月；绝不可把后验叙事当事实。
- 真太阳时临界：校正后时辰接近 23:00/00:00，务必提醒核对出生证明。
六、双盘合参（核心）
6.1 八字 + 紫微的互补
- 八字：先看月令定格局（成格先论格，不成格再论旺衰）→ 定用神（身旺看官杀/食伤/财是否有力，身弱看印比是否得助）。
- 紫微：定位命宫主星底色 + 生年四化（禄=天赋，忌=人生功课）。
- 联动：八字用神五行 ↔ 紫微对应宫位是否呼应（用神为火、官禄宫恰在午宫且吉 → 「天人合一」断事业顺）。
6.2 易经与象数的角色（很多用户会问为什么报告里没写）
- 《易经》是所有术数的共同底层：阴阳、五行、八卦、天干地支都源于易。八字、紫微、梅花、六爻、奇门、风水，都是易经在不同场景下的应用分支。
- 八字/紫微属于「命理」：看长期格局、先天禀赋、大运走势，回答「我是什么样的人、人生趋势如何」。
- 梅花易数 / 六爻 /《易魂》八卦象数属于「占卜」：看当下具体抉择，回答「这件事现在做不做、选 A 还是选 B」。
- 本技能的边界：以八字 + 紫微为默认技术底座；象数只在用户给出具体择事情境时追加（如换工作、签约、择校、择日），且必须说明「不臆造断语」。出生盘常规报告里不写象数，不是遗漏，而是体系边界——不能把长期趋势和具体占问混为一谈。
6.3 古籍与名家观点如何内嵌
- 《子平真诠》《四命通会》《命理约言》《千里命稿》等用于定格局、取用神、论旺衰。
- 《四言独步》《滴天髓》用于口诀化校验。
- 曾仕强/南怀瑾/袁了凡用于「怎么讲」，防止交付滑向宿命论。
- 不需要在报告里大段引用原文，但结论必须能在这些典籍体系内自洽。
七、趋吉避凶路线图（务必做）
按大运序列逐运给出「重点 / 风险 / 注意」，并用 Visualizer 的 show_widget（SVG 时间轴）画出人生阶段卡片，让用户直接看到而非读长文。命理不作股票图，不涉及「涨红跌绿」等金融约定。
八、求测动机与交付心法（人情世故）
命理咨询的本质不是「算准」，而是「陪人面对不确定」。先理解人为什么来找我们，交付才有分寸：
- 六大动机：对抗不确定性、重建控制感、给人生找意义锚点、情感寄托与倾诉、把重大决策「外包」求安心、获得社群/文化认同。
- 交付红线：给方法、给选择权、给陪伴，绝不给「注定」或「不可逆」的结论。宁可说「概率与趋势」，不制造焦虑与宿命感。
- 白纸黑字留待验证：所有流年断语写成可复核的「待验清单」，让时间判卷，而非口头圆回去。
- 不卖焦虑 / 给行动权 / 尊重隐私：把「命该如此」转成「你可以这么做」。
九、地域与合规
- 对外表述一律「中国香港 / 中国台湾 / 中国澳门」（Hong Kong, China / Taiwan, China / Macao, China），绝不作独立国家表述。
- 命理属传统文化，结尾必须附：「命理是古人观察规律的智慧，属传统文化哲学，无法替代理性决策与医学诊断。人生剧本的真正作者永远是您自己。」
十、交付物（Markdown + HTML 双文件，务必按此产出）
每次执行完排盘分析，必须产出 两份文件，并通过 present_files 同时呈现：
- Markdown 报告：文字为主，便于存档、打印、二次编辑。语言必须通俗，少术语，多「该做什么/防什么」的行动清单。
- HTML 可视化报告：同一内容的图文版，用卡片、时间轴、五行能量条、颜色标签等方式提升可读性；单文件自包含（内嵌 CSS/SVG），无需外部依赖。风格可依用户偏好采用「现代卡片」或「国风」（宣纸底、朱砂红、墨黑字、印章点缀、卷轴感容器）。国风可直接套用
assets/gufeng-template.html模板，把占位符替换为实际数据即可。
报告至少包含以下章节，顺序如下：
- 四柱盘面卡：四柱＋十神＋藏干＋日主＋起运（含「按节」算法说明）。
- 五行强弱与格局定势：用一句话定「身旺/身弱」与「用神/忌神」（子平体系）。
- 紫微底色：命宫主星、五行局、生年四化、关键宫位（命/财/官/夫/福/疾）一句话结论。
- 双盘联动：八字用神五行 ↔ 紫微对应宫位是否呼应。
- 大运逐运断语＋趋吉避凶：按大运序列逐段给「重点 / 风险 / 行动建议」，用「待验清单」形式写流年断语，白纸黑字留待验证。
- 易魂象意解读（黄鉴）：在出生盘内加入「读象」章节，必须覆盖：干支之象（如癸亥大海水+己亥平地木的画面感）、六亲之象（年柱父/远方、月柱母/学识、日柱自己和配偶、时柱子女/作品）、数字之象（生日数推命数/方位）、颜色与方位之象。用大白话讲画面，少术语。
- 人文交付声明：援引曾仕强/南怀瑾/袁了凡/黄鉴等名家，把「命该如此」转成「你可以这么做」。每位名家的观点必须落到具体建议，不能只是一句注脚。
- 易魂择事备注：说明八卦象数/梅花易数/六爻仅在用户给出具体择事情境时再起卦（如「签不签这个合同」「换不换赛道」），出生盘本身不硬塞卦象。
- 合规收尾：附「命理属传统文化哲学，无法替代理性决策与医学诊断」提示。
规则：报告以「据已知信息推演」为基调，绝不声称绝对；涉及中国香港/中国台湾/中国澳门必须按官方表述。
必做：接地气、去空泛、说人话（本技能核心交付质量要求，不可省略）
- 白话叙事，少术语：参考公开复盘式白话风格——先用一句话定调，再用「你像……」「你会……」「你要注意……」的人称化表达，把「印旺身强」「食神透干」等术语藏在解释后面，不让术语成为阅读门槛。
- 结合性别：男命以财为妻星／女命以官杀为夫星，必须点出「性别带来的优势与坑」，不能只讲中性格局。
- 结合现实背景（决定建议有多具体）：
- 命盘只能给出方向（喜金水、宜沉淀、忌投机、食神生财等）。
- 具体落点必须来自用户的真实背景：职业、城市、家庭结构、当前痛点、所在行业。例如「把内容能力方法论化」是方向；「把本行业爆款内容拆成可复用模板、用 AI 建素材库」是结合「内容从业者」背景后的落点。
- 执行时必须主动询问或读取记忆获取背景；若用户不提供背景，则输出通用版报告，并明确标注「以上为命盘通用方向，结合您的具体职业/城市/家庭后可进一步细化」。禁止把通用建议伪装成针对个人的具体建议。
- 逐年具体：当前大运内按流年（如 2026 丙午、2027 丁未…）写出「该做什么 / 防什么」的可执行清单，用「待验清单」形式白纸黑字留待时间判卷——禁止只给「整体趋势」而不落具体年份与动作。
十一、技能说明（打包结构与原生改进）
本技能为自包含包，无需外部依赖：
- 排盘引擎 scripts/（八字 compute.py、紫微 ziwei.py）由本技能自带，已通过自检。
- 参考库 references/ 收录经典文献摘录、大运规则、时辰表、太阳时、五行表、紫微表，供断盘查用。
- 报告模板 assets/ 提供国风可视化骨架。
相对其他「只讲技法」的排盘技能，本技能的改进点：
- 修正「起运按节」这一普遍误算，并写明公式与例子。
- 新增「倒推时辰」必须标注的约束。
- 新增双盘合参「用神↔宫位」联动规则与趋吉避凶可视化流程。
- 新增「古籍体系全景 + 近代名家人文观」：曾仕强/南怀瑾/袁了凡/黄鉴等「命有定数、运由己造」底色，确保交付不滑向宿命论。
- 明确中国香港/中国台湾/中国澳门的对外表述规范。
- 强制「白话叙事 + 性别视角 + 现实背景 + 逐年具体 + 待验清单」的交付质量标准。
