Gfriends 女友头像仓库

媒体服务器演员头像仓库。 旨在满足数量需求前提下，尽可能收集和处理高质量女友头像，并提供导入媒体服务器方案。

There is no correlation between this repo and Korean girl group GFRIEND.

快速开始

已有多款软件使用女友仓库作为数据源。对于一般用户来说，无需手动下载头像，即可通过以下方案导入头像。

Emby / Jellyfin

1. Gfriends Inputer 由 Gfriends 提供

官方维护的 Jellyfin/Emby 头像导入工具，兼容女友仓库所有特性，全平台支持。

2. MDCx 由 Hermit 提供

演化自 MDC 的图形化刮削软件，支持带桌面的 Windows 和 MacOS。

<details> <summary>或者试试安装插件导入？</summary>

3. JavScraper 由 JavScraper 提供

一个 Jellyfin/Emby 的日本电影刮削器插件，Emby JAV 刮削器元老。

4. MetaTube 由 MetaTube 提供

另一个为 Jellyfin/Emby 开发的好用插件，插件前端与刮削器后端分离，上手稍难。

</details>

Plex

1. JAVnfoMoviesImporter 由 ddd354 提供

基于 XBMCnfoMoviesImporter 修改的插件，增加了女友头像功能。

2. JAV.bundle 由 Xavier-Lam 提供

受 JAVLibrary.bundle 启发而开发的新插件，亦提供了 JAV 元数据刮削功能。

进阶说明

本项目以抓取官方高质量大图为主要目标，头像图片为自动化抓取，部分人工筛选。

上传新的头像图片到仓库

欢迎提交优质的演员头像图片或写真。以下条件应 尽可能 满足：

对应演员头像缺失或现有头像不堪入目。
新头像是以女友为主体的特写或近景、近似 3:2 的长宽比，且宽度宜在 300px 以上。

如果您的图片符合上述要求，则可以通过如下步骤上传图片：

轻击主仓库右上角 Fork 按钮，然后会自动克隆主仓库，并跳转到属于您的个人仓库。
移步至个人仓库 Content 下的 人工存储 HandStorage 目录，该目录拥有最高优先级，能保证上传的图片被优先使用。
轻击 Add files 菜单下的 Upload files 按钮，然后上传头像图片到仓库，图片应该以演员日文姓名.jpg来命名（请注意，仅支持jpg），女友仓库会自动匹配多语种姓名。在上传等待过程中，可以随便写一点 Commit Changes 说明，比如上传了哪些女友的图片。上传完成后轻击 Commit 提交。
进入 Pull Requests 板块下，点击 New Pull Requests 发起新的合并请求。稍等片刻，待仓库自动检查完成后，点击 Create Pull Requests 并轻击 Commit提交，请同时勾选 Allow edits by maintainers。
至此，在经过人工审核和文件树自动刷新后，您的美图就可以和大家分享了。

P.S. 如果您发现某些女友未自动匹配别名，请提交 issue 告诉我她的日文姓名和别名。 您可以使用文件检索来搜索仓库中存储的头像文件，该功能仅支持日文名。

对女友仓库的开发及调用

请务必先阅读法律信息及免责声明；快速开始所列出的工具均已开源，可供阁下在开发时参考。

【Json 文件树】

位于根目录的Filetree.json，是内容 Content 文件夹的文件树，在头像图片变化时自动更新，可供程序调用搜索。 P.S. 在请求头中开启 Gzip 压缩可以大幅减少下载文件树所需的流量

以下是文件树格式示例：

{
  "Information": {
    "TotalNum": "TotalNum",
    "TotalSize": "TotalSize",
    "Timestamp": "Timestamp"
  },
  "Content": {
    "CompanyNameA": {
      "ActorNameA.jpg": "ActorNameA.jpg?t=FileATimestamp",
      "ActorNameB.jpg": "ActorNameB.jpg?t=FileBTimestamp",
    },
    "CompanyNameB": {
      "ActorNameA.jpg": "ActorNameA.jpg?t=FileATimestamp",
      "ActorNameB.jpg": "ActorNameB.jpg?t=FileBTimestamp",
    },
}

通过拼接 URL，您可以获得对应女友头像的下载链接。

这些值得留意：

Information 对象内字段依次为：头像总数量 TotalNum、头像大小之和 TotalSize、文件树完成生成的微秒级时间戳 Timestamp。
Content 对象内字段按头像图片 质量升序 排列，参数 t 为头像文件更新时间的秒级时间戳 FileTimestamp。更多细节请继续往下阅读。

1. 多头像匹配

部分女友可能在多个厂牌下任职，亦或者参与过写真拍摄等，不排除同一位女友在仓库中存储了多张图片的情况。

{
  "Content": {
    "CompanyNameA": {
      "三上悠亚.jpg": "三上悠亚.jpg",
      "三上悠亚-1.jpg": "三上悠亚-1.jpg",
      "三上悠亚-2.jpg": "三上悠亚-2.jpg",
    },
    "CompanyNameB": {
      "三上悠亚.jpg": "三上悠亚.jpg",
      "三上悠亚-1.jpg": "三上悠亚-1.jpg",
    },
    "CompanyNameC": {
      "三上悠亚.jpg": "三上悠亚.jpg",
    },
}

2. 多姓名匹配

仓库已匹配女友的多语种姓名、艺名、片假名，甚至是素人佚名等别名。

但提请注意：无论何时，都应首先使用 主流艺名 为关键词进行搜索。

艺    名：妃月るい
简中译名：妃月由衣
繁中译名：紀月留衣
片 假 名：るいぺち
罗马拼音：Hiduki Rui、Rui Hiduki
素人佚名：Rui
曾 用 名：川島今日子、如月るい、日向美月、森平みさき、石原美紀、紀月るい

{
  "Content": {
    "CompanyNameA": {
      "妃月るい.jpg": "妃月るい.jpg",
      "妃月由衣.jpg": "妃月るい.jpg",
      "紀月留衣.jpg": "妃月るい.jpg",
      "るいぺち.jpg": "妃月るい.jpg",
      "Hiduki Rui.jpg": "妃月るい.jpg",
      "Rui Hiduki.jpg": "妃月るい.jpg",
      "川島今日子.jpg": "妃月るい.jpg",
      "如月るい.jpg": "妃月るい.jpg",
      "日向美月.jpg": "妃月るい.jpg",
      "森平みさき.jpg": "妃月るい.jpg",
      "石原美紀.jpg": "妃月るい.jpg",
      "紀月るい.jpg": "妃月るい.jpg",
}

3. AI 技术的应用

女友仓库通过 AI 鉴别并移除的违法头像，还会借助 AI 无损放大并优化的低质量头像图片、去除图片中的水印（如果有）。

{
  "Content": {
    "CompanyNameA": {
      "吉高寧々.jpg": "AI-Fix-吉高寧々.jpg",
}

女友仓库无法保证这些经优化的头像完美无瑕。若您不想调用获取到这些经 AI 优化的图片，只需删除文件树中的 AI-Fix- 前缀即可，仓库存储着未经 AI 处理的原始图片副本。

{
  "Content": {
    "CompanyNameA": {
      "吉高寧々.jpg": "吉高寧々.jpg",
}

【Recycled 回收站】

回收站 Recycled 目录是通过 AI 鉴别并移除的违法头像（基于中国大陆法律）。

文件树中不包含该目录，如有调用该目录需求请自行遍历。

【CDN 加速的镜像仓库】

鉴于 GitHub 在全球网络中的连通性不一，此全球可达的仓库镜像供阁下备用：https://cdn.jsdelivr.net/gh/xinxin8816/gfriends/

该链接仅供调用，无法使用浏览器直接访问

更新计划

女友仓库目前已趋于稳定，一段时间内不会有大型更新迭代。GfriendBot 将自动定期更新仓库内容。

✔ 自动定期抓取新入职女友头像至仓库（仅后述标注 🌟） ✔ 匹配多语种姓名（简体中文 / 繁体中文 / 日文） ✔ 匹配女友的多个艺名 ✔ AI 放大并优化低分辨率头像（仅后述标注 ➡） ✔ AI 鉴别并移除违法违规头像 ✔ AI 移除头像水印

图片来源

排序不分前后，表格更新可能滞后。 标注🌟的图片为原生高质量大图，标注➡的图片为经过 AI 算法放大优化的图片。 除下表外，仓库中还收录了热心网友提供或上传的头像，位于 人工存储 HandStorage 目录，后述法律信息同样适用于此。

第三方内容商

| 品牌 | 尺寸 |数量|简介|备注| | :----: | :----: | :----: | :----: | :----: | | GRAPHIS | 360×508 | 600+ | 知名的美女摄影写真机构 | 🌟 | | Juicy Honey | 640×960 | 30+ | X-City 旗下的写真分支 | 🌟 | | LovePop | 384×576 | 70+ | 美少女写真摄影机构 | 🌟 | | FANZA | inconsistent | 15,000+ | FANZA 官方（原DMM） | ➡ | | Warashi | 250×300 | 2800+ | 来自法国的演员数据库 | ➡ | | Javrave | inconsistent | 6800+ | 知名的演员资料数据库 | ➡ | | Nanairo | 400×400 | 700+ | S-cute 旗下流媒体 | 🌟 | | AVDBS | 380×460 | 800+ | 来自韩国的演员数据库 | ➡ | | Derekhsu | inconsistent | 3700+ | 来自中国台湾的演员维基 | | | Minnano | inconsistent | 19,000+ | 来自日本的信息交流站 | ➡ New Add! | | DigiGra | 380x576 | 750+ | ImageBox 旗下流媒体 | 🌟 New Add! |

经纪公司

| 品牌 | 尺寸 |数量|旗下知名小姐姐|备注| | :----: | :----: | :----: | :----: | :----: | | Diaz Group | 2880×1800 | 10+ | 友田彩也香、東凛、卯水咲流、長瀬麻美 | 🌟 New Add!| | T-powers | 948×948 | 130+ | 天海つばさ、野々浦暖、河合あすな、结城のの | 🌟 New Add! 最大的女友经纪公司| | Bambi | 500×500 | 30+ | 星奈あい、藍芽みずき、西村ニーナ、天音ゆい | 🌟 New Add!| | Eightman | 600×800 | 50+ | 葵つかさ、吉高寧々、七海ティナ、つばさ舞 | 🌟 New Add! 位于关西的事务所| | Mine's | 300×300 | 40+ | 明里ともか、朝倉ここな、あさみ潤、幾田まち | 🌟 New Add!| | C-more | 1920×1080 | 30+ | JULIA、明里つむぎ、本庄鈴、桐谷まつり | 🌟 New Add!| | Arrows | 720×1000 | 10+ | 松本いちか、七嶋舞、今井夏帆、月野かすみ | 🌟 New Add!| | Capsule | 1920×2560 | 30+ | 七沢みあ、香坂紗梨、稲森美優、結菜さき | 🌟 New Add!| | AllPro | inconsistent | 30+ | 佐知子、八乃つばさ、加藤ツバキ、夏川うみ | 🌟 New Add! AllGroup 旗下企业| | Attractive | inconsistent | 20+ | 永瀬ゆい、楓ふうあ、葵いぶき、皆瀬あかり | 🌟 New Add!|

品牌官方

| 品牌 | 尺寸 |数量|旗下知名小姐姐|备注| | :----: | :----: | :----: | :----: | :----: | | S1 No. 1 Style | 470×600 |300+|三上悠亜、羽咲みはる、桜羽のどか、架乃ゆら|🌟 人气与美形著称| | MUTEKI | 640×906|50+|深山あすか、水瀬ちあき、松本菜奈実、夢川エマ|🌟| | FaleNO | 1500×2125 |10+|桥本有菜、吉高寧々、美乃すずめ、佐藤ゆか|🌟 AllPro 旗下公司| | Dahlia | 1500×2125 |10+|水川潤、徳永しおり、月見伊織、本田もも|🌟 New Add! FaleNO 旗下品牌| | Attackers | 216×270|1000+|明里つむぎ、岬ななみ、二宮ひかり、結城のの|➡432×540| | Moodyz | 600x783 |1300+|高桥しょう子、西宫このみ、伊东ちなみ、千早希|🌟| | Premium | 544x724 |100+|樱木凛、星野美优、冬月枫、二宫沙树|🌟| | Idea Pocket | 300×300 |100+|天海つばさ、相沢みなみ、桃乃木かな、希崎ジェシカ|➡600×600| | KM Produce | 330×330|10+|川上优、麻生岬、麻仓忧、神咲诗织|➡660×660| | kawaii* | 640×896|300+|ひなみちゃん、伊藤舞雪、宇佐木あいか、有栖るる|🌟| | Prestige 蚊香社 | 119×170|200+|永瀬みなも、有村のぞみ、園田みおん、藤江史帆|绝对美少女制造商 ➡476×680| | 未満 |290×390|100+|あやみ旬果、さくらゆら、高岡美鈴、高梨ゆあ|➡580×780| | 无垢 |110×70|300+|河南実里、高杉麻里、本橋実来、大島美緒|➡440×280| | 桃太郎映像 |451×600 | 200+ |宝生リリー、泉りおん、入江愛美、阿部乃みく|🌟 专业企划制造商| | [えむっ娘ラボ](http://www.mko-labo.

Gfriends

Install / Use

README