개인
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 19Tailwind CSS v4shadcn/uiassistant-ui
- 콘텐츠
- NuartzD3.js (그래프뷰)Mermaid
- AI
- Aegra (Agent Protocol v2)LangGraphDeep AgentsLangGraph SDK
- 인증
- Auth.js v5 (GitHub·Google OAuth)Neon Postgres
- 렌더링
- KaTeX (수식)Shiki (코드 하이라이팅)
- 배포
- Vercel (웹)Mac mini 홈서버 (에이전트, Docker Compose + Tailscale Funnel)GitHub ActionsBunuv