nHentai Pro

项目简介

nHentai Pro 是一款专为 nHentai 设计的全能增强脚本。它集成了智能搜索联想、全站深度汉化、高级语言过滤及现代化交互体验。

本项目旨在消除语言障碍，提供比原生更丝滑、更智能的浏览体验。无论你是需要精准查找特定作者，还是希望在浏览时一目了然，本助手都能满足你的需求。

核心功能

1. 智能搜索增强

• 实时联想：输入关键词（中/英/日）即时显示带分类角标的建议。
• 中英互译：直接输入“黑丝”，自动转换为 tag:"pantyhose" 进行搜索。
• 滑动匹配：支持连续输入单词（如 sousou no -> sousou no frieren）。
• 快捷操作：
  • 快捷标签栏：一键添加 language:chinese 或 pages:>20 等条件。
  • 排除搜索：按住 Shift + 点击 联想词，自动添加排除标记（-）。

2. 全站深度汉化

• 无死角覆盖：从导航栏、设置页到用户个人主页、评论区，所有 UI 元素全汉化。
  • 智能标签翻译：
    • 原文优先：原文 (译文)
    • 译文优先：译文 (原文)
    • 仅显示译文：仅显示中文
    • 仅显示原文：仅显示原文* 上下文识别：智能区分同名标签在不同语境下的含义（如角色名与作品名）。

3. 现代化预览体验

• 封面页数显示：无需点击，列表页封面右上角直接显示本子总页数。
• 滑动预览：在封面下方进度条左右滑动（或使用键盘左右键），无需进入详情页即可快速阅览全书。
• 标签悬停：鼠标悬停在封面左上角的 "TAGS" 按钮，即刻弹出完整标签列表。

4. 净化与过滤

• 多语言筛选器：导航栏集成原生风格的语言筛选下拉菜单，支持多选（如仅看 CN+JP）。
• 界面净化：自动移除垃圾广告链接及社交媒体图标，还你清爽界面。

5. 快捷键指南

• 搜索交互
  • Shift + 点击：对联想词或快捷标签进行排除搜索（添加 - 前缀）。
  • ↑ / ↓：在搜索联想菜单中导航。
  • Tab / Enter：选中并填入当前联想词。
  • Esc：关闭联想菜单。
• 预览控制
  • ← / →：鼠标悬停在封面时，进行上一页/下一页翻页预览。

高度可配置

点击导航栏左侧的 “设置” 按钮即可呼出可视化面板：

• 功能开关：所有核心功能（汉化、搜索、预览、页数等）均可独立开关。
• 显示偏好：自定义翻译模式、快捷标签按钮显示等。
• 数据管理：支持手动更新汉化数据库。

更新日志

v2.7.6

• 修复了一些 bug。

v2.7.5.19

• 首页隐式分页恢复：首页虽然没有原生 a.next，但现在会显式推导 /?page=2 作为下一页，从而恢复首页无限滚动能力。
• 用户意图激活修正：分页直入页不再因为“页面高度不够滚动”而一打开就自动跳到下一页；改为需要真实滚轮、中键或实际滚动意图后才触发加载。
• 首页页码收敛：首页不再显示误导性的 Page 1，只有真正追加出后续页时才显示 Page 2 / 3 ...。

v2.7.5.11

• 列表页重建时序修复：对于路由切换后短时间内暂时拿不到分页入口的列表页，不再立刻清掉无限滚动，而是进入短暂恢复窗口继续尝试同步分页状态，避免“回首页后必须手动刷新才恢复滚动”。

v2.7.5.10

• 首页无限滚动 UI 收敛：对于首页这类本身没有分页入口的页面，不再误插入 Page 1 与“已加载全部页面”提示，避免把非分页页误当成无限滚动列表页。

v2.7.5.9

• 首页重置后分页恢复：当列表重置后暂时还拿不到新的 nextUrl 时，不再直接误判为“已加载全部页面”，而是短暂显示“正在同步分页状态...”，并自动重试恢复下一页状态。

v2.7.5.8

• 搜索栏快捷标签稳定性修复：修复导航栏重绘后，点击搜索框时快捷标签仍会闪现后消失的问题。
• 首页残留链判断收敛：进一步简化无限滚动的同列表重置条件，只要当前路由已不等于上一次内部同步到的分页 URL，且旧追加链仍存在，就强制清理旧链再按当前页面重建。

v2.7.5.7

• 搜索增强稳定性修复：修复导航栏重绘后，搜索栏快捷标签点击时闪现后立即消失的问题。
• 路由抑制范围修复：路由抑制现在只忽略脚本内部刚刚同步过的分页 URL，不再误吞点击 logo 返回首页这类真实导航，因此旧翻页链能正确重置。

v2.7.5.6

• 搜索增强恢复：修复站点导航栏重绘后搜索联想和搜索栏快捷标签失效的问题，现在会在导航栏刷新后重新绑定搜索增强逻辑。
• 首页重置修复：从高页码列表点 logo 回首页时，旧无限滚动页链会被识别并清理，不再把 Page 41、Page 42 一类旧内容带回首页。

v2.7.5.5

• 短页自动翻页修复：当页面高度不足、右侧滚动条都尚未出现时，无限滚动现在也会继续自动加载，直到页面进入可滚动状态或没有下一页。
• 路由重置清理：从高页码列表点击 logo 回首页时，会清理旧无限滚动追加出来的页链和旧 pagination，避免底部继续残留 Page 41、Page 42 一类旧内容。

v2.7.5.4

• 诊断面板收敛：缩小开发者诊断面板宽度与分组间距，减少对主内容区的遮挡。
• 自动滚动续载优化：为无限滚动增加延迟可见性复查，并适度放宽底部触发阈值，改善中键自动滚动到底后不继续加载的场景。

v2.7.5.3

• 诊断面板分组增强：开发者诊断面板现按“请求队列 / 预取 / 无限滚动”三组展示，新增 nextUrl、loading、userScrolledSinceInit、loadedUrls、哨兵文案等状态字段，便于定位滚动与路由问题。
• 最小自检脚本：新增 tools/self-check.mjs，可一键检查版本一致性、关键文件存在性和主脚本语法状态；传 --build 时会额外执行构建校验。

v2.7.5.2

• 分页直入回归修复：修复从 https://nhentai.net/?page=x 直接进入时，无限滚动在初始化阶段过早推进下一页并错误进入“已加载全部页面”状态的问题。
• 滚动激活门槛：无限滚动现在要求用户先产生实际滚动，再触发首次自动加载；首轮加载后仍保留连续滚动体验。

v2.7.5.1

• 开发版起步：从正式版 2.7.5 起步到工作版本 2.7.5.1，用于承接下一轮运行时稳定性修复。
• 无限滚动稳态增强：收敛 nextUrl 的解析来源，优先使用尾部有效 pagination，降低多轮追加后误取旧 a.next 的风险。
• 路由刷新去重：为 scheduleRouteRefresh() 增加刷新波次去重，避免短时间内叠加多个并发刷新批次。
• 加载中保护：当无限滚动正在请求下一页时，外部刷新只做状态同步，不再轻易重置 sentinel、observer 与关键状态。

v2.7.5

• 正式发布：将 2.7.4.x 工作补丁线收口为稳定版 2.7.5。
• 站点兼容增强：补齐新版 nhentai 多个用户页面与详情页空态文案的汉化，包括登录、注册、收藏、设置、删除账户、评论空态等。
• 用户设置页完善：支持按 #profile,blacklist,apikeys,sessions 自动展开对应区块，并在展开后立即翻译黑名单标签、下拉选项、API 区块、会话信息和危险区域文案。
• 详情与列表页修复：修复收藏页标题与 Remove、详情页评论空态提示等未覆盖文案，进一步提高全站汉化完整度。

v2.7.4

• 无限滚动：滚动到底部时自动加载下一页内容。
• 黑名单彻底屏蔽：彻底屏蔽黑名单本子。

v2.7.3

• 新版站点兼容：适配 nhentai 新版页面结构与 api 接口，恢复列表页页数显示、悬停预览与预览图地址解析。
• 导航与语言筛选修复：兼容新版 导航结构与语言类名，修复语言筛选初始化、翻页后失效与导航偶发错位问题。

v2.7.2

• 新增开发者诊断面板（设置页开关）：可实时查看队列长度、进行中请求、限速间隔、窗口请求数、缓存命中率、429 次数、最近失败数与预取排队数。
• 新增智能预取策略（固定窗口）：仅对视口附近画廊进行轻量元数据预取，默认窗口 [-2,+8]，单次最多 4 项、待处理上限 12，队列过长时自动暂停预取。
• 数据库策略调整：默认停用周期自动更新；保留“强制更新汉化数据库”手动入口；首次无本地词库时仍会自动初始化下载。

v2.7.1

• 版本过渡与备份版本，用于后续 2.7.2 功能升级前的基线保留。

v2.6.9

• 交互优化：显著提升 TAGS 信息的加载优先级。现在当鼠标移动到左上角 TAGS 按钮时，会立即触发数据加载，消除了之前的 300ms 延迟，实现即时反馈。

v2.6.8

• 修复与优化：为页数显示功能添加智能请求队列与限流机制。
  • 限流保护：彻底解决与 ComicRead 等脚本配合使用无限滚动时，因请求过快触发服务器 429 限制的问题。
  • 交互优化：新增“鼠标悬停优先”加载机制，鼠标指向的漫画将即时进入高优先级队列。
  • 预判加载：采用“批量前置”算法，优先加载当前视点及后续本子，实现更符合直觉的顺势加载体验。

v2.6.7

• 新增：设置界面支持中/英语言切换。

v2.6.6

• 新增：翻译模式增加“仅显示原文”选项。
• 优化：重命名翻译模式选项，使其含义更直观。

v2.6.5

• 重构：页数显示功能迁移至 API + 懒加载机制，彻底解决大量请求导致的加载缓慢问题。
• 优化：汉化库解析逻辑重写，大幅降低脚本启动时的内存消耗。
• 增强：搜索 Worker 引入分片索引技术，极大提升查询响应速度。
• 修复：解决了部分网络环境下 API 请求挂起的问题。

v2.6.4

• 优化：微调预览功能的触发逻辑与 UI 细节。

v2.6.3

• 新增：悬停预览功能（滑动阅览 + 标签弹窗）。
• 新增：列表页封面页数显示。

v2.6.0

• 新增：导航栏多语言筛选器（支持多选）。
• 重构：UI 组件完全重写，完美融合原生深色主题。
• 净化：移除无关广告与社交图标。

使用说明

1. 安装：安装脚本后，首次访问时搜索框下方会提示“正在下载汉化词库”。
2. 生效：下载完成后（视网络情况约 10-30 秒），提示“更新完成”并即时应用汉化与增强功能。
3. 故障排除：如遇汉化未生效，请在脚本菜单中点击“强制更新汉化数据库”。

免责声明

本脚本仅供技术研究与学习使用。脚本涉及的数据来源于 GitHub 开源项目，请在遵守当地法律法规及网站服务条款的前提下使用。

许可证

本项目采用 GPL-3.0-only 许可证