跳到主要内容
AI教程

鲸鱼娘开源资产库使用教程：浏览素材、本地预览与参与共建

本教程介绍鲸鱼娘开源资产库的内容、在线使用方法、本地预览流程、目录结构与贡献入口，并说明 GitHub Pages 部署及不同类型资源的许可注意事项。

AI我搜编辑部阅读约 7 分钟
鲸鱼娘开源资产库使用教程：浏览素材、本地预览与参与共建

项目简介

鲸鱼娘开源资产库是由社区自发维护的非官方资源网站，集中整理鲸鱼娘的角色参考图、生成提示词、社区项目、工具、参考资料、二创作品与梗图。它的目标是降低查找和分享资源的门槛，让创作者更方便地开展二次创作。

鲸鱼娘开源资产库展示图

该项目不代表深度求索公司或 DeepSeek 官方立场。鲸鱼娘是由社区共同创作、持续变化的形象，资源库仅提供参考，不设定唯一或标准化人设。

如果只想浏览资源，可以直接访问鲸鱼娘开源资产库在线网站。准备了解项目背景时，可查看项目 FAQ。

主要内容与特点

  • 角色创作参考：收录角色设定图以及可以直接复制使用的生成提示词。
  • 相关资源导航：整理鲸鱼娘社区项目、创作工具和参考资料。
  • 社区作品画廊：展示社区二创作品与梗图。
  • 低门槛贡献：非程序员也能通过 GitHub 表单投稿作品、推荐资源或反馈问题。
  • 静态网站结构：网站源文件集中在 site/，可通过简单的 Python HTTP 服务进行本地预览。
  • 自动部署：推送到 main 分支后，GitHub Actions 会把 site/ 自动部署到 GitHub Pages。

在线使用方法

第一步：进入资源网站

打开在线站点，浏览首页提供的资源与社区画廊。只查看或复制已有内容时，无需安装任何软件。

第二步：查找创作参考

根据创作需求查看角色设定图和生成提示词。设定图适合用于观察角色元素，提示词则可直接复制，再结合自己的创作目标进行调整。由于项目不设定唯一人设，使用这些资料时应将其视为社区参考，而不是强制规范。

第三步：核实素材许可

准备引用或再次发布图片前，应检查该素材对应的作者说明和授权条件。资源被网站收录，并不意味着网站拥有版权，也不代表使用者自动取得再次使用授权。

本地安装与预览

该项目是静态网站，不需要复杂的依赖安装或构建工具。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。

  1. 编辑目标 HTML 文件。
  2. 如需调整视觉样式，修改 site/styles.css。
  3. 如需调整已有页面交互，检查并修改 site/script.js。
  4. 使用 Python 命令启动本地服务器。
  5. 刷新浏览器，检查布局、内容与链接是否正常。

处理图片资源

页面使用的图片和社区画廊素材位于 site/assets/。角色设定图及品牌素材的原始归档则位于 characters/。修改图片引用时，应同时确认文件路径、来源信息与授权说明。

无需编程也能参与贡献

项目为不同类型的贡献准备了 GitHub Issue 表单。根据内容选择对应入口，可以帮助维护者更快处理：

提交时建议清楚说明作品或资源的名称、来源、作者以及授权信息。这样既方便维护者核实，也能降低后续使用者误解许可范围的风险。

通过 Pull Request 改进网站

熟悉网页开发的贡献者可以直接修改网站并提交 Pull Request。一个稳妥的流程如下：

  1. 在独立分支中修改 site/ 下的网页、样式或脚本。
  2. 运行本地 HTTP 服务器预览修改结果。
  3. 检查桌面和常用浏览器中的页面显示。
  4. 逐一验证新增或修改的链接。
  5. 在 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，即可在本地预览和修改静态网站。无论采用哪种方式参与，都应尊重社区共创属性，并认真核实每项素材的版权与许可。