<div align="center">

<img src="public/favicon.svg" alt="太卜" width="80" height="80">

太卜

将传统命理文化与AI深度融合

Language: 中文 | English

在线体验 · 报告问题

</div>

---

产品亮点

• 多命理体系 - 八字、六爻、紫微斗数、奇门遁甲、大六壬、梅花易数、塔罗、MBTI、面相、手相、合盘、周公解梦
• AI智能分析 - 支持导出命理体系文本进行AI分析，多模型支持，深度推理，视觉识别
• MCP Server - 支持 Model Context Protocol（MCP），可在支持MCP的客户端中直接调用命理工具
• 历史记录、知识库与@提及 - 支持存储所有命理体系的记录，可将命理体系纳入个人知识库，显式引用命理体系数据源
• AI个性化 - 表达风格/用户画像/自定义指令 + 上下文、提示词预算可视化
• 多端体验 - Web + iOS/Android 客户端
• 社区与激励 - 命理记录、匿名讨论、签到激励

---

命理功能预览

功能模块	核心特性
八字排盘	· 真太阳时、阳历农历排盘、即时排盘、四柱排盘<br/>· 五行天干地支、十神、藏干、星运、纳音、神煞（51种）、十二长生、刑害合冲<br/>· 天干五合、地支半合、地支三会<br/>· 大运、流年、流月、流日<br/>· 传统分析、盲派分析
紫微斗数	· 十二宫位、三方四正<br/>· 主星、辅星、杂曜、四化（含自化）<br/>· 命主星/身主星、小限、博士十二星<br/>· 旺衰落陷、大限/流年/流月/流日/流时运限分析<br/>· 飞星分析（飞化落宫、三方四正）
奇门遁甲	· 九宫、天地盘、八门、九星、八神<br/>· 值符值使、遁甲类型、局数<br/>· 格局判定（吉/凶）、空亡、驿马、入墓、旺衰<br/>· 转盘排盘，拆补/茅山局法<br/>· 显式时区支持
大六壬	· 天地盘、四课、三传<br/>· 天将（十二神将）、遁干<br/>· 49种神煞、课体分类<br/>· 十二长生、五行旺衰、建除十二神<br/>· 显式时区，支持本命/行年
六爻占卜	· 硬币起卦、快速起卦、选卦起卦、时间起卦、数字起卦<br/>· 爻变明动、暗动<br/>· 卦辞、爻辞、象辞<br/>· 用神、原神、伏神、仇神<br/>· 空亡 · 世应、旺衰状态、刑冲合害<br/>· 互卦、错卦、综卦<br/>· 应期推测
梅花易数	· 年月日時起卦、物数/声数、字占、丈尺尺寸、方位类象<br/>· 两数/三数报数扩展法<br/>· 本卦、互卦、变卦、错卦、综卦、动爻<br/>· 体卦/用卦、体用生克、月令旺衰、克应层次<br/>· 应期线索、定性吉凶判断
塔罗占卜	· 9种牌阵：单牌、三牌阵、爱情牌阵、凯尔特十字、马蹄、抉择、身心灵、情境、是/否<br/>· 逆位判定、78张完整牌面解读、精美卡牌<br/>· 星座/元素对应、数字命理（人格牌/灵魂牌/年份牌）<br/>· 每日运势指引
关系合盘	· 情侣、商业、亲子<br/>· 未来运势走线<br/>· 沟通建议
面相、手相	· 天庭、鼻相、眼相、口相<br/>· 生命线、智慧线、事业线、感情线
运势中心	· 基于命盘的每日、每月运势分析<br/>· 每日黄历（含方位系统、12时辰吉凶、二十八星宿）<br/>· 未来运势走线
MBTI性格测试	· 90+道性格测试题<br/>· 综合AI分析性格
高度AI集成	· 根据过往占卜综合分析<br/>· 命理体系全分析<br/>· 知识库、附件、搜索<br/>· 支持AI对话时提及所有命理体系<br/>· 年度命理报告

---

MCP

太卜提供 MCP，可在支持 MCP 的客户端中直接调用命理工具。

快速配置

配置中添加以下内容即可使用

{
  "mcpServers": {
    "taibu": {
      "command": "npx",
      "args": ["-y", "taibu-mcp"]
    }
  }
}

支持的工具

工具	功能	提问例子
bazi	八字排盘（支持阳历/农历，51种神煞，天干五合，地支半合/三会，胎元/命宫）	"我是1990年5月15日15点生，请帮我排盘"
bazi_pillars_resolve	八字反查（四柱 → 出生时间候选，1900-2100）	"我的八字是丙午庚寅丙辰癸巳，请帮我分析"
bazi_dayun	八字大运计算（十年大运周期，流年详情，太岁标注，小运）	AI会自动分析你的八字调用计算
ziwei	紫微斗数排盘（含命主星/身主星，小限，博士12星，三方四正）	"我是农历1990年4月初八生，请排紫微盘"
ziwei_horoscope	紫微运限（大限/小限/流年/流月/流日/流时，流年星曜）	"帮我看看2026年的紫微运限"
ziwei_flying_star	紫微飞星分析（飞化/自化/四化落宫/三方四正）	"分析一下我命宫的飞星"
liuyao	六爻占卜（支持起卦/自主选卦/时间起卦/数字起卦，含互卦/错卦/综卦）	"我想占卜今年的事业运，请帮我起卦分析"
meihua	梅花易数（支持年月日時、物数/声数、字占、丈尺尺寸、方位类象、两数/三数报数）	"现在起一卦，用梅花易数看这次合作能不能成"
tarot	塔罗抽牌（9种牌阵，78张完整牌面，独立逆位关键词，星座/元素对应）	"请为我抽一张塔罗牌，关于近期的爱情运势"
almanac	黄历查询（含方位系统，12时辰吉凶，二十八星宿）	"今天的黄历怎么样？适合求婚吗？"
astrology	西方占星命盘与流运（命盘三巨头、本命主星、重大流运触发）	"帮我看一下这段时间的占星流运重点"
qimen	奇门遁甲排盘（九宫、八门、九星、八神、值符值使、显式时区）	"用奇门看一下今天谈合作是否顺利"
taiyi	太乙九星观测（外部时空环境、九星阵列、能量交互）	"用太乙九星看一下这个项目推进情况"
daliuren	大六壬排盘（四课三传、天地盘、神将、显式时区）	"用大六壬看一下这件事的结果"
xiaoliuren	小六壬占测（起课结果、宫位落点、核心断事线索）	"用小六壬看一下今天出行顺不顺"

SDK

如果你想在自己的 Node.js 项目中直接调用计算引擎（无需 MCP 协议），可以使用核心库：

npm install taibu-core

详见 taibu-core npm 页面

---

快速开始

Docker 部署

支持三种方式：

# 准备环境变量（首次）
cp .env.example .env

# 1) 一键部署：同时启动 Web + MCP
docker compose up -d --build

# 2) 仅部署 Web
docker compose -f docker-compose.web.yml up -d --build

# 3) 仅部署 MCP Server
docker compose -f docker-compose.mcp.yml up -d --build

默认端口：

• Web: 3000 （http://localhost:3000）
• MCP: 3001

开发环境部署

环境要求：

• Node.js 18+
• pnpm (推荐) / npm / yarn

# 克隆项目
git clone git@github.com:hhszzzz/taibu.git
cd taibu

# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入必要的 API Keys

# 启动开发服务器
pnpm dev

访问 http://localhost:3000 查看应用。

---

贡献

欢迎提交 Issue 和 Pull Request！

---

许可证

本仓库采用混合许可证：

• packages/core
• packages/mcp
• packages/mcp-server

以上三个包采用 MIT 许可证，详见各自目录下的 LICENSE 文件。

除上述三个包外，仓库其余 Web、服务端、部署与运行时代码采用 AGPL-3.0-only，详见仓库根目录 LICENSE。

提示：

• AGPL-3.0-only 不禁止商用，但要求修改后的网络服务在对外提供时履行相应源码开放义务
• MIT 包允许商用、再分发与二次开发，但需保留版权与许可声明

---

<div align="center">

太卜 - 用AI解读命运，用科技传承文化

Made with ❤️ by hhszzzz

</div>