Renhuai123/ziwei-doushu
자미두수 오픈소스 배판 엔진 v4.0 공개
원제 Renhuai123/ziwei-doushu
스타 8,623당일 +295TypeScript
Key Point
동양 전통 명리학의 알고리즘을 오픈소스로 공개한 드문 사례로, 자미두수 배판 엔진의 정확한 구현 방식과 거대 해석 데이터셋이 관심사에 있는 개발자나 명리 연구자에게 실질적 자료를 제공한다.
핵심 요약
- 왕다위AI(王多鱼AI)가 자미두수 오픈소스 배판 엔진을 TypeScript로 구현해 GitHub에 공개했다.
- 니하이샤(倪海厦) 《천기(天紀)》 체계 기반으로 완전한 배판 알고리즘, 사주 십간십이지 변화 시스템, 격국 지식베이스 1100+ 줄, 고문헌 원문 데이터를 포함한다.
- 2026년 10월 15일 v4.0 해석 데이터셋을 발표했으며, 1950~2026년 공력 날짜 × 12시진 × 남녀 = 67만 4976장 명판 × 13개 분석 차원 = 877만 4688개 해석 문단을 담았다.
- 데이터셋은 압축 후 161MB, 해제 후 56.6GB(약 204억 자)로, 각 명판당 평균 3만 자의 해석을 제공한다.
- 13개 차원의 해석 문안을 니하이샤 《천기》 강의 자료와 《자미두수전서》 원문과 대조 검증했으며, 존재 불가능한 사주 변화 관련 문장은 삭제하고 조건부 해석은 조건을 명시했다.
- 배판 엔진은 진태양시 보정(경도 차이 + 균시차), 중국 1986~1991년 하절기 시간 자동 차감, 윤달 4가지 해석 방식, 23시 이후 다음날 배판 등을 지원한다.
- 별 밝기를 7단계(묘·왕·득·리·평·불·함)로 분류하고 유파별로 전환 가능하게 했으며, 사주 12신살은 본명 계산 시 생년지지, 유년 계산 시 유년지지로 기준을 바꾼다.
- 샘플 데이터셋 v3.0은 51만 8400장 명판을 담았으며, 코드는 MIT, 데이터는 CC BY 4.0으로 상용 이용 가능하다.
- 니하이샤 원말(《천기》 강의 1848개 항목) 부분만 CC BY-NC-SA 4.0으로 비상용 제한하며, 각 항목에 해당 강의 집수와 타임 코드를 기록했다.
- 인터페이스는 최소 구현 데모 수준으로, 상용 웹사이트 metisziwei.com의 UI/UX는 별도 개발됐으며 AI 해석 프롬프트와 백엔드 API는 미공개한다.
- 배판 엔진은 진태양시 보정, 중국 하절기 처리, 윤달 경계 처리, 晚子时(자정 후) 환일 전환, 1100+ 줄 격국 판정 규칙 등으로 상용 소프트웨어 수준의 정확성을 갖춘다.
- 고문헌 모듈로 《골수부(骨髓賦)》, 《자미두수전집》, 《자미두수전서》의 공개 영역 원문을 포함했다.
저장소 보기 ↗github.com