CyrilPeng/Venera-Next: +298 stars this week

Rank of CyrilPeng/Venera-Next in each topic for today, this week and this month
Topic	Today	This week	This month
Dart topic	#2of 4	#2of 17	#3of 42
Flutter & cross-platform topic	#6of 19	#8of 85	#15of 146
Windows topic	#27of 71	#46of 262	#56of 411

简体中文 | 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 应用数据同步与导入导出，以及可用于脚本调用的无头命令模式。

下载安装

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.18.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 与日志