Syshin0116 홈
프로젝트 목록

개인

Syshin0116.dev - 블로그 + 포트폴리오 통합

Nuartz 기반 기술 블로그와 RAG 검색 방법 평가 환경

기간
2025.11 ~ 진행 중2025.11 레포 생성 이후 지속 개발
역할
1인 풀스택 개발
팀
개인 프로젝트
상태
진행 중

배경

Obsidian에 작성한 기술 글과 프로젝트 포트폴리오를 Nuartz + Next.js로 발행하는 개인 사이트. Aegra·LangGraph·Deep Agents 기반 AI 채팅은 로그인 없이 Luna 모델로 체험할 수 있고, 로그인하면 계정별 일일 한도 안에서 모델을 고를 수 있다. 직접 작성한 공개 글을 코퍼스로 삼아 여러 검색 방법을 같은 조건에서 구현·비교하는 RAG 평가 환경도 함께 구축했다.

한 일

주요 기능

공개 AI 채팅

  • 로그인 없이 쓰는 Luna 게스트 채팅과, 로그인 사용자의 모델 선택 및 계정별 일일 사용 한도
  • assistant-ui 기반 스트리밍 응답과 대화 목록
  • 도구·서브에이전트 실행 상태와 검색 출처 표시
  • 익명 사용자의 실행 예산 제한과 대화 보관 기한 적용

RAG 검색 방법 평가

  • 채팅과 오프라인 평가가 같은 검색 인터페이스와 공개 글 코퍼스 사용
  • BM25, 필드 가중 BM25, 문자 n-gram, RRF 조합의 재현 가능한 비교 실행
  • 코퍼스·질의셋·검색 방법의 식별 정보와 질의별 순위 기록
  • 주제별 정답셋 검토와 공개 가능한 평가 결과 확정은 후속 과제

Obsidian 호환 블로그

  • 위키링크, 백링크, 콜아웃과 지식 그래프
  • 제목·경로·본문·태그 검색과 태그 필터·정렬
  • 링크 호버 프리뷰, 읽기 모드, 읽는 시간과 모바일 목차
  • Mermaid 다이어그램, 수식, 코드 하이라이팅과 복사

프로젝트 포트폴리오

  • 업무·개인 프로젝트를 나눈 목록
  • 프로젝트별 역할, 기술 스택, 성과와 해결 과제
  • 홈의 최근 글·프로젝트와 GitHub·데모 링크

콘텐츠 발행과 운영

  • 원본 글과 정리된 Wiki를 분리하고 공개 글만 검색 코퍼스에 포함
  • JSON-LD, Open Graph, sitemap과 RSS 피드
  • Giscus 댓글, Vercel Analytics와 Speed Insights
  • 웹·에이전트·평가 및 프로토콜 호환성을 CI에서 검증

문제와 해결

공개 콘텐츠 경계 유지
블로그와 에이전트가 서로 다른 글을 노출하지 않도록 공개 글만 포함한 코퍼스를 빌드 시 생성하고, 에이전트와 평가가 같은 산출물을 사용하도록 구성
스트리밍 대화와 실행 상태 연결
Aegra의 Agent Protocol v2와 assistant-ui 런타임을 연결해 메시지, 도구 호출, 서브에이전트 활동과 검색 출처를 화면에 반영
검색 방법 비교의 재현성
코퍼스와 질의셋, 검색 구현의 식별 정보를 실행 결과에 묶고 질의별 순위를 재검증. 자동 생성한 질의셋과 소유자가 검토한 정답셋을 구분해 평가 결과의 해석 범위를 제한

결과

  • 블로그·포트폴리오와 AI 채팅(게스트·로그인)을 하나의 사이트에서 제공
  • Nuartz의 문서 해석·렌더링·탐색 기능을 실제 사이트에 적용
  • 채팅과 오프라인 평가에서 동일한 검색 구현을 재사용하는 구조 구축
  • 검색 결과와 실행 환경을 기록하고 재현성을 검증하는 평가 파이프라인 구현

배운 점

  • 실제 콘텐츠로 Nuartz의 문서 처리와 탐색 기능 검증
  • 검색 구현을 공유하면서 온라인 채팅과 오프라인 평가의 실행 환경 분리
  • 익명 AI 체험에 필요한 사용자 격리, 비용 제한과 보관 정책 구현
  • 검색 정확도뿐 아니라 데이터 출처와 재현 조건까지 포함하는 평가 설계

기술 스택

프론트엔드
Next.js 16 (App Router)
React 19
Tailwind CSS v4
shadcn/ui
assistant-ui
콘텐츠
Nuartz
D3.js (그래프뷰)
Mermaid
AI
Aegra (Agent Protocol v2)
LangGraph
Deep Agents
LangGraph SDK
인증
Auth.js v5 (GitHub·Google OAuth)
Neon Postgres
렌더링
KaTeX (수식)
Shiki (코드 하이라이팅)
배포
Vercel (웹)
Mac mini 홈서버 (에이전트, Docker Compose + Tailscale Funnel)
GitHub Actions
Bun
uv

관련 글