lightapis / gfriends

媒体服务器演员头像仓库

女友头像仓库

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

目录

• 快速开始
  • Emby / Jellyfin
  • Plex
• 进阶说明
  • 导入本地头像图片到媒体服务器
  • 上传新的头像图片到仓库
  • 共享头像图片来源网站
  • 对女友仓库的开发及调用
  • 仓库更新计划
• 图片来源
• 法律信息

快速开始

对于一般用户来说，可以通过以下方案导入头像。

Emby / Jellyfin

无需下载本仓库的女友头像，仅需下载 Gfriends Inputer 一键导入工具，编辑 Config.ini 文件并运行程序。
该工具将自动从本仓库搜索头像并导入你的服务器。

或者试试安装插件导入？

由 JavScraper 提供

无需下载本仓库的女友头像，仅需为你的 Emby / Jellyfin 服务器安装 JavScraper 插件。
该插件将自动从本仓库搜索头像并导入你的服务器，亦提供了元数据刮削功能。

Plex

由 ddd354 提供

无需下载本仓库的女友头像，仅需为你的 Plex 服务器安装 JAVnfoMoviesImporter 插件。
该插件将自动从本仓库搜索头像并导入你的服务器，亦提供了元数据刮削功能。

进阶说明

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

推荐搭配任一刮削整理项目 AVDC(GUI)、JavScraper、JAVSDT、JAVOneStop。

导入本地头像图片到媒体服务器

Gfriends Inputer 已支持导入本地头像到媒体服务器。

导入工具首次启动时会自动创建 Avatar 文件夹（可在配置文件中修改）。将本地头像图片重命名为演员姓名.jpg，或将第三方头像包移动至该文件夹。此后，导入工具优先从该文件夹查找并导入头像，本地路径中不存在的则会尝试从本仓库搜索并导入。

上传新的头像图片到仓库

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

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

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

1. 轻击主仓库右上角 “Fork” 按钮，然后会自动克隆主仓库，并跳转到属于您的个人仓库。
2. 移步至个人仓库 “Content” 下的 “人工存储 HandStorage” 目录，该目录拥有最高优先级，能保证上传的图片被优先使用。
3. 轻击 “Add files” 菜单下的 “Upload files” 按钮，然后上传图片到仓库。在上传等待过程中，随便写一点 “Commit Changes” 说明，比如上传了哪些女友的图片，然后轻击 “Commit” 提交。
4. 进入 “Pull Requests” 发起新的合并请求，请同时勾选 “Allow edits by maintainers”。在经过审核后，您的美图就可以和大家分享了。

此外，如果您有大量的图片想要上传，则最好使用 Git 命令，也可以提交一个 issue 求助。

共享头像图片来源网站

首先，该优质网站上的图片除了满足上述条件，还应尽可能满足：每位女友只有一张或少量的图片，以避免二次人工筛选。

如果您有这样的来源网站，那就太完美了~ 您只需提交一个 issue 告诉我地址即可。

对女友仓库的开发及调用

请务必先阅读 法律信息及免责声明

1. Filetree.json 为 内容 Content 目录的 Json 文件树，在头像图片变化时将自动更新。该文件已按头像质量降序排列且已匹配多语言女友姓名，可供程序调用搜索。

2. 女友仓库通过 AI 移除违法头像（基于**大陆法律）至 回收站 Recycled 目录，如果想调用该目录的头像请自行遍历。下述仓库镜像中不包含此回收站目录。

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

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

仓库更新计划

✔ 自动定期抓取新入职女友头像至仓库（仅后述标注 🌟）
✔ 匹配简体中文 / 繁体中文 / 日文姓名
✔ 高斯模糊处理以匹配 Emby 的特殊尺寸（需使用 Gfriends Inputer 导入）
✔ AI 放大并优化低分辨率头像（仅后述标注 ➡）
✔ AI 鉴别并移除违法违规头像

图片来源

排序不分前后
标注🌟的图片为原生高质量大图，标注➡的图片为经过 AI 算法放大优化的图片。

第三方内容商

品牌	尺寸	数量	简介	备注
GRAPHIS	360×508	600+	著名的美女摄影写真机构	🌟
Juicy Honey	640×960	30+	X-City 旗下的写真分支	🌟
LovePop	384×576	70+	美少女写真摄影机构	🌟
FANZA	inconsistent	1.5W+	DMM官方	➡
Warashi	250×300	2800+	著名的演员资料数据库	➡ New Add!

品牌官方

品牌	尺寸	数量	旗下知名小姐姐	备注
S1 No. 1 Style	470×600	300+	三上悠亜、羽咲みはる、桜羽のどか、架乃ゆら	🌟 人气与美形著称
MUTEKI	640×906	50+	深山あすか、水瀬ちあき、松本菜奈実、夢川エマ	🌟
FaleNO	1500×2125	10+	桥本有菜、吉高寧々、美乃すずめ、佐藤ゆか	🌟 U-next 旗下公司
Attackers	216×270	1000+	明里つむぎ、岬ななみ、二宮ひかり、結城のの	➡432×540
Moodyz	230×300	1100+	高桥しょう子、西宫このみ、伊东ちなみ、千早希	➡460×600
Premium	208×276	100+	樱木凛、星野美优、冬月枫、二宫沙树	➡416×552
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	312×400	500+	Julia、红城まゆ、羽野理沙、蒂亚	➡624×800
Wanz Factory	280×280	200+	椎名そら、つぼみ、水野朝陽、浅井ルリ子	➡560×560
Honnaka 本中	335×375	300+	さわきりほ、さくらみゆき、つくしみか、あいだ飛鳥	➡670×750
kira☆kira	180×180	10+	加瀬エリナ、水谷心音、霧嶋りお、有村リア	➡360×360
BeFree	215×215	100+	つぼみ、浜崎真緒、安藤美奈子、坂口れな	➡430×430
痴女天堂	300×300	300+	大槻ひびき、沖田杏梨、大浦真奈美、渚みつき	➡600×600
Fitch	300×392	500+	春菜はな、美園和花、月森ゆの、河北はるな	➡600×786
Madonna	230×300	30+	美森けい、谷花紗耶、桜井ゆみ、今井ひまり	➡792×800
溜池ゴロー	100×100	500+	めぐり、本田岬、かすみ果穂、さとう遥希	MOODYZ 旗下公司 ➡400×400
Das!	280×280	300+	あべみかこ、冴月りん、跡美しゅり、一ノ瀬梓	➡560×560
ラグジュTV	116×236	900+	藤本ゆうり、美園和花、浜崎真緒、あやみ旬果	➡332×472

扫黄打非 · 净网2020

鉴于女友仓库目前受众多为**大陆地区用户，为积极配合**大陆地区相关部门开展专项行动，女友仓库将依托于 AI 技术，尽最大可能鉴别和删除违规头像。在此呼吁广大用户自觉守法、相互监督，共同打造绿色健康的网络环境。

投诉邮箱：gfriends#qxin.uu.me

法律信息及免责声明

1. 本项目作者旨在学习 Python 后端，提高编程水平。
2. 项目仅用于技术、学术交流，严禁用于商业和其他盈利目的。
3. 请自觉遵守当地法律法规，产生的一切后果由用户自行承担。
4. 头像图片版权归相应网站及演员所属经纪公司所有。
5. 作者保留最终决定权和最终解释权。

若您不同意上述任一条款，请勿直接或间接使用本项目。