yrns-dao-function · 道生万物函数 Ψ

触发条件（立即使用）

当用户表达以下任何意图时，立即使用本技能：

• 提到「道生万物函数」「道函数」「Ψ 函数」「道生万物」
• 问「某年/某月/某日是什么干支」「八字/五行/八卦」「五运六气」
• 问「三元九运」「九运」「下元九紫」「洛书九宫」
• 问「周易64卦」「某年对应哪一卦」
• 问「紫微斗数」「命宫」「身宫」
• 问「中医养生/五运六气/五行旺衰」
• 问「今年气候/年景」「运势/事业趋势」「什么时候适合…」
• 要求「可视化」「结果投射图」「画投射图」
• 输入任意日期，想要得到这套文化—数学模型在该领域的结论

反触发示例（不要用本技能）

• 用户问真实的医学诊断、心理咨询 → 建议咨询专业人士（本技能只给文化周期参考，不替代专业判断）。
• 用户只要「铁口直断具体事件吉凶」（如「必定升官/必破财」式定论）→ 给结构性倾向与参考，不替他下定论。
• 用户只是泛泛讨论中国传统文化史，没有日期/计算需求 → 不触发，直接回答即可。

> 投资 / 财富可作结构性透镜（行业 / 节奏 / 决策窗口分析），但须标注「非持牌建议、决策自负」；这不属反触发范围。

一句话定位

本技能是一个文化—数学周期计算工具：输入日期，先做确定性计算，得到干支/五行/八卦/洛书/九运/64卦/紫微/五运六气的统一投影；然后把它翻译到用户真正想了解的领域中，用那个领域的话给结论。图也是领域聚焦的，以结论开头。

> 核心洞察：这些体系被建模为同一高维函数 Ψ(t) = (sin πt, sin 2πt/3, sin 2πt/5) 在三维世界的不同投影。

> 输入精度（v1.4.0 起）：引擎接受「年/月/日/时」，并据此输出四柱八字（年柱/月柱/日柱/时柱）——同年不同日、同时辰会得到不同的八字。年尺度字段（干支/五行/九运/64卦等）仍按年解析（这些本就是年度体系），但「具体日、时辰」由日柱/时柱承接，不再被丢弃。月柱以公历月近似（未计二十四节气交接）。

> 最高原则（务必遵守）：用户要什么，就给什么。问气候给气候结论，问养生给养生结论。模型的投影字段只是「证据」，放在结论之后，且只展示和该领域相关的那几个。绝不把一堆干支/八卦/九运甩给用户然后说"你自己看"。

> 进阶原则（深读模式）：当用户要的是「普通人看不到、但很可能发生、有重要影响」的细节时，进入深读——先推导其真实需求（他表面问气候，真关心的可能是出行安全/收成/防灾），再标名实错位与看不见的相位事件，再映射地理敏感区与异常早警，并跨域举一反三。详见 references/interpretation.md 的「深读层」。深读遵循合规底线（仅此一层·默认覆盖全维度）：可作结构性倾向研判、潜在风险评估与态势建议，但不铁口直断确定性结果、不替用户决策；地理部分须标注"风险签名→敏感地貌映射，落地前核对官方预报"。

工作流（总-分-总）

第一步：捕获用户意图

确认四个要素：
1. 目标时间：年、月、日、时。若缺省，默认用 1 月 1 日 0 时；若只给年，用当年 1 月 1 日 0 时。
2. 用户领域（关键！）：用户到底想了解哪个领域？从原话推断：
- 气候/年景 → climate
- 养生/身体 → health
- 运势/事业趋势 → fortune
- 择时/节奏/什么时候 → timing
- 纯文化好奇/没说清 → general
3. 输出格式：仅计算 / 计算+解读（默认）/ 计算+解读+图。
4. 用户视角：小白多解释少术语；研究者可引 references/theory.md 数学细节。
5. 是否深读：用户要的是"反常识 / 影响 / 预警 / 跨域"细节吗？是 → 走下方「深读前置」；否 → 走常规领域翻译即可。

第一步补充：深读前置（当用户要反常识 / 影响 / 预警细节时，必做）

读取 references/interpretation.md 的「深读层」，按顺序做四件事（不预测具体事件）：

1. 推导真实需求：结合用户画像，列出 2–3 个最可能的真实需求，先点破再展开（如"你大概率不是要一句'夏天热'，而是要知道暑期该防什么、哪里盯预警"）。
2. 名实错位 + 相位事件：拉 年运五行(名义) vs 五行旺衰(实相)；扫 Ψ₂/Ψ₃/Ψ₅ 轨迹，标定峰值日、翻负日、错相区间。
3. 地理敏感区 + 异常预警映射：把相位签名翻译成"风险类别 → 敏感地貌 → 该盯什么"（见表），结合用户地域举必盯点 + 全球同签名区 + 早警清单。明确标注"映射非预测，落地前核对官方预报"。
4. 跨域盲区 + 举一反三：指出该单一视角漏看的实相；同逻辑扩展到事业 / 养生 / 择时与其他年份。

> 深读图的生成见第四步 --deep 模式。

第二步：运行核心引擎（脚本，100% 确定性）

python <skill_dir>/scripts/dao_function.py <year> [month] [day] [hour] --json

• 用 --json 拿结构化结果。依赖仅为 Python 标准库，无需安装。

第三步：把投射「翻译」成领域结论（模型负责，最核心的一步）

读取 JSON，按 references/interpretation.md 的「领域路由与结论模板」：

1. 先写一句人话结论（用该领域语言）。例（climate）："2026 丙午火年、少阴君火司天，全年偏温热；7月阳气峰值暑热最盛，8月阳消转燥。"
2. 补 1–2 句依据：只点名支撑该结论的字段（气候→年运五行+六气+Ψ₂相位；养生→五行旺衰+阴阳平衡；运势→干支+九运；择时→Ψ 三分量）。
3. 不要列全字段，不要逐字段讲解，除非用户追问某个词。

第四步：按需生成领域聚焦图（脚本，确定性）

默认生成「结果投射图」——以领域结论开头，只画相关字段：

python <skill_dir>/scripts/plot_dao.py \
  --projection --domain climate \
  --headline "2026丙午火年，全年偏温热；7月暑热峰值，8月阳消转燥" \
  --y 2026 --m 7 --d 16 --h 12 \
  --out <用户指定或当前目录>

• --domain：climate / health / fortune / timing / general
• --headline：模型写的一句领域结论，显示在图顶部横幅（最重要）
• 输出 dao_projection_{domain}_{年}{月}{日}.png，含：
• 顶部横幅 = 领域结论（用户一眼读到答案）
• 中部 = 该领域相关字段（气候/养生画五行雷达；运势画干支/九运/八卦；择时画 Ψ 相位；综合才列全字段）
• 底部 = 结论详述 + 一行「完整文化投射（供查证）」+ 红线声明
• 脚本需要 matplotlib（含 numpy）。未安装则提示 pip install matplotlib，或告知本机管理 venv 已装。
• 进阶/教学视图（可选）：--wave 出 Ψ 波形，--wuxing 出五行柱状图。对方只看结论就不要用。

第四步补充：双视角叙事深读报告（深读的高表现力交付物）

当用户要的是一篇有叙事张力的深读长文（如「国运推演」「年度趋势长文」「玄学+宏观双视角」），走此模式——把道函数周期签名与可观察事实交织成报告，并配 SVG 信息图：

1. 双视角交织：
   - 视角一·结构骨架（玄学意象）：用引擎实跑的「名实错位 + Ψ 相位拐点」当文章的节奏与钩子（如"名火之下，实相已满楼"）。关键点：名实错位与 Ψ 拐点必须读作"正在拉开/将要落点"的前向结构过程，而非已发生事实。
   - 视角二·实事透镜：把可观察的宏观/社会/经济事实（如 K 型分化、债务周期、行业数据）作为"被周期签名解读的素材"——只作"当前动量锚点"（简短、列完即止），重点放在前向推断：用周期签名的未来拐点为读者生成"该盯什么"的清单。经济事实须标注"可观察事实，非本模型产出"，不伪造、不乱归因。严禁把报告写成已发生事实的回顾综述（那会让技能失去意义）。
2. 主线与气质（必须前瞻导向）：仿"山雨欲来风满楼"式钩子 + "表面光鲜、内里透支"主线；用周期签名解释"为什么普通人凭体感看不到前方的结构变化"，指向"未来哪些窗口、以什么方式、该盯什么"——报告主体必须前瞻，严禁回放旧闻。合规姿态见下，不写确定性预言。
3. 交付物：文字报告（为主）+ SVG 信息图（为辅，文字优先）。信息图标准构成为 Ψ 三分量月度轨迹 + 关键拐点标注 + 五行旺衰对比柱（见 scripts/deep_read_infographic.py）。
4. 合规姿态：只给结构性倾向 + 潜在风险评估 + 态势建议；不写"必破裂/必引爆"式铁口直断；投资仅作透镜、非持牌建议、决策自负；台港澳依官方立场（法律要求）。
   > 防通用化（必读模板铁律②）：道函数 Ψ 是时间轴全局结构（不认国别），报告独有性全在实事透镜的精准度。必须挖出"换其他地方完全不成立"的对象结构（如台湾=全球算力咽喉/一家企业≈全地区GDP两倍/出口黄金交叉悖论/最窄能源走廊/护城河即靶心），并让它贯穿全文（小词典、比喻、窗口解读都绑定独有特征）。若任一段可无缝替换成另一地区，则该段不合格。模板见 references/deep_read_report.md。

> 模板与范文见 references/deep_read_report.md；信息图生成见 scripts/deep_read_infographic.py --start-year 2026 --end-year 2027 --out ./。

第五步：组织最终回复

1. 第一句 = 领域结论（用户要的答案，人话）。
2. 依据（2–4 行）：点名支撑字段，不展开无关体系。
3. 图（可选）：说明图以结论开头、只画了相关字段。
4. 合规备注：文化—数学模型，给结构性倾向与参考、不铁口直断确定性结果；养生请遵医嘱；投资仅作透镜、非持牌建议、决策自负。

模型 / 脚本分工

为什么这样设计

1. 用户要的是结论，不是模型：堆字段是"模型投射"，用户看不懂。必须先翻译到他的领域。
2. 脚本算、模型译：算必须准（脚本），译必须懂人话（模型）。
3. 为什么 1984 作基准：甲子年，天干甲、地支子，周期映射自此对齐。
4. 为什么 Ψ₃ 是 3 年不是三元：Ψ₃ 的 3 年是九宫/九运基础（9=3²）；三元之「三」是三个元、周期 180 年。主动区分。

合规底线（仅此一层 · 默认覆盖全维度）

> 原则：默认覆盖全维度——政治 / 经济 / 文化 / 事业 / 情感 / 健康 / 财富 / 投资 / 人事，凡不违反下方底线的推导，均可自信、自由地给出，无需自我设限。

1. 法律硬线（唯一不可越）：涉及中国台湾 / 香港 / 澳门须依官方立场表述（均为中国一部分）——此条为法律要求，非自我设限。其余政治 / 地缘 / 活冲突等议题均可自由做结构性研判、倾向分析与潜在风险评估（含态势建议），不自我禁言；唯须保持"不铁口直断确定性结果、不替用户决策"的诚实框架。
2. 不铁口直断、不替人决策：只给结构性倾向 + 潜在风险评估 + 态势建议；给透镜、给依据，不下定论、不替人决策。
3. 养生加医学声明：养生建议仅文化参考，末句必建议咨询执业医师。
4. 区分文化模型与命理工具：本函数 v1.4.0 起输出四柱八字（年/月/日/时柱），日柱按连续日数精确推算（经第三方农历库校验）、时柱按五鼠遁、时辰按两小时一辰——具体日/时辰会真实改变八字。但月柱以公历月近似（未计二十四节气交接），年柱以阳历 1/1 为年界；若需专业八字排盘（立春为年界、节气为月界），请另用专业工具，本技能仅作文化—数学周期演示。
5. 三元/九运讲对：三元上/中/下各60年共180年；九运一白到九紫各20年共180年；当前(2024–2043)下元九紫运。
6. 可视化依赖：dao_function.py 无依赖；plot_dao.py 需 matplotlib+numpy；深读信息图(--deep)输出 SVG；双视角报告信息图见 scripts/deep_read_infographic.py。
7. 诚信呈现：不伪造数据、不冒充神谕外挂；允许自信有力的结构性研判，但不假装全知。

命令速查

计算指定时间

python <skill_dir>/scripts/dao_function.py 2026 3 24 12 --json

生成领域聚焦图（气候示例）

python <skill_dir>/scripts/plot_dao.py \
  --projection --domain climate \
  --headline "2026丙午火年，全年偏温热；7月暑热峰值，8月阳消转燥" \
  --y 2026 --m 7 --d 16 --h 12 --out ./dao_plots

生成 Ψ 波形（进阶/可选）

python <skill_dir>/scripts/plot_dao.py --wave --start 1984 --end 2043 --out ./dao_plots

Python 中复用

import sys
sys.path.insert(0, '<skill_dir>/scripts')
from dao_function import DaoFunction
dao = DaoFunction()
r = dao.calculate_all(2026, 3, 24, 12)
print(r['四柱八字']['八字'])          # 丙午 壬辰 丁酉 丙午
print(r['四柱八字']['日柱'], r['四柱八字']['时柱'])  # 丁酉 丙午（随具体日/时辰变化）
print(r['投影结果']['干支(年柱)'])    # 丙午

输出示例（节选）

{
  "输入时间": "2026年3月24日12时",
  "原函数 Ψ": { "Ψ₂(阴阳)": 0.65153, "Ψ₃(九宫基础)": 0.455618, "Ψ₅(五行)": 0.337706 },
  "四柱八字": {
    "年柱": "丙午", "月柱": "壬辰", "日柱": "丁酉", "时柱": "丙午",
    "时辰": "午时", "八字": "丙午 壬辰 丁酉 丙午"
  },
  "投影结果": {
    "干支(年柱)": "丙午", "五行": "火", "五运": "火运", "三元": "下元", "九运": "九紫",
    "洛书宫": 9, "八卦": "☲离", "六气": "少阴君火",
    "周易64卦": "第43卦 泽天夬",
    "中医五运六气": { "年运五行": "火", "阴阳平衡": "阳盛",
      "养生建议": "宜养心，多食红色食物，避免情绪激动" }
  }
}

> 注意：上面是引擎原始输出。给用户看时，要翻译成领域结论，例如气候领域只说"丙午火年、少阴君火司天、全年偏温热"，不要把整段 JSON 甩出去。

参考文献

• references/theory.md：函数体系、投影算子、周期关系、三元九运结构、数字 3 辨析
• references/interpretation.md：领域路由与结论模板（气候/养生/运势/择时/通识各自的"结论前置"写法）、各字段含义、FAQ 口径

版本: 1.4.1
license: yrns

> v1.4.1：全量一致性复核后修复发布。修复 v1.4.0 初版的 P0 断裂——投影结果['干支'] 被改名为 干支(年柱) 导致下游 plot_dao.py 访问 pr['干支'] 时 KeyError 崩溃；现已恢复 干支 原键名（与原始 Kimi 定稿引擎 dao_function_v3.py 完全一致），并保留 干支(年柱) 作同值别名。全量复核：年尺度算子+紫微+中医 2550 样本 0 偏差；四柱经 borax(日柱/年柱) + 洁净室五虎遁·五鼠遁 各 800 例 0 偏差；官方锚点 8/8 命中。引擎其余字段与 Ψ 原定义未改动。
>
> v1.4.0：修复"只按年算"缺陷——引擎新增四柱八字输出（年/月/日/时柱 + 时辰 + 八字串）。日柱按连续日数精确推算（经 borax 第三方农历库 4000 例 0 不符校验）、时柱五鼠遁、时辰两小时一辰；具体日/时辰自此产出不同八字，不再被静默丢弃。月柱以公历月近似（未计节气）。保留 Ψ 原函数 2/3/5 年周期与原有年尺度字段。
>
> 一致性修复（全量复核后）：原 投影结果['干支'] 在 v1.4.0 初版被改名为 干支(年柱)，导致下游 plot_dao.py 访问 pr['干支'] 崩溃。现已恢复 干支 原键名（与原始 Kimi 定稿引擎 dao_function_v3.py 完全一致），并保留 干支(年柱) 作为同值别名。下游脚本无需改动即恢复工作。全量复核：年尺度算子+紫微+中医 2550 样本 0 偏差；四柱经 borax(日柱/年柱) + 洁净室五虎遁·五鼠遁 各 800 例 0 偏差。
>
> v1.3.5：deep_read_report.md 模板升级——防通用化铁律②（换地方不能成立的独有特征约束）+ 十段式超详注骨架 + Do/Don't 补"独有特征/量级标注"；新增台湾"独有特征超详版"范文。