你的硬盘里是不是躺着几百个 G 的本子和电影，却从来不想打开看？
各个平台的收藏夹里塞满了"下次一定"，结果"下次"永远不来？
别慌，这个项目就是为你准备的！
⚠️ 免责声明：本项目仅供学习交流使用，禁止用于任何商业用途。使用本项目产生的一切后果由使用者自行承担。
🙏 友情提示：珍爱 JM、PK、Javdb、Missav等，为了减轻服务器压力，请不要一次性爬取太多本子，西门 🙏🙏🙏
本项目不是为了取代各大平台，只是为大家的起飞事业铺平道路，本项目只做内容管理功能，新内容的获取请使用各平台官方网站
💬 交流群：QQ 讨论群 1092445662
🚀 提需求/建议：请在 GitHub Issue 中提出，并添加
feature标签
"我下载了几千部电影和本子和，文件夹一层套一层，囤积综合征犯了..."
"每次想看的时候，翻来翻去找不到，最后干脆不看了..."
"有些本子下载了就再也没打开过，纯属积灰..."
"JM 上收藏了一些，PK 上收藏了一些，JavDB 上又收藏了一些..."
"想看某个内容，得先回忆是在哪个平台，然后打开对应的 App..."
"平台之间不互通，收藏夹乱成一锅粥..."
"想找'画工好'的'纯爱'本子，翻了几十页也找不到..."
"有些电影或漫画忘了打标签，或者平台上的标签完全不对，想找的时候完全想不起来..."
"评分全靠记忆，好本子和烂本子混在一起..."
一句话概括：Ultimate Web 是一个"内容聚合管理平台"——它可以把你在各大平台的收藏同步过来，也可以管理你本地下载的本子，统一管理、统一阅读、统一观看。
| 功能 | 说明 | 解决什么问题 |
|---|---|---|
| 📂 本地漫画、电影管理 | 导入本地本子或者电影，自动识别信息，在线阅读和观看 | 本子太多太乱，找不到、不想看 |
| 🔄 收藏夹同步 | 一键同步 JM、PK、JavDB 的收藏内容 | 平台分散，来回切换太累 |
| 🔍 全网搜索 | 在一个地方搜索所有平台的内容 | 找内容要开好几个网站 |
| 📚 在线阅读 | 漫画直接在线看，支持多种翻页模式 | 不用再解压、翻文件夹 |
| 🎲 随机流浏览 | 像短视频一样上下滑，随机浏览本地库与预览缓存内容 | 不知道看什么时，快速“刷”到想看的 |
| 🎬 在线播放 | 视频一键播放，支持多清晰度切换 | 视频管理更方便 |
| 🏷️ 标签系统 | 给内容打标签，按标签筛选 | 找内容快到飞起 |
| ⭐ 评分系统 | 1-12 分精细评分，按评分排序 | 好内容一目了然 |
| 📋 清单功能 | 创建"待看清单"、"神作清单"等 | 分类管理更清晰 |
| 👤 订阅追更 | 关注作者/演员，一键检查更新 | 不错过任何新作 |
| 📱 多端同步 | 电脑、手机数据互通 | 随时随地访问 |
| 🗑️ 回收站 | 误删内容可恢复，安全删除 | 防止误删找不回 |
| 💾 备份与恢复 | 三级自动备份，数据安全保障 | 数据丢失可恢复 |
| 🧹 存储管理 | 缓存清理、孤立文件清理、空间管理 | 存储空间优化 |
| 🔗 软连接导入 | 不复制文件，只建立索引 | 节省磁盘空间 |
| 📤 批量上传 | 批量导入、断点续传 | 大批量导入更稳定 |
| 🎬 视频缩略图 | 自动缓存视频封面和预览图 | 离线预览、加载更快 |
| 🖼️ 封面生成 | 自动提取和优化内容封面 | 展示更美观 |
| ⚙️ 运行时配置 | 第三方集成开关，按需启用 | 灵活控制功能模块 |
还在纠结要不要下载？先预览再说！
Ultimate Web 独创性地设计了两套存储体系，满足不同场景需求：
- 所有资源都被下载到本地，存储在你的硬盘里
- 优点：离线也能看，不受网络波动影响，访问速度最快
- 缺点：比较占用存储空间，几百本本子轻松占用几十 GB
- 大多以链接形式存在，不占用本地空间
- 必要时会下载到缓存中（可以随时清除）
- 优点：轻量化，不占空间，想看什么先预览，觉得好再导入本地库
- 缺点：需要网络连接
我的习惯是：先用预览库"预览"一圈，筛选出真正喜欢的，再导入本地库深度阅读。这样既不会浪费硬盘空间，又能找到真正想看的内容！
场景：你只是想"先看看"，不确定要不要下载...
操作步骤：
-
在搜索结果中点击任意内容
-
直接进入详情页，可以在线阅读或播放
-
觉得喜欢？点击「导入本地库」按钮，下载到本地库
在预览库页面，点击批量管理，选中内容即可导入到本地库 4. 觉得一般？直接关掉，缓存会自动清理（也可以手动一键清除）
效果：
- ✅ 不占空间，先看再决定
- ✅ 觉得好再下载，不冲动消费
- ✅ 缓存可以随时清除，零负担
场景：你有一个文件夹，里面躺着 200 本下载好的本子、视频等，从来没整理过...
【本地库界面截图，展示漫画卡片列表】 电脑端：
手机端：
操作步骤：
- 点击「导入」→ 选择本地文件夹
- 系统自动扫描并识别漫画信息
- 完成！现在你可以在线阅读、打标签、评分了
【导入本地漫画的操作截图】
系统会自动扫描文件夹，识别出本子信息，并生成卡片哦。不管嵌套的目录多深，有多少个压缩包，系统都能识别！！
效果：
- ✅ 本子从"文件夹地狱"变成"精美卡片墙"
- ✅ 不用解压，直接在线看
- ✅ 打标签、评分、加清单，管理井井有条
场景：你在 JM 收藏了 200 本，PK 收藏了 100 本，JavDB 收藏了 50 部...
【同步收藏夹的操作截图】
操作步骤：
- 配置平台账号密码（只需一次） 重要！！！ 没有账号密码怎么知道你收藏了哪些（笑）。教程见后面配置部分
- 按照图片指示同步清单（JM和PK平台的清单就是收藏夹啦，，javdb平台有很多清单，都能导入哦）
- 等待同步完成，耐心。。。
效果：
- ✅ 所有收藏集中在一个页面
- ✅ 不用来回切换 App
- ✅ 数据存在本地，不怕平台跑路
场景：想找"画工好"的"纯爱"本子，翻了几十页...
【标签筛选界面截图】
操作步骤：
- 点击「筛选」按钮
- 选择标签："画工好" + "纯爱"
- 瞬间出结果！
【排序结果截图】
效果：
- ✅ 多标签组合筛选，精准定位
- ✅ 支持排除标签（不要 NTR？排除掉！）
- ✅ 按评分、时间、阅读状态排序
场景：想看某本本子，得先解压、翻文件夹、找图片...
（嗯，这个就不展示了，找不到可以放上来的图片...
操作步骤：
- 点击漫画卡片
- 点击「开始阅读」
- 左右滑动翻页，双指缩放
效果：
-
✅ 支持左右翻页、上下滚动两种模式
-
✅ 支持图片连续显示、单页显示两种模式
-
✅ 阅读进度自动保存
-
✅ 全屏沉浸式阅读
个人觉得体验非常好！本人有完美主义倾向
场景：自动找MISSAV、jable上的对应电影，在线播放！！（小声点，悄悄地用就行）
操作步骤：
- 导入电影后，直接点击播放按钮就可以了
【视频播放截图】
man，，what can i say！
效果：
-
✅ 支持更换视频源
-
✅ 支持更换清晰度
一个字，绝
场景：喜欢的作者更新了，但你不知道...
【订阅列表界面截图】
操作步骤：
- 在漫画详情页点击「关注作者」
- 定期点击「检查更新」
- 一键导入新作品
效果：
- ✅ 关注的作者/演员一目了然
- ✅ 一键检查所有订阅的更新
- ✅ 批量导入新作品
场景：电脑上整理好的内容，想在手机上看...
【数据同步1】
操作步骤：
- 电脑端运行服务，点击数据同步，点击生成配对码
- 手机安装 App，配置电脑端的服务器地址，输入配对码
- 点击配对
- 点击「同步」，数据秒传
【数据同步2】
效果：
- ✅ 电脑整理，手机看
- ✅ 增量同步，省流量
- ✅ 离线也能看已缓存内容
场景：你收藏/导入了很多内容，但一时不知道看哪部，想“随便刷刷”找感觉...
操作步骤：
- 进入漫画模式或视频模式，点击侧边栏（或底部导航）的「随机流」
- 上下滑动连续浏览推荐图片（无限序列，可重复）
- 点击当前图片，显示操作按钮（查看详情、刷新序列）；按钮会自动淡出
- 觉得有意思就点「查看详情」，直接跳到对应漫画/视频详情页
效果：
- ✅ 本地库 + 预览缓存混合推荐，开刷就有内容
- ✅ 无限下滑，不会“刷完”
- ✅ 支持缩放、拖拽，浏览体验更接近阅读页
- ✅ 一键刷新随机序列，换一批继续刷
有两种方式，选择适合你的：
最简单的方式！ 直接下载打包好的程序，无需安装任何依赖。
- 打开项目主页：https://github.com/Mmmtttt/ULTIMATE_WEB
- 点击右侧的 Releases 栏
- 下载对应平台的程序包：
- Windows：
ultimate_windows_x.x.x.zip - Linux：
ultimate_linux_x.x.x.zip - Android：
ultimate_android_x.x.x.zip
- Windows：
- 解压后直接运行脚本即可（安卓端直接安装apk，Windows端双击start_app.bat运行）
优点：
- ✅ 无需安装 Python、Node.js 等环境
- ✅ 解压即用，开箱即用
- ✅ 适合不想折腾的用户
如果你想自己编译或参与开发，可以克隆源码：
# 克隆仓库并同步子模块
git clone --recursive https://github.com/Mmmtttt/ULTIMATE_WEB.git
# 如果忘记带子模块
git submodule update --init --recursive然后安装依赖：
# 后端依赖
cd ULTIMATE_WEB/comic_backend
pip install -r requirements.txt
# 前端依赖
cd ../comic_frontend
npm install然后运行
# 后端
.\start_project.ps1 # Windows
./start_project.sh # Linux| 模式 | 适合人群 | 优点 | 缺点 |
|---|---|---|---|
| Windows 内网服务器 | 有电脑，想在家用手机访问 | 设置简单，功能完整 | 电脑要开着 |
| Linux 公网服务器 | 有云服务器，想随时访问 | 随时随地，24小时运行 | 需要购买服务器 |
| 安卓 App | 主要用手机，没有电脑 | 最简单，离线也能用 | 部分功能需配合服务器 |
| Docker 容器 | NAS 用户/有 Docker 环境 | 部署简单，环境隔离 | 需要配置数据持久化 |
如果你下载了打包程序：
- 解压
ultimate_windows_x.x.x.zip - 双击运行
start_app.bat - 浏览器访问
http://localhost:5173
如果你克隆了源码：
.\start_project.ps1手机访问：
- 确保手机和电脑连同一个 WiFi
- 在手机浏览器输入
http://你的电脑IP:5173
同理Windows
- 下载并安装 APK
- 打开 App 即可使用
- 如需同步服务器数据，在设置中配置服务器地址
| 功能 | Windows/Linux | 安卓端 |
|---|---|---|
| 本地库管理 | ✅ | ✅ |
| 在线阅读/播放 | ✅ | ✅ |
| 标签/清单/订阅 | ✅ | ✅ |
| 全网搜索 | ✅ | ❌ |
| 第三方同步 | ✅ | ❌ |
安卓端建议搭配 Windows/Linux 服务器使用：服务器负责同步和搜索，App 负责阅读和同步数据。
使用 Docker 部署，适合 NAS 或支持 Docker 的服务器。
快速启动：
# 拉取镜像
docker pull mmmtttt/ultimate_web:latest
# 运行容器
docker run -d \
--name ultimate_web \
-p 5000:5000 \
-p 5173:5173 \
-v ./data:/app/comic_backend/data \
mmmtttt/ultimate_web:latestDocker Hub 镜像地址：https://hub.docker.com/repository/docker/mmmtttt/ultimate_web/general
功能支持：
| 功能 | 支持情况 |
|---|---|
| 本地库管理 | ✅ |
| 在线阅读/播放 | ✅ |
| 标签/清单/订阅 | ✅ |
| 全网搜索 | ✅ |
| 第三方同步 | ✅ |
| 数据持久化 | ✅（需挂载数据目录） |
数据持久化：
- 将宿主机目录映射到容器内
/app/comic_backend/data - 配置目录映射：
./config:/app/comic_backend/data/config - 媒体目录映射：
./comics:/app/comic_backend/data/comics
这里的账号密码只保存在本地哦，毕竟这是开源项目
这是本项目的核心功能之一！ 专为那些"下载了本子却不想看"的用户设计。
功能亮点：
- 📂 批量导入：选择文件夹，自动扫描所有漫画
- 🔍 智能识别：自动解析漫画信息（标题、作者、页数）
- 📖 在线阅读：不用解压，直接看
- 🏷️ 标签管理：给本子打标签，方便筛选
- ⭐ 评分系统：给本子评分，好本子不埋没
支持同步以下平台的收藏：
- JM（禁漫天堂）：同步收藏夹内容
- PK（哔咔漫画）：同步收藏夹内容
- JavDB：同步收藏的视频
配置方法：
- 编辑
comic_backend/third_party_config.json - 填入平台账号密码
- 在清单管理页面点击「同步」
| 搜索类型 | 说明 |
|---|---|
| 本地搜索 | 在已导入内容中搜索 |
| 预览库搜索 | 在推荐内容中搜索 |
| 全网搜索 | 搜索 JM、PK、JavDB 全平台 |
全网搜索技巧：
- 支持多选，批量导入
- 搜索结果可直接查看详情
| 操作 | 说明 |
|---|---|
| 翻页 | 左右滑动或点击屏幕两侧 |
| 缩放 | 双指捏合或鼠标滚轮 |
| 全屏 | 点击全屏按钮 |
| 跳页 | 点击页码快速跳转 |
| 切换模式 | 左右翻页 / 上下滚动 |
阅读进度自动保存，下次打开继续看！
- ➕ 创建新标签
- ✏️ 编辑标签名称
- 📌 批量给内容打标签
- 🔍 按标签筛选内容
- 🚫 排除不想看的标签
- 📋 创建清单（如"我的最爱"、"待看清单"）
- ➕ 把内容加入清单
- 🔄 同步平台清单
- 📥 批量下载清单内的漫画
- 👤 关注喜欢的作者/演员
- 🔔 一键检查更新
- 📥 批量导入新作品
安卓端支持与服务器同步：
- 📚 漫画/视频元数据
- 📖 阅读进度
- 🏷️ 标签和清单
- 👤 订阅的作者/演员
同步特点：
- 增量同步，节省流量
- 双向同步，数据互通
- 支持离线阅读
适用于漫画模式和视频模式，入口与本地库/预览库同级。
功能亮点：
- 🎲 无限随机序列：以随机为主，可重复，适合"随便看看"
- 🔁 一键刷新序列：随时重排推荐顺序
- 🖼️ 沉浸式浏览：支持上下翻页、缩放、拖拽、前端预加载
- 🔍 详情快速跳转：点击图片显示操作按钮，再跳转到详情
- 🧩 可扩展推荐策略：后端支持权重策略扩展，便于按标签、评分、偏好做个性化推荐
误删内容不用怕！所有删除的内容都会进入回收站。
功能亮点：
- 🗑️ 安全删除：删除的内容暂存回收站，可恢复
- 📤 批量恢复：支持批量选择并恢复内容
- 🗑️ 彻底删除：回收站内再次删除将彻底清除文件
- ⏰ 批量清空：一键清空回收站，释放存储空间
智能管理存储空间，优化系统性能。
功能亮点：
- 📊 存储概览：查看 data 目录总存储大小
- 🧹 一键清理缓存：清理预览库缓存、缩略图缓存、临时文件
- 🗑️ 孤立文件清理：自动检测并清理无引用的孤立文件
- 🔧 数据目录迁移：支持更改 data 目录位置，平滑迁移数据
多层级备份机制，保障数据安全。
功能亮点：
- ⏰ 三级自动备份：
- 每 10 分钟备份一次（增量）
- 每小时备份一次
- 每天备份一次
- 📥 手动备份：支持随时手动触发备份
- 📤 从备份恢复：从任意备份点恢复数据
- 🗂️ 备份管理：查看备份列表，清理过期备份
支持通过软连接方式导入内容，节省磁盘空间。
功能亮点：
- 🔗 软连接导入：不复制文件，只建立索引引用
- 💾 节省空间：避免重复存储，适合多库引用同一文件
- 🔒 原文件保护：源文件移动或删除后自动识别
- 📁 跨目录引用：支持引用任意位置的文件夹
支持大批量文件导入，断点续传保障传输稳定性。
功能亮点：
- 📤 批量上传：一次选择多个文件/文件夹批量导入
- ⏸️ 断点续传：上传中断后支持从中断处继续
- 📊 上传进度可视化：实时显示上传进度和预估时间
- 🔍 可恢复会话：意外关闭页面后可恢复上传会话
可视化查看和管理所有导入任务。
功能亮点：
- 📋 任务列表：查看所有进行中和已完成的导入任务
- ⏳ 任务状态：显示导入中、待处理、已完成、失败等状态
- ❌ 取消任务：支持取消进行中的导入任务
- 🗑️ 清理历史：一键清理已完成/失败的历史任务
自动管理视频相关图片资源。
功能亮点：
- 🖼️ 自动缓存：自动下载并缓存视频缩略图和预览图
- 🔄 手动刷新：支持手动刷新单个或批量视频的缩略图
- 🧹 缓存清理：支持清理指定视频的缓存图片
- 📱 离线预览：缓存后支持离线查看缩略图
智能生成和管理内容封面。
功能亮点：
- 🖼️ 自动提取：从压缩包或视频中自动提取封面
- 🎨 封面质量优化：自动选择最佳质量图片作为封面
- 🔄 手动刷新：支持手动重新生成封面
- 📦 批量处理：支持批量为多个内容重新生成封面
保持数据库健康，提升系统性能。
功能亮点：
- 🔧 整理数据库：自动检测并修复数据库问题
- 🗑️ 清理无效引用：自动清理指向不存在文件的元数据
- 📊 数据库状态：查看数据库健康状况
- 💾 空间回收：清理后释放存储空间
灵活控制功能模块，按需启用。
功能亮点：
- 🔒 第三方集成开关：可单独启用/禁用 JM、PK、JavDB 等第三方平台
- ⚡ 轻量模式：禁用不需要的第三方功能，减少资源占用
- 🛡️ 安全模式：某些场景下可完全禁用第三方功能
- 📱 运行时配置：无需重启服务即可切换配置
检查以下几点：
- 是否安装了 Python 3.13+ 和 Node.js 20+
- 端口 5000 和 5173 是否被占用
- 是否正确安装了依赖
解决方法：
- 确保手机和电脑连同一个 WiFi
- 检查电脑防火墙是否放行端口
- 使用电脑的局域网 IP（不是 localhost）
不会！ 系统有三级自动备份：
- 每 10 分钟备份一次
- 每小时备份一次
- 每天备份一次
即使数据损坏，也可以从备份恢复。
在的！ 导入只是建立索引，原文件不会被移动或删除。
如果你想参与开发或了解更多技术细节，请查看：
- 开发者手册 - 环境配置、打包发布、架构设计
- 三平台构建手册 - Windows/Linux/Android 打包
- 同步设计文档 - 数据同步机制
- NAS 与 Docker 部署说明 - NAS 容器部署、路径映射、数据迁移与注意事项
- 软连接导入架构与限制 -
soft_ref协议抽象、读取链路、扩展点与当前限制
本项目的开发离不开以下开源项目和作者的贡献：
| 项目 | 说明 |
|---|---|
| JMComic-Crawler-Python | JM 禁漫天堂漫画爬虫库，本项目的核心依赖 |
| 项目 | 说明 |
|---|---|
| avbook | 视频图书管理系统的参考实现 |
| NASSAV | NAS 视频管理方案的参考实现 |
感谢以上开源项目的作者们！
本项目采用 MIT 协议开源，欢迎参与贡献！
如果你觉得这个项目有用，欢迎 Star ⭐ 支持一下！