Venera-Next README

The project's README from github.com/CyrilPeng/Venera-Next. As one markdown file: README.md.

简体中文 | English

VeneraNext

VeneraNext

Flutter Release License
Downloads 爱发电


目录


项目介绍

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

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

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

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

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

GitHub 主仓库 Gitee 国内镜像

软件截图

主页:阅读历史、稍后阅读与追更 漫画详情页
VeneraNext 主页,展示阅读历史、稍后阅读和追更 VeneraNext 漫画详情页,展示阅读操作、作品信息和章节列表

功能亮点

本分支的重点改进

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

延续 Venera 的核心能力


下载安装

Android

从 Releases 下载 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

从 Releases 下载 ipa 安装包,使用 AltStore 旁加载。

Windows

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

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

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

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

Linux

从 Releases 下载对应架构的安装包:

发行版 / 方式 安装或运行
Debian / Ubuntu(DEB) sudo apt install ./venera-next_xxx_amd64.deb(ARM64 选择 arm64 包)
Arch Linux(x86_64) sudo pacman -U ./venera-next-xxx-x86_64.pkg.tar.zst

Linux 安装包基于 Ubuntu 22.04 构建,系统需提供兼容的 glibc、GTK 3 和 WebKitGTK 4.1。

macOS

从 Releases 下载 VeneraNext-xxx.dmg。


快速上手

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

使用说明

阅读模式与进度

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

夜间与墨水屏阅读

在“设置 → 外观”选择浅色、深色或跟随系统主题;阅读器内的夜间调光用于进一步压暗漫画画面。开启后可在阅读设置或底部快捷面板调节 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。便携版需要下载新版本手动覆盖更新。

开发者入口


星标历史

Star History Chart

声明

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

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

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


赞助

爱发电

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

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

赞助者名单见 SPONSORS.md。


致谢

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

许可

本项目遵循 GPL-3.0 许可。


友情链接

Venera-Next (CyrilPeng/Venera-Next)

Searching Database…

Что это?VeneraNext — кроссплатформенное приложение для чтения манги и комиксов на Flutter, форк Venera: оно читает локальные файлы комиксов, библиотеки на WebDAV и сторонние JavaScript-источники комиксов на Android, iOS, Windows, Linux и macOS.
В нём есть встроенные источники манги или нужно добавлять свои?В нём вообще нет встроенных источников манги: нужно добавить собственные скрипты-расширения на JavaScript, настроить библиотеку комиксов на WebDAV или просто импортировать локальные файлы.
Что нужно, чтобы читать мангу из интернета?Нужно самостоятельно подключить совместимое расширение-источник комиксов на JavaScript (через страницу управления источниками); само приложение предоставляет только среду выполнения расширений и движок чтения.
Какие локальные форматы файлов НЕ поддерживаются?Не поддерживаются EPUB с текстом (не картинками), страницы SVG с прямой отрисовкой, зашифрованные PDF и файлы MOBI/AZW/AZW3.
Поддерживает ли оно e-ink устройства и ночное чтение?Да — есть отдельный ползунок ночного затемнения (яркость 20%–100%) и режим обновления e-ink, который обновляет экран каждые 1–10 перелистываний, чтобы уменьшить остаточные следы на чернильных экранах.
Чем это отличается от чтения в оригинальной Venera?VeneraNext добавляет плавную прокрутку с переходом между главами (waterfall), просмотр разворотов с разделением, ночное затемнение, обновление e-ink, статистику времени чтения и разделяет сценарии «прочитать позже» и «следить за обновлениями», сохраняя без изменений JS API расширений, локальную библиотеку и избранное Venera.
Можно ли синхронизировать библиотеку и прогресс между телефоном, планшетом и ПК?Да, через WebDAV: синхронизация данных приложения охватывает настройки/избранное/историю/куки/источники, резервное копирование архивов комиксов экспортирует локальные комиксы в CBZ для восстановления, а онлайн-библиотека читает папки с картинками прямо с вашего NAS.
Можно ли написать своё расширение-источник комиксов?Да, есть документированный JavaScript API (сеть, разбор HTML, хранилище, UI, работа с изображениями) и минимальный шаблон источника, так что можно писать расширения, совместимые с моделью комикс/глава/изображение читалки.
Как обновить версию для Windows?Если установлено через winget, выполните «winget upgrade --id CyrilPeng.VeneraNext --exact» (сначала «winget source update», если публичный фид отстаёт); портативную zip-сборку придётся обновлять вручную, скачав и перезаписав файлы.
Creator
CyrilPeng
Size
11 MB
Stars
1.6K
Age
4mo
Commits · 90 Days