Giới thiệu dự án
Kho tài nguyên mã nguồn mở Whale Girl là một website tài nguyên không chính thức do cộng đồng tự nguyện duy trì, tập hợp hình ảnh tham khảo nhân vật Whale Girl, prompt tạo ảnh, dự án cộng đồng, công cụ, tài liệu tham khảo, tác phẩm phái sinh và meme. Mục tiêu của dự án là hạ thấp rào cản tìm kiếm và chia sẻ tài nguyên, giúp nhà sáng tạo thực hiện các tác phẩm phái sinh thuận tiện hơn.
Dự án này không đại diện cho quan điểm chính thức của công ty DeepSeek hoặc DeepSeek. Whale Girl là một hình tượng do cộng đồng cùng sáng tạo và liên tục thay đổi; kho tài nguyên chỉ cung cấp tài liệu tham khảo, không đặt ra hình tượng nhân vật duy nhất hay tiêu chuẩn hóa.
Nếu chỉ muốn duyệt tài nguyên, bạn có thể truy cập trực tiếp website trực tuyến của kho tài nguyên mã nguồn mở Whale Girl. Để tìm hiểu bối cảnh dự án, hãy xem FAQ của dự án.
Nội dung và đặc điểm chính
- Tài liệu tham khảo sáng tác nhân vật: Tập hợp hình ảnh thiết lập nhân vật và các prompt tạo ảnh có thể sao chép, sử dụng trực tiếp.
- Điều hướng tài nguyên liên quan: Sắp xếp các dự án cộng đồng Whale Girl, công cụ sáng tác và tài liệu tham khảo.
- Thư viện tác phẩm cộng đồng: Trưng bày các tác phẩm phái sinh và meme do cộng đồng sáng tạo.
- Đóng góp dễ dàng: Người không biết lập trình cũng có thể gửi tác phẩm, đề xuất tài nguyên hoặc phản hồi vấn đề thông qua biểu mẫu GitHub.
- Cấu trúc website tĩnh: Các tệp mã nguồn website tập trung trong
site/, có thể xem trước cục bộ bằng dịch vụ HTTP Python đơn giản. - Tự động triển khai: Sau khi đẩy lên nhánh
main, GitHub Actions sẽ tự động triển khaisite/lên GitHub Pages.
Cách sử dụng trực tuyến
Bước 1: Truy cập website tài nguyên
Mở website trực tuyến để duyệt tài nguyên và thư viện cộng đồng trên trang chủ. Khi chỉ xem hoặc sao chép nội dung có sẵn, bạn không cần cài đặt phần mềm nào.
Bước 2: Tìm tài liệu tham khảo sáng tác
Xem hình ảnh thiết lập nhân vật và prompt tạo ảnh tùy theo nhu cầu sáng tác. Hình ảnh thiết lập phù hợp để quan sát các yếu tố của nhân vật, còn prompt có thể được sao chép trực tiếp rồi điều chỉnh theo mục tiêu sáng tác của bạn. Vì dự án không đặt ra hình tượng nhân vật duy nhất, hãy xem các tài liệu này là tài liệu tham khảo của cộng đồng, không phải quy chuẩn bắt buộc.
Bước 3: Kiểm tra giấy phép tài nguyên
Trước khi trích dẫn hoặc đăng lại hình ảnh, hãy kiểm tra ghi chú của tác giả và điều kiện cấp phép tương ứng với tài nguyên đó. Việc tài nguyên được đưa vào website không có nghĩa website sở hữu bản quyền, cũng không có nghĩa người sử dụng tự động được cấp quyền sử dụng lại.
Cài đặt và xem trước cục bộ
Đây là một website tĩnh, không cần cài đặt phụ thuộc phức tạp hay công cụ xây dựng. README yêu cầu môi trường cục bộ phải cài đặt Python 3.
1. Lấy tệp kho lưu trữ
Bạn có thể tải gói nén của kho lưu trữ từ GitHub hoặc sử dụng Git để sao chép dự án:
git clone https://github.com/TreapGoGo/deepseek-whale-girl.git
cd deepseek-whale-girl2. Khởi động máy chủ cục bộ
Thực hiện lệnh sau trong thư mục gốc của kho lưu trữ:
python -m http.server 4173 --directory siteLệnh này sử dụng máy chủ HTTP tích hợp của Python, đặt site/ làm thư mục website và lắng nghe trên cổng 4173 của máy cục bộ.
3. Mở trang xem trước
Sau khi máy chủ khởi động, truy cập địa chỉ sau bằng trình duyệt:
http://localhost:4173Sau khi chỉnh sửa tệp HTML, CSS hoặc JavaScript, hãy làm mới trình duyệt để xem kết quả. Khi hoàn tất xem trước, nhấn Ctrl+C trong cửa sổ dòng lệnh đang chạy máy chủ để dừng dịch vụ.
Giải thích cấu trúc kho lưu trữ
.
├── .github/
│ ├── ISSUE_TEMPLATE/
│ └── workflows/pages.yml
├── characters/
└── site/
├── assets/
├── index.html
├── project.html
├── contribute.html
├── styles.css
└── script.js.github/ISSUE_TEMPLATE/: Lưu các biểu mẫu dành cho tác phẩm cộng đồng, đề xuất tài nguyên và phản hồi..github/workflows/pages.yml: Định nghĩa quy trình tự động triển khai GitHub Pages.characters/: Lưu trữ bản lưu trữ gốc của hình ảnh thiết lập nhân vật và tài nguyên thương hiệu.site/assets/: Lưu hình ảnh website và tài nguyên thư viện cộng đồng.site/index.html: Trang chủ website và thư viện tài nguyên.site/project.html: Trang các câu hỏi thường gặp về dự án.site/contribute.html: Trang hướng dẫn đóng góp.site/styles.css: Kiểu dáng trang.site/script.js: Logic tương tác của trang.
Ví dụ chỉnh sửa cơ bản
Điều chỉnh nội dung trang
Nếu muốn chỉnh sửa văn bản trên trang chủ hoặc phần hiển thị tài nguyên, hãy bắt đầu từ site/index.html. FAQ và hướng dẫn đóng góp lần lượt nằm trong site/project.html và site/contribute.html.
- Chỉnh sửa tệp HTML mục tiêu.
- Nếu cần điều chỉnh kiểu dáng trực quan, sửa
site/styles.css. - Nếu cần điều chỉnh tương tác hiện có của trang, kiểm tra và sửa
site/script.js. - Khởi động máy chủ cục bộ bằng lệnh Python.
- Làm mới trình duyệt để kiểm tra bố cục, nội dung và liên kết.
Xử lý tài nguyên hình ảnh
Hình ảnh được sử dụng trên trang và tài nguyên thư viện cộng đồng nằm trong site/assets/. Bản lưu trữ gốc của hình ảnh thiết lập nhân vật và tài nguyên thương hiệu nằm trong characters/. Khi chỉnh sửa tham chiếu hình ảnh, cần đồng thời xác nhận đường dẫn tệp, thông tin nguồn và ghi chú cấp phép.
Đóng góp mà không cần lập trình
Dự án chuẩn bị các biểu mẫu GitHub Issue cho nhiều loại đóng góp khác nhau. Chọn đúng kênh tương ứng với nội dung sẽ giúp người duy trì xử lý nhanh hơn:
- Chia sẻ tác phẩm cộng đồng: Gửi tác phẩm phái sinh liên quan đến Whale Girl.
- Đề xuất tài nguyên liên quan: Đề xuất dự án, công cụ hoặc tài liệu tham khảo.
- Phản hồi, sửa lỗi hoặc bổ sung: Báo lỗi, đưa ra đề xuất hoặc liên hệ người duy trì để xử lý nội dung có khả năng vi phạm bản quyền.
Khi gửi, bạn nên nêu rõ tên, nguồn, tác giả và thông tin cấp phép của tác phẩm hoặc tài nguyên. Điều này giúp người duy trì dễ xác minh hơn, đồng thời giảm nguy cơ người dùng sau này hiểu sai phạm vi giấy phép.
Cải thiện website bằng Pull Request
Những người quen phát triển web có thể trực tiếp chỉnh sửa website và gửi Pull Request. Quy trình phù hợp gồm:
- Chỉnh sửa trang web, kiểu dáng hoặc tập lệnh trong
site/trên một nhánh riêng. - Chạy máy chủ HTTP cục bộ để xem trước kết quả chỉnh sửa.
- Kiểm tra cách hiển thị trang trên máy tính và các trình duyệt phổ biến.
- Kiểm tra lần lượt các liên kết được thêm hoặc chỉnh sửa.
- Nêu mục đích thay đổi, phạm vi ảnh hưởng và kết quả kiểm tra trong Pull Request.
Triển khai và mẹo nâng cao
Hiểu phạm vi tự động triển khai
Thư mục triển khai của dự án là site/. Khi các cập nhật được đẩy lên nhánh main, GitHub Actions sẽ tự động thực hiện triển khai GitHub Pages. Bạn cũng có thể vào trang Actions của kho lưu trữ để kích hoạt triển khai thủ công.
Nếu các tệp lưu trữ gốc nằm trong characters/ nhưng không được sao chép hoặc tham chiếu vào site/, không nên mặc định rằng chúng sẽ tự động xuất hiện trên website đã triển khai. Trước khi chỉnh sửa, cần phân biệt thư mục tài nguyên gốc với thư mục website thực tế.
Kiểm tra tối thiểu trước khi gửi
- Xác nhận trang chủ cục bộ có thể mở qua
http://localhost:4173. - Kiểm tra liên kết giữa trang chủ, FAQ và trang đóng góp.
- Xác nhận đường dẫn và tên tệp của hình ảnh mới thêm khớp nhau.
- Xác nhận tương tác của website không bị hỏng do chỉnh sửa JavaScript.
- Kiểm tra nguồn tài nguyên, ghi công tác giả và thông tin cấp phép.
- Giải thích lý do chỉnh sửa bằng thông điệp gửi rõ ràng.
Phân biệt các loại giấy phép
Mã nguồn website trong kho lưu trữ này sử dụng MIT License. Văn bản hướng dẫn do website tự sáng tác và prompt tạo ảnh sử dụng giấy phép chia sẻ CC BY-SA 4.0.
Hình ảnh thiết lập nhân vật, bài gửi của cộng đồng và tài nguyên từ các dự án bên ngoài không thuộc giấy phép mã nguồn nêu trên; chúng lần lượt tuân theo điều khoản cấp phép do tác giả hoặc nguồn cung cấp. Nếu một tệp có ghi chú cấp phép riêng, hãy ưu tiên ghi chú của tệp đó.
Không nên mặc định rằng một hình ảnh có thể tự do sao chép, chỉnh sửa hoặc sử dụng cho dự án khác chỉ vì nó xuất hiện trong kho lưu trữ hoặc website. Hãy xác minh giấy phép cụ thể trước khi sử dụng.
Tổng kết
Kho tài nguyên mã nguồn mở Whale Girl vừa là nơi tập trung tài liệu tham khảo nhân vật và prompt tạo ảnh, vừa là nền tảng chia sẻ tác phẩm, công cụ và tài liệu của cộng đồng. Người dùng thông thường có thể trực tiếp duyệt trực tuyến và đóng góp thông qua biểu mẫu; nhà phát triển chỉ cần chuẩn bị Python 3 là có thể xem trước và chỉnh sửa website tĩnh cục bộ. Dù tham gia theo cách nào, mọi người đều nên tôn trọng tính chất đồng sáng tạo của cộng đồng và cẩn thận xác minh bản quyền cũng như giấy phép của từng tài nguyên.