AI 튜토리얼

고래 소녀 오픈소스 리소스 라이브러리 사용 가이드: 자료 탐색, 로컬 미리보기 및 공동 구축 참여

이 가이드는 고래 소녀 오픈소스 리소스 라이브러리의 콘텐츠, 온라인 사용 방법, 로컬 미리보기 절차, 디렉터리 구조와 기여 방법을 소개하고, GitHub Pages 배포 및 리소스 유형별 라이선스 주의사항을 설명합니다.

2026년 9월 29일약 10분 소요

프로젝트 소개

고래 소녀 오픈소스 리소스 라이브러리는 커뮤니티가 자발적으로 유지 관리하는 비공식 리소스 웹사이트로, 고래 소녀 캐릭터 참고 이미지, 생성 프롬프트, 커뮤니티 프로젝트, 도구, 참고 자료, 2차 창작 작품과 밈 이미지를 한곳에 정리합니다. 이 프로젝트는 리소스를 찾고 공유하는 장벽을 낮춰 창작자가 2차 창작을 더 편리하게 진행할 수 있도록 하는 것을 목표로 합니다.

이 프로젝트는 DeepSeek 회사 또는 DeepSeek 공식 입장을 대표하지 않습니다. 고래 소녀는 커뮤니티가 함께 창작하고 계속 변화시키는 이미지이며, 리소스 라이브러리는 참고 자료만 제공하고 유일하거나 표준화된 캐릭터 설정을 정하지 않습니다.

리소스만 둘러보려면 고래 소녀 오픈소스 리소스 라이브러리 온라인 사이트에 바로 접속하면 됩니다. 프로젝트 배경을 알아보려면 프로젝트 FAQ를 확인할 수 있습니다.

주요 콘텐츠와 특징

캐릭터 창작 참고 자료: 캐릭터 설정 이미지와 바로 복사해 사용할 수 있는 생성 프롬프트를 수록합니다.
관련 리소스 안내: 고래 소녀 커뮤니티 프로젝트, 창작 도구와 참고 자료를 정리합니다.
커뮤니티 작품 갤러리: 커뮤니티 2차 창작 작품과 밈 이미지를 보여 줍니다.
낮은 진입 장벽의 기여 방식: 프로그래머가 아니어도 GitHub 양식을 통해 작품 제출, 리소스 추천 또는 문제 제보를 할 수 있습니다.
정적 웹사이트 구조: 웹사이트 소스 파일은 site/에 모여 있으며, 간단한 Python HTTP 서버로 로컬 미리보기를 실행할 수 있습니다.
자동 배포: main 브랜치에 푸시하면 GitHub Actions가 site/를 GitHub Pages에 자동으로 배포합니다.

온라인 사용 방법

1단계: 리소스 웹사이트 접속

온라인 사이트를 열고 홈페이지에서 제공하는 리소스와 커뮤니티 갤러리를 둘러봅니다. 기존 콘텐츠를 확인하거나 복사하기만 한다면 소프트웨어를 설치할 필요가 없습니다.

2단계: 창작 참고 자료 찾기

창작 목적에 따라 캐릭터 설정 이미지와 생성 프롬프트를 확인합니다. 설정 이미지는 캐릭터 요소를 관찰하는 데 적합하고, 프롬프트는 바로 복사한 뒤 자신의 창작 목표에 맞게 조정할 수 있습니다. 프로젝트는 유일한 캐릭터 설정을 정하지 않으므로, 이러한 자료는 강제 규범이 아닌 커뮤니티 참고 자료로 보아야 합니다.

3단계: 자료 라이선스 확인

이미지를 인용하거나 다시 게시하기 전에는 해당 자료의 작성자 설명과 이용 조건을 확인해야 합니다. 웹사이트에 리소스가 수록되어 있다고 해서 웹사이트가 저작권을 보유한다는 뜻은 아니며, 사용자가 자동으로 재사용 허가를 취득하는 것도 아닙니다.

로컬 설치 및 미리보기

이 프로젝트는 정적 웹사이트이므로 복잡한 의존성 설치나 빌드 도구가 필요하지 않습니다. README에는 로컬 환경에 Python 3을 설치해야 한다고 명시되어 있습니다.

1. 저장소 파일 가져오기

GitHub에서 저장소 압축 파일을 다운로드하거나 Git으로 프로젝트를 복제할 수 있습니다.

git clone https://github.com/TreapGoGo/deepseek-whale-girl.git
cd deepseek-whale-girl

2. 로컬 서버 시작

저장소 루트 디렉터리에서 다음 명령을 실행합니다.

python -m http.server 4173 --directory site

이 명령은 Python 내장 HTTP 서버를 사용해 site/를 웹사이트 디렉터리로 설정하고 로컬 컴퓨터의 4173 포트를 수신합니다.

3. 미리보기 페이지 열기

서버가 시작되면 브라우저에서 다음 주소에 접속합니다.

http://localhost:4173

HTML, CSS 또는 JavaScript 파일을 수정한 후 브라우저를 새로 고치면 변경 사항을 확인할 수 있습니다. 미리보기가 끝나면 서버를 실행 중인 터미널에서 Ctrl+C를 눌러 서비스를 중지합니다.

저장소 구조 설명

.
├── .github/
│   ├── ISSUE_TEMPLATE/
│   └── workflows/pages.yml
├── characters/
└── site/
    ├── assets/
    ├── index.html
    ├── project.html
    ├── contribute.html
    ├── styles.css
    └── script.js

.github/ISSUE_TEMPLATE/: 커뮤니티 작품, 리소스 추천 및 피드백 양식을 저장합니다.
.github/workflows/pages.yml: GitHub Pages 자동 배포 절차를 정의합니다.
characters/: 캐릭터 설정 이미지와 브랜드 자료의 원본 아카이브를 저장합니다.
site/assets/: 웹페이지 이미지와 커뮤니티 갤러리 자료를 저장합니다.
site/index.html: 웹사이트 홈페이지와 리소스 갤러리입니다.
site/project.html: 프로젝트 자주 묻는 질문 페이지입니다.
site/contribute.html: 기여 방법 안내 페이지입니다.
site/styles.css: 페이지 스타일입니다.
site/script.js: 페이지 상호작용 로직입니다.

기본 수정 예시

페이지 콘텐츠 수정

홈페이지의 텍스트나 리소스 표시를 수정하려면 site/index.html부터 확인합니다. FAQ와 기여 안내는 각각 site/project.html과 site/contribute.html에 있습니다.

수정할 HTML 파일을 편집합니다.
시각적 스타일을 조정해야 한다면 site/styles.css를 수정합니다.
기존 페이지의 상호작용을 조정해야 한다면 site/script.js를 확인하고 수정합니다.
Python 명령으로 로컬 서버를 시작합니다.
브라우저를 새로 고쳐 레이아웃, 콘텐츠와 링크가 정상인지 확인합니다.

이미지 리소스 처리

페이지에서 사용하는 이미지와 커뮤니티 갤러리 자료는 site/assets/에 있습니다. 캐릭터 설정 이미지와 브랜드 자료의 원본 아카이브는 characters/에 있습니다. 이미지 참조를 수정할 때는 파일 경로, 출처 정보와 이용 허가 내용을 함께 확인해야 합니다.

프로그래밍 없이도 기여하기

프로젝트는 다양한 유형의 기여를 위해 GitHub Issue 양식을 제공합니다. 내용에 맞는 입구를 선택하면 유지 관리자가 더 빠르게 처리할 수 있습니다.

커뮤니티 작품 공유: 고래 소녀 관련 2차 창작 작품을 제출합니다.
관련 리소스 추천: 프로젝트, 도구 또는 참고 자료를 추천합니다.
피드백, 오류 수정 또는 보충: 오류를 보고하고 제안하거나, 침해 가능성이 있는 콘텐츠 처리를 위해 유지 관리자에게 연락합니다.

제출할 때 작품이나 리소스의 이름, 출처, 작성자와 이용 허가 정보를 명확히 설명하는 것이 좋습니다. 이렇게 하면 유지 관리자가 확인하기 쉽고, 이후 사용자가 라이선스 범위를 잘못 이해할 위험도 줄일 수 있습니다.

Pull Request로 웹사이트 개선

웹 개발에 익숙한 기여자는 웹사이트를 직접 수정하고 Pull Request를 제출할 수 있습니다. 권장 절차는 다음과 같습니다.

독립 브랜치에서 site/ 아래의 웹페이지, 스타일 또는 스크립트를 수정합니다.
로컬 HTTP 서버를 실행해 수정 결과를 미리 봅니다.
데스크톱과 일반적으로 사용하는 브라우저에서 페이지 표시를 확인합니다.
새로 추가하거나 수정한 링크를 하나씩 검증합니다.
Pull Request에 변경 목적, 영향 범위와 확인 결과를 설명합니다.

배포 및 고급 팁

자동 배포 범위 이해

프로젝트의 배포 디렉터리는 site/입니다. 변경 사항을 main 브랜치에 푸시하면 GitHub Actions가 GitHub Pages 배포를 자동으로 실행합니다. 저장소의 Actions 페이지에서 배포를 수동으로 실행할 수도 있습니다.

원본 아카이브 파일이 characters/에 있지만 site/에 복사되거나 참조되지 않는다면, 배포된 웹사이트에 자동으로 표시된다고 가정해서는 안 됩니다. 수정하기 전에 원본 자료 디렉터리와 실제 웹사이트 디렉터리를 먼저 구분해야 합니다.

제출 전 최소 확인

로컬 홈페이지가 http://localhost:4173을 통해 열리는지 확인합니다.
홈페이지, FAQ와 기여 페이지 사이의 링크를 확인합니다.
새로 추가한 이미지 경로와 파일명이 일치하는지 확인합니다.
JavaScript 수정으로 웹페이지 상호작용이 작동하지 않게 되지 않았는지 확인합니다.
자료 출처, 작성자 표시와 라이선스 정보를 확인합니다.
변경 이유를 명확한 커밋 설명으로 작성합니다.

서로 다른 라이선스 구분

이 저장소의 웹사이트 소스 코드는 MIT License를 적용합니다. 웹사이트의 오리지널 설명 문구와 생성 프롬프트는 CC BY-SA 4.0으로 공유됩니다.

캐릭터 설정 이미지, 커뮤니티 제출물과 외부 프로젝트 자료는 위 코드 라이선스에 포함되지 않으며, 각각 작성자 또는 출처가 제공한 이용 허가 내용을 따릅니다. 특정 파일에 별도의 라이선스 안내가 있다면 해당 파일의 안내를 우선해야 합니다.

어떤 이미지가 저장소나 웹사이트에 있다는 이유만으로 자유롭게 복사, 수정하거나 다른 프로젝트에 사용할 수 있다고 가정하지 마세요. 사용하기 전에 구체적인 이용 허가를 확인해야 합니다.

정리

고래 소녀 오픈소스 리소스 라이브러리는 캐릭터 참고 자료와 생성 프롬프트를 모아 둔 입구인 동시에 커뮤니티 작품, 도구와 자료를 공유하는 플랫폼입니다. 일반 사용자는 온라인에서 바로 둘러보고 양식을 통해 기여할 수 있으며, 개발자는 Python 3만 준비하면 정적 웹사이트를 로컬에서 미리 보고 수정할 수 있습니다. 어떤 방식으로 참여하든 커뮤니티 공동 창작의 특성을 존중하고 각 자료의 저작권과 라이선스를 꼼꼼히 확인해야 합니다.