← 블로그로
Ai약 11 분 읽기

중국 점성술 리포지토리가 200억 자를 공개했다. 엔진은 MIT, 문장은 아니다

게시일 2026년 11월 8일
중국 점성술 리포지토리가 200억 자를 공개했다. 엔진은 MIT, 문장은 아니다

이번 주 GitHub에서 가장 빠르게 성장한 리포지토리 4위는 중국 점성술 명반을 계산하는 TypeScript 프로젝트다. 7일 만에 스타 4,906개를 얻었다. 대부분의 모델 공개보다 빠른 속도이고, 위에 남은 것은 몇 개의 agent 도구뿐이다. 주간 순위 상위는 평소 모델이나 인프라 프로젝트가 차지하는 자리다.

이름은 ziwei-doushu, 구현한 자미두수 체계에서 따왔다. 바탕에는 고(故) 한의사 Ni Haixia의 교학 체계가 있고, 이 주제를 다룬 그의 강의는 모두 열네 편이다. 리포지토리에는 완전한 명반 엔진, 퍼블릭 도메인이 된 원전, 그리고 사람들이 이 리포지토리를 굳이 열어 보는 이유인 데이터셋이 들어 있다.

데이터셋에 실제로 든 것

10월 15일 공개된 4.0 버전에는 명반 674,976장이 들어 있다. 각 명반은 열세 개 해석 차원으로 펼쳐져 총 8,774,688건의 해석이 나온다. 본문은 약 20.4 billion characters, 압축을 풀면 56.6 gigabytes, 압축 상태로 161 megabytes이며 연도별로 나눈 77개 파일이다.

자미두수 명반과 GitHub 리포지토리 화면이 나란히 놓이고 코드와 별자리 표가 겹쳐 보이는 이미지.

명반 수는 전수다. 1950년부터 2026년까지 실제로 존재하는 모든 날짜에 전통적인 열두 시진과 남녀 두 성별을 곱했다. 장당 평균 약 3만 자의 해석이 붙는다. 뒤집어 말하면, 실제로 존재하는 생일이라면 대응하는 명반이 여기 안에 있다.

공개 전에 관리자는 77개 파일을 모두 풀어 원본 데이터와 바이트 단위로 대조했다. 이런 QA 노트를 남기는 사람은 데이터에 한 번 크게 당한 적이 있다. 일 자체는 어렵지 않다. 다만 지루하고, 지루한 일은 보통 아무도 하지 않는다.

이전 3.0 버전은 1924년부터 1983년까지 518,400장을 담았고 압축을 풀면 33.1 gigabytes였다. 4.0은 범위를 17년 늘리고 장수를 30퍼센트, 압축 해제 용량을 71퍼센트 늘렸다. 용량이 장수보다 빠르게 는 이유는 장당 해석 문장이 길어졌기 때문이다.

다시 써도 남는 것은 엔진 쪽이다

명반 핵심은 `lib/ziwei/`에 있다. 기능 목록을 읽다 보면 업계가 수십 년간 다퉈 온 논점 목록을 보는 기분이 든다. 엔진 층은 이 프로젝트를 다시 써도 유일하게 남을 부분이기도 하다.

진태양시 보정은 경도차와 균시차를 함께 처리한다. 그래서 중국 서부에서 기록된 출생 시각이 시계 때문에 한 시진 통째로 밀리지 않는다. 1986년부터 1991년까지의 서머타임은 감지하지만 일부러 빼지 않는다. 앱이 해당 구간을 표시하고, 사용자가 시계 눈금을 확인한 뒤에 환산한다. 윤달은 네 가지 관례를 지원하며 모두 설정 가능하고, 특정 유파에 하드코딩하지 않았다. 만자시는 23:00에 날짜를 바꾸고, 이 규칙도 켜고 끌 수 있다. 별의 밝기는 일곱 단계로 등급을 나누고, 표시용 대체로 거친 세 단계를 남긴다. 밝기를 어느 유파로 볼지 자체가 토글인 이유는 주요 명반 소프트웨어끼리 서로 맞지 않기 때문이다. 이 기본값들은 아무거나 하나만 골라도 논쟁이 붙는다.

그 밖에 사화와 비성 체계, 본명층과 유년층으로 나뉜 열두 신살, 1,100개 이상의 규칙을 담은 격국 라이브러리가 있다. 자부동궁, 칠살조두 같은 고전 격국도 들어 있다. 이 용어들은 점성술 업계에서 설명이 필요 없다.

장식이 아니다. 밝기 배정을 두고 유파가 갈리는 체계에서 해석 하나를 코드에 박아 넣는 것은 구현 세부사항으로 위장한 제품 결정이다. 그것을 토글로 만드는 순간 개인 도구가 다른 술자도 받아들이는 물건이 된다.

돌려 보기

스택은 Next.js 16과 App Router, TypeScript, Tailwind, Framer Motion이고, 명반 로직 아래에는 iztro와 lunar-javascript가 있다. Node만 있으면 세우는 일 자체는 어렵지 않다.

git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install
cp .env.example .env.local
npm run dev

검증은 명령 하나다. `npm test`는 명반 768장을 대상으로 회귀 스위트를 돌린다. 핵심 규칙, 서머타임 경계, 입춘 경계, 샘플 일관성, 시진 인덱스 경계, 날짜 유효성, 같은 궁에서의 이중 사화가 포함된다. 이런 시스템에서 잘 깨지는 지점만 골랐다. 같은 스위트가 push마다 GitHub Actions에서 돈다.

명반을 보는 데 API key도, 백엔드도 필요 없다. 엔진은 브라우저 안에서 돈다.

경계를 이상하리만치 정확하게 그었다

이 리포지토리가 대부분의 오픈소스 공개와 갈라지는 지점이 여기다. 관리자는 얼버무리지 않고 무엇이 빠졌는지 목록으로 공개하며 증거로 줄 수를 붙였다. 명반 페이지는 데모 75줄, 상용 제품 1,227줄. 해석 패널은 467 대 5,088. 명반 그리드 285 대 1,334. 궁 셀 201 대 1,192. 궁합 페이지 368 대 1,937.

해석 공식 라이브러리, 즉 이 명반이 무슨 뜻인지 사용자에게 실제로 알려 주는 부분은 열려 있지 않다. 리포지토리의 `db-analysis.ts`는 자리만 채운 파일이다. AI 해석용 프롬프트도 비공개다. 백엔드 라우트도 비공개이고, README는 분명히 적어 두었다. API key를 설정해도 `/api/interpret`는 작동하지 않는다. 오픈 버전에 그 엔드포인트가 없기 때문이다. 사용자 시스템, 결제 흐름, 어뷰즈 방지 계층, 배포 설정도 전부 없다. 이것들이 모여야 돈을 받고 돌아가는 제품이 되는데, 전부 닫힌 쪽에 있다.

열린 것은 엔진, 원전, 열네 주성과 열두 궁을 다루는 SEO 지식 그래프, 데모 UI, 그리고 데이터셋이다. 마침 다시 만드는 데 비싸고 복사는 싼 부분들이다.

라이선스도 같은 논리로 네 갈래다. 코드는 MIT. 데이터셋은 CC BY 4.0으로 출처 표시를 조건으로 상업적 이용이 가능하다. 원전은 퍼블릭 도메인. 강의에서 옮긴 인용 1,848건은 CC BY-NC-SA 4.0, 즉 비상업용만 허용되며 데이터셋 라이선스는 이들을 명시적으로 제외한다.

마지막 조항을 눈여겨볼 만하다. 200억 자의 생성 해석은 출처만 표시하면 상업적으로 써도 된다. 그 원천이 된 인용 1,848건은 안 된다. 선은 글자 수가 아니라 출처에 그어져 있다.

점성술 밖에서 왜 흥미로운가

이 리포지토리에서 일반화할 수 있는 지점이 셋이다. 셋 다 점성술 전용은 아니다.

첫째는 해자의 모양이다. 한 사람이 명반 엔진을 만들고, 지식 베이스를 만들고, 데이터셋을 만든 뒤, 다시 만드는 비용은 비싸고 복사는 싼 부분을 오픈소스로 열었다. 남긴 것은 쓰기는 싸고 복사는 어려운 부분, 해석 문장과 프롬프트와 전환 퍼널이다. 투자를 받은 스타트업보다 "오픈소스"를 읽는 방식이 정교하다.

둘째는 데이터셋을 제품으로 다루는 태도다. 8.7 million건의 해석을 만드는 일은 커버리지의 완력이다. 모든 날짜, 모든 시진, 두 성별, 열세 차원을 다 채운다. 평가에도, 파인튜닝에도, 경쟁 제품을 만드는 데도 쓸 수 있고, 두 해석이 날짜 범위 전체에서 서로 모순되는지 확인하려는 사람에게도 쓸모가 있다. 배포 비용은 거의 0이고, 랜딩 페이지로는 살 수 없는 종류의 신뢰를 얻는다.

셋째는 유통이다. README는 Xiaohongshu, Douyin, 그리고 중국 중고 거래 앱 Xianyu에서 인사하자는 초대로 끝난다. 퍼널은 GitHub 리포지토리에서 호스팅 사이트로, 다시 소셜 계정으로 이 순서대로 흐른다. 리포지토리가 콘텐츠 마케팅 예산이 보통 하는 일을 대신하고 있다. 순서를 뒤집으면 보통 효율이 떨어진다.

관리자는 이 리포지토리를 유지되는 제품이 아니라 "open snapshot"이라고 부르고, issue 답변이 늦을 수 있다고 알리며, 명반 관례를 바꾸려는 사람에게는 출처를 붙여 달라고 요청한다. 스타 16,700개, 56기가바이트 데이터셋을 가진 프로젝트로서는 거래 조건을 정직하게 적은 편이다.

엔진이 필요하면 가져가면 된다. 문장이 필요하다면, 그 문장이 곧 사업이다.

관련 글