Ziwei Doushu: 자미두수 명반 계산 엔진과 해석 데이터셋
전통 자미두수 명반 계산 엔진, 최소 웹 데모, 고전 자료와 해석 데이터셋을 제공하는 저장소예요. 상용 사이트 전체나 완성된 AI 상담 서비스는 아니에요.
주요 기능
- 생년월일·시진·성별을 입력해 명반과 대운·유년 정보를 표시하는 브라우저 계산 데모를 제공해요.
- 진태양시·윤달·야자시·유파별 밝기 설정과 중국 서머타임 판별 모듈이 있어요.
- README 기준 v4 해석 데이터는 674,976개 명반·13개 항목이며 연도별 다운로드를 제공해요. 수량은 프로젝트 공표값으로 실측하지 않았어요.
구조
Next.js 16·React·TypeScript UI와 lib/ziwei의 iztro·lunar-javascript 기반 계산 모듈로 구성돼요. lib/classics에 고전 자료가 있고 db-analysis.ts는 STAR_DB가 비어 있는 플레이스홀더예요. API·회원·결제·상용 해석 라이브러리는 공개 범위 밖이에요.
누구에게 쓸모 있나요
전통문화 계산 규칙을 학습하거나 관련 데모·연구 데이터를 만드는 개발자. 과학적 예측·의료·재무 판단 도구로 사용하지 않아야 해요.
설치 전 준비
- Node.js·npm 및 Next.js 16과 호환되는 개발 환경. 루트 manifest에 engines 최소 버전은 명시되지 않았어요.
- 기본 명반 계산에는 API 키가 필요하지 않습니다. AI 기능은 사용자가 백엔드를 직접 구현해야 해요.
- v4 데이터 전체는 문서상 압축 161 MB, 해제 후 56.6 GB이므로 충분한 저장 공간과 zstd가 필요해요.
- 브라우저 기반 Next.js 개발·배포 환경
- 소스 데모는 모바일 대응을 설명하지만 OS별 실행은 미검증
- 데이터 해제는 macOS·Linux 또는 Windows용 zstd 경로
설치 방법
웹 데모 설치
명반만 볼 때 환경 파일은 선택 사항이에요. 키를 넣는 것만으로 미포함 AI API가 생기지 않습니다.
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install
npm run dev데이터 선택 다운로드
v4.0-13d 릴리스에서 필요한 연도 파일과 체크섬을 확인해요. 긴 창 옵션 –long=27이 문서상 필수예요.
zstd -d --long=27 year-1990.jsonl.zst사용 방법
- 출생 정보를 입력해 명반을 만들고 궁위·대운·유년을 살펴봅니다.
- hour 필드는 0~23시가 아닌 0~11의 시진 인덱스임을 구분해요. 서머타임은 감지만 하며 자동 차감하지 않습니다.
- AI 해석을 추가하려면 별도 API와 프롬프트를 구현하고 민감한 출생 정보 처리 방침을 마련해요.
비용과 API 키
코드·공개 데이터 이용 자체는 무료예요. 자체 호스팅·저장 공간·사용자가 추가하는 AI API 비용은 별도이며 상용 온라인 서비스 조건과 동일하지 않습니다.
라이선스
코드 MIT, v3·v4 릴리스 데이터 CC BY 4.0 및 출처 표시. 프로젝트는 고전 원문을 공공영역으로 설명해요. docs/tianji-ziwei 인용 자료는 CC BY-NC-SA 4.0이고 데이터 속 해당 인용도 데이터 허가 범위 밖이에요.
주의사항과 알려진 이슈
- 전통 명리 해석의 정확성·예측력을 검증한 프로젝트가 아니에요. 건강·금전·관계의 중요한 결정을 맡기지 않아야 해요.
- 상용 UI·AI 백엔드·해석 본문 DB가 없어 설치 후 온라인 서비스와 같은 결과를 기대하면 안 돼요.
- v3 데이터에는 약 2,520건의 존재하지 않는 날짜 표본이 알려져 있어요. v4는 실제 날짜로 생성했다고 설명해요.
- 2026-10-20 기본 밝기 규칙 변경으로 10월 15일 v4 생성 규칙과 현재 기본값이 달라요. 데이터·엔진 버전을 맞춰 비교해야 해요.
#30 API 키 설정 후 404(종료)
이슈는 완료 종료 상태예요. 현재 README는 공개 저장소에 해당 API가 없으므로 키 설정만으로 해결되지 않는다고 명시해요.
확인 범위
확인 날짜: 2026-11-02
확인 커밋: 7264e08b0b41a3e27ac786e232f0819c188eeabe
확인한 범위: 공식 GitHub main 커밋을 조회하고 해당 커밋에 고정된 README.md, package.json, LICENSE, DATASET-LICENSE, docs/tianji-ziwei/LICENSE.md, lib/ziwei/db-analysis.ts를 정적으로 확인했어요. 표시한 공개 이슈의 상태도 확인했어요.
확인 한계: 저장소 코드·의존성을 설치하거나 실행하지 않았어요. 계정 연결·모델 호출·과금·빌드·기기별 동작·성능·전체 보안 감사는 미검증이며 안내는 공식 문서 기준이에요.