番🍅茄小说阅读助手
增强番茄小说网页版阅读体验：锁定章节自动加载完整正文、块预取缓存、卷结构目录、全本 TXT 下载。所有数据只保存在你自己的浏览器里。
本脚本仅供个人学习与技术研究使用，请支持正版。第三方接口的内容稳定性与合规性不由本脚本控制，使用前请自行了解所在平台的服务条款，自行承担使用风险；脚本作者不对内容准确性、可用性作任何保证，请勿将获取的文本用于商业用途或二次传播。
功能一览
- 锁定章节自动加载完整正文：站点只给 200 字预览的章节，打开后自动从外部源取回全文并无缝画入页面，无需点击任何按钮；试读章节完全交给站点原生渲染，脚本不做任何干预。
- 块预取缓存：全书按 10 章一块，读到每块第 9/10 章时自动预取下一块（先做三道检查：连载前沿之外不取、已缓存不取、试读章不取）；从中间任意一章进入时按所在块整取。翻页秒开，线性阅读约 10 章 1 额度；缓存围绕当前读点自动滚动清理，不会无限膨胀。
- 卷结构目录侧边栏：右侧"书"标签打开。目录按卷分组、可折叠、带已读打勾和高亮当前章；顶部"继续阅读"一键回到上次读到的章节。
- 全本 TXT 下载：可指定章节范围，自动按每批 1000 章分批，带进度条、速度显示和随时取消；整批失败自动重试、缺章自动补取；分卷标题写入 TXT。
- 新手引导与额度提醒：未配置 Key 时打开锁定章节自动弹出申请引导（含 QQ 机器人二维码和图文步骤）；额度不足时弹出"签到领额度"提醒；设置页显示当日请求用量，方便与额度余额核对。
使用方法
首次配置（只需一次）
- 打开任意锁定章节，会自动弹出申请引导；也可直接用手机 QQ 扫引导里的二维码，或打开机器人页面：https://bot.q.qq.com/s/ucBwC9Kk7u
- 按机器人提示申请 API Key（免费，注册即送 1 万额度；每天在机器人处签到（打卡）可领 1000 额度）。
- 点页面右侧"书"标签 → ⚙ 设置 → 粘贴 Key → 保存。Key 只保存在你自己的浏览器里。
- 新源为第三方免费接口，按请求次数计费（一批多章只算 1 次），脚本已自动合并批量请求，日常阅读非常省。
基本阅读
- 打开任意章节。试读章节正常阅读即可；锁定章节会自动加载全文（已缓存秒开；未缓存约 1 秒，取决于外部源速度）。
- 页面右侧边缘有一个竖排"书"标签，点击展开侧边栏。
- 侧边栏顶部是"继续阅读"，点击直接跳回上次读到的章节（每本书独立记忆）。
- 目录里点击任意章节即可跳转；点击卷标题可折叠/展开该卷（折叠状态按书记忆）。
下载全本
- 展开侧边栏，点击底部"⬇ 下载全本 TXT"。
- 在弹出面板里设置 起始章 / 结束章：留空即从第 1 章到最后一章。分批全自动（每批 1000 章 = 1 次请求），无需配置。
- 点击"开始下载"。下载过程显示进度和速度，可随时点"取消下载"，已完成的部分会正常保存。
- 完成后自动保存为
书名.txt（UTF-8 带 BOM，含分卷标题）。
下载需要目录数据。如果当前在阅读页且从未打开过这本书的详情页，请先点一下站内右侧的"目录"按钮或进一次书籍详情页，再回来下载。
设置说明
| 设置项 |
默认 |
说明 |
| 章节缓存上限 |
2000 章 |
超过后按"整本书"为单位清理，最久没读的书先删 |
| 读点前后保留 |
20 章 |
距当前读点前后超过这个章数的缓存自动删除，每本书实际存量不超过 2×此值+1 章 |
| 读书保护 |
7 天 |
这么多天内读过的书不会被自动整本清理 |
| 缓存池上限 |
5 MB |
阅读进度 + 各书目录共用的存储上限，超出从最久未更新的书开始清 |
| API Key |
空 |
锁定章节全文来源（oiapi.net，第三方免费接口）的个人密钥，必填才能取锁定章。QQ 机器人申请、每日签到领额度；只保存在本机 |
设置页 API Key 输入框下方显示当日用量（已发请求数 / 取得章数，本地统计）。
设置页底部有三个清理按钮，作用范围互不影响：
- 清除本书数据：当前这本书的章节缓存 + 目录缓存 + 阅读进度（其他书不受影响）；
- 清空全部章节缓存：所有书的章节缓存与目录；
- 清空全部阅读进度：仅进度，章节缓存保留。
工作原理（想了解的再看）
- 试读/锁定判定：优先使用会话目录中的锁定标记（免轮询、出字快）；目录缺失时综合页面状态、已渲染字数与付费墙元素判断，判定不了的兜底按锁定处理，保证总能读到全文。
- 全文来源：第三方开放接口 OIAPI（
oiapi.net，需自备 API Key）。单章按章节 Id 直接取（无需目录），批量按全书序号一次取多章；脚本仅在打开锁定章节（含预取）与下载时向该源发起请求，失败请求同样计费。
- 目录来源：书籍详情页自带的完整目录是唯一权威来源（含全部卷结构），打开详情页时自动缓存；阅读页使用本地缓存的目录，或复用你自己点开站内目录时浏览器已收到的数据——捕获到的目录经归属校验（列表须包含当前阅读的章节 Id）后同样落盘留存。脚本从不为目录主动向番茄发请求。
- 块预取：全书按 10 章一块。读到每块第 9/10 章（9/19/29…/10/20/30…）时做三道检查——目录里有没有下十章（连载前沿之外不取）、缓存里有没有（已有不重取）、是否试读章（不取）——全部通过才预取下一整块；第 11 章起打开未缓存的锁定章时按所在块一次整取（本章即在其中，无需单等）；第 1~10 章永不预取。按请求计费下一整块只算 1 次，线性阅读约 10 章 1 额度。
- 下载分批：自动按每批 1000 章分批——该值按两类极端书实测确定（1500+ 章普通长篇、1531 章/2980 万字的字数怪兽），更大批量会撞源后端的内存上限。整批两连败自动跳过（不逐章硬补烧额度），稍后重新下载可补齐。
- 防覆盖：站点会周期性地用受限内容覆盖页面，脚本持续监视并自动画回全文。
- 数据都在本地：章节正文与 API Key 存于脚本管理器存储，阅读进度/目录/折叠状态存于浏览器 localStorage。卸载脚本即全部清除。
常见问题
Q：锁定章节没出全文？
三种常见原因：① 没填 API Key（会自动弹出申请引导）；② 外部源超时或被限流（等一会重新打开该章即自动重试）；③ 额度用完（去 QQ 机器人签到领额度）。已缓存的章节永远是秒开。
Q：侧边栏目录是空的？
目录有两个零成本来源：打开一次这本书的详情页，或点开站内的目录按钮（脚本会自动捕获站点自己加载的目录数据）。捕获到的目录经过归属校验后会自动留存，本书下次会话开局即从缓存恢复、无需重新等待。
Q：试读章节会被改动吗？
不会。试读章节完全由站点原生渲染，脚本不做任何干预。
Q：会拖慢页面或产生额外流量吗？
脚本不轮询、不向番茄发任何额外请求。网络请求只有：锁定章取文（含预取，批量）、下载，全部发往第三方接口 oiapi.net 并按次消耗额度。缓存按读点滚动清理，存储占用有硬上限（章节缓存按章数、进度+目录按 MB）。
Q：换书/多本书会串数据吗？
不会。进度、目录、折叠状态、缓存都按书隔离；换书瞬间会话状态整体重置。
Q：提示 Key 异常 / 额度用完了怎么办？
两种情况脚本都会自动弹出对应引导（带二维码）。Key 只存在你自己电脑里，失效就重新申请一个再在设置里换上；额度用完每日签到即可补充（+1000/天），无需重新申请。
兼容与安装
- 支持**脚本猫（ScriptCat）**与 Tampermonkey 两种脚本管理器，安装其一即可。
- 首次使用时脚本管理器可能询问"允许跨域请求"，请选择允许（用于访问外部源
oiapi.net）。
- 需自备 API Key：在 QQ 机器人（https://bot.q.qq.com/s/ucBwC9Kk7u ）处申请，注册送 1 万额度、每日签到 +1000，然后填入侧边栏 ⚙ 设置。
- 仅在
fanqienovel.com 上运行。
