Arkurator

처음인데 어떻게 시작하나요?

가입 후 워크스페이스(별자리) 하나 선택 → 파일 드래그앤드롭 → "AI 학습" 버튼. 3분 안에 첫 자료가 등록됩니다. 자료가 등록되면 우측 AI 패널에서 바로 질문할 수 있어요.

회원가입에 무엇이 필요한가요?

이메일 + 비밀번호만 있으면 됩니다. 가입 후 메일로 인증 링크가 발송되며, 인증 완료 시 로그인 가능. 본인의 LLM API 키(Gemini · OpenAI · Claude 중 택일)는 가입 후 설정 → 앱 설정 → LLM 설정에서 입력합니다.

가이드는 어디서 보나요?

상단 우측 메뉴의 가이드 링크에서 랜딩 · 메인 리스트 · 프로젝트 디테일 · 코드 수정 페이지의 모든 기능을 단계별로 확인할 수 있습니다.

AI 응답에 비용이 들어가나요?

본인의 LLM API 키(Google Gemini · OpenAI · Anthropic Claude 중 선택)를 설정해서 쓰는 구조입니다. Arkurator 자체 사용료는 없고 LLM 비용만 본인 명의로 처리. Gemini 는 무료 quota 만으로도 일상 사용 가능합니다.

RAG 학습이 정확히 뭔가요?

Retrieval-Augmented Generation. AI Agent 패널에서 "모든 문서를 RAG 로 학습" 버튼을 누르면 백엔드가 현재 별자리의 모든 문서를 임베딩해 벡터 DB 에 저장합니다. 이후 질문하면 관련 문서를 자동 인용해 답변 — 일반 AI 답변과 달리 출처 링크가 함께 표시됩니다.

AI 검색 범위를 좁힐 수 있나요?

AI 채팅 패널 상단의 scope 토글로 전체(모든 별자리·게시물) vs 현재 프로젝트(보고 있는 게시물 한정) 전환 가능합니다. 프로젝트 디테일에서 특정 첨부 PDF 만 학습 대상으로 지정도 가능.

"AI 매직 문서"가 뭐예요?

원본 콘텐츠를 LLM 이 분석해 시각적 HTML 보고서로 자동 생성한 결과물입니다. 프로젝트 디테일의 우측 하단 별 아이콘(보라/인디고)으로 생성하며, 생성 후 메인 리스트의 썸네일도 매직 문서 미리보기로 자동 전환됩니다.

모델은 어떻게 변경하나요?

사이드바의 현재 LLM 정보 pill 또는 설정 버튼 → 앱 설정 → LLM 설정 탭에서 provider 와 모델을 선택. 본인 API 키를 입력하면 자기 키로 호출되고, 비워두면 시스템 기본값을 사용합니다.

어떤 파일 형식을 지원하나요?

AI 학습 대상은 HTML · Markdown. 메인 패널에서 보는 것은 PDF · 이미지(JPG/PNG/WebP) · 비디오 · 오디오 · JSON 등 거의 모든 형식 가능. 프로젝트별 학습(특정 PDF 만)도 지원하니, 필요하면 PDF 도 검색 대상에 포함할 수 있습니다.

파일을 어떻게 올리나요?

사이드바의 새 파일 버튼으로 HTML/MD 본문 작성 후 첨부물 업로드. 또는 프로젝트 디테일의 좌측 Explorer 에서 카테고리(이미지/문서/비디오/오디오/링크)별로 추가 가능합니다. 공유 URL 링크도 그대로 첨부 가능.

HTML/MD 콘텐츠를 직접 수정할 수 있나요?

프로젝트 디테일의 우측 하단 코드 수정(연필 아이콘) 버튼을 누르면 Space Station 페이지로 이동. Monaco 에디터(VSCode 와 동일 엔진)에서 syntax highlight · 자동완성 · 멀티커서 · 실시간 미리보기를 사용해 편집 가능합니다.

썸네일이 다크 모드로만 보여요.

프리뷰 iframe 은 부모의 테마 클래스(html.dark)와 color-scheme 을 상속받아 자동 동기화됩니다. 단, 콘텐츠 HTML 이 하드코딩된 색(예: background: #020617)을 쓰는 경우는 그 색이 유지됩니다. Tailwind dark: 또는 prefers-color-scheme 패턴을 쓰면 자동 대응.

"별자리(Constellation)"가 뭔가요?

프로젝트나 주제 단위로 자료를 그룹화하는 워크스페이스의 별칭입니다 (예: Orion, Cygnus...). 하나의 별자리 안에는 여러 프로젝트가 별처럼 모여 있다는 개념. 필요하면 분리 / 합칠 수 있고, 사이드바의 "다른 별자리로 워프" 로 손쉽게 전환합니다.

팀원과 같이 쓸 수 있나요?

owner / admin / user / guest 4단계 권한으로 워크스페이스를 공유할 수 있습니다. 관리자는 사용자별 활동 로그(DAU / MAU · 게시 추이 · 접속 IP)를 대시보드에서 확인 가능.

특정 게시물만 공개할 수 있나요?

각 게시물은 공개 / 비공개 토글이 가능하고, 게시물 우측 액션의 공유 아이콘으로 단축 URL 을 생성해 비회원에게도 전달할 수 있습니다. 공유받은 사람은 해당 게시물의 파일들만 접근 가능.

댓글이나 노트는 어떻게 다나요?

프로젝트 디테일의 우측 패널에 Notes / Reply 두 탭이 있습니다. Notes 는 본인용 마크다운 메모, Reply 는 별점 + 댓글/답글 1단계 — 협업자 간 토론 용도.

데이터는 어디 저장되나요?

운영자가 직접 호스팅하는 서버의 디스크에 저장됩니다. 외부 클라우드 자동 동기화 없음. 직접 셀프호스팅 시 PC / NAS / 라즈베리파이 / Jetson Nano 등 어디든 운영 가능합니다.

셀프호스팅 어떻게 하나요?

구조는 PHP 프론트엔드(Apache/Nginx) + Python AI 백엔드(FastAPI) 분리. 저사양 SBC(라즈베리파이, Jetson)에서도 동작하도록 최적화되어 있으며, systemd 서비스 + nginx reverse proxy 로 배포합니다. 상세 설치 가이드는 추후 별도 페이지에서 제공 예정.

백업은 어떻게 하나요?

모든 자료는 파일 시스템에 그대로 저장됩니다 (별자리별 폴더, 카테고리별 하위 폴더). 백업은 rsync · tar · borgbackup 등 표준 도구로 폴더 통째로 백업하면 OK. 사용자 계정은 PostgreSQL 에 — pg_dump 로 파일 트리 백업과 함께 정기적으로 받으세요.

모바일에서도 잘 동작하나요?

반응형 디자인이라 폰 / 태블릿 / 데스크탑 모두 지원합니다. AI 채팅, 파일 열람, 매직 문서 생성 등 대부분의 기능은 모바일 브라우저에서도 동일하게 동작. 모바일에서는 사이드바 접힘 strip 이 자동으로 숨겨지고, 좌/우 패널은 항상 펼친 상태로 강제 표시됩니다.

카카오톡에서 로그인이 안 돼요.

카카오톡 내장 브라우저의 쿠키 처리 버그가 원인입니다. 랜딩 페이지 상단의 노란 안내 배너가 자동으로 표시되며, 우측 상단 메뉴 또는 우측 하단 메뉴 → "다른 브라우저로 열기" 로 Chrome / Safari 에서 다시 열어 주세요. Arkurator 는 카카오톡 진입 시 세션 쿠키 손실을 우회하는 JS-redirect 패치도 적용해 두었습니다.

업로드한 파일이 안 보여요.

먼저 현재 별자리를 확인하세요(사이드바의 "별자리 정보" 패널). 다른 별자리에 등록된 파일은 카테고리/필터에 잡히지 않습니다. 상단의 작성자 필터(전체 / 내 글 / 공유)도 점검. 그래도 안 보이면 페이지 새로고침으로 캐시 무효화.

AI 응답이 너무 느려요.

RAG scope 가 "전체"일 때 모든 문서를 검색해 느릴 수 있습니다. 현재 프로젝트로 좁히면 빠릅니다. 또한 사용 중인 모델이 무거운 경우(예: GPT-4 · Claude Opus)는 Gemini Flash · Claude Haiku 같은 경량 모델로 전환 시 응답 속도 개선.