taibu-divination

name	taibu-divination
description	太卜（TaiBu）占术排盘工具集：八字、紫微斗数、六爻、梅花易数、奇门遁甲、大六壬、小六壬、 太乙、塔罗、西方占星、黄历等 15 种本地计算引擎。凡涉及算命、排盘、起卦、占卜、运势、命理、 择日、宜忌、流年大运、星盘的请求（fortune-telling, divination, birth chart, BaZi, ZiWei, tarot, qimen, almanac），即使用户没有点名具体术数体系，也应使用本 skill——盘面必须由工具 计算，不可凭记忆推算干支、卦象、星曜。

太卜占术工具

太卜提供 15 个占术与命理排盘工具，涵盖八字、紫微斗数、六爻、梅花易数、奇门遁甲、大六壬、小六壬、太乙、塔罗、西方占星与黄历。计算引擎已随 skill 打包（scripts/vendor/taibu-core.bundle.mjs），本地直接运行，无需安装依赖，只要求环境中有 Node.js 18 或更高版本。

盘面一律由工具计算。干支、卦象、星曜的推算规则繁多，凭记忆手算既容易出错也无法复现；解读时以工具输出为唯一事实来源，不确定的细节回到输出中核对，而不是凭常识补写。

用法

TB 指本 skill 的根目录（加载 skill 时会告知）：

node "$TB/scripts/taibu.mjs" list           # 列出全部工具
node "$TB/scripts/taibu.mjs" schema bazi    # 查看参数说明与调用示例
echo '{"gender":"male","birthYear":1990,"birthMonth":5,"birthDay":20,"birthHour":8}' \
  | node "$TB/scripts/taibu.mjs" call bazi -

• 参数为 JSON。含中文内容时走 stdin（call <tool> -），避免 shell 转义问题。
• 默认输出规范文本，适合直接作为解读依据；加 --json 改为输出结构化数据（structuredContent）。
• 出错时返回中文提示（缺哪个参数、允许哪些取值），按提示修正后重试。退出码：0 成功，1 参数或业务错误，2 用法错误。

选择工具

工具名	名称	用途	参数文档	解读指引
astrology	西方占星命盘	根据出生信息计算本命盘与流运盘，输出基础坐标、命盘锚点、本命主星与流运触发	references/astrology.md	interpretation/astrology.md
bazi	八字命盘	根据出生信息计算四柱命盘，输出天干地支、十神、藏干、神煞、关系格局等信息	references/bazi.md	interpretation/bazi.md
bazi_pillars_resolve	四柱反推	根据年柱、月柱、日柱、时柱反推出生时间候选列表	references/bazi_pillars_resolve.md	interpretation/bazi.md
ziwei	紫微斗数命盘	根据出生信息计算紫微命盘，输出十二宫位、星曜分布、四化、大限等信息	references/ziwei.md	interpretation/ziwei.md
ziwei_horoscope	紫微斗数运限	根据出生信息与目标日期计算大限、小限、流年、流月、流日、流时等运限信息	references/ziwei_horoscope.md	interpretation/ziwei.md
ziwei_flying_star	紫微斗数飞星	分析命盘中的四化飞布、自化、落宫与三方四正关系	references/ziwei_flying_star.md	interpretation/ziwei.md
liuyao	六爻排卦	根据问题与起卦信息排出六爻盘面，输出卦象、爻位、用神体系、关系判断与时机提示	references/liuyao.md	interpretation/liuyao.md
meihua	梅花易数起卦	根据时间、字占、物数、报数等方式起卦，输出起卦信息、卦盘与体用推演	references/meihua.md	interpretation/meihua.md
tarot	塔罗抽牌	根据问题与牌阵抽取塔罗牌，输出牌面结果及占卜参考信息	references/tarot.md	interpretation/tarot.md
taiyi	太乙九星观测	根据问卜时间生成时空底盘、九星阵列与核心关系	references/taiyi.md	interpretation/taiyi.md
almanac	黄历查询	查询指定日期的黄历、宜忌、冲煞、值星、方位与时辰吉凶等信息	references/almanac.md	interpretation/almanac.md
bazi_dayun	八字大运	根据出生信息计算起运时间、大运列表、小运与流年链路	references/bazi_dayun.md	interpretation/bazi.md
qimen	奇门遁甲排盘	根据指定时间排出奇门盘，输出九宫、九星、八门、八神、格局等信息	references/qimen.md	interpretation/qimen.md
daliuren	大六壬排盘	根据日期时间起课，输出天地盘、四课、三传、神将、课体与时空信息	references/daliuren.md	interpretation/daliuren.md
xiaoliuren	小六壬占测	根据农历月日时辰起课，输出起课信息、推演链与结果信息	references/xiaoliuren.md	interpretation/xiaoliuren.md

调用前先 schema <tool>，或读 references/<tool>.md（参数表与可复制的示例）。

解读方法

排盘只是第一步。产出解读前，读工具表最后一列对应的 interpretation/<体系>.md——每份指引给出该体系的专家角色、流派技法与分析框架，按其组织解读内容。通用要求：

• 断语必须引用盘面证据（干支、星曜、爻位、格局名与工具输出逐字一致），不确定的回到输出核对。
• 正文以该体系术师的口吻写给问事人：先结论、后论证。工具调用与核验过程不写入正文，至多在文末一句带过——把篇幅留给卦理与判断，而不是操作记录。
• 关键事件给出时间范围、吉凶属性与影响程度；建议针对当前盘面，不写放之四海皆准的空话。
• 分析深度跟随用户要求伸缩：速断类（小六壬、单牌塔罗）短平快，命盘全局类（八字、紫微）分层展开，用户要求逐大限、逐流年时按指引调用运限工具补数据。

约定

• 历法：生辰类工具默认公历（calendarType: "solar"）；用户给的是农历生日时改传 "lunar"，闰月再加 isLeapMonth: true。xiaoliuren 例外，直接接收农历月、日。
• 时间：birthHour 传 0-23 的钟表小时，早晚子时由引擎处理，不要自行折算时辰。xiaoliuren 的 hour 可传时辰序号 1-12（子=1），也可传 0-23 小时。用户未提供的出生信息应当询问，而非代为假设。
• 占当下：qimen、daliuren、liuyao 与 meihua 的时间起卦需要当前时间时，先取系统时间（如 date +"%Y-%m-%dT%H:%M:%S"）再填入参数。
• 日期核实：用户说「今天/现在」并同时报出农历日期时，先取系统时间、用 almanac 核对公农历对应——农历与公历的映射是查历数据，不能凭记忆换算。口述与核实不符时，指出差异并以核实结果起盘，必要时附口述日期的对照结果。
• 随机性：tarot 可传 seed 复现抽牌；liuyao 的 method: "auto" 每次结果随机，需要复现时改用 select（指定卦名）或 number（数字起卦）。
• 六爻用神：yongShenTargets 必填，按占问主题选择，可多选：事业官职、官司、疾病忧患取 官鬼；财运、男问感情取 妻财；文书合同、长辈、房产车辆取 父母；子女晚辈、健康平安取 子孙；合作竞争、朋友取 兄弟。
• detailLevel：默认输出已够解读；需要完整盘面时在参数中加 "detailLevel": "full"（部分工具另有 "more"）。

其他接入方式

支持 MCP 的客户端可以不经本 skill，直接使用 npm 包 taibu-mcp（stdio）或公网端点 https://mcp.mingai.fun/mcp，工具集相同。