鸭先知些子法风水智能辅助系统

> 风水师的口袋罗盘——不是玩具，是干活用的工具。

你是不是也遇到过这些情况？

客户催你，你还在纸上画卦

客户问"这个向能不能立？"你脑子里飞速运转——来龙什么卦？坐山几运几气？向首合不合十？抽哪一爻？城门在哪？一通算下来，纸上画满了卦象和数字，客户等得不耐烦了。

手机上装了三四个App，排出来的盘每次都不一样

挨星表对不上书上的口诀，卦运映射错位，替卦口诀张冠李戴。你不敢拿它给客户看，最后还是回到纸笔。

客户拿了一个"大师"择的日子来问你

你一看——日柱冲坐山、福主命卦不合、卦运零向反了。但你要花二十分钟手算验证才能说清楚哪里不对。

想验证一本书上的案例，手算兼向卦太复杂

杨钊祖坟1994年惠州实例，寅兼甲、申兼庚、丁兼未、亥兼壬——12组兼向配卦表翻来翻去，稍不注意就错了。

这些痛点，鸭先知一次性解决。

为什么选择鸭先知

一句话：市面上能找到的玄空大卦排盘工具里，没有一个比它更准

不是调了几个API就敢叫"专业"

市面上很多风水App，本质就是套了个壳——核心算法全是抄来的，挨星表抄错了一个数字，后面全盘皆错。鸭先知不一样：

• 每一行算法都有出处：坤壬乙诀原文怎么写的，代码就怎么实现的
• 每一个数字都可追溯：42项真实案例反验，包括杨钊祖坟1994年惠州实例（正针+兼向双版本）
• 274项测试不是凑数：4个测试文件，覆盖基础算法、案例验证、模块交叉审计、兼向扩展

四大核心功能

1. 排盘命令 paipan — 3秒排出完整玄空大卦盘

输入来龙、坐山、向首、来水、去水，一键得到：
- 纳甲配卦（六十四卦名）
- 挨星数（1-9，与坤壬乙诀一致）
- 卦运、卦气（合十即吉）
- 城门宫位
- 抽爻换象结果
- 自动断语（吉/凶/注意三级）

告别纸笔，告别算错，告别客户等待。

node dist/cli.mjs paipan --yun 8 --zuo 丑 --xiang 未 --long 壬 --lai 辰 --qu 戌

2. 择日命令 zeri — 智能日课评估，0-100分量化评分

输入坐山+四柱干支+福主年份，自动评估：
- 卦运合十、卦气合十、同旺、三通
- 不冲坐山、不冲福主
- 夫妇交媾、当旺运
- 综合评分：80+优秀，60-79可用，60以下建议另选
- 逐条规则通过/失败原因，一目了然

客户拿来一个日子，你10秒就能说清楚好不好、为什么。

node dist/cli.mjs zeri --zuo 乙 --fzNian 1960 --year 癸巳 --month 庚申 --day 庚申 --hour 甲申

3. 流年飞星命令 liunian — 一年运势，全盘呈现

输入公历年份，自动推算：
- 紫白九星入中
- 各宫飞星分布
- 太岁、三煞方位
- 五黄、岁破到方

2026年五黄到哪？太岁三煞在什么方位？一查便知。

node dist/cli.mjs liunian --year 2026

4. 天卦排盘命令 tiangua — 玉函通秘天卦系统

输入元运+龙类型+来龙，排出：
- 山龙天卦（先天卦，合九）
- 水龙天卦（后天卦，合十）
- 流行卦（逆飞九宫）
- 火坑煞、剥官煞判定
- 八纯卦识别

市面App基本不支持的天卦排盘，这里有完整实现。

node dist/cli.mjs tiangua --yun 9 --longType shan --longShan 壬

三种使用方式，覆盖所有场景

断网了？在山上？在客户家里？都没关系。 Web版有PWA离线缓存，Android版完全本地运行，CLI零依赖。不需要WiFi，不需要信号，不需要服务器。

安全与隐私

• 无网络数据上传，所有计算在本地完成
• 无用户追踪，无 analytics，无埋点
• 案例数据存储在浏览器 localStorage，你的数据只有你能看到
• CLI 单文件运行，不访问网络、不读写磁盘敏感位置
• 代码完全开源，可审查每一行算法实现

触发方式

当用户提出以下需求时，使用本技能：

• 「排盘」「玄空大卦排盘」「些子法排盘」→ 执行 paipan 命令
• 「择日」「选日子」「日课评估」「这天能用吗」→ 执行 zeri 命令
• 「流年飞星」「2026年飞星」「太岁三煞」「五黄到方」→ 执行 liunian 命令
• 「天卦排盘」「山龙天卦」「水龙天卦」「火坑剥官」→ 执行 tiangua 命令
• 「风水」「坐山朝向」「来龙去水」「挨星」「卦运卦气」→ 根据上下文判断执行哪个命令

不要在用户只问"什么是玄空大卦"等纯理论问题时调用命令——那是知识问答，直接用文字回答即可。

CLI 命令完整参考

前置条件

需要 Node.js 18+ 环境。本技能包含一个零依赖的可执行 CLI（dist/cli.mjs，74KB），无需安装任何 npm 包。

所有命令输出均为 JSON 格式，可直接解析后向用户展示。

1. 排盘命令 paipan

用途：根据来龙、坐山、向首、来水、去水排出玄空大卦盘，包含纳甲配卦、挨星、卦运卦气、城门、断语。

输入参数：

二十四山列表：壬 子 癸 丑 艮 寅 甲 卯 乙 辰 巽 巳 丙 午 丁 未 坤 申 庚 酉 辛 戌 乾 亥

执行示例：

node dist/cli.mjs paipan --yun 8 --zuo 丑 --xiang 未 --long 壬 --lai 辰 --qu 戌

输出字段说明：

{
  "yun": 8,
  "zhengShen": 8,
  "lingShen": 2,
  "long": {
    "shan": "壬",
    "gong": "坎",
    "hexName": "风地观",
    "hexYun": 2,
    "hexQi": 2,
    "aiXing": 2,
    "wuxing": "火"
  },
  "zuo": { },
  "xiang": { },
  "lai": { },
  "qu": { },
  "chouYaoResult": null,
  "chengMenGongs": ["离","兑"],
  "pillars": [],
  "fuZhu": null,
  "judgments": [
    { "level": "good", "title": "...", "detail": "..." },
    { "level": "bad", "title": "...", "detail": "..." }
  ]
}

2. 择日命令 zeri

用途：评估候选日课与坐山的合度，给出0-100分评分和逐条规则通过/失败原因。

输入参数：

执行示例：

node dist/cli.mjs zeri --zuo 乙 --fzNian 1960 --year 癸巳 --month 庚申 --day 庚申 --hour 甲申

输出关键字段：

{
  "dateStr": "...",
  "ganZhi": { "year": "癸巳", "month": "庚申", "day": "庚申", "hour": "甲申" },
  "hexPillars": [],
  "compatibility": {
    "riYunHeShi": true,
    "riQiHeShi": true,
    "riYunTongWang": false,
    "riQiTongWang": false,
    "tianDiRenTong": true,
    "noChongShan": true,
    "noChongFz": true,
    "dangWang": false,
    "fuFu": false,
    "score": 65,
    "reasons": []
  },
  "judgments": [],
  "isAuspicious": true
}

3. 流年飞星命令 liunian

用途：推算某年紫白九星入中、各宫飞星、太岁三煞五黄岁破到方。

输入参数：

执行示例：

node dist/cli.mjs liunian --year 2026

4. 天卦排盘命令 tiangua

用途：执行玉函通秘天卦排盘（山龙天卦/水龙天卦），判断火坑剥官煞、八纯卦。

输入参数：

执行示例：

node dist/cli.mjs tiangua --yun 9 --longType shan --longShan 壬

异常处理

所有错误以 JSON 格式返回，包含 error 字段和 hint 字段：

{
  "error": "参数 --xiang=\"ABC\" 无效。必须是二十四山之一：壬、子、癸、丑、艮、寅、甲、卯、乙、辰、巽、巳、丙、午、丁、未、坤、申、庚、酉、辛、戌、乾、亥",
  "hint": "使用 \"node cli.mjs help\" 查看用法说明"
}

常见错误及处理：

能力边界

能做什么

• 玄空大卦些子法排盘：来龙/坐山/向首/来水/去水 → 纳甲配卦 + 挨星 + 卦运卦气 + 城门 + 断语
• 择日合度评估：四柱干支 + 坐山 → 0-100分评分 + 逐条规则
• 流年飞星推演：年份 → 紫白九星 + 太岁三煞五黄岁破
• 天卦排盘：山龙/水龙天卦 + 流行卦 + 火坑剥官煞
• 兼向分金：支持12组兼向配卦
• 抽爻换象：384爻全抽爻对比

不能做什么

• 不能替代专业风水师的现场判断：本工具输出的是算法计算结果和传统断语，最终决策需结合实地环境
• 不能预测命运：风水理气是环境学，不是算命术
• 不能处理非玄空体系：本系统仅支持玄空大卦些子法，不支持三合、八宅、杨公等其他流派
• 不支持室外峦头分析：本系统只做理气计算，不分析山水形态
• 节气数据仅覆盖1900-2100年：超出此范围的八字排盘不保证精度
• 不能用于商业择日的最终决策：建议结合专业风水师意见综合判断

FAQ

Q: 排盘结果中的"卦运"和"卦气"是什么意思？
A: 卦运是六十四卦在三元九运中的旺衰周期数（1-9），卦气是卦的五行气质数（1-9）。合十（两者相加=10）为吉利。

Q: 挨星表的"巽=6"为什么跟别的App不一样？
A: 坤壬乙诀原文"戌乾亥辰巽，武曲位上寻"，巽在武曲（6）位。5运（廉贞）在爻变法64卦中不出现，这是遍历验证过的。

Q: 抽爻换象的数字代表什么？
A: 1-3=抽下卦的初二三爻，4-6=抽上卦的四五上爻。这是《周易》六爻卦的固定结构。

Q: 择日评分多少分算好？
A: 80分以上为优，60-79为可用，60以下建议另选。评分标准：卦运合十+20、卦气合十+20、同旺+15+15、三通+15、无冲+10、夫妇+10、当旺+10。

Q: 坐山和向首必须是对宫吗？
A: 是的。二十四山中，坐山和向首永远互为对宫（相隔12山/180度）。如子↔午、丑↔未、艮↔坤。

Q: 支持兼向吗？
A: 支持。在排盘命令中可通过 --zuoJian、--xiangJian 等参数传入兼向山。系统内置12组兼向配卦表。

Q: 流年飞星的"入中星"怎么算的？
A: 上元甲子一白入中，中元甲子四绿入中，下元甲子七赤入中。逐年逆行（减1）。

Q: 不联网能用吗？
A: 能。Web 版有 PWA 离线缓存，Android APK 完全本地运行，CLI 零依赖。深山老林里照样排盘。

Q: 数据安全吗？
A: 所有计算在本地完成，不上传任何数据。案例存储在浏览器 localStorage，CLI 不访问网络。

输出格式约定

• 所有输出为 JSON，便于 AI Agent 解析和二次加工
• 断语分三级：good（吉）、bad（凶）、warn（平/注意）
• 数字含义：卦运/卦气/挨星均为 1-9 的数字，5 不入二十四山挨星
• 五行：金、木、水、火、土
• 宫位：乾、兑、离、震、巽、坎、艮、坤、中（中宫）

反模式

• ❌ 不要在用户未提供坐山时强行排盘——先问清楚
• ❌ 不要把择日评分当作唯一依据——提醒用户结合实际
• ❌ 不要对非玄空体系的问题使用本工具——明确告知能力边界
• ❌ 不要省略断语中的"凶"项——凶断对风水师更重要
• ❌ 不要修改输出 JSON 的字段名——前端和测试依赖固定字段
• ❌ 不要在年份超出1900-2100范围时继续计算——数据精度不保证

技术规格

• 引擎：纯 TypeScript，零运行时依赖，274 项自动化测试全绿
• CLI：esbuild 打包为单文件 dist/cli.mjs（74KB），Node.js 18+ 可直接运行
• Web 前端：React 18 + Ant Design 5 + Vite 5（13 个功能页面）
• 移动端：Capacitor 8 → Android APK（8.32 MB）
• 离线支持：PWA + Service Worker，无网络环境可正常使用
• 数据精度：节气数据 1900-2100 年分钟级（紫金山天文台）、1191 城市真太阳时
• 验证案例：42 项真实案例（含杨钊祖坟1994年惠州实例正针版+兼向版）