PyFQWeb - 番茄小说协议的 Python 实现

⚠️ 项目状态通告
因不可抗力因素影响，本项目自即日起停止开源维护，仓库仅保留基础框架文件及非核心衍生项目源码供技术研究参考。

⚠️ 本人不推荐利用本仓库中的文件及泄露的内部源码进行任何商业性牟利行为，否则见一个举报一个

项目背景

本项目为 番茄Web模块（原项目已删除）的 Python 重构实现，在完整保留并兼容原有功能和接口的基础上进行扩展。

部署指南

环境配置

# 方案一：使用 Poetry 管理
poetry install --no-dev

# 方案二：使用 pip 直接安装
pip install -r requirements.txt

启动方式

# 标准启动
python main.py

# 使用 PM2 进程管理
pm2 start npm --name "pyfqweb" -- start

API 接口规范

核心端点

功能分类	端点路径	HTTP 方法	参数说明
搜索	/search	GET	query: 关键词 offset=0: 分页偏移量（计算式：(page-1)*10） tab_type=3: 搜索类型（默认书籍）
书籍元数据	/info /detail	GET	book_id: 书籍唯一标识符
目录结构	/catalog /directory/all_items	GET	book_id: 书籍唯一标识符
内容获取	/content	GET	item_id: 章节ID text_mode=false: [bool]纯文本模式 image_mode=true: [bool]图片包含
批量操作	/multi-content /multi-detail	GET	book_id: 书籍ID（必须） item_ids: 逗号分隔的ID列表（仅multi-content）
正文预览	/item-summary	GET	book_id: 书籍ID item_ids: 逗号分隔的章节ID列表
听书服务	/audio	GET	item_ids: 音频ID列表
短剧服务	/video	GET	item_ids: 视频ID列表
接口信息	/self-info	GET	无

扩展接口

对于未明确列出的API端点，支持通过以下方式调用：
- 请求路径：保持与官方API一致
- 参数规范：遵循原始请求参数
- 请求体格式：保持与官方API一致

衍生项目

• web.html: 网页端番茄下载器
• llepub-latest.js: 浏览器端 EPUB 下载库
• user-script.user.js: 番茄小说网页辅助用户脚本

协议条款

授权声明

本项目框架及衍生项目依照 GPLv3 协议分发。官方API的操作插件依照 MIT 协议分发。

---

术语定义

1. "本项目" 指 PyFQWeb 及其衍生版本
2. "使用者" 指运行、修改或分发本软件的任何个人或实体
3. "版权内容" 包括但不限于：
   • 文字作品（正文、摘要等）
   • 视觉元素（封面、插图等）
   • 元数据（作者信息、分类标签等）

---

核心条款

法律效力声明
本附加条款中涉及第三方内容使用的指引，系善意使用建议而非法律约束。
GPLv3/MIT 授予的代码权利不受本条款限制，冲突时以原始许可为准。

数据合规性

1. 内容获取途径：
   • 数据源：番茄小说、今日头条等平台的公开接口
   • 免责声明：不保证数据的完整性、时效性及合法性

版权管理

2. 对由插件生成的第三方持有版权的内容处置要求：
   • 缓存数据须在 24小时（自然日） 内清除
   • 禁止对版权内容进行逆向工程或商业利用

责任豁免

3. 开发者不承担因以下情况导致的任何责任：
   • 违反当地法律法规的使用行为
   • 数据泄露或滥用造成的损失
   • 服务中断引发的商业影响

使用限制

4. 本项目在运行时可能会生成他人持有版权的版权内容，对于这些内容，使用者需承诺：
   • 遵守软件运行所在地法律法规
   • 不从事违反《番茄小说用户协议》核心条款的行为
5. 技术伦理倡议：
   • 反对滥用自动化手段破坏服务稳定性
   • 以上可能导致你被官方封禁

协议变更

5. 旧版本许可不变：
   • 新版本可能更新条款，但已发布的版本继续适用原有条款
   • 用户可自由选择是否升级

---

📘 版权倡议
本项目仅供技术研究用途，建议通过正规渠道支持内容创作者。文学创作不易，请尊重知识产权。