1499 张 AI 人脸参考图的纯静态图库：零依赖、零构建，可完全离线运行，支持搜索、收藏、上传自己的图与一键生成人像提示词。
在线演示： https://atom-kkk.github.io/AI-Face-Resource-Library/
原图库： https://ai-portrait-gallery.pages.dev/（AIモデル顔データベース）
PNG 原图打包： https://pan.quark.cn/s/3c15a8a8a96f（1499 张 1122×1402 / 1597×2000 无损，无需提取码）
原作者： あぎ · @agi_aibusi
本仓库： 在原站基础上的中文汉化 + 素材本地化 + 功能增强版
原站是一套面向 AI 绘画与视频制作的人脸参考素材库：想在多张图、多段视频里保持同一个人，就得反复拿同一张正面脸当参考。它把素材分成两类——正面且纯色背景的「人脸」，以及带服装与完整氛围的「造型」，以 CC0 发布。
原站只有日文界面、图片走外链、没有搜索也没有收藏，翻到第几十张就找不回刚才那张。本项目在保留原站全部素材与视觉风格的前提下，做成一个可以长期自己用下去的工具：
- 全站汉化 —— 界面文案、4 类发长、50 条发型风格描述全部译成中文，搜索也支持中文（
空气刘海、狼尾、挑染）。 - 素材完全本地化 —— 1499 张缩略图（400×500 WebP，30 MB）与 1499 张原图（PNG，4.53 GB）全部落在
assets/，字体也镜像到fonts/，断网、无 CDN 也能正常浏览与下载。 - 能找得到 —— 编号 / 发长 / 风格多词搜索、发长筛选、风格快筛、四种排序、收藏夹。
- 能往里加东西 —— 上传自己的人脸图（拖拽/多选），指定分区、发长与风格，编号自动续号，存浏览器本地。
- 能直接产出提示词 —— 点开任意一张图，点「生成」即调用 DeepSeek 写一条同款人脸的英文文生图提示词，可改、可复制、自动保存。
- 零门槛运行 —— 三个文件，双击
index.html就能用；也能扔到任意静态托管上。
原站 AIモデル顔データベース |
本项目 | |
|---|---|---|
| 界面语言 | 日文 | 中文全汉化 |
| 技术栈 | 单页 HTML + 外链 CSS/JS | 单页 HTML + 本地 CSS/JS，零依赖 |
| 图片 | 站内相对路径（需连原站） | 全部本地（缩略图 + 4.53 GB 原图） |
| 字体 | Google Fonts CDN | 本地镜像（10 MB，离线可用） |
| 搜索 | ✗ | ✓ 编号 / 发长 / 风格，多词 AND，中英文 |
| 收藏 | ✗ | ✓ 星标 + 收藏页签 |
| 上传自己的图 | ✗ | ✓ 拖拽/多选，存浏览器 IndexedDB |
| AI 提示词 | ✗ | ✓ DeepSeek，可改可存 |
| 深浅色 | 仅跟随系统 | ✓ 跟随系统 + 手动切换 |
| 打开方式 | 需联网 | 双击 file:// 即可 |
- 三个分区页签：正面人脸 893 张、造型 606 张、收藏
- 搜索框支持编号（
f71f980）、发长（短发）、风格词（空气刘海），空格分隔表示「同时满足」 - 发长筛选与风格快筛（波波头 / 狼尾 / 空气刘海 / 挑染 / 米色…）可叠加，标签上带实时计数
- 排序：默认顺序、按编号、按文件大小、最近上传优先
- 每批 120 张，滚到底自动追加；「加载更多」显示剩余数量
- 「随机」按钮：灵感枯竭时随便抽一张
- 先出缩略图占位，原图解码完成后无缝替换
- 右侧信息面板：编号、分区、发长、风格、分辨率、原图体积、在列表中的位置
←→切换、Esc关闭、关闭后焦点回到原卡片- 一键下载原图 PNG、复制编号、收藏
- 「＋ 上传我的图」支持拖拽或选择文件，多选，JPG / PNG / WebP / HEIC 均可
- 每张必须选分区 + 发长 + 填风格，缺失时不允许保存
- 自动生成 400×500 缩略图（canvas → WebP），原图单独保存
- 编号从
M-0001自动续号，删除后不回退、不重号 - 上传的图可删除；内置的 1499 张只读
- 按该图的发长 + 风格写一条 60–90 词的英文提示词，覆盖脸型、五官、肤质、发型、妆容、光线、镜头、画质
- 提示词可手动修改、复制、自动保存；已有提示词的卡片左下角有
AI角标 - 提示词模板（system prompt）可自行改写，固化自己的出图风格
| 分区 | 短发 | 中短发 | 中长发 | 长发 | 合计 |
|---|---|---|---|---|---|
正面人脸 face |
433 | 229 | 154 | 77 | 893 |
造型 styling |
294 | 147 | 106 | 59 | 606 |
| 合计 | 727 | 376 | 260 | 136 | 1499 |
发型风格共 50 条（如「收颈短发（后颈偏长・空气刘海）」「长狼尾（水母头）」），原图尺寸为 1122×1402（879 张）、1597×2000（600 张）等，平均 3.09 MB。
.
├── index.html # 页面结构（约 16 KB）
├── assets/
│ ├── app.js # 全部交互逻辑（约 40 KB，无依赖）
│ ├── data.js # 1499 条内置数据（约 128 KB）
│ ├── style.css # 样式（约 24 KB）
│ ├── fonts.css # 本地字体声明（499 条 @font-face，约 534 KB）
│ ├── thumb/ # 缩略图 400×500 WebP，1499 张，约 30 MB
│ └── full/ # 原图 PNG，1499 张，约 4.53 GB —— 本地镜像，已 gitignore
├── fonts/ # Noto Serif SC / Noto Sans SC / Cormorant Garamond，约 10 MB
├── scripts/
│ ├── build-data.py # 从日文数据生成 assets/data.js（含中文词表）
│ └── fetch-fonts.py # 镜像 Google Fonts 到本地
├── NOTICE-IMAGES.md # 图片权利与来源说明（图片不随代码以 MIT 授权）
├── LICENSE # 代码：MIT
└── README.md
内置数据在 assets/data.js，为了体积用了短字段名：
window.FACE_SECTIONS = [ { key:"face", name:"正面人脸", … }, { key:"styling", name:"造型", … } ];
window.FACE_LENGTHS = ["短发", "中短发", "中长发", "长发"];
window.FACE_ITEMS = [
{ i:"f71f980dde3", s:0, l:0, t:"收颈短发（后颈偏长・空气刘海）", w:1122, h:1402, b:1895954 },
/* … */
];| 字段 | 示例 | 说明 |
|---|---|---|
i |
f71f980dde3 |
编号 = 原站文件名，缩略图 assets/thumb/<i>.webp、原图 assets/full/<i>.png |
s |
0 / 1 |
分区：0 正面人脸，1 造型 |
l |
0–3 |
发长索引，对应 FACE_LENGTHS |
t |
收颈短发（…） |
中文风格描述，空串表示该图没有细分类 |
w / h |
1122 / 1402 |
原图尺寸 |
b |
1895954 |
原图字节数，用于显示体积与按大小排序 |
上传的图片不在这个数组里，而是存浏览器（见下一节），加载时合并进 ITEMS 并带 local 标记。
上传的图片、收藏、提示词、AI 设置全部只存在你的浏览器，不上传任何服务器：
| 位置 | 键名 / 库 | 内容 |
|---|---|---|
| IndexedDB | face-library → store items |
上传图的原图 Blob + 缩略图 Blob 与元数据 |
| localStorage | face.local |
IndexedDB 不可用时的降级存储（dataURL） |
| localStorage | face.fav |
收藏的编号数组 |
| localStorage | face.prompts |
{ 编号: 提示词 } |
| localStorage | face.ai |
DeepSeek Key / 接口地址 / 模型 / 模板 |
| localStorage | face.seq |
上传图的编号计数器 |
| localStorage | face.theme |
深浅色偏好 |
彻底清空：浏览器开发者工具 → Application → 清除本站点的 IndexedDB 与 Local Storage。
Key 的安全：DeepSeek API Key 以明文存在
localStorage，只在你点「生成」时随请求发往你填的接口地址。公共电脑上不要填。
方式一：直接双击
打开 index.html 即可，无需服务器、无需联网（AI 功能除外）。file:// 下 Chrome 会禁用 IndexedDB，上传的图会自动改存 localStorage（容量约 5 MB，够存几张）。
方式二：本地静态服务器（推荐）
cd ai-face-library-zh
python3 -m http.server 8080
# http://localhost:8080
⚠️ file://和http://localhost是不同来源，IndexedDB / localStorage 互不相通。上传过图片后请固定用同一种方式打开，否则会出现「之前上传的图不见了」。
纯静态文件，扔哪都能跑：
| 平台 | 做法 |
|---|---|
| 任意静态托管 | 上传全部文件，入口 index.html |
| GitHub Pages | 已配好：.github/workflows/pages.yml 推送 main 即自动部署（build_type: workflow） |
| Cloudflare Pages / Vercel / Netlify | 构建命令留空，输出目录 / |
| 内网 / NAS | 放进 Web 目录即可 |
仓库含 assets/full/ 约 4.5 GB，克隆与上传都很难受，所以它在 .gitignore 里。没有 assets/full/ 时页面依然能正常浏览，只是卡片与灯箱的下载按钮会自动改指向原站（启动时用一次 HEAD 探测）。
- 点右上「AI 设置」，填 platform.deepseek.com 申请的 API Key，点「保存设置」→「测试连接」。
- 接口地址默认
https://api.deepseek.com（OpenAI 兼容，路径/chat/completions），模型默认deepseek-chat，也可填其他兼容服务。 - 点开任意图片 → 右侧「AI 人像提示词」→「生成」。
默认模板要求模型：只写画面本身（脸型五官 / 肤质 / 发型细节 / 妆容 / 光线 / 镜头构图 / 画质）、正面纯色背景半身像、60–90 个英文词、逗号短语、不要解释与负面词。想换成特写 / 侧脸 / 胶片风，直接在设置里改模板，{{len}} 与 {{style}} 会被替换成该图的发长与风格。
费用按 token 计，单张约几百 tokens，建议先拿几张试。
- 与原站 1440×2400 首屏截图做像素比对，网格、灯箱、排行榜、筛选条全部对齐；差异集中在字体渲染（日文字体 → 中文字体），非布局差异。
- 端到端验证过：搜索（
空气刘海→ 84 张）、风格快筛（狼尾→ 41 张）、排序、加载更多（120 → 240）、随机、键盘翻页、收藏、上传（存 IndexedDB → 刷新仍在）、删除、file://打开。
| 层级 | 尺寸 | 本地化 | 体积 |
|---|---|---|---|
缩略图 assets/thumb/ |
400×500 WebP | ✅ 1499/1499 | 约 30 MB |
原图 assets/full/ |
1122×1402 / 1597×2000 PNG | 🟡 本地镜像，未入 git | 约 4.53 GB（每张约 3.09 MB） |
原图怎么补回来？
assets/full/ 合计 4.53 GB，塞进 git 会让克隆、拉取和静态托管都很难受，所以走 .gitignore，不随仓库分发。三条路：
① 网盘直接下（最省事） —— https://pan.quark.cn/s/3c15a8a8a96f 1499 张无损 PNG 打包，无需提取码。解压后整个文件夹丢进 assets/full/ 即可。
② 从原站按编号拉 —— https://ai-portrait-gallery.pages.dev/img/full/<编号>.png，编号清单就是 assets/data.js 里的 i 字段。
③ 已有文件直接拷 —— 文件名保持 <编号>.png（如 f71f980dde3.png）即可。
放进去后不需要改代码，刷新即可；启动时的 HEAD 探测会自动把下载按钮切回本地 PNG。
图片权利归原作者，本仓库与脚本仅作个人备份与学习用途。
上传的图刷新后不见了？
换过打开方式（file:// ↔ http://localhost），两者存储隔离；也可能是清过浏览器数据。
file:// 下上传提示存不下？
该环境禁用了 IndexedDB，走了 localStorage 兜底，容量只有 5 MB 左右。起一个本地服务器即可正常存。
点生成提示词报 HTTP 401？
Key 无效或余额不足；重新填一份，再点「测试连接」。
提示「网络或跨域请求失败」？ 接口地址填错、网络不通，或换成了不支持浏览器跨域的第三方服务。
下载按钮提示「下载原图（原站）」？
说明本地没有 assets/full/，页面自动回退到原站下载（需联网）。按上一节把 PNG 放回去即可。
为什么有些图没有风格名？ 原站数据里有 755 张只标了发长、没有细分风格，这里如实保留，显示为「—」。
- 图片与原始数据的著作权归原作者 あぎ（@agi_aibusi）所有，来源为
AIモデル顔データベース（https://ai-portrait-gallery.pages.dev/），以 CC0 1.0 发布，可商用、可编辑、可作参考，署名非必需。 - 画面中人物均为 AI 生成的虚构人物，不存在对应真人；不得用于冒充真实人物或违反公序良俗的用途。
- 本仓库对图片不主张任何权利；若原作者认为有不妥，请联系删除。
- 中文界面体例与工程做法参考了同作者的另一个项目 AI-Clothing-Resource-Library（单文件、素材全本地、可上传、AI 提示词）。
- 代码（
index.html、assets/app.js、assets/style.css等）以 MIT 授权，见 LICENSE；该协议不覆盖assets/与fonts/里的素材，详见 NOTICE-IMAGES.md。
- 2026-10 全站汉化：界面文案、4 类发长、50 条发型风格；搜索支持中文多词
- 2026-10 素材全本地化：1499 张缩略图 + 1499 张原图 + 字体镜像，移除全部 CDN 依赖
- 2026-10 新增搜索、发长筛选、风格快筛、四种排序、收藏夹、随机抽图
- 2026-10 新增上传自己的图（IndexedDB，
file://下自动降级 localStorage） - 2026-10 接入 DeepSeek 生成人像提示词；卡片增加
AI角标 - 2026-10 新增深浅色切换、原图缺失时自动回退原站下载
- 2026-10 接入 GitHub Actions 自动部署 Pages：https://atom-kkk.github.io/AI-Face-Resource-Library/