Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EH-Plus

E-Hentai / ExHentai 阅读增强扩展(Chrome Manifest V3)。

EH-Plus 在不改变站点原有使用方式的前提下,为 /g/ 画廊页与 /s/ 阅读页提供图片预加载、本地缓存、自动翻页、账号工具与数据统计,让翻页更快、加载更稳、重复请求更少。

本项目免费开源,GitHub 是唯一官方发布来源;任何其他渠道的付费出售均为第三方倒卖行为,与本项目无关。

主要功能

阅读加速

  • 图片预加载:阅读页按“下一页、上一页、下下页……”双向交错顺序自动预取后续页面,页数与全局并发数可调;多开页面共享并发额度,聚焦标签页优先,已在其他页面加载过的图片自动去重不重复下载。
  • 缓存优先显示(cache-first):默认开启;进入阅读页时优先使用本地缓存展示图片,未命中时快速恢复原图请求,不阻塞正常浏览。
  • 换源重试:接管 EH/EX 官方 nl() 换源机制,图片加载失败时后台自动换源重试,地址栏不再残留 ?nl= 参数、页面不再整页刷新。
  • 内置自动翻页:默认开启;/s/ 阅读页与 /g/ 画廊页均支持滚动到底自动拼接下一页,拼接图片优先走本地缓存。

本地缓存

  • 两种存储模式:默认浏览器 IndexedDB;也可授权本地目录,把图片按 images/<gid>/ 结构存成真实文件。
  • 存储迁移:IndexedDB 与授权目录之间迁移,逐条校验、支持断点续迁、可取消、实时显示进度。
  • 目录恢复:更新时会扫描仍获授权的目录;重新安装或重新选择目录后,在用户重新授权时读回其中的设置、统计、日志、历史和图片缓存。目录原有记录不会清空,后续缓存继续追加。
  • 缓存治理:按天数清理(可保护高频访问的图片与画廊)、重复图片自动合并去重、临时缓存随全部 EH/EX 页面关闭自动回收。
  • 容量与统计:存储占用、命中率、访问计数一目了然,日志保留天数与大小上限可配置。

页面浮窗

  • 可拖拽、可折叠的悬浮面板:状态点与预加载矩阵、实时图片加载状态(命中缓存 / 换源重试 / 失败可见)、当前并发与排队数、迷你统计。
  • 全部设置就地生效:预加载、缓存、自动翻页、清理、迁移、日志、颜色自定义、中英双语切换。

账号与签到

  • 账号状态:图片限额、Credits、GP、Hath 等状态刷新,打开 EH/EX 页面期间后台定时保持更新。
  • 限额重置:二次确认后提交官方 Reset Quota 请求,并显示实际消耗。
  • Dawn 每日签到:页面打开时自动检查,或无需开页的后台定时签到,奖励明细可见。

浏览历史

  • 独立浏览历史页:记录 /g//s/ 访问,支持来源筛选、按最近访问 / 访问次数排序、单条删除与清空,上限可自定义,且与图片缓存互不影响。

开放接口

  • 提供合作式缓存查询消息(EHPLUS_COOPERATIVE_CACHE_QUERY):其他扩展或页面脚本可查询 EH-Plus 的本地缓存并直接复用已缓存图片,避免重复请求。

安装

  1. 准备固定命名的未打包扩展目录 EH-Plus;本地正式构建会生成 %USERPROFILE%\Downloads\EH-Plus,GitHub Release 下载包则固定命名为 EH-Plus.zip
  2. 打开 chrome://extensions/,开启右上角“开发者模式”。
  3. 点击“加载已解压的扩展程序”,选择 EH-Plus 文件夹。
  4. 打开或刷新任意 E-Hentai / ExHentai 画廊页或阅读页,左上角出现 EH-Plus 浮窗即安装成功。

更新方式:从 GitHub Release 下载固定资产 EH-Plus.zip,解压并用其中的新版文件覆盖浏览器当前加载的同一个 EH-Plus 文件夹,再到扩展管理页点击“重新加载”;不要改目录名或另选新目录重复加载。版本号只保留在 GitHub Release 标签和 manifest.json 中。扩展内“关于”分组提供更新检查;标题旁出现“有新版本”时,点击后可确认下载该 Release ZIP。下载只接受官方仓库且必须与最近一次成功检查选中的资产完全一致;拒绝只会忽略该 Release 版本,检测到另一新版本时会再次显示。

从 1.0.2 升级时,旧版更新检查不认识新资产名。若首个更名后的 Release 只上传 EH-Plus.zip,需要手动从 Releases 下载一次;升级到 1.0.3 后即可优先识别新名称并继续兼容已发布的旧资产。

从源码构建

需要 Node.js ≥ 20。

npm test                 # 运行全部自动化测试
npm run build:extension  # 测试 + 构建固定 EH-Plus 目录,并生成供 Release 上传的 Downloads/EH-Plus.zip

权限说明

权限 用途
storage / alarms 保存设置与运行状态;定时签到、账号刷新与缓存维护
tabs / webNavigation 判断 EH/EX 页面开关状态、聚焦标签优先调度
declarativeNetRequest 仅在开启缓存优先时,对当前阅读页图片请求做本地缓存抢占
downloads 下载 GitHub Release 更新包
host 权限 仅限 e-hentai.orgexhentai.org*.hath.network 图片服务器

所有数据(图片缓存、设置、日志、历史、统计和账号摘要)均保存在本地,无任何遥测或第三方上报,也不会随更新检查上传到 GitHub。运行功能的网络请求仅发往 EH/EX 官方页面与其图片服务器;只有检查/下载更新时会访问官方仓库的 GitHub Release API 与所选下载资产。账号相关操作全部使用浏览器已登录的会话。

许可证

MIT。衍生来源与第三方声明见 NOTICE.md,版本变更见 CHANGELOG.md

参考的开源项目

About

EH+

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages