🍅 番茄小说 · VS Code 阅读器
在 VS Code 里直接阅读番茄小说:抖音扫码登录、书城(排行榜/分类)、搜索、书架、历史记录、沉浸式阅读器(上下翻页/字号主题/工具栏显隐)、书评。
🌐 项目地址 https://github.com/zwb8926/fanqie-novel-vscode
📖 使用说明
登录(推荐扫码登录)
- 打开面板 → 右上角「登录」→ 默认「扫码登录」;
- 点击「开始扫码登录」→ 用 抖音 或 番茄小说 App 扫码 → 在手机上确认;
- 登录成功后即可同步云端书架与阅读进度。
扫码登录走番茄官网同源 passport 接口(/passport/web/get_qrcode/ + check_qrconnect/),不经过 sso.douyin.com,不受其风控影响(实测有效)。
阅读
- 书城分三个 tab:排行榜(男/女频 + 推荐/热读/新书/完结/更新)、分类(男生 41 类 / 女生 38 类,点分类看精选)、最近更新(追更,显示最新章节与更新时间);
- 书城/搜索/书架点击书籍 → 详情 → 「开始阅读」;
- 沉浸阅读:默认隐藏导航/工具栏,点击正文左侧/右侧快速翻页、点击中间切换工具栏显隐(或右上角「设置」→「工具栏」);
- 翻页:按钮、键盘
←/→、PageUp/PageDown、空格;
- 切换章节:
Ctrl+← / Ctrl+→,或打开「目录」抽屉点击;
- 顶部「书评」查看书籍评论(分页加载,顶栏显示评论总数与评分);
- 阅读器右上角「设置」调整字号、行距、主题(羊皮纸/白天/夜间);
- 阅读进度自动保存在本地书架,登录后同步到云端;
- 历史记录自动记录最近读过的书(本地保存,无需登录),在「个人信息」页可查看、点击续读。
🔁 正文来源(默认:只用第三方源)
官方正文接口在风控 IP 下会被 bdturing 人机验证拦住(HTTP 200 + 0 字节),此时官方 SSR 页对锁定章节只给约 200 字试读。扩展提供三档策略,在阅读器右上角「设置」→ 正文源切换,下面的地址栏可换成自建服务:
| 模式 |
行为 |
适用 |
仅第三方(默认) |
正文只向备用正文源要,完全不请求官方正文接口、也不抓 SSR 正文;备用源不可用时才回退官方,并在提示条里说明 |
想要稳定全文、不介意非官方来源 |
自动补全 |
官方接口 → SSR 秒开;只有拿到试读片段时才用备用源后台补全(先渲染片段,取到全文后无缝替换,保留阅读位置) |
想优先用官方、把第三方当兜底 |
仅官方 |
只用官方接口 + SSR 页面 |
完全不想碰第三方(被风控时会出现试读提示条) |
「仅第三方」模式下的体验与实现细节:
- 首次打开某章要等备用源响应(实测 3~20 秒,波动较大),阅读器会显示「正在从备用正文源加载正文」;
- 取到的章节进入 LRU 缓存(60 章),并且每章加载后会预取下一章,所以正常翻章基本不用等(缓存命中实测 0ms);
- 章节标题取自备用源的
raw_full;轻量端点不带标题时,用目录里的章节标题兜底(前端随请求带上 titleHint);
- 只有正文来自第三方;目录 / 详情 / 搜索 / 书评仍走官方接口(这些接口不受该风控影响)。
⚠️ 代价与风险(务必知情):
⚠️ 已知限制
- 搜索在部分机房 IP 下会被官网风控返回空响应(家用宽带正常),此时自动降级到番茄 App 网关(
novel.snssdk.com)的搜索接口;
- 章节正文:正文接口(
/api/reader/full)在风控 IP 下返回 HTTP 200 + 0 字节,响应头带 bdturing-verify(番茄的人机验证/滑块挑战)。默认由备用正文源提供全文;若切到 仅官方,锁定章节只会显示试读片段,此时阅读器顶部会显示醒目提示(「只取到试读片段(N / M 字)」)并提供「在浏览器中打开本章」「重试」两个出口——在浏览器里完成验证、或换网络/登录后重试,即可恢复官方全文;
- 书籍详情优先走
/api/book/info(字段更全且不受上述风控影响),失败再降级旧接口与 SSR 页面;
- 章评/段评(按段落/章节的评论)为番茄 App 专属功能,网页端与 H5 均无对应接口,本扩展只提供书籍维度的书评;
- 付费章节(
needPay)需登录并在官方平台购买后方可阅读;
- 本项目仅用于个人学习研究,请遵守番茄小说服务条款,勿用于批量抓取。
🙏 致谢
📄 License
MIT
| |