dw-dengwei/daily-arXiv-ai-enhanced

📚 daily‑arXiv‑ai‑enhanced가 하는 일

이 저장소는 서버 없이 GitHub만 사용하는 서비스로 매일 다음과 같은 작업을 수행합니다:

1. 크롤링 – 컴퓨터 과학 분야의 arXiv API에서 새로운 논문을 수집합니다 (기본값: CV, GR, CL, AI, CE, GT, IT, LG).
2. 초록(또는 전체 텍스트)을 대규모 언어 모델(LLM)에 전달합니다 – 기본 모델은 deepseek‑chat이며, 중국어 요약본을 반환합니다.
3. 결과를 GitHub Pages에서 호스팅하는 정적 웹사이트로 게시하여, 아무도 설치 없이 매일 요약본을 브라우저로 확인할 수 있도록 합니다.

이 프로젝트는 본질적으로 세 가지 기존 기술을 연결한 처리 파이프라인입니다:

• arXiv의 공개 RSS/JSON 피드를 통한 논문 메타데이터 제공,
• LLM API (DeepSeek, 또는 OpenAI 호환 엔드포인트라면 어떤 것도 가능),
• GitHub Actions + Pages를 통한 스케줄링 및 호스팅.

전체 워크플로우가 GitHub의 CI 환경에서 실행되므로, 서버나 스토리지 비용은 전혀 발생하지 않고, LLM 사용 비용만 발생합니다 (하루 약 0.2 CNY).

---

✨ 핵심 기능 (README에 설명된 내용)

기능	사용자에게 의미하는 바
영구적인 인프라 없음	VM, Docker, 클라우드 계정이 필요 없음 – 저장소를 포크하고 GitHub Actions 및 Pages를 활성화하기만 하면 됩니다.
AI 기반 요약	매일 논문은 DeepSeek(또는 사용자가 설정한 모델)에 의해 요약되며, 기본 출력 언어는 중국어입니다.
개인화된 읽기	로컬에 키워드/저자 목록을 저장할 수 있으며, UI는 관심 있는 논문을 강조 표시합니다.
다중 기기 UI	생성된 사이트는 데스크톱 및 모바일 브라우저에서 모두 작동합니다.
SKILL 시스템	사용자 정의 ‘스킬’ 모듈을 추가하여 논문 목록을 필터링하거나 변환할 수 있는 플러그인 스타일 메커니즘입니다.
내보낼 수 있는 설정	키워드/저자 설정을 한 번의 클릭으로 복사하여 SKILL 시스템과 공유하거나 재사용할 수 있습니다.
사용자 정의 가능	저장소 시크릿/변수를 수정하여 카테고리, 대상 언어, LLM 모델을 변경할 수 있으며, 비밀번호로 사이트를 보호할 수도 있습니다.

---

🛠️ 실행 방법 (빠른 시작)

1. 포크하기.
2. 두 가지 시크릿 추가: OPENAI_API_KEY (LLM 키) 및 OPENAI_BASE_URL (엔드포인트, 예: DeepSeek의 API URL).
3. (선택 사항) secrets.ACCESS_PASSWORD를 설정하여 공개 접근을 제한합니다.
4. 다음 변수 설정:
   • CATEGORIES – 관심 있는 arXiv 카테고리들 (쉼표로 구분).
   • LANGUAGE – Chinese 또는 English.
   • MODEL_NAME – 예: deepseek-chat.
   • EMAIL / NAME – 워크플로우에서 생성된 사이트를 커밋할 때 사용됩니다.
5. GitHub Actions 활성화하고 arXiv-daily-ai-enhanced 워크플로우를 한 번 실행합니다 (약 1시간 소요될 수 있음). 이후 실행은 매일 자동 스케줄링됩니다.
6. GitHub Pages를 켜고 (소스: main 브랜치, 루트), 몇 분 기다립니다. 사이트는 https://<your‑username>.github.io/daily-arXiv-ai-enhanced/에서 접근 가능합니다.
7. 사이트를 브라우저로 열고 설정 패널에서 키워드 설정을 조정한 후, 매일 AI 요약된 arXiv 요약본을 즐기세요.

---

🎯 누구에게 유용할까?

• 모든 초록을 읽지 않고도 새로운 논문을 빠르게 언어별로 요약해보고 싶은 연구자.
• 자신이 익숙한 언어로 최신 컴퓨터 과학 연구에 매일 노출되길 원하는 학생.
• 자체 호스팅 서버를 운영하지 않고도 정적 사이트 기반의 프라이버시 보호형 AI 요약을 선호하는 모든 사람.

---

📦 저장소 안에 있는 내용?

• .github/workflows/run.yml – arXiv 데이터를 가져오고, LLM을 호출하며, 마크다운 파일을 작성하는 스케줄된 액션.
• src/ (암시적) – API 호출, 프롬프트 구성, 결과 형식화를 처리하는 스크립트.
• buy-me-a-coffee/ – 기부 페이지용 작은 플레이스홀더.
• README.md – 지금 읽고 있는 문서입니다.
• 필터링, 강조 표시, 설정 내보내기 기능을 갖춘 최종 사이트를 렌더링하는 정적 자산 (HTML/CSS/JS).

---

⚠️ 법적/준수 참고 사항

README는 학술 데이터 검열이 있는 지역에 있는 사용자에게 콘텐츠를 검토하고, 중국에서 접근 가능한 진입점을 제거할 수 있도록 경고합니다. 재배포 시 원본 논문의 라이선스와 AI 생성 콘텐츠 관련 규정을 모두 준수해야 합니다.

---

요약하면: daily‑arXiv‑ai‑enhanced는 서버 관리나 호스팅 비용 없이, arXiv에서 새로운 논문을 자동으로 가져와 LLM으로 요약하고, 깔끔하고 검색 가능한 매일 요약본을 정적 사이트로 게시하는 가벼운 GitHub 전용 서비스입니다.