Blume 2.0 favicon

Blume 2.0

Blume 2.0은 문서 사이트 설정을 모듈식 어댑터 구조로 리팩터링하고, AI 에이전트 탐색 설정을 새롭게 도입하며, 대화형 코딩 에이전트 연동을 지원하는 자동화된 업그레이드 도구를 제공합니다.

코드 및 IT호스트 어댑터를 사용하여 문서 사이트를 정적 결과물 또는 서버 빌드로 배포로컬 파일 시스템, Notion, Obsidian, Sanity, 원격…Algolia, Orama Cloud, Typesense,…문서 인터페이스에 AI 어시스턴트 제공자 및 게이트웨이 엔드포인트 연동
Blume 2.0 product interface screenshot
예상 월간 방문 수
1.1만
데이터 기준:
AIToolly 등록일

Blume 2.0란? 제품 개요

제품의 기능과 공식 포지셔닝

Blume 2.0은 기존 Markdown 및 MDX 콘텐츠를 그대로 보존하면서 사이트 설정을 전면적으로 재구성한 문서화 프레임워크의 메이저 릴리스입니다. 이번 업데이트에서는 기존의 문자열 기반 옵션과 복잡한 중첩 설정 블록을 제거하고 배포 호스트, 검색 엔진, 콘텐츠 소스, 분석 도구, API 레퍼런스, AI 어시스턴트 백엔드를 포괄하는 전용 하위 경로에서 임포트하는 타입 안전 어댑터로 대체했습니다.

또한 이번 릴리스에서는 기계 판독이 가능한 AI 메타데이터, Model Context Protocol 설정, 스킬 등을 전용 agents 네임스페이스로 체계화하여 탐색 가능성을 현대화했습니다. 개발 프로젝트에서는 Codex나 Claude Code 같은 자동화 코딩 에이전트와 호환되는 대화형 명령줄 업그레이드 도구를 활용해 마이그레이션 과정을 자동화할 수 있습니다.

Blume 2.0으로 무엇을 할 수 있나요?

공식 출처로 확인된 활용 사례

문서 사이트의 Blume 2 마이그레이션

개발팀은 업그레이드 CLI를 실행하여 구버전 설정을 식별하고, 컴포넌트 재정의 방식을 수정하며, 설정 스키마를 업데이트하여 기존 문서 저장소를 손쉽게 업그레이드할 수 있습니다.

다중 소스 기반 개발자 포털 구축

기업 및 조직은 로컬 저장소, Notion 워크스페이스, Sanity, GitHub Releases, API 스키마의 문서를 단일화된 정적 또는 서버 렌더링 기반 문서 사이트로 통합하여 서비스할 수 있습니다.

Blume 2.0 사용 방법

공식 문서에 안내된 사용 절차

  1. 1

    업그레이드 명령 실행

    프로젝트 루트에서 업그레이드 CLI를 실행하여 패키지 버전을 올리고 설정 파일에서 필요한 변경 사항을 자동으로 검사합니다.

  2. 2

    설정 어댑터 업데이트

    blume.config.ts 내의 검색, 배포, 콘텐츠 소스, API 레퍼런스, 분석, 어시스턴트 설정 블록을 임포트된 어댑터 함수 호출 구조로 전환합니다.

  3. 3

    컴포넌트 재정의 유효성 검사

    components.ts 내부의 인라인 함수와 내부 선언을 별도 파일로 분리하고, 이를 독립적인 컴포넌트 참조로 임포트하도록 수정합니다.

  4. 4

    진단 및 빌드 검증 수행

    CLI의 doctor 및 build 명령을 실행하여 모든 설정과 컴포넌트 바인딩이 오류 없이 유효성 검사를 통과하는지 확인합니다.

어댑터 아키텍처 및 업그레이드 자동화

Blume 2.0은 모든 기능적 통합 지점에서 아키텍처를 모듈식 어댑터 방식으로 전면 개편했습니다. 개발자는 blume.config.ts 내부에서 공급자 문자열과 인증 블록을 지정하는 대신 blume/search, blume/deploy, blume/sources, blume/reference, blume/analytics, blume/ai와 같은 전용 하위 경로에서 개별 어댑터 함수를 임포트해 구성합니다. 이러한 설계를 바탕으로 Vercel, Netlify, Cloudflare, Node.js 등의 플랫폼에 맞는 호스트별 결과물을 명시적으로 선언할 수 있어 묵시적인 런타임 서버 감지 및 더 이상 사용되지 않는 명령줄 빌드 플래그를 완전히 제거했습니다.

마이그레이션 도입을 간소화하기 위해 Blume 2.0에는 CLI 기반의 자동화된 업그레이드 워크플로가 포함되어 있습니다. 업그레이드 유틸리티를 실행하면 blume.config.ts, components.ts, 패키지 스크립트를 검사하여 구버전 설정의 정확한 파일 위치와 대체 코드를 출력합니다. 또한 이 도구는 Codex나 Claude Code 같은 코딩 에이전트를 직접 호출하여 마이그레이션 변경 사항을 대화형으로 해결할 수 있으며, 이후 내장된 doctor 및 build 진단을 통해 사이트 구성을 최종 검증합니다.

  • 모듈식 어댑터가 검색, 배포, 콘텐츠 소스, 분석, 레퍼런스, AI 설정 전반에서 기존의 문자열 공급자 방식을 대체합니다.
  • CLI 업그레이드 유틸리티가 제거된 플래그, 잘못된 컴포넌트 재정의, 지원 중단된 설정 경로를 자동으로 감지합니다.
  • CLI 플래그를 통해 코딩 에이전트를 즉시 실행하여 필요한 마이그레이션 변경 사항을 대화형으로 적용할 수 있습니다.

Blume 2.0 선택 전에 확인할 사항

본인의 자료와 작업 흐름으로 직접 확인할 항목

  • components.ts의 커스텀 컴포넌트 재정의가 인라인 함수가 아닌 외부 파일에서 임포트되었는지 확인합니다.
  • package.json 빌드 스크립트에 adapter, output, base와 같이 제거된 CLI 플래그가 포함되어 있지 않은지 검증합니다.
  • 1.x 또는 2.x 버전의 AsyncAPI 사양을 사용하는 경우 프로젝트 의존성에 필수 변환기 피어 종속성이 포함되어 있는지 점검합니다.
  • 검색 공급자의 관리자 API 키가 클라이언트 설정이 아닌 비공개 환경 변수로만 안전하게 관리되고 있는지 확인합니다.

Blume 2.0 출처 및 확인일

확인한 출처와 확인 시점

마지막 확인
카테고리
코드 및 IT

Blume 2.0 자주 묻는 질문

출처를 확인한 제품 정보를 바탕으로 한 답변

Blume 2.0으로 업그레이드할 때 기존 Markdown 및 MDX 콘텐츠는 어떻게 처리되나요?

Blume 2.0은 페이지 콘텐츠 구조가 아닌 사이트 설정 구문을 주로 변경하므로, 업그레이드 과정에서 기존 Markdown 및 MDX 문서를 별도로 수정할 필요가 없습니다.

Blume 2.0에서는 프론트매터(frontmatter)의 검색 관련도 조정을 어떻게 처리하나요?

Blume 1 버전에서는 무시되었던 프론트매터의 search.boost 필드가 이제 정상 작동하며, 해당 페이지의 검색 관련도 순위 점수를 직접 곱하여 순위를 조정합니다.

Blume 2.0 마이그레이션 시 코딩 에이전트를 활용해 자동화할 수 있나요?

codex 또는 claude 플래그를 사용하여 업그레이드 명령을 실행하면 대화형 에이전트 세션이 열려 필요한 설정 수정 사항을 자동으로 분석하고 코드에 적용할 수 있습니다.

components.ts의 컴포넌트 재정의 방식에서 무엇이 바뀌었나요?

모든 컴포넌트 항목은 이제 외부에서 임포트한 컴포넌트나 파일 경로, 또는 전용 컴포넌트 기술 객체여야 하며, 내부 함수 선언이나 인라인 함수 방식은 더 이상 허용되지 않습니다.

Blume 2.0에서 API 레퍼런스 사양은 어떻게 설정하나요?

개별 레퍼런스 블록 대신 OpenAPI, AsyncAPI, GraphQL, Scalar 전용 어댑터 함수로 구성된 단일 reference 배열을 선언하여 사양을 통합 관리하도록 변경되었습니다.

같은 카테고리에 최근 등록된 다른 도구를 살펴보세요.

모든 코드 및 IT 도구 보기