# 本地漫画导入 英文版本:[import_comic.en.md](import_comic.en.md) ## 简介 VeneraNext 支持从本地目录、漫画压缩包、PDF 和图片型 EPUB 导入漫画。导入后的内容会统一存放为本地图片漫画,以复用现有阅读模式、进度记录和拆分双页等能力。 支持的漫画图片扩展名包括 `jpg`、`jpeg`、`jpe`、`png`、`webp`、`gif` 和 `avif`。 导入后看不到条目时,请先检查本地列表的搜索词和关键词屏蔽设置。列表会提示因关键词屏蔽隐藏的数量;收藏页还会提示阅读状态筛选隐藏的数量。提示不会自动修改规则。Unicode、括号或双扩展名本身不代表文件名无效,无需先批量改名或删除数据。批量导入请核对实际成功/失败数量及具体失败文件。 多选模式左上角的数字是选中数量,不是导入成功数量。从 v1.18.2-rc.3 起修复本地列表全选/反选误选隐藏条目及刷新后残留旧选择的问题;v1.18.1 和此前 rc.1/rc.2 不包含此修复。这不代表 Android 上归档导入后不显示的所有场景已经解决。反馈时请区分导入结果、可见/隐藏条目与选择数量,并提供完整版本和单个/批量导入入口,无需清库或重复上传私人归档。 ## 恢复本地下载 如果迁移应用时保留了本地下载文件夹,但丢失了 `local.db`,可以通过扫描当前本地路径恢复本地数据库。 - 打开 `本地` -> `导入` -> `恢复本地下载`。 - 应用会扫描当前本地存储路径并重建条目。 - 该操作不会复制文件,也不会添加收藏。 - 同名标题或目录会被视为重复并跳过。 执行前请确认设置中的本地存储路径指向包含已下载漫画的目录。 ## 漫画目录 目录只有符合以下两种结构之一时,才会被视为漫画目录。 **无章节目录** ```text comic_directory ├── cover.[ext] ├── img1.[ext] ├── img2.[ext] ├── img3.[ext] ├── ... ``` **包含章节目录** ```text comic_directory ├── cover.[ext] ├── chapter1 │ ├── img1.[ext] │ ├── img2.[ext] │ ├── img3.[ext] │ ├── ... ├── chapter2 │ ├── img1.[ext] │ ├── img2.[ext] │ ├── img3.[ext] │ ├── ... ├── ... ``` 图片文件名可以任意命名,但扩展名必须是有效图片格式。 页面按文件名自然排序,例如 `图片_1.jpg`、`图片_2.jpg`、`图片_10.jpg`;支持多段数字、前导零和大小写文件名。 封面图是可选的。如果目录中存在 `cover.[ext]`,它会被识别为封面;否则第一张图片会被用作封面。 漫画标题使用漫画目录名。章节标题使用章节目录名。 ## 压缩包 VeneraNext 支持从压缩包导入漫画。 压缩包适合作为导入、导出、归档、迁移和分发格式,应符合 [Comic Book Archive](https://en.wikipedia.org/wiki/Comic_book_archive_file) 格式。 当前支持以下压缩包格式: - `.cbz` - `.cb7` - `.zip` - `.7z` 压缩包可以直接包含图片,也可以包含一个顶层目录;如果顶层目录下是多个章节目录,应用会按章节目录导入。 ```text 猫之眼[北条司].cbz └── 猫之眼[北条司] ├── cover.jpg ├── 第01卷 │ ├── 001.jpg │ └── 002.jpg └── 第02卷 ├── 001.jpg └── 002.jpg ``` 如果根目录没有 `cover.[ext]`,应用会使用第一章的第一张图片作为封面。 ### 鸿蒙漫画合集 ZIP 开发分支的「漫画合集 ZIP」支持以下两种结构;外层自动识别改进尚未随安装包发布。 ```text 合集.zip 合集.zip ├── 漫画甲/图片 └── 总文件夹/ └── 漫画乙/章节/图片 ├── 漫画甲/图片 └── 漫画乙/章节/图片 ``` 应用只识别一层可选总文件夹,不递归压平目录。若只有一个顶层文件夹,里面全是直接放图片的子文件夹,这既可能是多本漫画,也可能是同一本漫画的章节:此时会显示目录名,由你选择「分别导入」或「保留为一本含章节的漫画」。没有默认选择,取消不会入库,也不需要重新压缩文件。已有封面或正文图片的漫画根目录不会自动剥离。 每本漫画仍按自己的目录名命名并保留章节。普通「一个归档文件」继续按单本漫画导入,不自动拆成多本;隐藏的系统附属文件不参与目录识别,但所有归档路径仍须通过安全校验。 ### 旧配置与收藏记录 开发分支已修复导入旧配置后出现 `Favorite registration identity is already in use` 的 ID 冲突。新漫画使用未被本地库或任何收藏夹占用的同类型 ID,即使导入时不选择收藏夹,也不会误关联旧收藏。 无需为新导入先删除旧收藏或清空数据库。该修复不会按标题猜测关联,不改写旧收藏、旧路径或原漫画文件;旧平台的外部路径仍需另行迁移,不会因为导入配置而自动变成本机可访问路径。 ## PDF 与图片型 EPUB 在 `本地` -> `导入` 中可以分别选择 PDF 漫画文件或图片型 EPUB 文件。这两种格式都会在导入时转换为应用管理的本地图片漫画,而不是直接读取原文件。 ### PDF - 在 `本地` -> `导入` -> `PDF 漫画文件` 中可一次选择一个或多个 PDF;每个文件分别导入为一本漫画,收藏夹只需选择一次。 - 多个文件会按队列依次转换,界面同时显示当前文件、本批次文件数及当前文件的页数进度,无需逐本等待并重新选择。 - **v1.17.0 起支持后台导入**:点击“后台运行”、关闭进度框或返回即可继续阅读其他漫画,导入不会因此取消。可从主页“本地”卡片或本地漫画页的 PDF 图标进入“PDF 导入任务”,重新查看进度、取消任务或查看逐项结果;重新打开不会重复执行导入。再次选择 PDF 会加入同一个串行队列,等待中的任务可直接取消。已完成记录可清除,不会删除已导入漫画。 - 每本成功后立即保存到本地漫画库。重复选择的文件和已存在的同名漫画会跳过;单本损坏、加密或读取失败不会阻断后续文件,结束后可查看逐项结果。 - 点击取消会停止后续导入,并在当前文件读取或页面处理安全结束后清理未完成的漫画;已成功导入的漫画会保留,未处理文件不会计为失败。 - 主分支中,PDF 正在转换或入库时,迁移本地存储位置、扫描恢复本地漫画库会提示先等待导入完成或取消导入;若迁移/恢复已经开始,新 PDF 会等待它结束后转换。期间可继续阅读其他漫画。 - 导入期间请保持应用运行,不支持退出应用后继续任务或跨重启续传。Android 上无法直接访问的文件会逐本复制到临时目录,处理后释放。 - 每个 PDF 页面会按顺序渲染为 JPEG 图片,第一页同时作为封面。 - 导入结果是无章节的单本漫画,标题默认使用 PDF 文件名。 - 为兼顾清晰度、内存和存储占用,页面按约 3 倍 PDF 点尺寸渲染,最长边限制为 3000 像素。 - 加密或需要密码的 PDF 暂不支持。 - 导入会生成新的图片副本,因此需要预留额外本地存储空间。 ### 图片型 EPUB - 支持 spine 中直接引用栅格图片,或 XHTML/SVG 页面通过 `img`、SVG `image` 引用栅格图片的固定版式 EPUB。 - 页面顺序以 EPUB spine 为准;元数据中的标题、作者和封面会尽量保留。 - 当 EPUB 导航中存在多个有效章节时会保留章节;没有明确章节导航时会导入为无章节漫画。 - 原始栅格图片会直接复制,不重新压缩。 - 文字型 EPUB、直接绘制的 SVG 页面、外部图片引用和越界路径会被拒绝,不会静默丢弃正文。 当前不支持 MOBI、AZW 和 AZW3。它们是电子书容器而不是本项目当前的图片漫画交换格式,建议先在外部工具中转换为图片型 EPUB、PDF 或 CBZ。 如果本地漫画库中已经存在同名作品,文档导入不会覆盖原内容。 ## WebDAV CBZ 归档结果与重试 从 v1.18.2-rc.4 起(#126):从本地漫画列表选择“归档到 WebDAV”,或从漫画归档页选择“下载并导入”,本轮结果窗口会持续显示每本的标题、远端文件名、状态和可选择的错误详情,不再只闪过汇总数量。v1.18.1 和此前候选版不包含本轮结果与重试改进。 - 可重试单个失败项或全部失败项,成功项不会重新上传或导入。取消会等待正在执行的操作安全结束;已成功内容保留,未开始项目不算失败,可在同一窗口继续。 - 初次发现远端同名文件时显示“跳过(未核验)”,不代表归档完整。上传发送 `If-None-Match: *`,不会为绕过冲突而回退到无条件覆盖;实际服务是否正确支持该条件仍需验证。 - 若上传返回失败但远端出现同名文件,重试会下载并比对该项上次实际上传字节的 SHA-256。内容一致才确认成功;不同或没有可比对记录时保留冲突,不删除远端文件。大归档核验需要额外带宽和临时空间。 - 下载导入若已保存或不能确认提交结果,直接重试会禁用;请先检查本地库、封面、页面及重启后显示,避免重复导入。不要先清空数据或删除可能已保存的文件。 - 结果与重试记录仅保留到关闭本轮窗口;不提供后台或跨重启任务队列。关闭前请自行记录需跟进的错误,分享前检查凭据、私人链接和个人路径;默认脱敏不是全面匿名化。 这只改善结果可查和失败恢复,不代表已定位 123 云盘断联或限流等服务端原因,也不改变应用数据同步及 WebDAV 在线阅读流程。 ## WebDAV 在线漫画库 WebDAV 漫画库是在线阅读渠道,和本地导入导出、WebDAV CBZ 归档是不同能力。 在线阅读只读取远端目录图片,应用会按需列目录和加载图片,不会把远端 CBZ/ZIP/7Z 当作在线预览内容。可以直接使用普通图片目录,也可以把 VeneraNext 导出的单本 CBZ 解压后放到 WebDAV,以保留标题、作者、标签和章节信息。 ### 普通目录模式 推荐结构: ```text /venera_comics/ └── 猫之眼[北条司] ├── cover.jpg ├── 第01卷 │ ├── 001.jpg │ └── 002.jpg └── 第02卷 ├── 001.jpg └── 002.jpg ``` 普通目录模式的规则: - 漫画标题取漫画文件夹名。 - 子目录作为章节;如果根目录直接包含图片,则根目录图片可作为单章节漫画阅读。 - 普通目录的页面和章节按文件名自然排序;元数据明确指定的章节范围继续保留。 - 封面优先使用根目录下文件名为 `cover` 的图片;支持 `jpg`、`jpeg`、`png`、`webp`、`gif`、`jpe`、`avif`。没有独立封面时,依次使用根目录首图、首个可读章节的 `cover.*` 或首图。 - 不要求 `metadata.json` 或 `ComicInfo.xml`。 ### 元数据标记的分层目录模式 如果 WebDAV 目录层级较深,建议在漫画根目录放置 `metadata.json`,将该文件夹明确标记为一本漫画: ```text /venera_comics/ └── 分类/ └── 作者/ └── 猫之眼/ ├── metadata.json ├── cover.jpg ├── 第01章/ │ ├── 001.jpg │ └── 002.jpg └── 第02章/ └── 001.jpg ``` 应用会在同步 WebDAV 漫画库时递归查找带有 `metadata.json` 的目录,并将该目录作为一本漫画;其直接子目录作为章节。找到漫画根目录后不会继续把章节或更深层目录单独识别为漫画。漫画 ID 使用相对于 WebDAV 漫画库路径的目录路径,因此不同分类下的同名漫画不会互相覆盖。 在这种模式下,漫画标题、作者和标签来自 `metadata.json`,章节名称和章节路径来自直接子目录。根目录下的 `cover.*` 只作为封面;如果根目录还有普通图片,它们会作为 `Images` 章节保留。 当目录同时存在真实章节文件夹和 `metadata.json` 中的 `chapters` 页码范围时,真实章节文件夹优先,页码范围不会被强行映射到文件夹。只有根目录图片、没有章节文件夹时,`chapters[].start` 和 `chapters[].end` 才用于扁平 CBZ 目录的虚拟分章。 递归识别仅用于发现带有元数据标记的漫画;没有元数据的复杂多层目录不会无限递归猜测,仍建议在漫画根目录补充 `metadata.json`,以避免不同漫画被错误合并。 ### CBZ 解压增强模式 VeneraNext 导出的单本 CBZ 解压后通常是扁平图片目录: ```text /venera_comics/ └── 猫之眼 ├── metadata.json ├── ComicInfo.xml ├── cover.jpg ├── 0001.jpg ├── 0002.jpg ├── 0003.jpg └── 0004.jpg ``` `metadata.json` 模板: ```json { "title": "猫之眼", "author": "北条司", "tags": ["动作", "漫画"], "chapters": [ {"title": "第01卷", "start": 1, "end": 2}, {"title": "第02卷", "start": 3, "end": 4} ] } ``` 字段规则: | 字段 | 类型 | 说明 | |---|---|---| | `title` | 字符串 | 漫画标题;空字符串会回退为文件夹名 | | `author` | 字符串 | 作者,可为空字符串 | | `tags` | 字符串数组 | 漫画标签,可为空数组 | | `chapters` | 数组或 `null` | 章节范围;为 `null` 或空数组时,根目录图片作为单章节 | | `chapters[].title` | 字符串 | 章节显示名称,不可为空 | | `chapters[].start` | 整数 | 章节起始页,从 1 开始,包含该页 | | `chapters[].end` | 整数 | 章节结束页,包含该页 | 章节范围必须按顺序排列、不得重叠、不得反向,并且不能超过根目录实际页面数。`cover.*` 不计入页面编号。元数据允许存在额外字段,以便后续扩展;当前不会从元数据读取远端 URL、脚本或本地绝对路径。 `metadata.json` 使用 UTF-8 编码,文件名匹配不区分大小写。`ComicInfo.xml` 会随 CBZ 导出保留,用于其他漫画阅读器兼容;VeneraNext WebDAV 漫画库当前以 `metadata.json` 为增强信息来源。 如果元数据文件缺失、无法读取、JSON 损坏、字段类型错误或章节范围不合法,应用会记录警告并回退普通目录模式。漫画仍以文件夹名显示,目录中的图片和章节子目录仍可阅读。 这里的 `metadata.json` 是单本 CBZ 的元数据格式,不是历史 `.venera-comics` 批量包中的漫画列表格式,两者不可混用。 ### 压缩包与在线阅读 CBZ/ZIP/7Z 仍然可以通过 WebDAV 归档功能上传、下载和恢复,但它们属于备份与分发格式,不用于在线阅读。需要在线阅读时,请先在 WebDAV 服务端解压;应用只按需读取解压目录中的图片,不会下载整个压缩包。