FLUTTER ECOSYSTEM

CyrilPeng/Venera-Next

VeneraNext 是一個跨平台漫畫閱讀器，支援本機漫畫、WebDAV 漫畫來源、第三方網路漫畫來源，支援 Android、iOS、Windows、Linux、macOS 平台。

在 GitHub 查看 ↗

Stars: 848
Forks: 24
最近推送（UTC）: 2026年9月16日
專案狀態: 未封存

GITHUB User

某不科学的高数 ↗

到工位就来聊天摸鱼，再陌生的网友也要保持亲密关系！

語言DartC++JavaScriptKotlinCMakePythonSwiftInno SetupRubyCObjective-C

技術主題

# cbz # comic-reader # dart # flutter # manga-reader # webdav # windows

使用的依賴

依賴清單 51 項

flutter{"sdk":"flutter"}
path_provider^2.1.6
intl^0.20.2
window_manager^0.5.2
sqlite3^2.7.4
sqlite3_flutter_libs^0.5.42
flutter_qjs{"git":{"url":"https://github.com/venera-app/flutter_qjs","ref":"8feae95df7fb00455df129ad7a0dfec1d0e8d8e4"}}
crypto^3.0.7
dio^5.11.0
html^0.15.7
pointycastle^4.0.0
url_launcher^6.3.2
path^1.9.0
photo_view{"git":{"url":"https://github.com/venera-app/photo_view","ref":"a1255d1b5945aad4b7323303ec2ecdf0c90ffc4c"}}
mime^2.1.0
share_plus^12.0.2
scrollable_positioned_list{"git":{"url":"https://github.com/venera-app/flutter.widgets","ref":"09e756b1f1b04e6298318d99ec20a787fb360f59","path":"packages/scrollable_positioned_list"}}
flutter_reorderable_grid_view^5.7.0
uuid^4.6.0
desktop_webview_window{"git":{"url":"https://github.com/venera-app/flutter_desktop_webview","path":"packages/desktop_webview_window","ref":"7801fc582ecf5a7351632887891ecf309a7b2583"}}
flutter_inappwebview{"git":{"url":"https://github.com/venera-app/flutter_inappwebview","path":"flutter_inappwebview","ref":"3ef899b3db57c911b080979f1392253b835f98ab"}}
app_links^7.0.0
sliver_tools^0.2.12
flutter_file_dialog^3.0.3
file_selector^1.1.0
zip_flutter^0.0.13
lodepng_flutter{"git":{"url":"https://github.com/venera-app/lodepng_flutter","ref":"ac7d05dde32e8d728102a9ff66e6b55f05d94ba1"}}
rhttp^0.15.1
webdav_client{"git":{"url":"https://github.com/venera-app/webdav_client","ref":"2f669c98fb81cff1c64fee93466a1475c77e4273"}}
battery_plus^7.1.1
local_auth^3.0.2
flutter_saf{"git":{"url":"https://github.com/venera-app/flutter_saf","ref":"fe182cdf40e5fa6230f451bc1d643b860f610d13"}}
dynamic_color^1.8.1
shimmer_animation^2.1.0
flutter_memory_info^0.0.3
syntax_highlight^0.5.0
flutter_7zip{"git":{"url":"https://github.com/venera-app/flutter_7zip","ref":"b33344797f1d2469339e0e1b75f5f954f1da224c"}}
flex_seed_scheme^4.0.1
flutter_localizations{"sdk":"flutter"}
yaml^3.1.4
enough_convert^1.6.0
display_mode^0.0.2
flutter_staggered_grid_view^0.7.0
archive^4.2.0
image^4.9.2
pdfrx^2.4.7
xml^6.6.1
flutter_test開發依賴{"sdk":"flutter"}
flutter_lints開發依賴^6.0.0
flutter_to_arch開發依賴^1.0.1
flutter_to_debian開發依賴{"git":{"url":"https://github.com/venera-app/flutter_to_debian.git","ref":"3777c91b6b1cc0b7c03357c67ca216d4313c3db5"}}

所在榜單

Rising#9

原始 README

以下為英文專案原文快照，最新內容請造訪 GitHub。

展開 / 收合專案 README

简体中文 | English

VeneraNext

VeneraNext

Flutter Release License
Downloads 爱发电

项目介绍

VeneraNext 是一个基于 Flutter 框架开发的跨平台漫画阅读器，支持本地漫画和网络漫画源，支持 Android、iOS、Windows、Linux、macOS 平台。

本项目是 Venera 的 fork 分支，定位是面向个人日常使用的漫画阅读器，核心理念是尽量减少打断阅读的动作。

长篇作品可以用瀑布流跨章节连续阅读，也可以把常看的作品收藏、追更、离线下载，并通过 WebDAV 在多台设备之间同步常用数据。

[!IMPORTANT] 重要声明：本仓库只维护漫画阅读器本体，不提供、内置、托管或推荐任何漫画源。漫画源需要由用户自行合法配置，请不要在本仓库反馈源站内容、具体作品可用性或漫画源本身的问题。

GitHub 主仓库 Gitee 国内镜像

功能亮点

本分支特色

瀑布流跨章节阅读：默认阅读模式。阅读到章节末尾附近时会自动预加载下一章，适合长篇连载和整卷连续阅读。
纵向模式拆分双页：纵向连续和瀑布流模式可将横向双页图拆成上下排列，并支持交换拆分顺序，适合右翻、左翻方向不同的作品。
章节排序偏好：漫画详情页的正序、倒序切换使用分段控件，状态会作为全局偏好保存，减少每次打开都要重新调整的操作。
阅读时长统计：按漫画累计前台有效阅读时长，并在历史页集中展示总时长、阅读最久漫画和时长排行。
本地漫画和远端目录并重：本地漫画支持目录、CBZ/ZIP/7Z、PDF 和图片型 EPUB 导入；WebDAV 漫画库支持普通图片目录，以及 VeneraNext 导出 CBZ 的解压目录在线阅读。

漫画来源

本地漫画：适合阅读设备上已有的图片目录、压缩包或图片文档。支持单本目录、批量目录、CBZ、ZIP、7Z、CB7、PDF 和图片型 EPUB 导入。
网络漫画源：兼容 JavaScript 扩展 API。添加扩展后，可使用搜索、分类、排行、探索页、收藏和下载等能力。
WebDAV 漫画库：把 WebDAV 服务端作为在线漫画库读取，适合 NAS、Nextcloud、坚果云等场景；支持普通图片目录和 CBZ 解压后的增强目录，不在线预览压缩包本身。
下载内容：网络源章节可以下载到本地漫画库，适合移动端离线阅读或网络不稳定时使用。

管理与同步

收藏管理、阅读历史与时长统计、图片收藏、下载队列和追更。
本地漫画导入、导出、扫描恢复、章节删除和存储路径迁移。
WebDAV：数据同步、漫画归档（CBZ 备份/恢复）和在线漫画库，详见使用说明。

跨平台

Android、iOS、Windows、Linux、macOS
Releases 提供多平台构建产物
Windows 已正式接入 winget，可使用包管理器安装和更新

完整变更记录见 CHANGELOG.md。

下载安装

Android

从 Releases 下载 APK 安装包：

文件名	说明	适用场景
`VeneraNext-xxx-android.apk`	通用版	适用于大多数 Android 设备
`VeneraNext-xxx-android-arm64-v8a.apk`	ARM64 版	适用 4GB 以上内存的 64 位设备
`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 下载 venera-next_xxx_amd64.deb 或 AppImage。

macOS

从 Releases 下载 VeneraNext-xxx.dmg。

快速上手

从 Releases 下载适合当前平台的安装包。
先选择漫画来源：
- 已经有图片目录、漫画压缩包、PDF 或图片型 EPUB：进入 本地 -> 导入。
- 使用网络漫画源：进入漫画源管理，添加兼容 JavaScript 扩展 API 的扩展。
- 使用 NAS/WebDAV 在线阅读：进入 设置 -> 应用 -> WebDAV Comic Library 配置远端目录。
在 设置 -> 阅读器 中选择阅读模式。长篇作品推荐瀑布流；希望传统翻页时选择画廊；希望只在当前章节内纵向阅读时选择连续模式。
打开漫画详情页，检查章节顺序。如果章节列表方向不符合习惯，用正序/倒序切换调整，应用会记住这个偏好。
如果作品包含横向双页图，在纵向连续或瀑布流模式中开启拆分双页；顺序不对时再开启交换拆分顺序。
常看的作品可以加入收藏或追更；网络不稳定或移动端使用时，可先下载章节再阅读。
多设备使用时再配置 WebDAV。注意：应用数据同步、CBZ 归档备份、WebDAV 在线漫画库是三套独立配置。

使用说明

阅读器模式

瀑布流（从上到下）：本分支重点优化的默认模式。适合长篇连续阅读，会在接近章节末尾时加载后续章节，阅读体验接近整本连续卷。
画廊模式：传统分页阅读。左右、上下方向可选，适合想严格按页翻看的场景。
连续模式：在当前章节内连续滚动，不自动跨章节。适合希望保留章节边界，但又想纵向浏览的场景。
图片预加载：可在阅读器设置中调整预加载数量。网络较慢时适当增加；移动端内存较小或容易发热时不建议设置过高。
进度记录：阅读器会记录章节、页码和章节组。瀑布流跨章节阅读时也会更新到当前实际章节。
拆分双页：只作用于纵向连续和瀑布流模式。它会把横图处理成上下排列的竖向图，不改变章节页数；如果拆分后阅读顺序不对，可开启交换顺序。

本地漫画

本地漫画适合阅读设备上已有的作品，也适合管理从网络源下载的章节。
支持两类目录结构：

漫画目录/
├── cover.jpg
├── 001.jpg
└── 002.jpg

漫画目录/
├── cover.jpg
├── 第01卷/
│   ├── 001.jpg
│   └── 002.jpg
└── 第02卷/
    ├── 001.jpg
    └── 002.jpg

cover.jpg 可选；如果没有封面，应用会尽量使用第一张图片作为封面。
页面顺序按文件名自然排序，例如 图片_1.jpg、图片_2.jpg、图片_10.jpg；也支持补零编号和多段数字。PDF/EPUB 转换及归档元数据明确指定的顺序继续保留。
批量导入目录时，应选择“包含多本漫画目录”的父目录，而不是某一本漫画内部的章节目录。

CBZ/ZIP/7Z 导入导出

CBZ/ZIP/7Z/CB7 适合作为导入、导出、备份、迁移和分发格式。
压缩包可以直接包含图片，也可以包含一个顶层目录；如果顶层目录下是章节目录，应用会按章节导入。
支持这种打包风格：

猫之眼[北条司].cbz
└── 猫之眼[北条司]/
    ├── cover.jpg
    ├── 第01卷/
    │   ├── 001.jpg
    │   └── 002.jpg
    └── 第02卷/
        ├── 001.jpg
        └── 002.jpg

如果压缩包很大，导入需要先解压和复制到本地漫画库，因此更适合“下载后阅读”或“分发迁移”，不适合作为在线流式阅读格式。
已导入的本地漫画可以导出为 CBZ，便于备份或在设备之间移动。

PDF 与图片型 EPUB 导入

PDF 支持一次选择多本并依次导入，显示文件和页数进度；可安全取消，已完成的漫画会保留，同名或重复文件会跳过，单本失败不会中断整批任务。
PDF 会在导入时逐页渲染为本地 JPEG 图片，第一页作为封面；导入结果为无章节漫画。
图片型 EPUB 会按 spine 顺序提取栅格图片，并尽量保留标题、作者、封面和有效章节导航；原图不会重新压缩。
文字型 EPUB、直接绘制的 SVG 页面、加密 PDF，以及 MOBI/AZW/AZW3 暂不支持。
PDF/EPUB 导入后会占用额外本地存储，阅读器读取的是转换后的图片，不会继续依赖原文件。
完整兼容规则见本地漫画导入文档。

网络漫画源

漫画源通过兼容 JavaScript 扩展 API 的扩展提供。添加扩展后，应用才能搜索、浏览和读取对应站点内容。
本仓库不提供源列表，也不处理源站内容问题。搜索不到、章节为空、图片加载失败，通常需要检查对应扩展、源站状态、网络环境或代理设置。
不同漫画源提供的能力不同。分类、排行、评论、评分、归档下载、登录等入口会按扩展实际支持情况显示。
如果某个源要求登录、Cookie 或站点验证，应在对应源的设置或登录入口中处理。

WebDAV 漫画库

WebDAV 漫画库是一种在线阅读渠道，适合把 NAS、Nextcloud、ownCloud、坚果云等服务端目录当作漫画库。
配置入口：设置 -> 应用 -> WebDAV Comic Library。
普通目录不要求配置文件。漫画名默认取文件夹名，章节取子目录；没有 cover.* 时会依次尝试根目录首图、首个可读章节的封面或首图。
普通目录示例：

/venera_comics/
├── 猫之眼[北条司]/
│   ├── cover.jpg
│   ├── 第01卷/
│   │   ├── 001.jpg
│   │   └── 002.jpg
│   └── 第02卷/
│       ├── 001.jpg
│       └── 002.jpg
└── 另一部漫画/
    ├── cover.jpg
    └── Chapter 01/
        ├── 001.webp
        └── 002.webp

VeneraNext 导出的单本 CBZ 解压后也可以直接放入漫画库。目录中的 metadata.json 会提供标题、作者、标签和章节页码范围，根目录图片仍按需加载：

/venera_comics/猫之眼/
├── metadata.json
├── ComicInfo.xml
├── cover.jpg
├── 0001.jpg
├── 0002.jpg
└── ...

metadata.json 缺失、损坏或章节范围不合法时，应用会忽略元数据并回退普通目录推断，不会隐藏整本漫画。
远端 CBZ/ZIP/7Z/CB7 文件仍会被视为归档文件，不会在线预览；需要在线阅读时，应先在服务端解压为上述目录。
首次打开远端目录时需要列目录，WebDAV 服务端较慢时会有等待；图片阅读时按需加载，并走应用缓存。
完整目录规则和元数据模板见本地漫画导入、CBZ 与 WebDAV 漫画库。

WebDAV 数据同步和漫画归档

VeneraNext 有三类 WebDAV 能力，配置入口和用途不同：

能力	设置入口	用途	是否用于在线阅读
WebDAV 数据同步	`设置` -> `应用` -> `Data Sync`	同步设置、收藏、历史、Cookie、漫画源文件等应用数据	否
WebDAV 漫画归档	`设置` -> `应用` -> `Comic Archive Backup`	将本地漫画导出为 CBZ 上传，或从远端 CBZ 下载恢复	否
WebDAV 漫画库	`设置` -> `应用` -> `WebDAV Comic Library`	读取远端目录图片结构并在线阅读	是

数据同步适合多设备共享应用状态，但不会同步本地漫画图片本体。
漫画归档适合换设备、备份和恢复本地漫画。它会上传或下载 CBZ 文件，恢复后漫画会进入本地漫画库。
WebDAV 漫画库适合在线读取远端图片目录，不要求先把整本漫画下载到本地。

收藏、追更和下载

收藏用于长期管理作品，阅读历史用于快速回到最近看过的位置。
稍后阅读：在漫画详情页点击“稍后阅读”，或从本地漫画列表菜单加入；主页可快速打开待看列表。再次点击可移除，打开阅读不会自动移除。它使用独立的本地收藏夹，支持重命名、删除和备份同步，不改变快速收藏设置。
追更会检查已追更漫画的更新情况，适合连载作品；追更结果依赖对应网络源或收藏数据。
下载管理用于离线阅读，网络状况不稳定或移动端使用时尤其有用。下载后的章节会作为本地漫画内容读取。
图片收藏和图库浏览适合单独保存、查看喜欢的图片页。
本地收藏和网络收藏是不同概念：本地收藏由应用维护，网络收藏依赖对应源站账号和扩展能力。

FAQ

1. VeneraNext 自带漫画源吗？

不自带。VeneraNext 只提供阅读器、兼容 JavaScript 扩展 API 的漫画源运行环境和本地管理能力，网络内容需要用户自行合法配置漫画源扩展。

2. 可以在本仓库反馈漫画源问题吗？

不建议，也不会在本仓库处理。与漫画源、源站内容、具体作品可用性、章节缺失、图片加载失败或版权相关的问题，请不要提交到本仓库。

本仓库只维护阅读器本体。如果问题能在不涉及具体源站和具体内容的情况下复现，例如阅读器崩溃、界面异常、设置不生效、构建失败，可以提交 issue。

3. 为什么搜索不到漫画或图片加载失败？

通常与漫画源扩展、源站状态、网络环境或代理设置有关。请先检查对应漫画源是否仍可用，以及当前设备是否能正常访问对应站点。

4. Windows 能不能一键更新？

可以。推荐使用 winget 安装和升级：

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

如果刚发布的新版本尚未显示，请先运行 winget source update。winget 版本更新需要经过 Microsoft 审核，通常会晚于 GitHub Release；zip 便携版无法通过 winget 自动升级。

开发者入口

README 面向安装和使用。构建、测试、仓库结构与发布维护说明统一放在开发文档中：

星标历史

声明

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

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

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

赞助

爱发电

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

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

赞助者名单见 SPONSORS.md。

许可

本项目遵循 GPL-3.0 许可。