← 블로그로
Ai약 11 분 읽기

규칙 1100개짜리 점성술 엔진이 대부분의 AI 제품보다 잘 설계된 이유

게시일 2026년 11월 9일
규칙 1100개짜리 점성술 엔진이 대부분의 AI 제품보다 잘 설계된 이유

중국 점성술 차트를 계산하는 TypeScript 저장소가 이번 주 GitHub에서 별 1만 6868개를 받았다. 대부분의 개발 도구가 평생에 받기 어려운 숫자이고, 서구 엔지니어 대다수가 '소프트웨어가 아니다'라고 분류할 주제다.

흥미로운 것은 주제가 아니다. 이 저장소가 'AI 제품'이라는 라벨로 나오는 많은 것보다 더 나은 엔지니어링이라는 점이다.

ziwei-doushu는 자미두수(紫微斗數)를 위한 오픈소스 엔진이다. 니하이샤(倪海廈)가 〈天紀〉 강의에서 가르친 체계를 기반으로 한다. 차트는 전부 브라우저에서 계산된다. API 키도, 모델도, 추론도 없다. 산술, 조회표, 그리고 1100줄의 패턴 규칙이다.

그리고 회귀 테스트 차트 768개가 함께 온다.

실제로 계산하는 것

이 영역을 모른다면, README의 기능 표가 이런 계산이 틀리는 방식의 목록이기도 하다.

진태양시 보정. 시계에 기록된 출생 시각은 그 장소의 태양시가 아니다. 엔진은 경도 차이와 균시차를 보정해, 나라 동쪽에서 뽑은 차트가 한 시진(두 시간) 어긋나지 않게 한다. 점성술판 타임존 버그이고, 순진한 구현에서 가장 먼저 깨지는 것이다.

중국의 서머타임, 1986년부터 1991년까지. 6년간 시행했다가 중단했다. 엔진은 구간을 감지하지만 일부러 한 시간을 자동으로 빼지 않는다. README는 시계 판독값을 사용자가 확인한 뒤 별도의 clock-adjust.ts를 거쳐 변환한다고 분명히 밝힌다. 옳은 직감이다. 사용자 입력을 조용히 조정하는 것이 자신 있게 틀린 차트를 만드는 방법이다.

윤달에 대한 네 가지 관례. 윤달이 앞 달에 속하는지, 다음 달에 속하는지, 날짜로 쪼개는지, 독립된 달로 세는지에 대해 유파가 갈린다. 엔진은 편을 고르는 대신 설정으로 만든다. 별의 밝기도 마찬가지다. 전통마다, 같은 상용 소프트웨어의 버전마다 척도가 다르다. 7단계를 지원하고, 표시용 폴백으로 더 거친 3단계 분류를 둔다.

늦은 자시의 날짜 전환. 23시부터 23시 59분은 다음 날, 00시부터 00시 59분은 당일로 본다. 출생 장소가 주어지면 진태양시로 판단해 두 규칙이 일관되게 유지된다.

그 위에 사화(四化)와 비성(飛星), 본명반과 연운반 사이에서 이동하는 열두 신살 배치, 그리고 1100개가 넘는 규칙의 패턴 라이브러리가 있다. 자부동궁(紫府同宮), 일월병명(日月並明), 칠살조두(七殺朝斗) 같은 것들이다.

A carved wooden printing block and a worn ink brush on coarse paper

테스트가 곧 논증이다

누구나 자기 차트 엔진이 정확하다고 주장할 수 있다. 이쪽은 모든 푸시와 풀 리퀘스트에서 도는 테스트 스위트를 공개하고, 무엇을 검사하는지의 목록이 저장소에서 가장 정보량이 많은 부분이다.

체계의 철칙에 대한 차트 768개. 서머타임 구간. 입춘(立春) 경계, 이 달력에서 해가 바뀌는 지점이자 거의 모든 구현이 하나씩 어긋나는 지점. 홍란(紅鸞)과 천희(天喜)의 배치. 샘플 차트 전반의 시진 인덱스 일관성. 시진 인덱스 경계 조건. 날짜 유효성. 두 사화가 같은 궁에 떨어지는 경우.

마케팅 목록이 아니다. 각 항목에 차례로 물린 사람이 쓴 목록이다. 입춘 경계 하나만으로도 2월 첫 주에 태어난 사람의 순진한 구현은 해마다 반드시 깨진다.

설치

명령 세 개다.

git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install

원하면 cp .env.example .env.local 후 npm run dev. 검증은 전체 TypeScript 패스를 위한 npm run typecheck, 차트 엔진 회귀 스위트를 위한 npm test다.

차트를 뽑거나 표시하는 데 API 키가 필요 없고, 궁합 차트에도 필요 없다. 전부 클라이언트에서 돈다. 생년월일과 출생지로 만드는 물건에는 맞는 선택이다.

저자가 그은 경계, 그리고 그것이 README에서 가장 정직한 부분인 이유

오픈소스 버전에는 백엔드 API 라우트가 없다. 차트 산출, 차트 표시, 궁합 산출은 모두 로컬이다. 하지만 AI 해석 엔드포인트인 /api/interpret와 궁합 분석 엔드포인트는 구현돼 있지 않다.

그게 없으면 인터페이스는 오픈소스 버전에 해당 엔드포인트가 없다고 분명히 말한다. README는 사람들이 계속 올리던 이슈를 해소하는 문장도 덧붙인다. API 키를 설정해도 그 기능은 작동하지 않는다. 이슈 #30은 사용자들이 반대로 가정했기 때문에 존재한다.

이례적인 결정이다. 쉬운 길은 모델을 호출해 그럴듯한 해설을 만드는 스텁을 넣는 것이었다. 대신 이 저장소는 자기가 신탁인 척하기를 거부하는 계산기다. 이 주제의 온라인 존재 대부분이 자신 있는 헛소리인 걸 감안하면, 자기가 계산할 수 있는 것의 경계에서 멈추는 도구는 주목할 만하다.

이름 붙이기, 그리고 라이브러리처럼 읽히는 이유

코드는 이 학문이 실제로 가르쳐지는 방식대로 조직돼 있고, 그래서 읽힌다.

lib/ziwei/algorithm.ts는 산출 순서를 담는다. 명궁을 잡고, 오행국을 정하고, 14주성을 배치하고, 보조성을 배치하고, 대운과 연운을 깐다. constants.ts는 천간, 지지, 성요 목록을 담는다. sihua.ts는 사화, 즉 녹(祿)·권(權)·과(科)·기(忌)를 담고, 비성 자기 변환 사례도 포함한다. 그다음 패턴 라이브러리와 밝기 표가 별도 모듈로 있다.

이 영역을 안다면 이 대응은 뻔하다. 모른다면 그래도 읽힌다. 상수, 산술, 규칙, 해석에 인접한 데이터 순서다. 영역은 낯설고 구조는 낯설지 않다. 트렌드가 아니라 그 대상 자체를 이해하는 사람이 만들 때 좋은 소프트웨어가 갖는 모양이다.

TypeScript 선택도 중요하다. 차트는 각기 성요를 담은 궁들의 트리이고, 서로를 참조하는 규칙으로 변환된다. '궁은 성요 목록을 담고, 각 성요는 고정된 집합에서 온 밝기 등급을 갖는다'를 표현할 수 있는 타입 시스템은 컴파일 시점에 부류 전체의 버그를 잡는다. 저장소는 무엇보다 먼저 전체 타입체크를 돌린다. 이만큼 열거값이 많은 영역에서 그건 장식이 아니다.

AI 블로그가 점성술 엔진을 쓰는 이유

지금 대부분의 AI 제품이 만들어지는 방식에 대한 깔끔한 반례라서다.

모든 출력이 결정론적이고, 모든 규칙이 이름 있는 전통에 귀속되고, 모든 모호한 관례가 의견이 아니라 설정 스위치이고, 정확성이 회귀 케이스 768개로 강제되는 시스템이다. 같은 질문을 두 번 하면 같은 답이 나온다. 환각이 없다. 생성하는 것이 없기 때문이다.

그리고 명시적으로 하지 않을 것이 있다. 해석이다. 판단이 필요하고 실천가마다 의견이 갈리는 층은 사용자에게, 혹은 별도로 구현된 엔드포인트에 남긴다.

언어 모델로 제품을 만드는 대부분의 팀은 그 분리를 베낄 이득이 있다. 계산할 수 있는 것은 정확히 계산하고, 해석이 시작되는 지점을 분명히 하라. 대안은 둘 사이의 차이에 대해 권위 있는 목소리를 내는 시스템이고, 이 저장소가 피하도록 설계된 실패 모드가 정확히 그것이다.

코드는 MIT다. 데이터셋은 CC BY 4.0. 고전 텍스트는 퍼블릭 도메인. 강사의 육성은 비상업 라이선스이고, README가 그렇게 밝힌다. 전부 문서화돼 있다. 훨씬 논쟁이 적은 소재에 대해 대부분 프로젝트가 해내지 못하는 일이다.

주제를 믿지 않아도 엔지니어링에서 배울 것이 있다. 보통 잘 만든 물건의 표시다.

관련 글