-
Notifications
You must be signed in to change notification settings - Fork 0
Usage
中文 · English
GalleryVault 采用单页应用（SPA）与 hash 路由体系（如 #/library、#/gallery/7），浏览器刷新与前进/后退均无需服务器往返。
桌面端顶栏：Browse（浏览）、Discover（发现）、Library（画廊库）、Series（系列）、Tags（标签）、Downloads（下载）、Favorites（收藏夹）、「管理」。History / Settings / Logs 在「更多」。点「管理」落到回收站（#/recycle），页内 tab 为：回收站、重复副本（#/duplicates）、收藏夹重复（#/duplicates/favorites）、跨 GID（#/duplicates/cross-gid）、缺页体检（#/integrity）、冷库归档（#/archive）。#/favorites/manage 仍指向收藏夹重复，仅作旧链兼容。移动端汉堡菜单扁平展示。
顶栏可叠加黄条（全局暂停）、红条（Cookie 失效 / 无里站权限 / IP 封禁）与图片配额告警；探活失败（网络或站点异常、Cookie 未必坏）走橙条。🎲 旁的铃铛为应用内通知中心（下载完成/失败/改下新版、扫库完成/失败、归档开始/成功/失败、Cookie 失效/无权限/IP 封禁；约 15 秒轮询，无需配置 Telegram 也可获知后台事件；Cookie 红条仍保留；面板支持一键「清空」；时间戳跟随容器 TZ 本地时区，非 UTC 截断）。
首次部署后（仍在使用默认密码时），登录会自动进入 #/welcome 三步向导：
-
修改默认密码：把内置默认密码
p1a2s3s4改成你自己的强密码（不可跳过，可随时在设置中修改）。 -
连接 ExHentai：选择 base URL（ExHentai 里站 / E-Hentai 外站 / 官方域名的自定义子域，任意其它主机名会拒绝）并填入
ipb_member_id/ipb_pass_hash/igneouscookie，可用「测试登录」验证（可跳过，详见后文 配置 ExHentai Cookie）。 - 填充画廊库：点击「扫描库」或「立即检查所有收藏夹」（可跳过）。
每步完成会显示 ✓；点击「完成设置」即可进入主界面。已配置的实例登录不会强制进入向导，可在地址栏手动访问 #/welcome 重新查看。
为保证最佳的使用体验与元数据匹配准确率，推荐按以下步骤使用：
- 配置账户 Cookie（可选但推荐）：在向导或设置页中配置 ExHentai Cookie 并通过连通性测试。
-
先缓存收藏夹元数据：前往 收藏与更新（
#/favorites）点击「立即检查所有」，优先将云端收藏夹元数据与封面预热至本地缓存。 -
扫描本地画廊入库：将本地归档存入
./library挂载目录，在 浏览与库 点击「扫描库」。本地文件将自动比对云端已缓存元数据，实现高精度入库识别。 -
查重与维护：进入 库维护 → 重复副本（
#/duplicates）清理同 GID 多目录副本；收藏夹重复用#/duplicates/favorites（旧链#/favorites/manage仍可用）。 - 增量监控与日常阅读：在收藏夹中启用目标文件夹并设为「增量下载」以追踪最新画廊；日常可在 画廊详情与阅读 中享受多模式阅读与搜索上下文保护。
如需与 ExHentai 联通、同步收藏夹、在线拉取标签或下载画廊，需提供你在浏览器的登录 Cookie：
- 获取 Cookie：
-
填入系统：
- 在
#/welcome向导第二步，或进入 系统设置（#/settings）的 ExHentai 配置区； - 基础 URL 保持默认
https://exhentai.org（无里站可改为https://e-hentai.org；仅允许这两个官方域或其子域）； - 依次填入对应的三个字段；Cookie 在前端提交后不会回显。
- 在
-
连通性验证与探活：
- 点击 测试登录 按钮，系统会即时验证 Cookie 的有效性并反馈连接结果；
- 服务启动时会自动探活，且之后每 30 分钟轮询检测一次；
- Cookie 失效、无里站权限或 IP 封禁时顶栏出红条；探活因网络/站点失败时出橙条（不一定是 Cookie 坏了）。红条链到设置更新凭据。
安全提示：Cookie 属于敏感凭据，请切勿将其写入仓库正文、公开文档或分享给他人。系统支持启用环境变量
ENCRYPTION_KEY进行数据库静态加密保护（详见 静态加密）。
使用指南已拆分为以下各功能分册，点击即可深入查阅对应特性说明：
-
- 浏览（#/browse） — 落地网格、继续阅读卡片区、键盘导航与全局快捷搜索；画廊卡片横向封面不再裁切，采用同图模糊铺底。卡片封面优先读取 EH 原图缓存（remote-covers），miss 时立即回退本地 0.jpg 并在后台拉取；收藏立即检查自动识别并跳过已有封面。
- 发现（#/discover） — 在线浏览 ExHentai、Popular / Watched / Toplist 热门与游标翻页
- 系列作品（#/series） — 默认同人/漫画过滤与分页浏览、活动前缀剥离与多维打分聚类；支持聚合云端未下载收藏成员并展示云端角标与一键下载，支持手工添加 GID/收藏画廊及移出云端，扫库收尾自动 rebuild。
-
画廊库（#/library） — 多维索引排序、阅读状态互斥过滤、AND/OR 多标签与
-tag排除筛选、批量加收藏与批量删除熔断 - 本地列表（#/library） — 完全解耦于 EH 的本地独立列表生命周期与归类
- 标签（#/tags） — 标签命名空间分组、词频检索与 EhTag 中文联想补全
- 历史（#/history） — 阅读历史时间线管理与进度清除
-
- 画廊详情（#/gallery/） — 缩略图按进度定位、原站直达、标签同步、画质推断与一键升级原图、CBZ 导出
-
阅读器（#/reader//） — 逐页流式加载、LTR/日漫 RTL/双页并排/条漫 Webtoon 模式、移动端捏合缩放、
G精准跳页、F图片全屏、搜索上下文粘性保留
-
- 下载页（#/downloads） — 粘贴 URL/GID 批量入队、自动跟随新版、任务状态队列、全局暂停、GP 与配额看板、断点续传与指数退避自愈
- 归档下载（ExHentai archive） — 官方整包 zip 通道、GP 余额/清晰度只读预检、Range 断点续传与逐页自动降级
-
- 收藏夹（#/favorites） — 10 个收藏夹全量/单夹检查、元数据自动应用、跳过启发式、文件夹内排序与批量移动
-
收藏夹查重（#/duplicates/favorites） — 同作品多版本查重；旧路由
#/favorites/manage仍可用 - 更新画廊（#/updates） — 重传换 GID 智能检测、新版下载与旧版本地副本安全级联删除
- 「download favorites」与「启用」的区别 — 全局定时检查总开关与单文件夹启用逻辑矩阵
- 三种模式的区别 — 增量下载、仅监控、强制下载的行为机制
-
- 重复副本（#/duplicates） — 同 GID 多目录副本、收藏夹重复、跨 GID
- 回收站（#/recycle） — 用户删除与扫描失踪、恢复与彻底删除
- 缺页体检（#/integrity） — 缺页/坏图扫描与差量补页
- 冷库归档（#/archive） — 打包 CBZ、取消任务、清理已归档源目录
- 日志页（#/logs） — 后台任务与系统日志
-
- 设置（#/settings） — 库根目录、下载看门狗与并发调优、分区折叠与磁盘用量快照、标题显示（日文/英文/目录名）、账户安全、Telegram Bot 控制命令、PWA、主题、OPDS 与第三方客户端接入（Basic 鉴权）
- 哪些操作要上网 — 全功能网络访问分级清单（向 ExHentai 拉取、访问 GitHub、纯本地运行、本地优先）
若你此前收藏或引用了旧版 Usage.md 的长文锚点，请参考下表对应到拆分后的新文档与章节：