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

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

• 快速开始
  • Emby / Jellyfin
  • Plex
• 进阶玩法
  • 手动搜索头像 (日文姓名)
  • 成为 Gfriends 女友头像仓库的贡献者
    • 上传新的头像到仓库
    • 开发及调用
  • 衍生项目
    • Gfriends Inputer
    • PornChecker
• 更新计划
• 图片来源
  • 第三方内容商
  • 经纪公司
  • 品牌官方
• 法律信息

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

1. Gfriends Inputer
由 Gfriends 提供

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

2. MDCx
由 Hermit 提供

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

1. JAVnfoMoviesImporter
由 ddd354 提供

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

2. JAV.bundle
由 Xavier-Lam 提供

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

推荐与 Gfriends Inputer 搭配刮削整理项目，神兵利器助您事半功倍。

Movie Data Capture、 AVDC GUI、 JAVSDT、 JAVOneStop、 Avutil

您知道其他相似的开源工具？欢迎提交 issues 告诉我。

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

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

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

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

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

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，您可以获得对应女友头像的下载链接。

这些值得留意：

1. Information 对象内字段依次为：头像总数量 TotalNum、头像大小之和 TotalSize、文件树完成生成的微秒级时间戳 Timestamp。
2. 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 目录，后述法律信息同样适用于此。

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

投诉邮箱：Gfriends#keemail.me

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

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