鲲侯 · 星河易道 奇门排盘引擎
BigFishMarquis Qimen Dun Jia Engine
基于 TypeScript 的全自研奇门遁甲排盘引擎，覆盖年/月/日/时家四层排盘，支持拆补、茅山、置闰三种起局法。
零外部引擎依赖，经过 500+ 样本跨 300 年验证。
🎯 在线演示: xuebz.com/?chart=qimen
English
A fully self-developed Qimen Dun Jia (奇门遁甲) charting engine written in TypeScript. Qimen Dun Jia is one of the three supreme ancient Chinese divination arts (三式), used for strategic decision-making, timing analysis, and forecasting.
Key highlights:
- 4 charting layers: Yearly / Monthly / Daily / Hourly Qimen
- 3 chart methods: ChaiBu (拆补法), MaoShan (茅山法), ZhiRun (置闰法)
- Complete elements: Nine Stars, Eight Doors, Eight Gods, Hidden Stems, Tomb/Punishment/Pressure marks
- 81 pattern interpretation: Automatic pattern detection with classical analysis text
- Zero dependencies: Pure TypeScript, no external engine required
- Battle-tested: 500+ samples validated across 300 years, zero known bugs
✨ 特性 | Features
四层排盘引擎 | Four-Layer Charting Engine
- 时家奇门 (Hourly Qimen) — 拆补法 / 茅山法 / 置闰法
- 日家奇门 (Daily Qimen) — 基于公历日期自动排盘
- 月家奇门 (Monthly Qimen) — 按节气月定局
- 年家奇门 (Yearly Qimen) — 按太岁年定局
完整排盘要素 | Complete Chart Elements
- 🏛️ 九宫布局 (Nine Palaces — Earth Plate / Heaven Plate)
- ⭐ 九星排布 (Nine Stars: TianPeng → TianYing)
- 🚪 八门排布 (Eight Doors: Xiu → Kai)
- 🛡️ 八神排布 (Eight Gods: ZhiFu → JiuTian)
- 👻 地八神 (Earth Eight Gods — second layer divine generals)
- 🔮 暗干支 (Hidden Stems — Sexagenary Cycle palace-flying method)
- 📍 寄宫系统 (Palace Lodging — TianQin lodges in TianRui)
- ⚰️ 墓/刑/迫标记 (Tomb / Punishment / Pressure marks)
- 🐴 驿马宫位 (Post-Horse palace)
- 🈳 空亡检测 (Void detection)
格局解读 | Pattern Interpretation
- 81 格局自动识别与断语 (81 patterns auto-detection with classical text)
- 十干克应 (Ten Stems Correspondences)
- 用神体系 (Deity System)
- 值符克应 (Duty Star Correspondences)
- 九星/八门/八神详解 (Detailed Star/Door/God analysis)
- 运筹决策 (Strategic Decision-Making)
🚀 快速开始 | Quick Start
# Clone the repository
git clone https://github.com/perfhelf/bigfishmarquis-qimen.git
import { chaiBuJuByGanZhi } from './src/engines/chaibuquju';
import { shiJiaGenerate } from './src/engines/shijia';
import { maoShanJu } from './src/engines/maoshan';
// Step 1: Determine the chart number (局数)
const result = chaiBuJuByGanZhi('秋分', '己', '卯', 14);
// → { isYangDun: false, juNumber: 7, yuan: '上' }
// Step 2: Generate the full chart
const chart = shiJiaGenerate(
'甲', // Hour Stem (时干)
'子', // Hour Branch (时支)
7, // Chart Number (局数)
'yin', // Yin Dun (阴遁)
fourPillars, // Four Pillars (四柱)
'秋分', // Solar Term (节气)
);
// Alternative: MaoShan method
const maoshan = maoShanJu('冬至', 25);
// → { isYangDun: true, juNumber: 7, yuan: '中' }
📦 目录结构 | Project Structure
bigfishmarquis-qimen/
├── src/
│ ├── engines/
│ │ ├── chaibuquju.ts # ChaiBu method (拆补取局法)
│ │ ├── maoshan.ts # MaoShan method (茅山取局法)
│ │ ├── zhirun.ts # ZhiRun method (置闰取局法)
│ │ ├── shijia.ts # Hourly Qimen engine (时家奇门排盘)
│ │ ├── shared.ts # Shared logic for Year/Month/Day (共享逻辑)
│ │ ├── nianjia.ts # Yearly Qimen engine (年家奇门)
│ │ ├── yuejia.ts # Monthly Qimen engine (月家奇门)
│ │ └── rijia.ts # Daily Qimen engine (日家奇门)
│ ├── data/ # JSON data (八门/八神/九星/宫位/格局断语)
│ │ ├── ba_men.json # Eight Doors data
│ │ ├── ba_shen.json # Eight Gods data
│ │ ├── jiu_xing.json # Nine Stars data
│ │ ├── gong_wei.json # Nine Palaces data
│ │ ├── ge_ju_duan_yu.json # 81 Patterns interpretation
│ │ ├── shi_gan_ke_ying.json # Ten Stems correspondences
│ │ ├── zhi_fu_ke_ying.json # Duty Star correspondences
│ │ ├── yong_shen.json # Deity system data
│ │ ├── yun_chou.json # Strategic decision data
│ │ └── shi_er_shen_jiang.json # Twelve Divine Generals
│ ├── engine.ts # Unified dispatcher (统一调度入口)
│ ├── types.ts # TypeScript type definitions
│ ├── constants.ts # Qimen constants (奇门常量)
│ └── interpretation.ts # Pattern interpretation system (格局解读)
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── CHANGELOG.md
├── LICENSE # MIT
├── package.json
└── README.md
🏗️ 技术架构 | Architecture
┌─────────────────────────────────────────┐
│ Unified Dispatcher (engine.ts) │
├──────┬──────┬──────┬────────────────────┤
│Yearly│Month │Daily │ Hourly │
│ │ │ │ ┌──────┬─────┬───┐ │
│ │ │ │ │ChaiBu│MaoSh│ZhiR│ │
│ │ │ │ └──────┴─────┴───┘ │
├──────┴──────┴──────┴────────────────────┤
│ Pattern Interpretation System │
│ (81 patterns + Ten Stems + Deities) │
├─────────────────────────────────────────┤
│ Data Layer (data/*.json) │
│ Stars · Doors · Gods · Palaces │
└─────────────────────────────────────────┘
🆚 与同类开源项目对比 | Comparison
| Feature |
bigfishmarquis-qimen |
3META |
| Hourly chart methods |
3 (ChaiBu+MaoShan+ZhiRun) |
1 |
| Chart layers |
4 (Year/Month/Day/Hour) |
Hour only |
| Known bugs |
0 |
TianQin-BaMen misalignment |
| Hidden Stems |
✅ |
❌ |
| Earth Eight Gods |
✅ |
❌ |
| Tomb/Punishment/Pressure |
✅ |
❌ |
| Palace Lodging System |
✅ |
❌ |
| 81 Pattern Interpretation |
✅ Full |
Basic |
| Validation coverage |
500 samples × 300 years |
Unknown |
| External dependencies |
Zero |
— |
📋 依赖 | Dependencies
- Runtime: Zero external dependencies (Pure TypeScript)
- Optional:
lunar-javascript or lunar-typescript for Solar Term and GanZhi data
🤝 贡献 | Contributing
We welcome contributions! Please read CONTRIBUTING.md before submitting a Pull Request.
See CODE_OF_CONDUCT.md for community guidelines.
📄 License
MIT © 2026 BigFishMarquis (鲲侯)
🔗 链接 | Links
Built with ❤️ by BigFishMarquis (鲲侯)
评论