媒体服务器演员头像仓库。
旨在满足数量需求前提下，尽可能收集和处理高质量女友头像，并提供导入媒体服务器方案。
There is no correlation between this repo and Korean girl group GFRIEND.
已有多款软件使用女友仓库作为数据源。对于一般用户来说，无需手动下载头像，即可通过以下方案导入头像。
1. Gfriends Inputer
由 Gfriends 提供
官方维护的 Jellyfin/Emby 头像导入工具，兼容女友仓库所有特性，全平台支持。
2. MDCx
由 Hermit 提供
演化自 MDC 的图形化刮削软件，支持带桌面的 Windows 和 MacOS。
或者试试安装插件导入？
3. JavScraper
由 JavScraper 提供
一个 Jellyfin/Emby 的日本电影刮削器插件，Emby JAV 刮削器元老。
4. MetaTube
由 MetaTube 提供
另一个为 Jellyfin/Emby 开发的好用插件，插件前端与刮削器后端分离，上手稍难。
1. JAVnfoMoviesImporter
由 ddd354 提供
基于 XBMCnfoMoviesImporter 修改的插件，增加了女友头像功能。
2. JAV.bundle
由 Xavier-Lam 提供
受 JAVLibrary.bundle 启发而开发的新插件，亦提供了 JAV 元数据刮削功能。
推荐与 Gfriends Inputer 搭配刮削整理项目，神兵利器助您事半功倍。
Movie Data Capture、 AVDC GUI、 JAVSDT、 JAVOneStop、 Avutil
您知道其他相似的开源工具？欢迎提交 issues 告诉我。
本项目以抓取官方高质量大图为主要目标，头像图片为自动化抓取，部分人工筛选。
欢迎提交优质的演员头像图片或写真。以下条件应 尽可能 满足：
- 对应演员头像缺失或现有头像不堪入目。
- 新头像是以女友为主体的特写或近景、近似 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 告诉我她的日文姓名和别名。
您可以使用 文件检索 来搜索仓库中存储的头像文件，该功能仅支持日文名。
请务必先阅读 法律信息及免责声明；快速开始 所列出的工具均已开源，可供阁下在开发时参考。
位于根目录的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 目录是通过 AI 鉴别并移除的违法头像（基于中国大陆法律）。
文件树中不包含该目录，如有调用该目录需求请自行遍历。
鉴于 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+ | 宝生リリー、泉りおん、入江愛美、阿部乃みく | 🌟 专业企划制造商 |
| えむっ娘ラボ | 168×191 | 200+ | 有坂深雪、有村のぞみ、笹倉杏、上原亜衣 | ➡336×382 |
| OPPAI | 312×364 | 100+ | 浜崎真緒、成海さやか、美緒みくる、柊るい | ➡624×728 |
| E-BODY | 702x900 | 500+ | Julia、红城まゆ、羽野理沙、蒂亚 | 🌟 |
| Wanz Factory | 280×280 | 200+ | 椎名そら、つぼみ、水野朝陽、浅井ルリ子 | ➡560×560 |
| Honnaka 本中 |
335×375 | 300+ | さわきりほ、さくらみゆき、つくしみか、あいだ飛鳥 | ➡670×750 |
| kira☆kira | 180×180 | 170+ | 加瀬エリナ、水谷心音、霧嶋りお、有村リア | ➡360×360 |
| BeFree | 215×215 | 100+ | つぼみ、浜崎真緒、安藤美奈子、坂口れな | ➡430×430 |
| 痴女天堂 | 300×300 | 300+ | 大槻ひびき、沖田杏梨、大浦真奈美、渚みつき | ➡600×600 |
| Fitch | 300×392 | 500+ | 春菜はな、美園和花、月森ゆの、河北はるな | ➡600×786 |
| Madonna | 230×420 | 1700+ | 美森けい、谷花紗耶、桜井ゆみ、今井ひまり | 🌟 |
| 溜池ゴロー | 100×100 | 500+ | めぐり、本田岬、かすみ果穂、さとう遥希 | MOODYZ 旗下公司 ➡400×400 |
| Das! | 280×280 | 300+ | あべみかこ、冴月りん、跡美しゅり、一ノ瀬梓 | ➡560×560 |
| ラグジュTV | 116×236 | 900+ | 藤本ゆうり、美園和花、浜崎真緒、あやみ旬果 | ➡332×472 |
鉴于女友仓库目前受众多为中国大陆地区用户，为积极配合中国大陆地区相关部门开展专项行动，女友仓库将依托于 AI 技术，尽最大可能鉴别和删除违规头像。在此呼吁广大用户自觉守法、相互监督，共同打造绿色健康的网络环境。
投诉邮箱：Gfriends#keemail.me
- 本项目作者旨在学习 Python 后端，提高编程水平。
- 项目仅用于技术、学术交流，严禁用于商业和其他盈利目的。
- 请自觉遵守当地法律法规，产生的一切后果由用户自行承担。
- 头像图片版权归相应网站及演员所属经纪公司所有。
- 作者保留最终决定权和最终解释权。
若您不同意上述任一条款，请勿直接或间接使用本项目。