鸭先知阳宅指要

工具解决的排盘痛点

三合风水的理气计算并不复杂，但在实操中容错率极低。客户现场询问“这个向能不能立”时，手算需要交叉核对二十四山、十二长生阴阳逆顺、八曜煞与黄泉煞，稍有不慎就会记错口诀。市面上的 App 也存在算法不一致的问题，双山五行混淆、建除推算简化等情况屡见不鲜，难以作为可靠的交付依据。此外，当面对《阳宅指要》中复杂的兼针案例，或者需要快速验证外部“大师”给出的日课时，传统纸笔推算耗时过长，极易延误沟通时机。

核心命令与工作流

该技能将核心算法封装为零依赖的单文件 CLI（dist/cli.mjs），所有计算在本地 Node.js 18+ 环境运行，无需联网且无数据上传。针对理气分析的典型场景，它提供了四个结构化命令，输出统一为 JSON 格式，便于 Agent 直接解析：

• paipan：三合排盘。输入坐山与朝向，输出四大局归属、十二长生配九星、八曜煞与黄泉煞检测，并附带 0-100 分的综合评分与吉凶等级。
• zeri：修造择日。输入公历日期与坐山，快速推算四柱干支、建除十二神、黄道黑道，并自动检测日冲坐山、年/月/日三煞及岁破。
• liunian：流年飞星。输入年份，输出年紫白入中宫的九宫分布、五黄大煞方位、太岁三煞及二黑病符位。
• tiangua：天卦排盘。专门用于推算坐山天卦贵神位，判定贵神到向或到坐的情况。

适用边界与注意点

• 理气为主，非峦头替代：该 CLI 仅处理抽象的方位与日课推算，无法替代实地环境的勘察。
• 流派限制：算法严格遵循《阳宅指要》倪尚忠全本的三合体系，不支持玄空大卦或八宅等其他流派的推演。
• 节气数据更新：内置节气表目前基于 2026 年构建，跨年度的高精度排盘可能受限。
• 环境要求：运行前需确保服务器或本地环境已安装 Node.js 18 及以上版本。