Об этом проекте

Zi Wei Dou Shu (紫微斗数) — это традиционная китайская система предсказательного гадания по звёздам. Данный проект представляет собой открытый движок для построения карт, основанный на учебной системе «Небесные принципы» (天纪) Ни Хайся. Он создан на Next.js 14 (App Router) и TypeScript, включает алгоритмы расклада, базу знаний, данные древних текстов и интерфейс, а также крупный набор примеров карт. Автор предоставляет онлайн-сайт metisziwei.com для непосредственного ознакомления. Основные алгоритмы находятся в каталоге lib/ziwei/: algorithm.ts реализует полный процесс построения карты, включая размещение Дворца Судьбы, определение пяти элементов, размещение 14 основных звёзд, вспомогательных звёзд, а также цикла больших и малых лет; sihua.ts — это система четырёх трансформаций (лу, цюань, кэ, цзи) с таблицами для каждого небесного ствола; patterns.ts — база знаний из более чем 1100 строк, охватывающая классические конфигурации, такие как «Цзы Фу в одном дворце», «Солнце и Луна в сиянии», «Ци Ша, взирающий на Цзы»; heming-knowledge.ts предоставляет методологию сравнения двойных карт; cities.ts содержит координаты китайских городов для коррекции истинного солнечного времени; также есть constants.ts (константы небесных стволов, земных ветвей и звёзд), types.ts (определения типов) и famous.ts (примеры карт исторических личностей). В основе лежат открытые библиотеки iztro и lunar-javascript. Что касается древних текстов, lib/classics/ включает оригинальные тексты «Костного мозга» (骨髓赋), «Полного собрания Zi Wei Dou Shu» (древняя рукопись династии Цин) и «Полной книги Zi Wei Dou Shu» (передача Чэнь Сии); lib/seo/ предоставляет структурированные знания по 14 основным звёздам × 12 дворцам, которые можно использовать для генерации контента или построения базы знаний. Интерфейс включает рабочую область для построения карт (сетка карты, детали дворцов, панель звёзд), страницу анализа совместимости, читалку древних текстов с полнотекстовым поиском, энциклопедию (страницы знаний о 14 звёздах и 12 дворцах), поддержку светлой/тёмной темы и адаптивность для мобильных устройств. Стилизация выполнена с помощью Tailwind CSS и CSS Variables, анимации — Framer Motion. Данные: в разделе Releases репозитория доступен набор примеров карт v3.0 — всего 518 400 записей (покрытие 60 лет × 12 месяцев × 30 дней × 12 часов × 2 полов), общий размер около 5,5 ГБ, разделён на 3 тома со сжатием и контрольными суммами SHA256. Каждый образец содержит полный JSON карты и текст интерпретации по 13 темам (обзор судьбы, богатство, карьера, отношения, здоровье и т.д.). В README указано, что данные можно использовать для дообучения малых моделей, как источник для RAG, для A/B-сравнения после изменения patterns.ts, а также для исследований и анализа. Важные ограничения: открытая часть не включает промпты для ИИ-интерпретации, серверные API-маршруты (например, /api/interpret, /api/heming, /api/generate), пользовательскую систему, серверную безопасность и конфигурацию развёртывания. Алгоритмы и интерфейс работают независимо; для ИИ-интерпретации необходимо реализовать соответствующие интерфейсы самостоятельно. README рекомендует обращаться к базам знаний patterns.ts и heming-knowledge.ts и строить промпты с любой LLM. Быстрый старт: клонируйте репозиторий, выполните npm install, скопируйте .env.example в .env.local и укажите ключ API для ИИ, затем запустите dev-сервер командой npm run dev. Лицензия: код (lib/, app/, components/) — MIT; набор данных можно свободно использовать (включая коммерческое), единственное требование — указание источника; древние тексты — общественное достояние.