출생 정보로 13개 영역의 명리 해석을 자동 생성하는 오픈소스 도구
태어난 날짜와 시간, 성별만 입력하면 성격부터 건강, 재물까지 13가지 측면의 해석 문장이 자동으로 나옵니다. 이 저장소는 중국 전통 명리학인 자위두수의 판을 짜는 알고리즘과, 그 판을 바탕으로 한 방대한 해석 데이터셋을 함께 제공합니다.
2026년 10월, 데이터 규모와 정확도 대폭 강화
최근 업데이트에서 가장 큰 변화는 v4.0 버전의 13차원 해석 데이터셋 공개입니다. 이전 버전보다 30% 더 많은 674,976개의 명판을 다루며, 각 명판당 약 3만 자의 해석 텍스트를 제공합니다. 총 용량은 압축 해제 후 56.6GB에 달하지만, 연도별로 파일이 나뉘어 있어 필요한 기간만 선택적으로 다운로드할 수 있습니다. 또한 해석 문장의 출처를 엄격히 검증하여, 근거가 없는 인용은 삭제하고 조건부 해석에는 해당 조건을 명시하는 등 데이터의 신뢰성을 높였습니다.
정밀한 시간 보정과 고전 기반 알고리즘
이 엔진의 핵심은 단순한 시간 입력이 아닌, 실제 태양 시간을 계산하는 데 있습니다. 출생지의 경도와 계절에 따른 시간 차이를 보정하여, 동서 방향에 따른 시간대 오차를 줄입니다. 또한 1986년부터 1991년까지 시행된 중국의 서머타임 기간을 자동으로 고려하며, 윤달 처리 방식이나 자시의 날짜 변경 규칙도 설정할 수 있습니다. 별의 밝기를 7단계로 나누고, 다양한 학파의 기준을 전환할 수 있어 전통적인 명리학의 세부 규정을 충실히 따릅니다.
데이터셋 활용 범위와 라이선스
제공되는 데이터셋은 CC BY 4.0 라이선스를 따르며, 상업적 이용이 가능합니다. 단, 출처를 명시해야 합니다. 이 데이터는 AI 모델의 미세 조정용 학습 자료로 적합하며, RAG(검색 증강 생성) 시스템의 지식 베이스로도 사용할 수 있습니다. 반면, 니하이샤 선생의 강의 원문은 CC BY-NC-SA 4.0 라이선스를 적용받아 비상업적 목적의 학습과 연구에만 사용할 수 있습니다. 코드 자체는 MIT 라이선스로 자유롭게 수정 및 재배포할 수 있습니다.
개발자 관점의 실행 가능성
TypeScript와 Next.js 16 기반으로 작성되어 웹 환경에서 쉽게 통합할 수 있습니다. npm install 후 npm run dev 명령으로 로컬 서버를 띄우면, 브라우저에서 직접 명판 생성과 시각화를 테스트할 수 있습니다. 다만, AI 기반의 실시간 해석 기능은 오픈소스 버전에서 제외되어 있어, 해당 기능을 원한다면 자체적으로 API를 구현해야 합니다. 대신, 13개 영역의 정적 해석 데이터는 이미 제공되므로, 이를 기반으로 한 정적 콘텐츠 서비스나 데이터 분석 프로젝트에는 바로 적용할 수 있습니다. 테스트 스위트가 포함되어 있어 알고리즘의 정합성을 검증하는 것도 용이합니다.
사용 전 반드시 확인할 사항
이 저장소는 명리학의 '판 짜기'와 '해석 데이터'를 제공하지만, 모든 명리학의 세부 규정을 하나의 표준으로 고정하지는 않습니다. 윤달 처리나 별의 밝기 기준은 학파에 따라 다를 수 있으므로, 자신의 목적에 맞는 설정을 선택해야 합니다. 또한, 데이터셋은 특정 시점의 알고리즘 버전으로 생성되었으므로, 엔진 코드를 업데이트할 경우 기존 데이터와의 일관성을 확인하는 과정이 필요합니다. 특히 6친(부모, 형제, 자녀) 관련 해석은 전통적으로 한계가 있다는 점을 명심하고, 참고 자료로만 활용하는 것이 좋습니다.
