hhhge/fanqie-assistant

0 Fork 0

mirror of https://github.com/naiyQAQ/fanqie-assistant.git synced 2026-10-21 10:24:47 +00:00

Files

T

naiy d77d4edfd6 docs: update README.

2026-08-03 16:31:47 +08:00

7.4 KiB

Raw Blame History

番茄小说助手 (fanqie-assistant)

一个用于番茄小说网页版的用户脚本（Userscript）：去广告、去推广、解锁章节、优化阅读体验。

使用该项目会有账号被官方封禁的风险。 如您继续使用，则证明您已知晓未来可能发生的风险并对其负责。
项目处于快速开发期。 核心功能已基本稳定，但仍可能随时调整接口和目录结构。欢迎试用和反馈。
这是我的第一个 TypeScript 项目。 属于边学边写，代码质量可能不高，有问题欢迎指正。

脚本发布地址:

GitHub | 如果觉得好用，去点点 star 吧！
GreasyFork

功能特性

阅读体验

正文增强：拉取完整正文并重新渲染，替换网页原有内容容器，允许复制文本
解锁章节：网页端被屏蔽的章节可以正常阅读
漫画阅读：图片章节支持懒加载，加密图片滚动到视口时自动解密
章内注释：自动处理 EPUB footnote，悬浮查看或点击定位，末尾保留注释列表
字体反混淆：还原网页自绘字体渲染的混淆文本，动态插入的内容同样生效
书籍样式：支持随正文下发的 CSS，同时限制作用域避免污染全站
章节信息补全：补上卷名、精确到秒的更新时间，并修正页面标题

书架优化

完整书架：展示所有书籍（包括因版权等原因网页端不可见的），支持跳转阅读
详细信息：显示更新时间、未读章节数、最后阅读时间等
分组展示：保留原站书架分组，支持切换查看

用户相关

用户信息展示：已登录时在头像菜单里显示已读本数和累计阅读时长
设置面板：提供可视化设置界面，支持自定义阅读器字体、CSS、API 偏好等

隐私与安全

屏蔽埋点上报：拦截发往字节、百度统计域名的埋点请求
设备管理：首次使用自动注册匿名设备并激活会员，支持手动填写设备信息

开发计划

计划不分先后，也可能会开发以下列表以外的功能：

短剧网页端播放
更完善的用户详情界面（自己的和他人的）
段评、章评、书评功能
阅读数据上报（与安卓端同步阅读进度与时长）
APP 端带推荐的排行榜
分类筛选与搜索优化
更详细的书籍信息（评分、在读人数等）
推书页面
听书功能

如果您有更多好的想法，欢迎提 PR 或 Issue。

使用

需要一个用户脚本管理器，推荐 Tampermonkey。

安装构建产物 fanqie-assistant.user.js 即可。

开发

npm install
npm run dev      # 启动开发服务器
npm run build    # 类型检查 + 打包
npm run preview  # 预览构建产物

调试

npm run dev 后，vite-plugin-monkey 会输出一个安装地址，在脚本管理器里安装这个开发版即可。它指向本地开发服务器，改完代码刷新页面就能看到效果，不需要每次重新打包安装。

脚本运行时机是 document-start，日志都打在浏览器控制台，按 fqa 或钩子 id（如 readerHook_load）过滤比较方便。

调试时注意关掉正式版脚本，两个版本同时启用会重复注入。

编译

npm run build

产物是单文件 dist/fanqie-assistant.user.js。build 会先跑 tsc 做类型检查，类型报错会中断打包。

项目结构

src/
├── main.ts              入口，安装导航钩子并按顺序初始化各模块
├── config.ts            设备配置与全局常量
├── types.ts             书籍、卷、章节等数据模型
├── settings.ts          设置项定义与持久化
├── settingsPanel.ts     设置面板的挂载/卸载
├── userStyle.ts         用户自定义样式（字体、CSS）
├── cssInject.ts         基础样式注入
├── fontDecrypt.ts       自绘字体文本还原
├── localStorage.ts      存储读写封装
├── api/                 接口相关内容
├── crypto/              加密算法相关内容
├── hooks/               页面钩子
│   ├── index.ts         钩子调度器
│   ├── readerHook.ts    阅读页正文替换
│   ├── bookshelfHook.ts 书架页面接管
│   ├── userHook.ts      用户菜单增强
│   └── fetchHook.ts     请求拦截（屏蔽埋点）
├── utils/               通用工具
│   ├── index.ts         DOM 等待、数组分块等
│   ├── request.ts       GM_xmlhttpRequest 封装
│   ├── time.ts          时间格式化
│   ├── compress.ts      Gzip 压缩/解压
│   └── footnote.ts      章内注释处理
├── views/               Vue 组件
│   ├── SettingsView.vue 设置面板
│   ├── BookshelfView.vue 书架主视图
│   ├── BookCard.vue     书籍卡片
│   ├── BookGroupCard.vue 分组卡片
│   ├── BookHoverCard.vue 悬浮卡片
│   ├── ContextMenu.vue  右键菜单
│   └── useBookshelf.ts  书架数据逻辑
└── assets/              样式与图标
    ├── script.css       阅读器样式
    ├── bookshelf.css    书架样式
    ├── settings.css     设置面板样式
    └── *.svg            图标资源

扩展开发

新增页面功能时，在 hooks/ 下建一个模块，导出 HookConfig[] 并在 hooks/index.ts 里注册。每个钩子声明自己关心的事件（load、onUrlChange、onHashChange 等）和一个 filter 函数，命中才执行，互不影响。

新增设置项时，在 settings.ts 的 Settings 接口和 DEFAULT_SETTINGS 里添加字段，Vue 组件通过 import { settings } from './settings' 引入后直接修改，会自动持久化。

关于账号安全

正文与书籍详情走 *.jxbhmy.com，这是番茄小说旗下红烛小说的接口，与番茄数据基本通用，风控更低且不需要请求签名。这是第一方接口，不是第三方服务。

脚本没有申请 GM_cookie 权限。sessionid 是 HttpOnly 的，脚本读不到、也没打算读。所有需要登录凭据的请求都用页面原生 fetch 发送的同源请求完成，由浏览器自动带上 Cookie，凭据不经过脚本，也不会被发往任何其他地方。
如果后续同源接口无法满足脚本需求，会考虑使用 GM_cookie 权限。但我们确保您的凭据不会被发送到番茄小说及其相关平台以外的任何第三方。后期加入第三方接口时，接口由您自己输入。此时，我们可能会将凭据发往 您自己填写的 API 。使用即应确认风险，我们不对任何第三方接口的行为负责。

代码全部开源，欢迎审查。

许可

GPL-3.0

免责声明

本项目仅供学习和技术研究使用。请遵守番茄小说的用户协议与相关法律法规，不要用于商业用途或内容再分发。
本项目永久开源免费，未经授权不得用于售卖。如果您通过购买获得此项目，那么证明你被骗了，请举报退款。
本项目不保证任何功能的稳定性、准确性和安全性，使用时请自行承担风险。

7.4 KiB Raw Blame History Unescape Escape