プロジェクト概要
鯨娘オープンソース素材ライブラリは、コミュニティが自主的に運営する非公式のリソースサイトです。鯨娘のキャラクター参考画像、生成プロンプト、コミュニティプロジェクト、ツール、参考資料、二次創作作品、ミーム画像をまとめて掲載しています。検索や素材共有のハードルを下げ、クリエイターが二次創作に取り組みやすくすることを目的としています。
本プロジェクトは、深度求索社またはDeepSeek公式の立場を代表するものではありません。鯨娘はコミュニティによって共同制作され、継続的に変化しているキャラクターです。本ライブラリは参考情報を提供するものであり、唯一または標準化されたキャラクター設定を定めるものではありません。
素材を閲覧するだけなら、鯨娘オープンソース素材ライブラリのオンラインサイトに直接アクセスできます。プロジェクトの背景を確認したい場合は、プロジェクトFAQをご覧ください。
主な内容と特徴
- キャラクター制作の参考：キャラクター設定画像と、そのままコピーして使える生成プロンプトを収録しています。
- 関連リソースの案内：鯨娘コミュニティのプロジェクト、制作ツール、参考資料を整理しています。
- コミュニティ作品ギャラリー：コミュニティの二次創作作品やミーム画像を展示しています。
- 簡単に貢献可能：プログラマーでなくても、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-girl2. ローカルサーバーを起動する
リポジトリのルートディレクトリで次のコマンドを実行します。
python -m http.server 4173 --directory siteこのコマンドはPython内蔵のHTTPサーバーを使用し、site/をサイトディレクトリとして設定して、ローカルの4173ポートで待ち受けます。
3. プレビューページを開く
サーバー起動後、ブラウザーで次のURLにアクセスします。
http://localhost:4173HTML、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フォームを用意しています。内容に合った入口を選ぶことで、メンテナーがより迅速に対応できます。
- コミュニティ作品を共有：鯨娘に関連する二次創作作品を投稿します。
- 関連リソースを推薦：プロジェクト、ツール、参考資料を推薦します。
- フィードバック、誤りの報告、情報の補足：誤りを報告したり、提案をしたり、権利侵害の可能性がある内容についてメンテナーに連絡したりします。
投稿時には、作品やリソースの名称、出典、作者、許諾情報を明確に記載することをおすすめします。これによりメンテナーが確認しやすくなり、後の利用者がライセンス範囲を誤解するリスクも減らせます。
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を用意するだけで、静的サイトをローカルでプレビューして変更できます。どのような形で参加する場合でも、コミュニティによる共同制作という性質を尊重し、各素材の著作権とライセンスを慎重に確認してください。