中文版

Установите сердце неба и земли, Защищать средства к существованию людей, Продолжайте утерянные учения прошлых мудрецов. Откройте эру мира для всех поколений.

— Чжан Зай, Hengqu Four Maxims

Оригинальное название: Qi Men Dun Jia: Eight Gates Huaqi Array

Чистый двигатель Qi Men Dun Jia с нулевой внешней зависимостью.

Что такое Qi Men Dun Jia?

Qi Men Dun Jia является одним из «Трех стилей» (三).) классического китайского космологического прогнозирования, наряду с Тай И ().) и Лю Жэнь ( ) . Датируемый более двух тысяч лет назад, он отображает время и пространство на девятидворцовой сетке, полученной из магического квадрата Луошу, а затем накладывает несколько систем символов сверху: небесные стебли, звезды, ворота и божества. Каждый слой взаимодействует через пятифазный цикл генерации и преодоления, создавая богатую символическую картину энергетического ландшафта данного момента.

Система исторически использовалась для военной стратегии, выбора места и выбора времени. Сегодня он остается живой традицией в китайской метафизике, изучаемой как из-за его культурной глубины, так и из-за его внутренней структурной элегантности.

Выбор дизайна

中文版

Establish the heart of heaven and earth, Secure the livelihood of the people, Continue the lost teachings of past sages, Open an era of peace for all generations.

— Zhang Zai, Hengqu Four Maxims (横渠四句)

Qi Men Dun Jia — Eight Gates Huaqi Array

奇门遁甲 八门化气阵

A pure-Bash Qi Men Dun Jia plate-setting engine with zero external dependencies.

What Is Qi Men Dun Jia?

Qi Men Dun Jia (奇门遁甲) is one of the “Three Styles” (三式) of classical Chinese cosmological forecasting, alongside Tai Yi (太乙) and Liu Ren (六壬). Dating back over two thousand years, it maps time and space onto a nine-palace grid derived from the Luoshu (洛书) magic square, then layers multiple symbol systems on top: heavenly stems, stars, gates, and deities. Each layer interacts through the five-phase (五行, wuxing) cycle of generation and overcoming, producing a rich symbolic picture of a given moment’s energetic landscape.

The system was historically used for military strategy, site selection, and timing decisions. Today it remains a living tradition in Chinese metaphysics, studied for both its cultural depth and its internal structural elegance.

Design Choices

Zhi-Run intercalary method only. Two major schools exist for handling the boundary between solar terms: Zhi-Run (置闰法) and Chai-Bu (拆补法). This project implements Zhi-Run exclusively. In Zhi-Run, when the current time falls between the Jieqi (节气) boundary and the start of a new Yuan (元), the previous Ju number is carried forward (“intercalated”). Chai-Bu instead splits and patches across both Ju numbers. Zhi-Run produces a single clean Ju per moment, which simplifies the computation pipeline and aligns with the dominant mainland Chinese tradition.

Hourly Qi Men with rotating plate. This is Shi Jia Qi Men (时家奇门), the hourly variant, not the daily or monthly variants. The plate uses the rotating-plate (转盘) method, where stars and gates physically rotate around the nine palaces. The alternative flying-star (飞盘) method assigns symbols by flight path rather than rotation. Rotating plate preserves the spatial relationship between symbols and palaces, making it more intuitive for reading directional significance.

Tianqin palace assignment. The star Tianqin (天禽, Heavenly Bird) sits in the center palace (5-palace), which has no gate and therefore needs a hosting palace. Three modes are available via --tianqin=MODE:

• follow-tiannei (default): Tianqin follows wherever Tiannei (天内) goes. When the heaven plate rotates, Tiannei and Tianqin share the same palace. This preserves Tianqin’s yin-earth affinity with Tiannei’s yin-earth nature.
• jikun: Tianqin lodges permanently in the Kun 2-palace (寄坤二宫), regardless of plate rotation. This is the most traditional convention.
• follow-zhifu: Tianqin follows the Zhifu (值符) duty star to its rotated palace.