피드로 돌아가기
Dev.toBackend
원문 읽기
True Solar Time 보정을 적용한 고정밀 Bazi 계산 엔진의 AI 에이전트 통합
I Open-Sourced a Chinese Astrology Engine and Wired It Into Every AI Coding Tool
AI 요약
Context
기존 오픈소스 Bazi 라이브러리들의 True Solar Time 보정 부재로 인한 시간 기둥(Hour Pillar) 산출 오류 발생. 단순 Clock Time 의존 설계 및 Midnight Problem(子時分日) 처리 방식의 불투명함으로 인한 데이터 신뢰도 결여가 핵심 한계점임.
Technical Solution
- Equation of Time을 적용하여 지구 공전 궤도 이심률과 자전축 기울기를 반영한 True Solar Time 보정 로직 구현
- Midnight Problem 해결을 위해 사용자 선택 가능한 시간 구분 컨벤션(早子時 vs 晚子時) 설계
- Calculation Engine을 pure TypeScript 라이브러리로 분리하여 Node.js 및 브라우저 환경 범용성 확보
- MCP(Model Context Protocol) Server 레이어를 구축하여 AI Agent가 자연어로 정밀 계산 도구를 호출하는 구조 설계
- ClawHub 보안 스캔 통과를 위해 런타임 npm install을 제거하고 선언적 의존성 관리 방식으로 구조 개선
- Production Backend와 Golden Case 비교 검증을 통한 산출 결과의 Parity Baseline 구축
실천 포인트
- 도메인 특화 계산 엔진 설계 시 단순 표준 시간(Clock Time)이 아닌 물리적 실제 시간(Solar Time) 등 정밀 보정 필요성 검토 - AI Agent 통합 시 MCP와 같은 표준 프로토콜을 활용하여 도메인 지식과 계산 로직을 분리하는 레이어드 아키텍처 적용 - 외부 스킬 배포 시 런타임 패키지 설치를 지양하고 정적 의존성 정의를 통한 보안 신뢰성 확보