VeneraX

<div align="center">
  <img src="assets/new_logo.png" width="180" alt="VeneraX" />
  <h1>VeneraX</h1>

[![Flutter](https://img.shields.io/badge/flutter-3.44.3-blue)](https://flutter.dev/)
![AI-Driven](https://img.shields.io/badge/AI--Driven-Claude%20|%20Codex%20|%20DeepSeek-6e47ff)
[![License](https://img.shields.io/github/license/Kyosee/VeneraX)](https://github.com/Kyosee/VeneraX/blob/master/LICENSE)
[![Stars](https://img.shields.io/github/stars/Kyosee/VeneraX?style=flat)](https://github.com/Kyosee/VeneraX/stargazers)
[![Release](https://img.shields.io/github/v/release/Kyosee/VeneraX)](https://github.com/Kyosee/VeneraX/releases)

  <p>中文 | <a href="README_EN.md">English</a></p>
</div>

VeneraX 是一款免费开源的多平台漫画阅读应用，基于 Venera 持续维护与增强。

**[下载](#下载与安装) · [功能](#新功能优化) · [使用说明](doc/guide.zh.md) · [更新日志](CHANGELOG.md) · [反馈](#反馈与贡献)**

> **原始项目：** 本项目 fork 自 [venera-app/venera](https://github.com/venera-app/venera)。

> [!IMPORTANT]
> **使用前请阅读[《VeneraX 用户协议与免责声明》](#venerax-用户协议与免责声明)**，了解软件功能、第三方服务风险及数据处理情况。本说明不增加 GNU GPLv3 之外的许可限制；依法需要另行取得的数据处理同意仍须单独办理。

## 下载与安装

**[下载最新版本](https://github.com/Kyosee/VeneraX/releases/latest)** · [全部版本](https://github.com/Kyosee/VeneraX/releases)

请按系统和处理器架构选择安装包，并查看对应版本的安装说明。

鸿蒙仍为开发预览版：[测试包安装说明](doc/harmonyos-testing.md) · [从源码构建与适配](doc/harmonyos.md)。

<details>
<summary><b>Linux AppImage 安装说明</b></summary>

在 [Releases](https://github.com/Kyosee/VeneraX/releases) 下载 `VeneraX-<版本>-x86_64.AppImage`（Intel / AMD 64 位）或 `VeneraX-<版本>-aarch64.AppImage`（ARM64）。赋予执行权限后直接运行，无需安装 deb 包：

```bash
chmod +x VeneraX-<版本>-x86_64.AppImage
./VeneraX-<版本>-x86_64.AppImage
```

请替换示例中的版本号和架构。AppImage 包含 GTK、WebKitGTK、ONNX Runtime 及托盘运行库，基于 Ubuntu 22.04 构建；需要 glibc 2.35 或更新版本、桌面图形驱动及 X11／XWayland，不支持旧版 glibc 或 Alpine 等 musl 系统。系统缺少 FUSE 时可解包运行：

```bash
./VeneraX-<版本>-x86_64.AppImage --appimage-extract
./squashfs-root/AppRun
```

更新时下载新版 AppImage 并替换旧文件；应用数据仍保存在原有用户数据目录。

</details>

## 新功能&优化

<details open>
<summary><b>查看完整功能列表</b></summary>

### 阅读体验

- [x] 连续章节无缝阅读
- [x] 章节阅读状态变更
- [x] 自定义章节顺序：可按名称、倒序或目录修改时间批量排序，可隐藏重复章节，设置随同步
- [x] 自动翻页新增匀速滚动模式，可设置阅读时屏幕常亮
- [x] 夜览模式
- [x] 阅读背景色（可按漫画设置）
- [x] 墨水屏适配（实验性）：翻页时全屏刷新清残影，掌阅设备支持系统水波纹翻页

### 漫画管理

- [x] 本地、追更、收藏优化；追更可同时追多个收藏夹，可设检查间隔、启动时检查与每日定时检查
- [x] 稍后阅读功能
- [x] 支持多库管理
- [x] 自定义合集：把分卷、分部发布的多本漫画合成一本阅读，可跨来源
- [x] 阅读统计：记录阅读时长，支持排序与滑动删除
- [x] 抽一本：从收藏中随机抽取一本，可选抽取范围
- [x] 导入本地 PDF 漫画
- [x] 自定义漫画缓存目录
- [x] 支持自定义自动清理历史记录

### 同步与隐私

- [x] WebDAV 备份与同步优化，可逐项选择不参与同步的设置
- [x] 支持多设备通过扫码方式快速同步webdav配置信息
- [x] WebDAV 漫画库（实验性）
- [x] 应用锁新增 PIN 码、密码、手势解锁

### 翻译与画质

- [x] 阅读时 AI 翻译（实验性）：图片与 OCR 均在本机处理，仅将识别文字发送到用户自行配置的 LLM；服务商支持新手模板/模型拉取与高级自定义，提供省资源、均衡、快速档位，支持整章预翻译、智能消字与受限区域嵌字；支持繁体中文（含竖排）、自定义目标语言与自定义翻译接口脚本，主页可查看已翻译漫画
- [x] 简易画质增强功能，支持原图与增强效果实时对比预览

### 平台与交互

- [x] 新增任务功能，支持后台执行任务及相关视图界面
- [x] 支持 Android 端后台下载、追更检查、导入/导出漫画
- [x] 支持 Windows 端托盘最小化
- [x] 桌面端自定义快捷键：全屏、翻页、切换章节、阅读菜单等均可自由设置；Windows 可用全局快捷键隐藏到托盘或唤回窗口
- [x] Windows 与 Android APK 自动检查更新
- [x] 支持主界面长按自定义功能区排序
- [x] 部分 UI 及使用体验调整优化

</details>

## 使用说明

各