究天人之际，通古今之变

BaZi / Ziwei / Liuyao / Meihua / Qimen / Liuren / Taiyi / Fengshui / WuYun-LiuQi / Constitution / Daoism / Buddhism — 全融合 AI Agent 咨询工作流
本地排盘 · 不上传生辰 · 全功能免费 · 三层路由 · 25 引擎推算（16 排盘 + 9 联合分析）· 知识库引用 · React+SVG 可视化 Dashboard

关于 · 快速开始 · AI 引导 · 使用说明 · 架构设计 · 贡献 · 许可证

🌐 English

如果你是 AI Agent，直接跳转到 README_AI.md，严格按照内容要求执行。

当 AI Agent（Claude Code、Codex CLI、Cursor 等）遇到用户的人生困惑、健康调养、事业决策、婚姻合婚、择吉选址等问题时，本工作流系统提供从输入检查 → 三层路由 → 排盘推算 → 知识库检索 → 综合分析 → 可视化报告 → 经验沉淀的全链路能力。

用户问题 → 三层路由(问题→学科→融合深度) → 六引擎推算 → 知识库引用 → 可视化报告 → 经验沉淀

为什么需要这个项目：

市面上多数命理平台需付费解锁完整解读，且生辰等敏感信息要上传服务器、安全性未知。本项目正是为解决这个问题而设计：所有排盘在浏览器本地完成，不上传完整生辰，核心能力全部免费开放。

• 本地优先 · 不上传生辰：所有引擎纯 TS 本地计算（lunar-javascript/iztro/3meta 内置），生辰只收集年/月/日/时拆分字段，不存完整日期、不传服务器，比要你上传的平台隐私风险更低
• 零付费 · 全功能开放：无解锁、无会员、无付费墙，25 个引擎与可视化全部免费；MCP server 也是本地 stdio，不依赖任何付费远端
• 多学科统一入口：八字、紫微、六爻、梅花、风水、五运六气、体质等散落不同工具，此处统一聚合，AI Agent 可直接调用
• 古籍可检索：内置 16+ 部风水经典全文，同一问题不必每次重新查证
• 零安装即刻体验：纯前端可视化，打开即用

(返回顶部)

React + Vite + TypeScript · SVG 可视化 · Tailwind CSS · lunar-javascript · iztro · 3meta · MCP SDK

(返回顶部)

向 AI 提出你关心的任何问题即可。AI 会自动：

1. 基于三层路由匹配最佳工具组合
2. 排盘推算 → 调用知识库 → 综合分析 → 生成结构化咨询报告
3. 询问是否生成可视化 HTML 报告

无需安装任何依赖，启动 React Dashboard：

cd apps/visual && pnpm dev      # React + SVG Dashboard（vite dev server）
# 或构建产物：
cd apps/visual && pnpm build && pnpm preview

工作区按功能分组：术数排盘（八字/紫微/六爻/梅花/奇门/大六壬/二十八星宿/太乙/联合分析）、堪舆风水（罗盘/流年飞星/八宅）、医道运气（五运六气/体质）、日用工具（黄历/姓名/解梦/节律）、知识检索（图谱/古籍）、开发者（历史/测试）。

把 25 个计算引擎（八字/紫微/六爻/奇门/大六壬/二十八星宿/太乙/皇极经世/梅花/五运六气/姓名/喜用神/体质/周公解梦/测字/称骨 + 9 个跨系统联合分析）挂载到 Claude Code、Claude Desktop、Cursor、Cline 等 MCP 客户端，AI 可直接调用排盘工具。

一键自动配置（无需手动编辑配置文件）：

node scripts/setup-mcp.mjs

脚本自动检测已安装的客户端并写入对应配置（幂等不覆盖）。配置后重启客户端，chinese-wisdom server 即连接，对话中说「排个八字」「解梦」等 AI 自动调用工具。

如需手动配置或脚本未覆盖的客户端，参考 apps/mcp-server/examples/ 与 apps/mcp-server/README.md：

{
  "mcpServers": {
    "chinese-wisdom": {
      "command": "npx",
      "args": ["tsx", "/绝对路径/apps/mcp-server/src/index.ts"]
    }
  }
}

MCP server 是三层架构 Layer 2 的薄壳，复用 apps/visual/src/legacy 的纯 TS 引擎，统一返回 ToolEnvelope 结构化结果，共 27 个工具（25 计算 + agent_guidance 防参数瞎猜 + wisdom_dispatch 自然语言意图路由）。与 Dashboard 共享同一份计算逻辑，互不依赖。

(返回顶部)

Dashboard 会在每个标签页显示能力状态，避免把演示数据误认为精确排盘：

能力状态由 apps/visual/src/lib/modules.ts 的 MODULES 注册表统一管理（getModuleById 查询）；报告导出由 ExportReportButton 生成脱敏 JSON 快照，含 version、generatedAt、sourceNotes 与 birth.year（不导出完整出生日期）。

.
├── README.md                   # 本文件
├── SKILL.md                    # 总控入口 + 三层路由契约
├── RULES.md                    # 行为规则
├── EVOLUTION.md                # 演进记录
├── tool-index.md               # 工具索引
├── LICENSE                     # MIT 许可证
│
├── bootstrap/                  # 引擎接入引导
├── templates/                  # 咨询报告模板
├── knowledge-base/fengshui/    # 古籍知识库（30 文件 / 16+ 部经典）
│   └── mappings/               # 6 个 JSON 确定性映射表
├── reference-*.md              # 玄学 / 佛教 / 道家 / 中医参考
│
├── apps/                       # 主架构（React Shell + MCP Server）
│   ├── visual/                 # React + Vite + TS Dashboard（SVG 可视化，主开发入口）
│   │   └── src/legacy/         # 纯 TS 引擎 + 21 个 ToolEnvelope 适配器
│   └── mcp-server/             # MCP Server（三层架构 Layer 2，27 工具薄壳）
│       ├── src/index.ts        # McpServer + StdioServerTransport 入口
│       ├── src/tools.ts        # 25 个计算工具定义（zod schema）
│       ├── examples/           # Claude Desktop / Cursor / Cline 配置示例
│       └── README.md           # 安装与挂载指南
│
├── visual/                     # 可视化系统（纯前端，旧入口，留 fallback）
│   ├── index.html              # 旧 Dashboard（Canvas）
│   ├── test-runner.html        # 旧测试运行器
│   ├── js/engines/             # 纯 JS 排盘引擎（旧，留 fallback）
│   ├── vendor/                 # 内置第三方浏览器库（lunar-javascript/iztro/3meta）
│   └── js/tests/               # 自动化测试与 schema 校验
│
└── field-journal/              # 经验沉淀

(返回顶部)

用户输入 → 三层路由
  ↓
bootstrap/ → 加载对应引擎引导
  ↓
推算引擎执行（纯JS / npm / PyPI / API）
  ↓
JSON 映射表 / 古籍知识库 → 确定性查询 + 全文引用
  ↓
templates/ → 选择报告模板
  ↓
询问可视化模式 → A: 静态HTML报告 / B: Web Dashboard
  ↓
field-journal/ → 经验沉淀

• 6 确定性 JSON 映射表：命卦速查、八宅大游年、二十四山（360° 连续）、流年飞星、阳宅三要、形煞化解
• 30 古籍文件：16+ 部风水经典全文，覆盖形势/理气/阳宅/综合四大类
• 23 纯 TS 排盘引擎：八字/紫微/六爻/奇门/大六壬/二十八星宿/太乙/皇极经世/梅花/五运六气/姓名/喜用神/体质/解梦 + 9 联合分析，零 DOM 依赖，统一 ToolEnvelope 输出，MCP 与 Dashboard 共享

(返回顶部)

欢迎任何贡献！Fork 本仓库 → 创建特性分支 → 提交 PR 即可。

1. Fork 项目
2. git checkout -b feature/AmazingFeature
3. git commit -m 'Add some AmazingFeature'
4. git push origin feature/AmazingFeature
5. 提交 Pull Request

(返回顶部)

本项目采用 MIT License（详见 LICENSE）。

• 架构参考 reverse-skill（zhaoxuya520）
• 历法与排盘引擎（已接入运行依赖，均 MIT）：lunar-javascript（节气干支）、iztro（紫微斗数）、3meta（奇门遁甲）
• 姓名数据 fate（MIT，康熙笔画/字义/数理/三才/生肖）
• 六爻纳甲：自研京房八宫纳甲引擎，规则参考 ichingshifa（MIT）与《京房易传》
• 大六壬 / 太乙 / 二十八星宿：纯 TS 自研，算法参考 kinliuren（MIT）、kintaiyi（MIT）等开源实现
• 梅花易数：自研时间/数字/揲蓍法起卦（meihua-yishu 因 CC BY-NC-SA 未接入运行代码）
• 五运六气 wuyun-liuqi-skills（MIT，字段契约参考）

(返回顶部)

English Version — README.md is bilingual. Chinese content is above. Below is a summary.

A holistic life consulting AI Agent workflow integrating BaZi, Ziwei, Liuyao, Meihua, Qimen, Liuren, Taiyi, Fengshui, WuYun-LiuQi, TCM Constitution, Daoist philosophy, and Buddhist psychology.

Why this project exists: Most metaphysics platforms require paid unlocks for full readings and ask you to upload birth data to their servers with unclear security. This project solves that — all charts are computed locally in the browser, no full birth datetime is uploaded, and every core capability is free.

Features:

• React + Vite + TypeScript dashboard with SVG visualization, capability badges and offline Mermaid fallback
• 22 pure-TS calculation engines (14 divination + 8 cross-system combo) with unified ToolEnvelope output, shared by MCP server and Dashboard
• MCP server (23 tools) for Claude Code / Desktop / Cursor / Cline direct invocation
• 30-file classic text knowledge base (16+ Fengshui classics)
• 6 deterministic JSON mapping tables
• Automated tests (unit + e2e + contract)

Quick Start: cd apps/visual && pnpm dev for the React dashboard, node scripts/setup-mcp.mjs for MCP, or let the AI handle everything.

Tech Stack: React, Vite, TypeScript, SVG, Tailwind CSS, lunar-javascript, iztro, 3meta, MCP SDK

License: MIT

AI Community: linux.do