简体中文 | English

VeneraNext

项目介绍

VeneraNext 是基于 Venera 持续开发的 Flutter 漫画阅读器，支持 Android、iOS、Windows、Linux 和 macOS。

本分支围绕“少一点打断，多一点阅读”改进日常体验：长篇漫画可以瀑布流跨章阅读，横向双页可以拆开看，夜间和墨水屏设备有各自的阅读设置；从发现作品、稍后阅读、收藏追更，到离线下载、阅读统计和多设备同步，也有相互衔接的入口。

原项目的 JavaScript 漫画源扩展、本地阅读、搜索与分类、收藏下载，以及按源提供的登录、评论和评分能力继续保留。

快速入口： 下载安装 · 使用说明 · 编写漫画源 · JavaScript API · 更新日志

> [!IMPORTANT] > 本仓库只维护阅读器本体和扩展运行环境，不提供、内置、托管或推荐漫画源。网络漫画源需由用户自行合法配置，具体内容及源站可用性由相应扩展和服务决定。

软件截图

主页：阅读历史、稍后阅读与追更	漫画详情页

功能亮点

本分支的重点改进

改进	日常使用体验
瀑布流跨章节阅读	默认阅读模式。接近章末自动预加载下一章，可以继续向下阅读，也可以滚回已加载的上一章；章节分隔和阅读记录跟随实际位置。
纵向拆分双页	在纵向连续和瀑布流模式中，把横向双页按顺序上下排列，支持交换左右两半的先后顺序；保持原图片页数与进度含义。
夜间调光	阅读器内独立开关与 20%–100% 亮度调节，阅读设置和底部快捷面板均可操作；与应用的浅色、深色主题配合使用。
电子墨水屏刷新	画廊翻页后按设定间隔闪屏，可调时长，支持黑色、白色、先白后黑三种样式，帮助减少残影。
更顺手的详情页	桌面与移动端统一两行操作区，突出下载、阅读和继续阅读；显示章节进度与更新提示，章节正序/倒序偏好会保存。
稍后阅读与追更	把“准备开始看的作品”和“持续关注的连载”分别管理；首页提供待看列表、追更封面预览和更新提示。
收藏与检索	收藏页可切换封面画廊，自动或 2～6 列；支持保存作者、标签搜索快捷方式，图片收藏增加单部漫画的图库浏览。
阅读时长统计	记录前台有效阅读时长，在历史页和设置入口查看累计时长、读过的漫画数量与排行。
更完整的本地漫画库	图片目录、CBZ/ZIP/7Z/CB7、PDF 和图片型 EPUB 导入；支持章节目录、自然排序、PDF 批量导入，以及 CBZ 导出和恢复。
WebDAV 漫画库与归档	在线读取 NAS/WebDAV 图片目录，支持目录缓存、增量同步和元数据；本地漫画还可单独备份为 CBZ 并恢复。
数据与桌面体验	配置原子写入与备份恢复、同步状态与错误展示、历史清理，以及 Windows 安装器、便携包和 winget 更新。

延续 Venera 的核心能力

开放的扩展接口：用 JavaScript 对接漫画服务，按源提供搜索、聚合搜索、探索页、分类、排行和标签翻译。
多种阅读方式：保留画廊分页、章节内连续滚动、缩放和多图布局，支持触摸、键盘及移动端音量键等阅读操作。
收藏与离线阅读：本地收藏、网络收藏、历史记录、图片收藏和下载队列；已下载章节可离线读取。
按源启用的互动：登录、Cookie、评论与回复、章节评论、点赞和评分等，由扩展实际支持的能力决定。
跨设备使用：WebDAV 应用数据同步与导入导出，以及可用于脚本调用的无头命令模式。

下载安装

当前稳定版为 v1.17.0。下方下载入口默认指向最新稳定版。

Android

从最新稳定版下载 APK 安装包：

文件名	说明	适用场景
`VeneraNext-xxx-android.apk`	通用版	适用于大多数 Android 设备
`VeneraNext-xxx-android-arm64-v8a.apk`	ARM64 版	支持 ARM64 应用的 Android 设备
`VeneraNext-xxx-android-armeabi-v7a.apk`	ARM32 版	较老的 32 位设备

推荐：如果不确定应该下载哪个，选择通用版 VeneraNext-xxx-android.apk。

iOS

从最新稳定版下载 ipa 安装包，使用 AltStore 旁加载。

Windows

推荐通过 winget 安装，后续可以直接使用同一包 ID 升级：

winget install --id CyrilPeng.VeneraNext --exact
winget upgrade --id CyrilPeng.VeneraNext --exact

也可以从最新稳定版下载 VeneraNext-xxx-windows-installer.exe 安装包或 zip 便携版。便携版不受 winget 管理，需要手动下载新版本并覆盖更新。新版本发布后，winget 公共源可能需要等待 Microsoft 审核；可先执行 winget source update 刷新本地索引。

Windows 安装器、便携包和 winget manifest 维护说明见 doc/distribution/windows.zh.md。

Linux

从最新稳定版下载对应架构的安装包：

发行版 / 方式	安装或运行
Debian / Ubuntu（DEB）	`sudo apt install ./venera-next_xxx_amd64.deb`（ARM64 选择 `arm64` 包）
Fedora 等提供所需依赖的发行版（RPM）	`sudo dnf install ./venera-next-xxx.x86_64.rpm`（ARM64 选择 `aarch64` 包）
Arch Linux（x86_64）	`sudo pacman -U ./venera-next-xxx-x86_64.pkg.tar.zst`
AppImage（x86_64 / ARM64）	`chmod +x VeneraNext-xxx-x86_64.AppImage`，再执行 `./VeneraNext-xxx-x86_64.AppImage`（ARM64 选择 `aarch64` 文件）

xxx 请替换为下载文件中的实际版本号。v1.17.0 稳定版提供 x86_64 和 ARM64 的 RPM 与 AppImage；可用 uname -m 查看机器架构。

Linux 安装包基于 Ubuntu 22.04 构建，glibc 基线为 2.35。当前稳定版 AppImage 已包含 GTK 3 和 WebKitGTK 4.1，无需额外安装 GTK/WebKit；仍需系统提供 glibc 2.35 或更新版本及兼容的 OpenGL/EGL 显卡驱动。依赖安装、FUSE 问题及发行版兼容范围见 Linux 安装与分发。

macOS

从最新稳定版下载 VeneraNext-xxx.dmg。

快速上手

从最新稳定版安装适合当前平台的版本。
选择内容来源：设备上的图片、压缩包或图片文档进入“本地 → 导入”；网络阅读先添加兼容扩展；NAS 目录在“设置 → 应用 → WebDAV 漫画库”配置。
在“设置 → 阅读器”选择阅读模式。长篇连载可用默认瀑布流；传统逐页翻看可用画廊；只想在当前章滚动可用连续模式。
按设备调整拆分双页、夜间调光或墨水屏刷新。需要时启用设备专属、漫画专属设置。
详情页点“阅读/继续阅读”或具体章节开始；暂时不看可加入“稍后阅读”，连载作品可放入追更收藏夹。
需要离线时下载章节；需要跨设备时再配置数据同步、漫画归档或在线漫画库。

使用说明

阅读模式与进度

模式	方向	适用场景
瀑布流	从上到下	跨章节连续阅读，接近边界时加载相邻章节
画廊	从左到右、从右到左、从上到下	按页翻看，可按阅读习惯设置多图布局
连续	从左到右、从右到左、从上到下	当前章节内滚动，保留章节切换边界

预加载：瀑布流复用“预加载图片数量”设置。数量越大，可能越早加载后续内容，也会增加网络和内存占用。
拆分双页：只适用于纵向连续、瀑布流；顺序不合适时开启“交换拆分顺序”。应用仍按原图片记录页数。
继续阅读：保存章节、页码和章节组；瀑布流会记录实际正在阅读的章节。详情页的正序/倒序只调整章节列表显示。
设置范围：阅读设置按漫画专属、设备专属、全局依次回退，专属设置需先启用。

单页阅读模式	拆分双页模式

夜间与墨水屏阅读

在“设置 → 外观”选择浅色、深色或跟随系统主题；阅读器内的夜间调光用于进一步压暗漫画画面。开启后可在阅读设置或底部快捷面板调节 20%–100% 的亮度，它作用于应用内画面，不调整设备系统亮度。

墨水屏设备可选择画廊模式并开启“电子墨水屏刷新”：设置每 1～10 次翻页刷新一次、100～1500 毫秒闪屏时长，以及黑色、白色或先白后黑样式。这是阅读器画面的闪屏刷新，效果会受设备自身刷新策略影响。连续与瀑布流模式不触发这一功能。

详情页、稍后阅读与追更

详情页：常用互动操作与下载/阅读主按钮分行显示，继续阅读、章节进度、更新提示集中呈现；正序/倒序切换会记住偏好。
稍后阅读：详情页或本地漫画菜单可加入/移除，首页可以进入完整列表。打开阅读不会自动移除；列表复用独立本地收藏夹，可重命名、删除并随应用数据同步。
追更：以选定的本地收藏夹作为检查范围，首页展示封面和更新数量。默认快捷收藏可指向“追更”，已有有效偏好与主动停用状态会保留；长按详情页收藏按钮可快速收藏。
更新依据：追更依赖源详情提供的有效更新日期，不保证仅凭新增章节就能识别更新；更新提示可在设置中关闭。
作者与标签：支持搜索跳转的作者/标签可保存为搜索快捷方式，在搜索页复用；这是保存检索条件，不是自动追更某位作者的全部作品。

收藏、图片与阅读统计

本地收藏由应用管理，网络收藏由源站账号和扩展提供。收藏页的封面画廊支持自动或 2～6 列布局；图片收藏可按漫画进入图库浏览。

历史页记录阅读位置和前台有效阅读时长，并提供累计时长、漫画数量和时长排行；“设置”中也有阅读统计入口。可按保留天数清理历史。离开阅读器或进入后台时会结算相应的有效阅读时段。

本地漫画与离线下载

内容	导入与阅读方式
图片目录	支持单本、批量目录及章节子目录；封面可选，文件按自然顺序排列
CBZ / ZIP / 7Z / CB7	解压后导入本地库，支持带顶层目录和章节子目录的归档
PDF	支持多选逐本导入、进度与取消；逐页转为本地 JPEG，第一页作为封面
图片型 EPUB	按 spine 顺序提取栅格图片，尽量保留标题、作者、封面和有效章节导航
网络源下载	已下载章节进入本地漫画库，供离线阅读，也可用于后续导出和归档

可导出 CBZ、扫描恢复下载内容、删除章节或迁移存储位置。PDF/EPUB 导入会占用额外空间；文字型 EPUB、直接绘制的 SVG 页面、加密 PDF 和 MOBI/AZW/AZW3 不支持。

目录示例、压缩包兼容规则及元数据模板见本地漫画导入、CBZ 与 WebDAV 漫画库。

网络漫画源

网络内容由用户添加的 JavaScript 扩展提供，不同扩展支持的搜索、探索、分类、账号、收藏和评论入口可能不同。

在漫画源管理页添加兼容的脚本链接或文件。编写自己的扩展请阅读下方漫画源开发。

WebDAV 数据同步、归档与在线漫画库

三类能力分别配置：

能力	“设置 → 应用”中的入口	用途
应用数据同步	数据同步 / Data Sync	同步设置、收藏、历史、Cookie 和源文件等，不包含本地漫画图片
漫画归档	漫画归档备份 / Comic Archive Backup	把本地漫画导出为 CBZ 上传，或下载归档恢复到本地库
在线漫画库	WebDAV 漫画库 / WebDAV Comic Library	按需读取远端图片目录，并缓存目录与图片

在线漫画库支持普通图片目录、带章节的目录，以及 VeneraNext 导出 CBZ 的解压目录。有效的 metadata.json 可提供标题、作者、标签和章节页码范围，也可标记分层目录中的漫画根目录；元数据无效时回退普通目录识别。

书架优先展示缓存，后台增量检查远端变化，可手动同步和设置自动更新周期。远端 CBZ/ZIP/7Z/CB7 本身不支持在线预览，应先在服务端解压，或通过归档恢复后本地阅读。目录与元数据规则

漫画源开发

第三方源开发者从这里开始：

文档	内容
漫画源编写指南	最小示例、搜索/详情/章节返回规则、图片请求与可选能力
最小源模板	可复制的 JS 文件，使用虚构接口演示完整加载流程
JavaScript API	Network、HTML 解析、数据存储、UI、图片处理及运行时限制
本地调试	导入、编辑、JS Evaluator 与日志

英文对应文档：Comic Source Guide · JavaScript API · Local Source Debugging。

本分支继续维护兼容 Venera 的扩展接口。瀑布流、拆分双页和夜间调光由阅读器处理；扩展应提供稳定的漫画/章节标识、正确的章节与图片顺序、有效的更新日期，无需为每一种阅读模式另写一套规则。

FAQ

VeneraNext 自带漫画源吗？

不自带，也不提供推荐源列表。可以先导入本地漫画，或自行合法配置兼容扩展、WebDAV 漫画库。

搜索不到内容、图片加载失败或没有追更提示怎么办？

先检查扩展、登录/Cookie、源站状态和网络。追更还需要扩展返回有效的更新日期。具体站点和内容问题应联系相应维护者；可脱离具体站点复现的阅读器或扩展运行时问题可按贡献指南反馈。

Windows 怎样更新？

使用 winget upgrade --id CyrilPeng.VeneraNext --exact。公共源收录新版本可能晚于 GitHub Release，可先运行 winget source update。便携版需要下载新版本手动覆盖更新。

开发者入口

构建与开发：Flutter/Rust 环境、依赖锁定、测试和发布。
贡献指南 · 项目结构约定 · 依赖治理。
Windows 分发维护 · 无头命令模式。
安全政策 · 行为准则 · 完整文档索引。

星标历史

声明

本仓库只维护 VeneraNext 漫画阅读器本体，不提供、内置、托管或推荐任何漫画源，也不处理任何源站内容。

网络阅读能力兼容 JavaScript 扩展 API，需要用户自行配置合法的漫画源扩展；搜索结果、章节加载、图片可用性和内容版权均取决于对应源站与扩展实现。

请不要在本仓库提交与漫画源、源站内容、具体作品可用性或版权相关的问题，此类反馈会直接关闭。

赞助

本项目为个人兴趣维护，不以盈利为目的。如果 VeneraNext 对你的日常阅读有帮助，欢迎在爱发电上支持作者的持续维护。

赞助状态会通过爱发电 API 定期同步。需要公开鸣谢时，请在订单备注中填写“公开昵称：你的昵称”；未提供公开昵称的订单不会展示。

赞助者名单见 SPONSORS.md。

致谢

感谢 Venera 提供的阅读器与扩展基础，以及 EhTagTranslation 的中文标签翻译数据。也感谢所有贡献者与赞助者。

许可

本项目遵循 GPL-3.0 许可。

友情链接

LINUX DO