본문으로 건너뛰기

모델 레지스트리

AISCouncil는 사용 가능한 모델 목록을 최신 상태로 유지하기 위해 커뮤니티 관리 모델 레지스트리를 사용합니다. 레지스트리는 앱이 가져와서 캐시하는 GitHub Pages에서 호스팅되는 JSON 파일입니다.

작동 방식​

레지스트리 파일(registry/models.json)에는 제공업체, 모델 및 가격 계층의 구조화된 목록이 포함되어 있습니다. 페이지 로드 시 AISCouncil.Registry 모듈이 24시간 캐시로 최신 레지스트리 데이터를 가져옵니다. 가져오기가 실패하면 로컬로 번들된 복사본으로 대체됩니다.

레지스트리 형식​

레지스트리는 메타데이터와 함께 제공업체와 모델을 정의합니다:

{
  "providers": [
    {
      "id": "anthropic",
      "name": "Anthropic",
      "models": [
        {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4",
          "tier": "standard"
        }
      ]
    }
  ]
}

모델 기여​

레지스트리에 모델을 추가하거나 업데이트하려면:

  1. 리포지토리 포크
  2. 변경 사항으로 registry/models.json 편집
  3. 검증 스크립트 실행: python registry/validate.py
  4. 풀 리퀘스트 제출

검증 스크립트는 다음을 확인합니다:

  • 유효한 JSON 구조
  • 필수 필드 (id, name, provider)
  • 중복 모델 ID 없음
  • 올바른 tier 값

자동 새로고침​

레지스트리는 페이지가 로드될 때 자동으로 새로고침됩니다. 24시간 캐시가 과도한 요청을 방지합니다. 설정 > 개인정보에서 앱의 캐시된 데이터를 지워 강제로 새로고침할 수 있습니다.

GitHub Pages 호스팅​

레지스트리는 정적 JSON 파일로 GitHub Pages에서 제공됩니다. 이것은 다음을 의미합니다:

  • 서버 측 로직 필요 없음
  • PR이 병합되고 Pages가 다시 빌드되는 즉시 변경 사항이 적용됨
  • 빠른 글로벌 액세스를 위해 CDN 캐시됨
  • GitHub에 연결할 수 없는 경우 앱이 정상적으로 대체됨