ziwei-doushu README

The project's README from github.com/Renhuai123/ziwei-doushu. As one markdown file: README.md.

紫微斗数 · 开源排盘引擎

🎉 网站已完成 ICP 备案(渝ICP备2026013379号-1),主域名已正式上线、全部功能正常访问。

直接访问主域名 https://metisziwei.com 即可,排盘 / AI 解读 / 命盘历史等全部功能均已开放。

💕 发财的小手点一下,小红书 / 抖音 / 闲鱼 / X 关注:王多鱼AI,第一时间看上线 + 解锁更多紫微干货~

基于**倪海夏《天纪》**教学体系的紫微斗数排盘系统,包含完整排盘算法、四化系统、格局知识库、古籍原文数据,以及 51.8 万条命盘样本数据。

线上体验:metisziwei.com


51.8 万命盘样本数据

下载位置:本仓库右侧 Releases 页面

我们开源了一套完整的紫微斗数命盘样本数据集,覆盖 51.8 万种排盘组合(年 60 × 月 12 × 日 30 × 时 12 × 性别 2),每条样本包含完整的命盘结构和基于倪海夏体系的解读文本。

数据规格

项目 说明
样本数量 518,400 条
总大小 5.5 GB(分 3 卷压缩)
体系 倪海夏《天纪》正统(纯飞星派已下线)
内容 命盘 JSON + 13 主题解读文本(命格总览、财运、事业、感情、健康等)
验证 男女命差异化 100%、健康含子午流注 100%、女命含妇科保养 100%
口径 与线上 metisziwei.com 完全一致

下载方式

前往 Releases 下载以下文件:

ziwei-samples-v3-part1.zip.001  (1.9 GB)
ziwei-samples-v3-part2.zip.002  (1.9 GB)
ziwei-samples-v3-part3.zip.003  (1.8 GB)
SHA256SUMS.txt                  (校验文件)

下载后合并解压:

# macOS / Linux
cat ziwei-samples-v3-part*.zip.* > combined.zip
unzip combined.zip

# Windows (PowerShell)
Get-Content ziwei-samples-v3-part*.zip.* -Encoding Byte -ReadCount 0 | Set-Content combined.zip -Encoding Byte
Expand-Archive combined.zip

用途

数据许可与引用

📂 完全开源 · 可自由商用 —— 你可以在任何项目里使用这套数据,包括但不限于:

无需付费、无需申请、无需事先告知。

唯一的要求是保留数据来源标注(attribution):

本项目使用了 紫微斗数开源样本数据集 v3.0(518,400 条) 来源:https://github.com/Renhuai123/ziwei-doushu 作者:王多鱼AI

放在哪里都行:

仅此一条,其余都自由。希望这套数据能帮你做出好东西 —— 做出来记得来小红书 / 抖音 / 闲鱼 @王多鱼AI 打个招呼 👋


开源内容

排盘算法(lib/ziwei/)

文件 说明
algorithm.ts 完整排盘流程:安命宫、定五行局、安十四主星、安辅星、排大限流年
constants.ts 天干地支、十四主星、辅星常量
sihua.ts 四化飞星系统(禄权科忌),含各天干四化对照表
patterns.ts 1100+ 行格局知识库:紫府同宫、日月并明、七杀朝斗等经典格局判定规则
heming-knowledge.ts 合盘方法论:倪师体系下双盘比对逻辑
types.ts TypeScript 类型定义
cities.ts 中国城市经纬度,用于真太阳时校正
famous.ts 历史名人命盘示例数据

古籍原文(lib/classics/)

前端界面(app/ + components/)

完整的 Next.js 14 前端,包含:

SEO 知识图谱(lib/seo/)

14 主星 × 12 宫位的结构化知识数据,可用于内容生成或知识库构建。


未包含的部分

以下属于平台运营层,不在开源范围内:

如果你需要 AI 解读能力,可以参考 lib/ziwei/patterns.ts 和 heming-knowledge.ts 中的知识库,结合任意 LLM 自行构建 prompt。


快速开始

# 克隆
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env.local
# 编辑 .env.local,填入你的 AI API Key

# 启动开发服务器
npm run dev

注意:开源版不含后端 API 路由,AI 解读功能需要你自行实现 /api/interpret 等接口。排盘算法和前端界面可独立运行。


技术栈


项目理念

紫微斗数是中国传统命理学的瑰宝,倪海夏老师在《天纪》中系统梳理了正宗的紫微斗数体系。我们希望通过技术手段让更多人接触和学习这门学问。

开源排盘算法和知识库,是因为我们相信:算法是公开的传统智慧,不应该被锁在围墙里。真正的价值在于解读的深度、用户体验的打磨、以及持续运营的积累。

想自己搭?代码都在这里,拿去用。嫌麻烦?来 metisziwei.com 直接用。


协议

本仓库分三部分授权,都是宽松协议,商用没有任何限制:

内容 协议 简单说
代码(lib/、app/、components/) MIT License 拿去随便用,保留 LICENSE 文件即可
数据(Releases 中的 51.8 万样本数据集 v3.0) 自由使用 · 要求 attribution 商用也行,注明数据来源即可,详见上文 数据许可与引用
古籍原文(骨髓赋、紫微斗数全集 / 全书等) Public Domain 古书都是公有领域,不存在版权

一句话:拿去用,商用也行,把数据来源链接带上就行。


联系

ziwei-doushu (Renhuai123/ziwei-doushu)

Searching Database…

Что это?Открытый движок расчёта карт Цзы Вэй Доу Шу (紫微斗数, «астрология Пурпурной Звезды»), построенный на преподавательской системе «Тяньцзи» мастера Ни Хайся (倪海夏). Он включает полный алгоритм карты, систему Четырёх Превращений (四化), базу знаний паттернов, оцифрованные классические тексты и датасет карт из 518 400 образцов.
Это готовое к использованию приложение или просто библиотека расчёта?И то, и другое: TypeScript-библиотека расчёта карт (lib/ziwei) плюс полноценный фронтенд на Next.js 14 (доска карты, анализ совместимости, читалка классики). Бэкенд ИИ-трактовки и система пользователей/платежей НЕ открывались, но движок карт и UI прекрасно работают сами по себе.
Как запустить движок карт и фронтенд?Склонируйте репозиторий, установите зависимости и запустите входящие в комплект npm-скрипты (`npm run dev` для разработки, `npm run build && npm run start` для продакшена) — это стандартный проект Next.js.
Что мне нужно, если я хочу сам добавить функцию ИИ-трактовки карт?Придётся самому построить маршрут в духе '/api/interpret' и подключить любую LLM; репозиторий даёт лишь базу знаний паттернов ('patterns.ts') и логику совместимости ('heming-knowledge.ts'), которые можно скормить собственному промпту.
Чего не хватает в открытой версии?Слой эксплуатации платформы остаётся закрытым: промпты ИИ-трактовки, бэкенд-маршруты API (/api/interpret, /api/heming, /api/generate), система пользователей/подписок/платежей, серверная антиабузная защита и конфиги развёртывания (Vercel/Nginx/Docker/база данных).
Что в датасете карт из 518 400 образцов?Он покрывает все комбинации год/месяц/день/час/пол (60×12×30×12×2 = 518 400), общий объём 5,5 ГБ; каждый образец соединяет полную структуру карты с 13 тематическими текстами трактовки (карьера, богатство, любовь, здоровье и т.д.) — для fine-tuning моделей, RAG-извлечения или исследований.
Почему алгоритм открыт, а промпты ИИ-трактовки — нет?Автор считает алгоритм расчёта общедоступным традиционным знанием, которое не должно быть заперто, тогда как реальная коммерческая ценность — глубина трактовки и UX — остаётся собственностью их облачного продукта на metisziwei.com.
Какой стек технологий стоит за фронтендом?Next.js 14 с App Router, TypeScript, Tailwind CSS плюс собственная дизайн-система, Framer Motion для анимации и библиотеки iztro + lunar-javascript для лежащей в основе математики карт.
Классические тексты Цзы Вэй Доу Шу полностью оцифрованы?Да — три классики включены как структурированные TypeScript-модули: Гусуйфу (骨髓赋), Полное собрание (紫微斗数全集) и Полная книга (紫微斗数全书), все в общественном достоянии.
Creator
Renhuai123
Size
2.6 MB
Stars
5.2K
Age
5mo
Commits · 90 Days