CyrilPeng / Venera-Next

简体中文 | 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 升级：
 [code] 
也可以从 最新稳定版 下载 `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 或更新版