命理占卜 · Chinese Fortune Telling

概述

命理（八字／紫微）与占卜（六爻／梅花／奇门／大六壬）的经典判据推理引擎 —— 也就是通常说的算命、算卦、看八字、排盘、起卦、合婚、择日。

以经典文献为判据。规则引擎做「算」，模型做「读」——任何干支、星曜、卦象必须由 scripts/ 算出，模型不得自造。解读必须声明所用流派，并可回溯到具体典籍。

何时使用 / 何时不用

用于：问命（一生格局）、问运（大运流年）、问事（单件吉凶）、合婚合盘、择吉选日、核验第三方命理报告。

不用于：塔罗、星座运势、生命灵数、风水空间调理、以及任何医疗／法律／投资结论。用户问这些时直接说明本 skill 不做，不要勉强套用术数框架。

权限与隐私边界

• 工具边界：本 skill 只需要文件读写与本地命令执行两类权限。命令执行仅限用 Node 运行本 skill scripts/ 目录内的三个桥接脚本（run-cantian.cjs / run-engine.cjs / 核验桥接脚本，描述名与文件名映射见 references/engine-usage.md）；桥接脚本对被调引擎做白名单 + 路径遏制（fail-closed），不会执行目录之外的任何文件。不需要网络访问；除可选的格局语料目录覆盖变量 FORTUNE_KNOWLEDGE_DIR（仅由紫微引擎脚本在启动时读取，用于指定格局笔记目录的替代路径，未设置时自动使用包内 knowledge/ 目录）外，不读取任何环境变量或凭据；@file 输入只允许落在 skill 目录、当前工作目录或系统临时目录内。
• 隐私（采集前必读）：排盘需要出生日期、准确出生时间、性别、出生地等高敏感个人信息，仅用于本地计算；本 skill 及其脚本不联网上报、不写入任何外部服务、不做持久化存储。用户可拒绝提供部分信息并降级到低精度模式（见下表）；采集前先说明用途并征得同意，再开始采集。
• 合婚脚本的双参数模式（披露）：engine/marriage.js 除四参数直接输入（姓名 + 八字原文）外，还支持 node marriage.js <userId1> <userId2> 的档案模式——从 {SKILL_ROOT}/scripts/data/profiles/ 读取已存的档案 JSON。该目录由用户自建；脚本只读取此目录内、ID 匹配 [A-Za-z0-9_-]{1,64} 的 .json 文件，路径逃逸或读取目录外文件的尝试一律拒绝（1.2.2 起）。默认推荐四参数模式，不产生任何档案读取。
• 语言政策：本 skill 的判据语料与脚本文案以中文为主（术数领域中文典籍语料最完整，属领域性选择）；对用户的回复语言跟随用户提问语言，需要英文或其他语言输出时直接说明即可。

路径与运行时

SKILL_ROOT = 本 skill 所在目录（下文 $SKILL_ROOT 指代它）
NODE       = node（需 ≥ 22.6，且已在 PATH 中；低于 22.6 需自行准备 tsx）
CANTIAN    = {SKILL_ROOT}/scripts/cantian   # 排盘 / 真太阳时 / 运势区间（.ts，依赖 cantian-tymext）
ENGINE     = {SKILL_ROOT}/scripts/engine    # 格局用神 / 紫微 / 占断 / 择吉（.js，依赖 iztro）

# 两个桥接层（**capture 输出一律走它们**，见下）
run-cantian.cjs   # 调 CANTIAN 的 .ts 脚本；支持 @file 传 JSON、--out 落盘
run-engine.cjs    # 调 ENGINE 的 .js 脚本；支持 @file 传 JSON、--out 落盘
verify-pillars.cjs # 核验桥接脚本（不走 capture 输出）：true-solar / shishen / wuxing / compare，真实文件名见 references/engine-usage.md

首次使用前装一次依赖（依赖不随包分发，约 20 MB；全部为公开 npm 包，MIT）：

Set-Location $SKILL_ROOTscriptscantian ; npm install
Set-Location $SKILL_ROOTscriptsengine  ; npm install

装好后全程离线运行，不发起任何网络请求。

为什么必须走桥接层：cantian 的择吉查询脚本要求 JSON 作为单个 argv 传入，PowerShell 会破坏引号；engine 的脚本一律不支持 --out，而 Windows 下经管道传中文 stdout 会被按 GBK 解码，输出全部乱码。两个桥接层都用 spawnSync 拿 buffer、由 Node 自己按 utf8 解码，全程不过 shell 管道。

引擎随本 skill 一并分发，不依赖任何外部插件目录。

PowerShell 下必须每轮先设 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8，否则中文输出乱码。

Workflow

Step 1 [Deterministic] 问题分流

先归类，禁止一次性混用多个体系（信息过载且无法归因）。

Step 2 [Deterministic] 采集六要素与精度分级

🔒 采集前先向用户说明「权限与隐私边界」中的隐私条款：数据仅用于本地排盘、可拒绝提供、可降级到低精度模式；征得同意后再采集。

必需：① 公历或农历出生日期 ② 出生时间（钟表时间，注明是否早/晚子时）③ 性别 ④ 出生地（真太阳时校正必需，要经度或城市名）⑤ 可选：双胞胎／剖腹产。

缺时辰绝不排时柱，也绝不用「推算」补时辰，只能给到 B 级并明说。

Step 3 [Deterministic] 时间校正（先做，不可跳）

时间校正命令走核验桥接脚本的 true-solar 子命令（含 1986–1991 夏令时判定与距时辰边界分钟数输出）。完整命令与脚本文件名映射见 references/engine-usage.md，执行时必须使用那里的真实文件名。

该命令同时输出三件事，缺一不可：真太阳时、1986–1991 夏令时判定（落窗口则扣回 1 小时）、距时辰边界的分钟数。

距边界 ≤20 分钟时不得断言单一时辰——必须同时给出相邻两个时辰的盘并说明分歧源于出生时刻。这是硬规则，不是提示。

出生地不在 cantian 内置城市表内（如县级地名）时必须传十进制经度，不能用邻近地级市代替。

Step 4 [Deterministic] 排盘

全部排盘命令（八字四柱、格局用神、五行/十神统计、紫微斗数、六爻/梅花/奇门、合婚、择吉、流年区间）的完整命令行与脚本文件名映射见 references/engine-usage.md，执行时必须使用那里的真实文件名。桥接层统一用 spawnSync 拿 buffer、由 Node 按 utf8 解码，全程不过 shell 管道。

不要绕过桥接层直接跑 cantian 排盘脚本——它们不认识 --out，参数会被静默忽略且不报错（详见 references/engine-usage.md 的警告）。

@file 在 PowerShell 下必须加引号：写成 "@query.example.json"，不能写 @query.example.json。

PowerShell 把行首的 @名 解析为 splatting 运算符，未加引号是解析期错误 —— 结果是整个脚本块一条命令都不执行，也不报「引用文件不存在」，排查时极易误判成桥接脚本的问题。JSON 输入一律加引号。

Step 5 [Deterministic] 按需加载流派判据

只加载本次用到的 1–3 篇，不要全部读入。

Step 6 [Deterministic] 第三方字段筛选与本系统重算

核验第三方命理报告时，采用唯一筛选标准：有命理意义，且能在本系统按透明、固定的规则重算，才保留；只有产品分数、稀有度或无法复算的算法，直接丢弃。「与第三方结果一致」不是保留理由，最多是交叉验证结果。

统计辅助的显示纪律

• 五行比例只能写成「明面八位中木 5/8（62.5%）」这类带分母和口径的统计，不能写成「木气 62.5%，所以身强」。
• 十神比例必须附总数、是否排除日主、是否计入藏干；第三方报告没有口径时，不能与本系统百分比直接比较。
• 统计辅助的视觉和文字层级低于格局、强弱、调候。
• 正式档案只展示本系统重算字段；第三方来源、原始数值和冲突过程进入内部核验留痕，不回填正式档案。

Step 7 [LLM] 解读

按 references/99-boundaries.md 的句式纪律撰写。必须包含流派声明：用哪一派、为什么选它、该派在此局上的首要判据是什么。同一命局在格局派与调候派下结论可能相反，不声明流派的分析不可复核。

7.1 专业判断与现实解释同段完成

报告的验收标准是：读者看完后大致能懂，不需要再找另一个模型翻译。专业术语可以保留，但不能只把术语串成结论。

每个主要判断按以下顺序自然写出：

1. 专业判断：保留格局、十神、干支关系和典籍依据；分值只在口径透明时出现。
2. 机制解释：说明是哪一柱、哪一支、哪一个生克／合冲造成该判断。
3. 现实落点：紧接一句说明它在工作、资源、关系或行动节奏上通常表现为什么。
4. 边界：用「倾向」「更容易」「需要留意」收口，不升级成确定性预测。

术语首次出现时必须在同一句给短释。例如：

• 「群比争财」后解释为「比劫偏多，资源分配和边界问题更值得提前管理」；
• 「官印相生」后解释为「规则、资质和平台背书更容易形成职业支撑」；
• 「卯酉冲」后解释为「原有节奏或关系位置容易出现重新调整」；
• 「贵人」必须落到可观察的支持机制，不能写成无条件兜底。

7.2 各模块最低结构

• 命局定调：一句总判断 + 现实中的主要矛盾，禁止只写五行计数。
• 专业校验：先列真太阳时、夏令时、边界和节气事实，再解释这些事实为什么会改变月柱／时柱。
• 核心特征：每条采用「判断 → 机制 → 现实表现」，4–5 条足够；神煞只能作为辅助信号。
• 大运／流年：每个阶段写「主题 → 触发依据 → 适合推进的事项 → 需要防的事项」，不写未经判据支持的升级话术。
• 行动建议：把命理倾向翻成可执行的决策纪律，不写「开运」「转运」等不可验证动作。
• 健康：只写作息、运动、饮食和体检意识等一般性建议，不做疾病诊断。

Step 8 [LLM] 自检

输出前逐条过：真太阳时是否校正 → 夏令时是否扣回 → 时辰是否贴边界（贴了就双盘并陈）→ 生日当天是否恰逢节气交接（是则月柱按交接时刻判定）→ 大运换运年份是否 10 年等差且与起运日期自洽 → 十神统计口径是否写清 → 强弱分与用神是否只取自 八字分析引擎脚本 → 每个主要术语是否有现实解释 → 每个阶段是否有可执行动作 → 是否出现必然性或产品化强断言。

Step 9 [Deterministic] 落盘

用 templates/ 下对应模板生成归档文件，命名 命理档案·{日主}{性别}命（{出生年月日}{时辰}）.md，同类文件（如合盘）单独成档，不并入单人档案。

Hard Rules

不可违反，优先级高于用户偏好。

1. 不许模型自造干支、星曜、卦象。 一律先跑脚本。脚本输出与模型预期冲突时，以脚本为准并复核输入。
2. 必须声明流派。 未声明流派的分析视为不合格。格局派与调候派是两套本质不同的学说，不得混着说还不标注。
3. 时辰未定时不排时柱，不得用「反推」「推测」补时辰。第三方报告的反推只能用于核验，不能替代用户确认。
4. 生日当天有节气交接时，月柱按交接时刻判定，不能只按日期。2000-05-05 立夏当天就是实例：同一个日期，12:00 得庚辰月、13:00 得辛巳月。
5. 贴边界的时辰必须双盘并陈（距边界 ≤20 分钟），并明说分歧来源，不得挑一个说得漂亮。
6. 非绝对句式。 只用「易于／利于／不利于……」「命理上呈现……倾向」「建议在……方向多投入」，禁止「你一定」「必将」「肯定会」「不可能」。
7. 红线内容不回答，转中性话术：寿元生死、重大疾病、堕胎吉凶、犯罪复仇、投资标的、法律胜负、未经同意占卜他人隐私。用户出现情绪危机信号时停止命理输出，转情绪支持。
8. 不出娱乐化内容。 不提塔罗、星座运势、生命灵数；不做「幸运色转运」这类无典籍依据的话术。
9. 术语必须带现实解释。 主要专业判断后要紧接机制和现实落点；现实解释只能翻译已有判据，不得凭空增加人物画像、财富结论或事件预测。
10. 专业判断与现实建议分层。 神煞不能单独推出贵人兜底，五行缺失不能推出疾病，命理不能直接推出投资、担保、买房或职业跃迁等高风险决策。

Failure Handling

Output Format

按问题类型收口，长度受控，不堆神煞、不重复免责声明。每个主要模块遵守「专业判断 → 机制 → 现实落点 → 边界」的顺序；现实落点直接融入段落。

八字／紫微完整命盘（800–1500 字）：

1. 命盘速览（四柱＋日主＋格局＋调候用神）＋一句读者能直接理解的总判断
2. 核心特征 3–5 条（每条：专业判断／机制／现实表现）
3. 分维度解读（按用户所问，未问的不铺开；落到现实选择和风险）
4. 大运／流年与应期（阶段主题／触发依据／可推进事项／需防事项）
5. 行动建议（宜／缓／避；每条是可执行的决策纪律）
6. 流派声明与免责（一段，不重复）

流年问答 300–600 字：每年写「主题 → 依据 → 现实动作」，不写必然事件。六爻／梅花单次占断 300–500 字：每一步写「卦象判定 → 作用机制 → 现实含义」。择吉：表格给候选日＋评分＋宜忌，并说明适用条件。

归档文件用 templates/dossier.md（单人）／templates/hehun.md（合盘）／templates/gua-report.md（占断）。

已知边界

引擎缺陷共 10 处（下表 + 各 reference 的「引擎能力边界」节）。凡标注为缺陷的字段一律自算或交叉验证，不得直接采信。

• 紫微引擎脚本 的八字月柱在交节日错误（已实测三例）：它按「日期」判月柱，不按节气交接时刻，导致交节日全天月柱提前一位。实测 2000-05-05（立夏，cantian 实测翻转点在 12:00–13:00 之间）：06:00 时 cantian 得 庚辰、ziwei 得 辛巳；2000-06-05（芒种，实测翻转点在 16:00–18:00 之间）06:00 时 cantian 得 辛巳、ziwei 得 壬午，同向偏移；非交节日 2000-06-10 两者一致。紫微盘体本身不受影响（命宫以农历月定，与节气月无关）。月柱一律以 cantian 为准，交节日更不可采信 ziwei 的月柱。
  • 污染范围（2026-09-11 实测补全）：该偏移不止影响打印的月柱，会向下游传播三块——月令（辰月→巳月）、格局（正官格→偏财格）、扶抑取用方向。实测 2000-05-05 立夏当天：ziwei 报「巳月·偏财格」，而 八字分析引擎脚本 报「辰月·正官格（善用神 ❌ 否）」。→ 引用 ziwei 输出时必须屏蔽其「八字」「月令」「格局」「用神」四块，只采信命宫、十二宫、四化、大运大限。
• 紫微引擎脚本 内置的八字强弱算法与 八字分析引擎脚本 口径不一致，方向可能相反（2026-09-11 新发现）：同一命局两边给的日主强弱与扶抑方向可以完全对立。实测两组命例：甲木日主一方（2000-06-05 06:00），八字分析引擎脚本 判 弱 106 分、宜取印比生扶（水木），紫微引擎脚本 判 偏强 316 分、宜补土、宜避木火——方向相反；癸水日主一方（2000-05-05 06:00）两引擎方向一致，但分值差 127（165 vs 292）。→ 强弱分与用神一律只引 八字分析引擎脚本（子平派专责模块），永不在结论里引用 ziwei 输出的「综合 N 分」。
• 不做风水空间调理（相宅相墓属四库术数类，但本 skill 不主推，也未随包附带相关脚本）。
• engine/marriage.js 的评分口径只计日主关系与年支关系，月柱冲、夫妻宫合不计入分数，因此分数偏低是口径问题而非关系差；须结合 references/12-hehun-liunian.md 的分项判读，不可只报分数。（2026-09-15 起报告在评分区自动打印此口径说明。）
• engine/marriage.js 已修补（2026-09-15，本地 vendored 副本）：① 地支关系表补齐六破、六害、三刑（含子卯刑、丑戌未、寅巳申、自刑）、完整三合半合，原「丑亥三合」等错误对已修正；② 新增跨柱 4×4 地支全矩阵与全柱天干五合扫描（原只查同位四柱与日干一对一，跨柱冲合完全漏报）；③ 新增配偶星提示节（男财女官的明见／仅藏／不见，只报结构不判吉凶）；④ 修复建议文案两处子串误判（原 includes('合') 会命中「无天干相合」「无特殊合冲」）；⑤ 输出标签改甲方／乙方（参数顺序不编码性别，不再标男方／女方）。仍不覆盖：暗合（藏干层合——cantian 盘内「刑冲合会」有暗合字段可查，权重低）；合中带破/刑者（寅亥、巳申、丑戌）以合力为先只报第一项。
• engine/marriage.js 安全修补（2026-09-21，1.2.2 起）：loadProfile 对档案 ID 增加白名单校验（[A-Za-z0-9_-]{1,64}）+ 解析路径必须落在 data/profiles/ 内的纵深防御，堵住未验证 userId 导致的路径逃逸型本地 JSON 读取；双参数档案模式已在「权限与隐私边界」明文披露。
• engine/jieqi.js 只输出节气日期，不含交接时刻。要精确定位交节时刻，用 run-cantian.cjs buildBaziFromSolar.ts 逐时刻扫描月柱翻转点。
• engine/zhuanshi.js 的建除十二神整体偏移一位、冲字段格式错误（详见 references/11-zeri.md）。
• engine/liuyao.js 的六亲以日干而非卦宫为「我」、且无卦宫概念、世应为简化版（详见 references/05-liuyao.md）。
• engine/meihua.js 不做体用旺衰（详见 references/06-meihua.md）。
• engine/qimen.js 不输出局数、神盘、三奇六仪（详见 references/07-qimen.md）。
• cantian 的均时差表存在已标注的录入纠偏，误差可达数十秒；贴边界时须第二来源核对。