Skip to content

About

离线本地漫画阅读器、网页更新器与漫画整理器(Windows)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

本地漫画阅读器

把本地图片漫画变成离线网页书架,也可以整理章节并导出为 CBZ、EPUB 或无缝长页 PDF。

Windows · 单文件工具 · 相对路径 · 不上传漫画 · 任意章节名 · 自定义阅读顺序


项目简介

这是一套完全在本机工作的 Windows 漫画管理工具。它不提供漫画内容,也不连接漫画网站;扫描、核验、整理、网页生成和格式导出都在本地完成。

文件 用途
漫画阅读器.html 本地书架入口,由更新器生成和维护
漫画更新器.vbs 扫描漫画目录、核验图片并生成书架、目录页和连续阅读页
漫画整理器.vbs 合并或拆分章节、编辑顺序/标题/简介并标准化图片文件名
漫画导出器.vbs 导出分话 CBZ、整本 CBZ、EPUB 或分话长页 PDF

三个 VBS 都是单文件工具:完整 PowerShell 程序和工具偏好设置都嵌入其中。双击后只显示图形界面,不会留下黑色命令行窗口;关闭界面后后台进程也会退出。整理器与导出器会直接把最后使用的目录和选项写回自己的 VBS,因此复制、改名或打包带走该单文件时,设置不会丢失,也不会在旁边生成配置 JSON。

三个桌面工具使用 Windows 原生 Per-Monitor V2 DPI 渲染,并按当前屏幕 DPI 调整窗体、表格和列表尺寸。在 125%、150% 等系统缩放比例下,文字直接绘制到显示器的实际像素网格,不再由 Windows 把 96-DPI 窗口整体位图拉伸。此项只修正显示与基础配色、边框,不改变按钮、操作流程或文件处理逻辑。

更新器生成的书架列表、合集和阅读器配置属于当前漫画库的数据,嵌在同目录的 漫画阅读器.html 中;整体移动漫画目录时也会保留。旧版 漫画阅读器配置.json 或旧注册表设置如果存在,只用于一次兼容迁移,新版工具不会再把界面偏好写进注册表。

Important

仓库与发布压缩包不包含任何漫画、封面、阅读记录或作者作品。请只处理你有权保存和阅读的内容。

下载与放置方式

下载 release/local-comic-reader-windows.zip,或克隆整个仓库。

更新器、导出器和整理器都以“自己所在的文件夹”为工作区,所以漫画根目录可以改名、换盘符或整体移动。仓库与压缩包把三个 VBS 放在同一级,方便下载;实际使用时可以按需要摆放。

最简单的布局

我的漫画/
├─ 漫画阅读器.html
├─ 漫画更新器.vbs
├─ 漫画导出器.vbs
├─ 漫画整理器.vbs
├─ 漫画 A/
│  ├─ cover.jpg
│  ├─ 第1话/
│  │  ├─ 0001.jpg
│  │  └─ 0002.jpg
│  └─ 特典/
│     └─ 0001.jpg
└─ 漫画 B/

整理器放在这里也能运行,它会把当前根目录中的漫画作为可选来源。

推荐的防混淆布局

如果不想把“已经进入书架的漫画”和“刚下载、等待整理的文件夹”混在一起,建议自己建立一个 new、待整理 或任意名称的子文件夹,并把整理器放进去:

我的漫画/
├─ 漫画阅读器.html
├─ 漫画更新器.vbs
├─ 漫画导出器.vbs
├─ 已整理漫画 A/
└─ new/
   ├─ 漫画整理器.vbs
   ├─ 刚下载的来源文件夹 1/
   └─ 刚下载的来源文件夹 2/

整理器首次使用时默认把结果写到同级的 整理完成 文件夹,也可以在界面中浏览并指定其他目标文件夹。以后再次打开时,会恢复这个整理器 VBS 上次关闭或成功整理时使用的目标文件夹;不同 VBS 副本分别记忆、互不覆盖,把单文件复制到别处时设置也会随它移动。输出漫画仍会在该目标文件夹下以漫画名称建立独立子目录。确认无误后再手动复制到漫画根目录。整理器所在子文件夹不必叫 new,中文名、其他盘符和任意层级都可以。

快速开始:生成离线网页书架

  1. 把 漫画更新器.vbs 放在漫画根目录。
  2. 双击更新器,用“加入书架”列决定哪些漫画显示在总书架,用“本次操作”列决定这次要处理哪些漫画。
  3. 首次使用或需要重建整个书架时点击“全部更新”;平时加入新漫画或重建少数旧漫画时,勾选相应“本次操作”并点击“加入 / 更新本次勾选”。
  4. 底部会实时显示正在核验或生成第几部漫画,以及当前处理到这部漫画的第几话和章节名。任务完成后会弹窗提示,主界面不会自动关闭。
  5. 打开生成的 漫画阅读器.html。

更新器支持:

  • “全部更新”重建所有加入书架的漫画,并以“加入书架”列决定总书架内容;
  • “加入 / 更新本次勾选”只处理“本次操作”列中勾选的项目:新漫画会加入,旧漫画会重建,其他既有书架内容保持不动;
  • “加入书架”与“本次操作”互不混用,并分别提供全选和清空;
  • “重新扫描”会追加刚放入根目录的新漫画,不重置当前勾选;已经载入的漫画若检测到文件变化,会先二次确认再重新导入该项;
  • 章节目录封面可按漫画批量选择“跟随元数据 / 首图 / 自选 / 该话其他图片 / 隐藏”,并在独立的“元数据状态”列显示文件中实际保存的整本开关和逐话设置;没有保存 coverMode 时明确显示“未设置”,不会把运行时回退结果误写成元数据状态;非“跟随元数据”的设置会在执行更新时同步写入该漫画的 元数据.json;
  • 可建立虚拟合集,成员默认只在合集页出现;每部成员都能独立选择是否还要在总书架重复显示。同一漫画属于多个合集时,任一合集允许重复显示便会在总书架出现一次;选择“指定成员漫画封面”后,封面候选框只列出当前合集已经勾选的成员;
  • 更新器右上角将“管理合集”和“将合集改动写入阅读器”分成两个按钮。保存合集设置后,可只重建总书架和受影响的合集目录页,不重新核验或生成任何漫画章节;即使“本次操作”没有勾选漫画也能单独写入合集改动;
  • 主窗口常驻,任务期间在底部实时显示“漫画进度 + 漫画名 + 章节进度 + 章节名”;
  • 可选择完成后是否自动打开阅读器;
  • 已有元数据时严格采用元数据顺序,没有元数据时按章节名自然排序;
  • 自动核对网页引用的图片数量,防止静默漏图;
  • 第3话 前编 与 第3话 中编 会作为两个独立章节,不会因数字相同而冲突。

章节目录封面

模式 实际行为
跟随元数据 完全采用整理器或既有 元数据.json 中的逐话设置
首图 使用该话第一张正文图片
自选 选择任意本地图片并复制到漫画的 漫画阅读器资源/章节封面,正文图片不变
该话其他图片 直接引用该话现有正文图片,例如第二张;不复制图片,也不修改正文编号
隐藏 漫画目录只显示章节文字,不显示章节缩略图

更新器的“编辑当前漫画逐话封面”还提供“插入本地图片为本话首图”:确认后,新图片写为该话的 0001,原数字图片整体顺延为 0002、0003……,并把这一话的封面逻辑重设为首图。执行前会检查图片是否为从 1 开始、连续且不重复的纯数字编号;不安全的共享目录、断号、重复号或混合命名会拒绝修改。文件移动采用倒序并带失败回滚。插入完成后,请执行“加入 / 更新本次勾选”以刷新网页引用。

整理器也有“本地图片插入为首图”,但只改变“整理完成”中的输出:来源漫画不改动,新图片输出为 0001,原正文依次顺延。

网页阅读器提供:

  • 所有图片等宽、无缝、从上到下连续阅读;
  • 阅读页置顶工具栏,只保留“当前话 / 总话数”和工具按钮;
  • 25%~500% 多档缩放,只影响阅读页,不改变书架与目录页;缩放前会锁定当前页以及屏幕中心对应的图片位置,缩放后仍停留在同一页、同一视觉位置附近;
  • 背景颜色和文字颜色使用两个独立按钮;
  • 预设颜色、调色板和自定义收藏色;
  • 漫画、章节和图片位置的本地阅读进度;
  • 漫画目录可按元数据选择显示每话封面,或只显示文字章节卡片;
  • 阅读页侧边“目录”会弹出纯文字章节列表;侧边“顶部 / 底部”可一键移动到长页两端;
  • 右下角显示“当前页 / 总页数”,可直接输入页码后按回车或点击“跳转”;
  • 桌面与手机浏览器自适应布局。

每部漫画的 index.html 和各话阅读页都生成在漫画根目录,不会往每话图片文件夹中散落 HTML。网页使用相对路径引用图片。

支持的漫画结构

多章节漫画

漫画名/
├─ cover.jpg
├─ 第1话 开始/
├─ 第3话 前编/
├─ 第3话 中编/
├─ 第4.5话/
├─ 特典/
└─ after/

章节文件夹不要求必须叫“第 X 话”。特典、番外1、后记、插画集、after、英文名或其他任意名称都能使用。

  • 有有效 元数据.json 时,更新器、整理器和导出器严格采用其中的阅读顺序与显示标题;
  • 没有元数据时,按文件夹名称自然排序;
  • 1.01、4.5、8.5 等小数话序可以保留;
  • 特殊话实际放在哪里由元数据中的行顺序决定,不受显示编号限制。

工具在匹配元数据章节名时兼容 Windows 文件名规则。例如元数据里的半角 ?、:、末尾空格或末尾句点,即使被 Windows 改成全角字符或自动删掉,也不会误判为另一个章节。

根目录单行本

漫画名/
├─ 0001.jpg
├─ 0002.jpg
└─ 0003.jpg

正文图片直接位于漫画根目录时,默认作为一话处理,不需要额外创建“第1话”文件夹。即使文件名带有多个可识别前缀,也不会静默拆成多话;更新器会在核验提示中提供“根据文件名分组拆成不同话”的可选项。没有 cover.jpg 时可以自动采用第一张正文图作为封面。

复合命名或总集

P01_001.jpg
P01_002.jpg
P02_001.jpg
P02_002.jpg

工具会识别“章节组 + 页码”并把它作为可选分组提示,但根目录图片仍默认按一个文件夹一话处理,只有明确选择分组时才会拆话。无法识别固定格式时,可确认按完整文件名自然排序。输出时只复制图片到新漫画文件夹,并统一重命名为 0001、0002……,不会改动原文件。

支持 .jpg、.jpeg、.png、.webp、.gif、.bmp、.avif。

漫画整理器

整理器适合两类常见情况:多个文件夹实际属于同一部漫画,以及一个总集图片文件夹需要拆成多话。

主要功能:

  • 一个来源拆成多话,或多个来源合成一话;
  • 按图片起止范围拆分总集;
  • 多选任意行后统一设置章节封面、合并、复制、删除或移动;
  • 拖动、上移/下移、移到最上/最下决定真实阅读顺序;
  • 为每话单独填写话序、特殊标签和章节标题;支持 4.5、3 前编、3 中编 等数字分段标签;
  • 输出漫画名称既可编辑,也可从已载入来源名称中下拉选择;
  • 简介默认跟随漫画名称来源,确认编辑后固定,不再随名称来源变化;
  • 可从含有 description、intro、summary、desc、简介 或 簡介 的来源元数据中采用简介;
  • 在表格最后一列选择整本封面来源;工具会同时保存该行的来源漫画、来源章节和范围起始图片,同一来源漫画调整章节顺序或把一章拆成多段时也不会误取别的图片;
  • “重新扫描来源文件夹库”刷新工作区与已载入章节数量;
  • “载入新增文件夹”追加新来源,不重置已经编辑的行;
  • “重新载入所选文件夹”明确重建表格;
  • 支持“撤销 / 恢复”最近 40 个编辑状态,也可使用 Ctrl+Z、Ctrl+Y 或 Ctrl+Shift+Z;
  • 合并章节后,被并入行的原话序、章节名、章节封面和元数据指向会灰显保留,方便核对来源;
  • 按范围分割时若有遗漏、重叠或不连续,会指出常见的边界错误并要求二次确认;分割后第一段保留原话序和章节名,后续段留空,并且只保持第一段的“选择”复选框勾选;
  • 每话目录封面可选择跟随元数据、首图、自选本地图片、该话其他图片、本地图片插入为首图或隐藏;“自选”会复制图片到输出漫画的阅读器资源目录,“该话其他图片”直接引用本话正文,“插入为首图”只在整理结果中把新图片输出为 0001 并让原正文顺延,三种方式都不会改动来源文件;
  • 可自选输出目标文件夹;首次启动默认使用整理器同级的 整理完成,以后自动恢复上次关闭或成功整理时的路径;设置嵌在当前整理器 VBS 中,复制单文件会连同设置一起带走,不同副本也可各自保存不同路径;目标路径还会随整理方案保存和恢复;
  • 保存、加载和核验整理方案;
  • 大型方案会缓存来源章节扫描结果,加载 100 话以上的方案时不再为每一行重复扫描整个漫画,并在底部显示当前载入行数;
  • 只使用总集中的一部分时列出遗漏内容并二次确认,而不是直接报错。

如果来源漫画含有效 chapterInfos.order,载入时优先采用该顺序;配置缺失或无效时才回退到名称自然排序。

“从选中行后续编号”会从当前行的下一行继续:选中第3话后从4开始,选中第4.5话后从5开始,选中 3 中编 后也会从4开始。特典话、番外1、后记 等没有传统数字编号的名称可以直接保留和移动。

图片顺序与缺页检查

文件名情况 排序与核验
0000.jpg、0001.jpg……或从 0001.jpg 开始 按数字排序,并检查起始编号、断号和重复号;零号图片属于正文
P01_001.jpg、P01_002.jpg…… 识别章节组与页码,在组内检查重复及明显断号
断号、重复号或无法识别的名称 先列出错误,再由用户选择取消修正,或“按当前文件名顺序继续”

自然排序会把 2.jpg 放在 10.jpg 前。遇到断号、重复号、混合命名或不能可靠判断顺序时,更新器和整理器会先显示具体问题,不会再直接卡死;确认“按当前文件名顺序继续”后,会纳入全部已找到的图片并采用自然排序。这个回退无法证明是否真的缺图,所以空文件、没有图片、元数据结构错误等非排序问题仍会阻止继续。

只有明确命名为 cover.jpg、cover.png 等的图片才作为独立整本封面排除在正文之外。没有命名封面时,工具可以引用阅读顺序第一张正文图片作为目录封面,但不会把 0.jpg、000.jpg 或 0000.jpg 从正文中删除。

JSON 元数据有什么用?

整理器输出的 元数据.json 用来记录:

  • 章节的严格阅读顺序;
  • 每话的显示编号和独立标题;新版会把话序写入 chapterSequence、章节名写入 chapterName 两个独立字段,避免纯文字话序、内部空格或特殊话名称在再次导入和导出时被错误拆分或合并;
  • 漫画简介与简介来源;
  • 封面来源;
  • 每话目录封面的模式,以及自选图片或该话正文图片的相对路径;
  • 整理器版本和必要结构信息。

没有 JSON 时三个工具仍能工作,只是改用名称自然排序。JSON、HTML 和整理方案不会被塞进 CBZ、EPUB 或 PDF;导出文件只包含阅读所需内容。

漫画导出器

把 漫画导出器.vbs 放在漫画根目录并双击。导出器会把上次关闭时的导出方式、选项和输出目录直接记在自身 VBS 内;复制这个单文件到另一台电脑或另一处目录时,这些选择会原样保留。

支持四种方式:

方式 适用场景
每话一个 CBZ(推荐) Mihon 等漫画阅读器;手机书架一部漫画,打开后列出各话
整部漫画一个 CBZ 只要求顺序阅读,不要求可靠章节目录
整部 EPUB ReadEra 等电子书阅读器;一本书带可点击章节目录
每话一个无缝长页 PDF(推荐) 每话生成一个 PDF,所有图片拼成无间隙长页

其他选项:

  • 可把总封面放在第一话或整本开头;
  • 可在导出文件夹名称后标注 CBZ、EPUB、PDF;
  • 已有同名导出时对应漫画会变灰,默认防止重复;
  • 开启“同名时自动加(1)(2)继续导出”后可以保留多个版本;
  • 可选择完成后打开输出目录;
  • 导出大体量漫画时窗口仍可正常响应,底部会实时显示当前漫画、当前话和当前图片;
  • 有有效元数据时严格采用其中的章节顺序;没有元数据或元数据无效时按章节文件夹名称自然排序,例如“第2话”会排在“第10话”前;
  • 分话 CBZ 和长页 PDF 使用“三位阅读顺序 - 完整话序 章节名”命名;三位前缀用于手机端排序,话序与章节名完整保留,例如 007 - 第 6 话 沙滩排球社 后篇.cbz;
  • 元数据中的章节顺序、标题、作者和简介会在格式允许时写入导出结果;新版优先读取独立的 chapterSequence 与 chapterName,旧元数据缺少这两个字段时才使用兼容推断。

Mihon:一部漫画、多话、无缝长条

选择“每话一个 CBZ”,把导出的整个漫画文件夹复制到手机:

Mihon/local/
├─ 漫画 A/
│  ├─ 001 - 第 1 话 相遇.cbz
│  └─ 002 - 特典 后日谈.cbz
└─ 漫画 B/
   └─ 001 - 全一话.cbz

在 Mihon 中进入“浏览 → 图源 → 本地来源”并刷新。打开章节后进入阅读器设置,把本系列阅读模式设为 长条模式(Long strip)。

ReadEra:一本 EPUB、可点击目录

选择“整部 EPUB”后,把 .epub 复制到手机并让 ReadEra 扫描。每部漫画在书架中显示一本,目录中的章节可以点击。水平分页、垂直翻页或连续滚动由阅读 App 决定;若必须获得网页漫画式无缝长条,优先使用 Mihon + 分话 CBZ。

VBS 和 EXE 有什么区别?

VBS 是由 Windows Script Host 执行的脚本;EXE 是 Windows 可执行程序,可能是原生程序,也可能只是脚本与运行环境的封装。

本项目选择 VBS,是为了在不附带额外运行库的情况下实现单文件、无黑框、相对路径和可审查源码。EXE 更方便设置图标、版本信息和数字签名,但未签名 EXE 同样可能触发 SmartScreen,功能也不会天然更强。

从源码重新打包

完整 PowerShell 源码位于 source/:

powershell.exe -NoProfile -ExecutionPolicy Bypass `
  -File .\source\build-single-file-tools.ps1 `
  -OutputDirectory .\.tmp

生成:

  • .tmp/漫画更新器.vbs
  • .tmp/漫画整理器.vbs
  • .tmp/漫画导出器.vbs

常见问题

为什么双击 VBS 后没有黑色命令行窗口?

这是正常设计。VBS 隐藏 PowerShell 控制台,只显示图形界面;关闭图形界面后后台进程随之退出。

为什么漫画没有出现在工具列表中?

确认漫画目录中至少有一张受支持格式的图片。图片既可以位于章节子文件夹,也可以直接位于漫画根目录。只有 JSON/HTML、没有图片的目录不会成为候选漫画。

为什么分话 CBZ 导入 ReadEra 后变成很多本?

ReadEra 会把每个 CBZ 当成独立文档。需要“一本书 + 可点击目录”时使用 EPUB;需要“一部漫画 + 多章节 + 无缝长条”时使用 Mihon 本地来源。

生成的 HTML 阅读器能在手机上使用吗?

可以。必须把 漫画阅读器.html、每部漫画文件夹及其中图片作为一个完整目录复制到手机,再用允许访问本地文件的浏览器打开。界面会适配手机宽度,但不同手机浏览器对 file:// 本地页面跳转和存储的限制不同,阅读进度只保存在当前浏览器中,也不会与电脑同步。

如果主要在 Android 手机上长期阅读,推荐使用导出器的“每话一个 CBZ”并放入 Mihon 本地来源,然后把阅读模式设为长条模式;它对大量漫画、章节管理和连续滚动通常比手机浏览器更稳定。

整理器必须放在 new 文件夹吗?

不必须。整理器只处理自己所在的文件夹,放在漫画根目录也能运行。单独建立 new 或“待整理”子文件夹只是为了降低误选和混淆的概率。

已知边界

  • 完全没有数字规律或已断号的图片名,在用户确认后只能按文件名自然排序,工具无法可靠证明是否缺页;
  • 同一个文件夹混用多套命名规则时,建议先用整理器预览并确认;
  • 超长路径可能受 Windows 或解压软件限制,建议不要嵌套得过深;
  • HTML 阅读器适合本机离线阅读;跨设备同步进度、网络书库和多人共享不在项目范围内。

本地优先:漫画、封面与阅读进度都留在你自己的设备中。

About

离线本地漫画阅读器、网页更新器与漫画整理器(Windows)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages