08 Reading and Library

08 阅读与书库管理

ComiGo 的书库来自 StoreUrls 或命令行参数。一个书库可以是本地文件夹，也可以是远程地址。

远程 ComiGo 书库可直接填写另一个服务主页，例如 https://user:password@host/comigo；书籍资源阅读时实时从远端获取。

推荐目录结构

建议用清晰的目录结构：

Books/
  作者A/
    作品1.cbz
    作品2.zip
  作者B/
    作品3/
      001.jpg
      002.jpg

ComiGo 会扫描目录和压缩包，把能识别的内容显示在书架里。

如果使用 Windows 右键菜单添加书库，需要注意：已经作为书库添加的文件夹，其子文件夹和内部文件不会再作为独立入口重复添加。这可以避免同一本书或同一目录被重复扫描。

扫描规则

常用扫描相关设置：

• MaxScanDepth：扫描目录深度。目录层级很深时需要调大。
• MinImageNum：一个目录至少包含多少图片才当成一本书。
• ExcludePath：排除不想扫描的路径。
• AutoRescanIntervalMinutes：定时重新扫描。

如果书没有显示，优先检查扫描深度和最少图片数量。

阅读模式选择

模式	适合内容
滚动模式	条漫、长图、手机阅读
翻页模式	日漫、双页、横屏、平板
播放器模式	视频或音频文件
在线阅读器	临时打开单个压缩包或 PDF

滚动模式和翻页模式都可以配合多设备同步使用。滚动同步适合长条内容；翻页同步适合把电脑、平板和手机作为同一阅读场景中的多个屏幕。

阅读历史与书签

ComiGo 支持阅读历史和书签，用于继续阅读。浏览器端也会保存一些阅读设置，例如模式、方向、缩放、背景等。

如果换设备后历史不同步，先确认是否访问的是同一个服务地址，以及是否使用了同一个书库。

上传

启用上传后，可以从 Web 页面上传文件到书库。服务器或公网环境中建议同时设置账号密码。

关闭上传：

comi --enable-upload=false /path/to/books

或使用只读模式：

comi --read-only /path/to/books

下载导出

ComiGo 提供下载接口，可以把图片文件夹打包成 ZIP，也可以把 ZIP 转换为 EPUB 下载。这个能力适合临时转存和跨设备阅读，但不建议把它当成完整的漫画整理软件。

部分版本还支持把漫画转换为内嵌图片的单网页文件。这个 HTML 文件保留阅读器功能，可以用普通浏览器打开。

插件和自定义

插件可用于自动滚动、自动翻页、时钟显示、自定义脚本和样式。用户插件目录通常位于配置目录下的 plugins/。

如果你刚开始使用，建议先关闭复杂插件，确认基础阅读流程稳定后再逐步开启。