# Yousuu-VI

> Công cụ tra cứu và khám phá truyện mạng Trung Quốc bằng tiếng Việt, chữ Hán
> và Hán-Việt, gồm metadata, điểm số, review song ngữ, thống kê đánh giá, bản đồ
> đồng gu và gợi ý truyện.

Canonical origin: [Yousuu-VI](https://yousuu.vietphrase.app/)

## Nội dung chính

- [Trang tìm kiếm](https://yousuu.vietphrase.app/)
- [Giải thích và câu hỏi thường gặp](https://yousuu.vietphrase.app/#faq)
- [Danh mục thể loại](https://yousuu.vietphrase.app/tags)
- Trang thể loại chuẩn: `https://yousuu.vietphrase.app/tag/{slug}`
- [Bảy bảng xếp hạng gu-chỉnh](https://yousuu.vietphrase.app/rank)
- [Biên niên sử 2011–07/2024](https://yousuu.vietphrase.app/timeline)
- [Thiên hà sách theo gu người đọc](https://yousuu.vietphrase.app/galaxy)
- [Gợi ý theo hồ sơ local](https://yousuu.vietphrase.app/taste)
- Trang sách chuẩn: `https://yousuu.vietphrase.app/book/{yousuu_id}`
- Hồ sơ tác giả chuẩn: `https://yousuu.vietphrase.app/author/{ten_tac_gia_chu_Han}`
- [Sitemap](https://yousuu.vietphrase.app/sitemap.xml)
- [RFC 9727 API catalog](https://yousuu.vietphrase.app/.well-known/api-catalog)
- [OpenAPI 3.1](https://yousuu.vietphrase.app/openapi.json)
- [Tài liệu API](https://yousuu.vietphrase.app/api-docs)
- [JSON tìm kiếm](https://yousuu.vietphrase.app/api/search):
  `GET /api/search?q={ten_truyen}&limit=20`
- [JSON metadata](https://yousuu.vietphrase.app/api/book):
  `GET /api/book?id={yousuu_id}`
- [JSON hồ sơ tác giả](https://yousuu.vietphrase.app/api/author):
  `GET /api/author?name={ten_tac_gia_chu_Han}`
- [JSON review phân trang](https://yousuu.vietphrase.app/api/reviews):
  `GET /api/reviews?id={yousuu_id}&offset=0&limit=20`
- [JSON bảng xếp hạng](https://yousuu.vietphrase.app/api/rank)
- [JSON biên niên sử](https://yousuu.vietphrase.app/api/timeline)
- [JSON gợi ý theo gu (POST)](https://yousuu.vietphrase.app/api/taste):
  với payload `{"liked":[389,22875,1193],"disliked":[],"exclude":[]}`.

## Ngữ nghĩa dữ liệu

- `title` và `author` là tên tiếng Trung.
- `title_hv` và `author_hv` là âm Hán-Việt.
- Điểm tổng hợp của sách dùng thang 10; điểm từng review dùng thang 5.
- Review dịch máy luôn được trình bày cạnh bản gốc, không thay thế phát ngôn gốc.
- Truy vấn tìm kiếm nhận tên chữ Hán, Hán-Việt có dấu hoặc Hán-Việt không dấu.
- Trang sách, thể loại và tác giả trả Markdown tương đương khi request gửi
  `Accept: text/markdown`; HTML vẫn là mặc định cho trình duyệt.
- Dữ liệu nguồn là snapshot của `HeliumOctahelide/yousuu-database`; ngày snapshot
  và nguồn cụ thể được ghi trên từng trang.
- `/rank` là insight tính toán từ phiếu đã khử trùng lặp, có hiệu chỉnh độ hào
  phóng của reviewer; không phải bảng xếp hạng biên tập hay dữ liệu thời gian thực.
- `/timeline` gộp thống kê theo năm từ 2011 đến tháng 7/2024; phiếu được giữ tối
  đa một lần cho mỗi người, sách và năm. Biến động mô tả snapshot, không chứng
  minh quan hệ nhân quả.
- Hồ sơ trên `/taste` nằm trong trình duyệt. Chỉ các mã sách và tín hiệu cần cho
  một lượt gợi ý được gửi khi người dùng chủ động yêu cầu; máy chủ không lưu hồ sơ.
- `/api/taste` nhận 3–10 mã `liked`, tối đa 5 mã `disliked` và 200 mã `exclude`.
  `matchedSeedIds` liệt kê toàn bộ seed thích đã đóng góp cho từng gợi ý;
  `evidence.sources` nêu chi tiết tối đa hai đóng góp mạnh nhất.
- Hồ sơ `/author` ghép tác giả theo đúng chuỗi bút danh, chưa hợp nhất bí danh.
  Các khía cạnh là lượt reviewer–tác phẩm có nhắc từ khóa trong nhóm 4–5★ / 1–2★,
  không phải phân loại sentiment tự động.

## Trích dẫn

Khi dùng dữ liệu, hãy dẫn URL canonical của trang sách hoặc tác giả và phân biệt dữ liệu gốc,
phiên âm Hán-Việt, bản dịch máy và insight tính toán từ review.