鸭先知阳宅指要（三合）智能辅助系统
> 风水师的口袋罗盘 —— 不是玩具，是干活用的工具。
你是不是也遇到过这些情况？
客户催你，你还在纸上画卦
客户问"这个向能不能立？"你脑子里飞速运转——坐山什么局？长生在哪？帝旺在哪？来水去水合不合局？八曜犯不犯？黄泉犯不犯？一通算下来，纸上画满了表格和数字，客户等得不耐烦了。
手机上装了三四个App，排出来的盘每次都不一样
三合局归属对不上书上的口诀，十二长生配星搞混了阴阳逆顺，黄泉煞口诀张冠李戴。你不敢拿它给客户看，最后还是回到纸笔。
客户拿了一个"大师"择的日子来问你
你一看——日柱冲坐山、月柱犯三煞、建除是破日、黄道是黑道。但你要花二十分钟手算验证才能说清楚哪里不对。
想验证一本书上的案例，手算太复杂
《阳宅指要》48局实例，24山×正针兼针×左倒右倒，翻来翻去稍不注意就错了。
这些痛点，鸭先知一次性解决。
为什么选择鸭先知
一句话：市面上能找到的三合风水排盘工具里，没有一个比它更准
| 对比项 | 市面App | 鸭先知 |
|---|---|---|
| 三合四大局 | 双山五行混淆 | 24向取长生系统，与《阳宅指要》原文一致 |
| 十二长生 | 阴阳逆顺搞反 | 阳逆阴顺，逐山验证24山全通过 |
| 八曜煞 | 缺失或简略 | 完整八曜煞表，24山全覆盖 |
| 黄泉煞 | 口诀不全 | 救贫黄泉+杀人黄泉完整判定 |
| 建除十二神 | 简化版 | 月支起建，逐日推算 |
| 黄道黑道 | 不支持 | 完整十二神口诀，子午青龙起在申 |
| 三煞检测 | 不支持 | 年/月/日三煞+岁破全检测 |
| 九宫飞星 | 不支持 | 年紫白入中+九宫分布+五黄到方 |
| 天卦贵神 | 不支持 | 24山天卦贵神位推算 |
| 测试验证 | 无 | 521项自动化测试全绿 |
| 离线使用 | 需联网 | 深山老林里照样排盘 |
| AI可调用 | 无 | 零依赖单文件CLI，AI Agent直接调用 |
不是调了几个API就敢叫"专业"
市面上很多风水App，本质就是套了个壳——核心算法全是抄来的，三合局归属抄错了一个字，后面全盘皆错。鸭先知不一样：
- 每一行算法都有出处：《阳宅指要》倪尚忠原文怎么写的，代码就怎么实现的
- 每一个数字都可追溯：521项测试覆盖基础算法、案例验证、模块交叉审计
- 算法引擎与主项目同源：本CLI的算法直接提取自"鸭先知阳宅指要"主项目核心引擎（
src/core/），与 Web/Android 端完全一致
四大核心功能
1. 排盘命令 paipan —— 3秒排出三合48局综合盘
输入坐山+朝向，一键得到：
- 三合四大局归属（水火金木）
- 十二长生位推算 + 九星配属（贪狼/武曲/巨门等）
- 八曜煞检测
- 黄泉煞检测
- 正针/兼针判定
- 综合评分（0-100分）与吉凶等级
- 逐条吉凶原因
告别纸笔，告别算错，告别客户等待。
node dist/cli.mjs paipan --sitting 子 --combine 午
输出示例：
{
"sitting": "子", "direction": "午",
"ju": { "element": "水", "combination": "申子辰", "changsheng": "申", "diwang": "子" },
"stage": "帝旺", "star": "武曲", "isAuspicious": true,
"bayao": "不犯", "huangquan": "不犯",
"score": 90, "level": "大吉",
"summary": "坐子向午，水局，帝旺位武曲星，大吉（90分）"
}
2. 择日命令 zeri —— 智能日课评估，宜忌一目了然
输入公历日期+坐山，自动评估：
- 公历转干支四柱（年/月/日，以立春为年界、节气为月界）
- 建除十二神（建除满平定执破危成收开闭）
- 黄道黑道十二神（青龙明堂天刑朱雀...）
- 日冲坐山检测
- 年/月/日三煞检测
- 岁破检测
- 修造宜忌综合判定
客户拿来一个日子，你10秒就能说清楚好不好、为什么。
node dist/cli.mjs zeri --date 2026-08-01 --sitting 子
3. 流年飞星命令 liunian —— 一年运势，全盘呈现
输入公历年份，自动推算：
- 年干支推算
- 太岁、岁破方位
- 三煞方检测（劫煞/灾煞/岁煞）
- 九宫飞星分布（年紫白入中）
- 五黄大煞方位
- 二黑病符方位
- 坐山飞星吉凶
2026年五黄到哪？太岁三煞在什么方位？一查便知。
node dist/cli.mjs liunian --year 2026 --sitting 子
4. 天卦排盘命令 tiangua —— 天卦贵神方位
输入坐山，排出：
- 天卦贵神位推算
- 贵神到向/到坐判定
- 24山天卦映射
市面App基本不支持的天卦排盘，这里有完整实现。
node dist/cli.mjs tiangua --sitting 子
触发方式
当用户提出以下需求时，使用本技能：
- 「排盘」「三合排盘」「阳宅排盘」「坐山朝向」「这个向能不能立」→ 执行
paipan命令 - 「择日」「选日子」「修造择日」「这天能修造吗」「动土吉日」→ 执行
zeri命令 - 「流年飞星」「2026年飞星」「太岁三煞」「五黄到方」「岁破方」→ 执行
liunian命令 - 「天卦」「天卦贵神」「贵神方位」→ 执行
tiangua命令 - 「风水」「坐山」「来龙去水」「三合局」「长生」「八曜」「黄泉」→ 根据上下文判断执行哪个命令
不要在用户只问"什么是三合风水"等纯理论问题时调用命令——那是知识问答，直接用文字回答即可。
CLI 命令完整参考
前置条件
需要 Node.js 18+ 环境。本技能包含一个零依赖的可执行 CLI（dist/cli.mjs），无需安装任何 npm 包。
所有命令输出均为 JSON 格式，可直接解析后向用户展示。
1. 排盘命令 paipan
用途：根据坐山、朝向排出三合48局综合盘，包含四大局、十二长生、九星、八曜、黄泉、评分断语。
输入参数：
| 参数 | 必填 | 格式 | 说明 |
|---|---|---|---|
--sitting |
是 | 二十四山 | 坐山（如 子、丑、艮） |
--combine |
否 | 二十四山 | 朝向（默认取坐山对宫） |
二十四山列表：壬 子 癸 丑 艮 寅 甲 卯 乙 辰 巽 巳 丙 午 丁 未 坤 申 庚 酉 辛 戌 乾 亥
2. 择日命令 zeri
用途：评估某日是否适合修造动土，给出建除、黄道、冲煞、三煞综合判定。
输入参数：
| 参数 | 必填 | 格式 | 说明 |
|---|---|---|---|
--date |
是 | YYYY-MM-DD | 公历日期 |
--sitting |
是 | 二十四山 | 坐山 |
3. 流年飞星命令 liunian
用途：推算某年紫白九星入中、各宫飞星、太岁三煞五黄岁破到方。
输入参数：
| 参数 | 必填 | 格式 | 说明 |
|---|---|---|---|
--year |
是 | 1900-2100 数字 | 公历年份 |
--sitting |
否 | 二十四山 | 坐山（提供则检测坐山飞星吉凶） |
4. 天卦排盘命令 tiangua
用途：推算坐山天卦贵神方位，判断贵神到向/到坐。
输入参数：
| 参数 | 必填 | 格式 | 说明 |
|---|---|---|---|
--sitting |
是 | 二十四山 | 坐山 |
异常处理
所有错误以 JSON 格式返回，包含 error 字段和 hint 字段：
{
"error": "参数 --sitting=\"ABC\" 无效。必须是二十四山之一：壬、子、癸、丑、艮、寅、甲、卯、乙、辰、巽、巳、丙、午、丁、未、坤、申、庚、酉、辛、戌、乾、亥",
"hint": "使用 \"node dist/cli.mjs help\" 查看用法说明"
}
常见错误及处理：
| 错误场景 | 错误信息 | 处理方式 |
|---|---|---|
| 坐山填错 | 参数 --sitting="X" 无效。必须是二十四山之一：... |
列出正确山名让用户重选 |
| 日期格式错 | 日期 "X" 无效，请使用 YYYY-MM-DD 格式 |
给出正确格式示例 |
| 年份超范围 | 年份超范围。支持 1900-2100 年 |
提醒用户数据覆盖范围 |
| 缺少必填参数 | 参数 --sitting 不能为空 |
列出缺失参数 |
| 未知命令 | 未知命令"xxx"。支持：paipan, zeri, liunian, tiangua |
列出可用命令 |
输出格式约定
- 所有输出为 JSON，便于 AI Agent 解析和二次加工
- 吉凶等级：
大吉/吉/平/凶/大凶（五级） - 评分：0-100 分，80+大吉，60-79吉，40-59平，20-39凶，20以下大凶
- 九星：
贪狼、武曲、巨门（吉星）；破军、禄存、文曲、廉贞（凶星） - 五行：
金、木、水、火（三合四大局） - 宫位：
坎(北)、艮(东北)、震(东)、巽(东南)、离(南)、坤(西南)、兑(西)、乾(西北)、中宫
能力边界
能做什么
- 三合48局排盘：坐山+朝向 → 四大局+长生+九星+八曜+黄泉+评分断语
- 修造择日评估：公历日期+坐山 → 四柱+建除+黄道+冲煞+三煞+宜忌
- 流年飞星推演：年份 → 紫白九星+太岁三煞五黄岁破
- 天卦贵神排盘：坐山 → 天卦贵神位+到向到坐判定
- 正针/兼针自动判定
- 24山完整覆盖
不能做什么
- 不能替代专业风水师的现场判断：本工具输出的是算法计算结果和传统断语，最终决策需结合实地环境
- 不能预测命运：风水理气是环境学，不是算命术
- 不能处理非三合体系：本系统仅支持三合风水，不支持玄空大卦、八宅等其他流派
- 不支持室外峦头分析：本系统只做理气计算，不分析山水形态
- 节气数据基于2026年：跨年排盘精度受限于内置节气表
- 不能用于商业择日的最终决策：建议结合专业风水师意见综合判断
FAQ
Q: 三合四大局怎么定的？ A: 24向取长生系统（非标准双山五行）。水局长生申、火局长生寅、金局长长生巳、木局长长生亥。来源《阳宅指要》倪尚忠全本。
Q: 十二长生为什么阳逆阴顺？ A: 阳干顺行十二宫、阴干逆行十二宫，这是三合派标准规则。如壬为阳，从申长生顺数；癸为阴，从申长生逆数。
Q: 八曜煞是什么？ A: 坐山所忌讳的方位。如坐壬子癸，忌辰方；坐艮寅，忌卯方。来源于坎龙坤兔震山猴口诀。
Q: 黄泉煞怎么判断？ A: 庚丁坤上是黄泉，乙丙须防巽水先，甲癸向中休见艮，辛壬水路怕当乾。朝向逢黄泉方即为犯。
Q: 建除十二神怎么推算？ A: 以月支起建，逐日顺推。如寅月建寅，卯日为除，辰日为满，依此类推。除定执危成开为吉，建满平破收闭为凶。
Q: 不联网能用吗？ A: 能。CLI 零依赖，Node.js 18+ 直接运行。深山老林里照样排盘。
Q: 数据安全吗？ A: 所有计算在本地完成，不上传任何数据。CLI 不访问网络。
反模式
- ❌ 不要在用户未提供坐山时强行排盘——先问清楚
- ❌ 不要把择日评分当作唯一依据——提醒用户结合实际
- ❌ 不要对非三合体系的问题使用本工具——明确告知能力边界
- ❌ 不要省略断语中的"凶"项——凶断对风水师更重要
- ❌ 不要修改输出 JSON 的字段名——前端和测试依赖固定字段
理论依据
- 《阳宅指要》倪尚忠全本
- 杨公三合四大局（申子辰水、寅午戌火、巳酉丑金、亥卯未木）
- 24山双山五行
- 十二长生配九星七曜
- 建除十二神口诀
- 黄道黑道十二神口诀（子午青龙起在申）
- 九宫飞星洛书序
技术规格
- 引擎：纯 JavaScript，零运行时依赖，521项自动化测试全绿
- CLI：零依赖单文件
dist/cli.mjs，Node.js 18+ 可直接运行 - 算法来源：提取自"鸭先知阳宅指要（三合）智能辅助系统"主项目核心引擎（
src/core/） - Web 前端：React 18 + TypeScript + Vite 5 + Tailwind CSS
- 移动端：Capacitor 8 → Android APK
- 离线支持：完全本地运行，无网络依赖
- 安全：无网络数据上传，无用户追踪，代码完全开源
安全与隐私
- 无网络数据上传，所有计算在本地完成
- 无用户追踪，无 analytics，无埋点
- CLI 单文件运行，不访问网络、不读写磁盘敏感位置
- 代码完全开源，可审查每一行算法实现
License
MIT
