GitHub Stars Manager

AI 기반 저장소 관리

• GitHub 토큰 연결 시 별표 저장소를 자동 동기화하고, AI 배치 분석으로 요약·태그·카테고리를 일괄 생성합니다.
• 14개의 사전 정의 카테고리와 사용자 정의 카테고리를 지원하며, 잠금(lock) 설정으로 AI의 카테고리 덮어쓰기를 방지할 수 있습니다.
• 저장소 카드에는 별표 수, 포크 수, 언어, 기본 브랜치 상태, README 미리보기가 표시되고, 분석 상태(완료/미완료/실패/수정됨)별 필터링이 가능합니다.

의미 검색과 벡터 검색

• 키워드, 언어, 태그, 분석 상태, 릴리스 구독 여부 등 다차원 필터 검색을 기본으로 제공합니다.
• Cloudflare Vectorize 기반 벡터 의미 검색을 옵션으로 활성화할 수 있으며, OpenAI·Gemini·Cohere·Ollama·SiliconFlow 등 다양한 임베딩 제공자를 지원합니다.
• 저장소 카드에서 ‘유사한 저장소 찾기’를 누르면 해당 저장소를 기준으로 의미상 가장 가까운 별표 저장소들을 보여 주는 시맨틱 이웃 뷰가 열립니다.

저장소 Q&A 어시스턴트

• 저장소 카드에서 단일 저장소에 대한 짧은 질문을 던지면 README, 커밋, 이슈를 읽기 전용 증거로 활용한 답변과 출처 카드를 제공합니다.
• 대화는 시작 시 선택한 특정 커밋에 고정되며, 답변과 함께 인용된 출처와 검색 활동을 확인할 수 있고 세션 기록은 로컬에 보관됩니다.

MCP 서버(에이전트 연동)

• 설정에서 MCP 서버를 켜면 Claude Code, Cursor 등 MCP 호환 에이전트가 AI로 가공된 별표 라이브러리를 검색 도구로 활용할 수 있습니다.
• Streamable HTTP(권장)와 레거시 SSE 엔드포인트를 모두 제공하며, Bearer 토큰 인증(`gsm_mcp_…`)으로 보호됩니다. 데스크톱 클라이언트에서는 루프백(127.0.0.1) 주소만 열어 로컬 에이전트만 접근하도록 제한합니다.

릴리스 추적과 다운로드

• 저장소 구독 시 새 릴리스가 통합 타임라인에 표시되며, macOS·Windows·Linux·ARM 등 플랫폼과 dmg·zip·deb·rpm·apk 등 파일 유형별 스마트 에셋 필터링을 제공합니다.
• 사용자 정의 키워드 필터 규칙을 저장해 두면 반복 작업을 자동화할 수 있고, 에셋 목록을 펼쳐서 한 번에 다운로드 링크를 복사하거나 aria2 RPC로 원격 전송할 수 있습니다.

포크와 Gist 관리

• 포크 목록을 자동 가져오고 업스트림 변경을 감지해 한 번에 동기화하거나 GitHub Actions 워크플로를 트리거할 수 있습니다.
• Gist는 생성·편집·삭제, AI 요약과 의미 검색, 카테고리별 필터링을 지원하며 다중 파일 편집과 구문 강조 표시가 가능합니다.

디스커버리, 백업, 환경 설정

• GitHub Trending(오늘/이번 주/이번 달), 핫 릴리스, 인기 프로젝트, 토픽, 검색 다섯 가지 채널로 새 프로젝트를 발견하고 즉시 구독할 수 있습니다.
• WebDAV 백업은 Jianguoyun, Nextcloud, ownCloud, 표준 WebDAV 서버를 지원하며, OpenAI·Anthropic·Ollama 등 다양한 AI 제공자를 설정해 요약·임베딩·Q&A에 사용할 수 있습니다.
• HTTP·SOCKS5 프록시, 12가지 테마 프리셋, ZH/EN 언어 전환, 데이터 가져오기/내보내기 등 환경 설정 옵션을 제공합니다.

데스크톱 클라이언트(권장)

• GitHub Releases 페이지에서 Windows·macOS·Linux용 패키지를 내려받아 별도 환경 설정 없이 바로 실행합니다.
• Windows에서는 winget 명령(`winget install –id AmintaCCCP.GithubStarsManager –exact`)으로 설치할 수도 있습니다.
• 최초 실행 시 GitHub 계정을 연결해 별표·포크·Gist를 동기화하고, 설정에서 원하는 AI 제공자·벡터 검색·MCP 서버 옵션을 켭니다.

소스에서 직접 실행

• 저장소를 내려받은 뒤 `npm install`로 의존성을 설치하고 `npm run dev`로 실행합니다.
• 로컬 개발 모드에서는 AI 서비스와 WebDAV 호출이 CORS 제한으로 실패할 수 있으므로, 사전 빌드된 클라이언트나 `cd server && npm run dev`로 백엔드를 함께 띄우는 방식을 권장합니다.

Docker로 자체 호스팅

• GHCR의 사전 빌드 이미지를 받아 프런트엔드와 백엔드를 분리해 `docker-compose up -d`로 실행하면 프런트엔드 8080 포트, 백엔드 3000 포트가 사용됩니다.
• 단일 컨테이너 풀스택 이미지도 제공되며, 시작 전 루트 `.env`에 `API_SECRET`를 설정해야 인증 없는 배포가 거부됩니다.
• 비공개 패키지라면 먼저 `docker login ghcr.io`를 PAT(`read:packages` 권한 포함)로 수행해야 합니다.

선택 사양: 백엔드 서버

• 순수 프런트엔드만으로도 동작하지만, Express + SQLite 백엔드를 추가하면 기기 간 데이터 동기화, API 키 암호화 저장, AI·WebDAV 호출의 CORS 우회, 프록시 포워딩을 활용할 수 있습니다.
• 설정에서 백엔드 주소를 입력하고 ‘테스트 연결’으로 상태를 확인한 뒤 ‘백엔드로 동기화’/’백엔드에서 동기화’ 버튼으로 데이터를 전송합니다.

릴리스 에셋 원격 다운로드(aria2)

• aria2를 `–enable-rpc –rpc-listen-port=6800` 옵션으로 실행한 뒤, 설정의 네트워크-원격 다운로드 항목에서 호스트·포트·(선택) 시크릿을 입력하고 연결을 테스트합니다.
• 저장 후에는 릴리스 에셋 버튼이 aria2로 다운로드를 큐잉해 대용량 파일을 효율적으로 받을 수 있습니다.

GitHub Stars Manager는 무료인가요?

예, 본 프로젝트는 MIT 라이선스의 오픈소스 소프트웨어로 공식 저장소와 공식 사이트에서 무료로 내려받아 모든 기능을 자유롭게 사용할 수 있습니다.

클라우드 계정이 꼭 필요한가요?

별도의 클라우드 계정은 필요하지 않습니다. 데이터는 기본적으로 로컬에 저장되며, 기기 간 동기화가 필요할 때만 WebDAV 등 자가 호스팅 옵션을 선택적으로 켜면 됩니다.

어떤 운영체제에서 실행할 수 있나요?

공식 사이트에서는 Windows·macOS·Linux용 데스크톱 클라이언트 패키지를 제공하며, 그 외에도 자체 호스팅 웹 빌드와 Docker 이미지를 지원합니다.

AI 기능은 어떻게 설정하나요?

설정 패널의 AI 구성 항목에서 OpenAI·Anthropic Claude·Ollama 등 호환 제공자 중 하나를 선택하고 엔드포인트와 키를 입력한 뒤 모델을 고른 뒤 연결 테스트를 실행하면 됩니다.

백엔드 서버 없이도 작동하나요?

예, 순수 프런트엔드(localStorage) 모드만으로도 모든 핵심 기능을 사용할 수 있으며, 백엔드는 기기 간 동기화와 API 키 암호화 저장, CORS 우회 같은 추가 기능을 선택적으로 제공합니다.