b.Bison创作与开发笔记

学习路线

漫阅+ 阅读与书库学习路线

从本地漫画导入和离线阅读开始，学习书架整理、阅读设置、WebDAV、SMB、服务器书库与同步排查。

从第一篇开始 了解 漫阅+

先用一个自己拥有的本地文件走通导入与阅读流程，再根据存储方式选择 NAS 或服务器教程。连接成功之后，还需要检查实际页面和离线可用性。

漫阅不提供漫画内容。部分远程书库和同步功能有会员条件，具体以应用当前界面为准；阅读记录同步与漫画文件传输是不同的任务。

导入第一本漫画

从一个本地文件开始，确认格式、目录和页序都能正常读取。

  1. 漫阅+ 入门：导入本地漫画并离线阅读

    用一个自己的 CBZ、CBR 或 PDF 文件开始，了解漫阅的本地漫画导入、书架选择、离线阅读与常见问题。

    约 6 分钟

  2. 漫阅+ 文件格式指南：选择 CBZ、CBR、CB7 或 PDF，并检查页序

    分清漫画压缩包、PDF 与图片目录，整理文件名和章节结构，导入后核对封面、页数与跨页。

    约 6 分钟

  3. 漫阅+ 图片文件夹导入：把散页整理成一本书或多个章节

    从单本图片目录、章节目录与多个漫画文件出发，选择正确目录层级，避免混合结构导致漏导或错分。

    约 6 分钟

  4. 漫阅+ 导入失败怎么办：从文件可用性、格式和目录层级逐项排查

    区分文件未下载、格式不符、目录混合、空间不足和部分导入失败，建立可以重复验证的小样流程。

    约 6 分钟

阅读与书架整理

安排书架、调整阅读方式，并在离线前检查下载是否完整。

  1. 漫阅+ 书架整理：用分组安排待阅读、正在读和已完成

    建立少量稳定书架分组，分清移动、复制、移出分组与删除漫画，并用样本验证整理结果。

    约 6 分钟

  2. 漫阅+ 阅读布局：设置方向、单页双页与跨页检查

    按漫画的页序和设备方向调整阅读模式，区分原稿跨页、双页组合与缩放，建立每本书的阅读基线。

    约 6 分钟

  3. 漫阅+ 书签与笔记：保存一页、写下提醒，再准确回到原处

    为阅读参考页建立书签和简短笔记，区分书签、历史与收藏，并检查章节变化后的定位边界。

    约 6 分钟

  4. 漫阅+ 离线阅读准备：出发前确认整本漫画真的在设备上

    用首中末页、跨章节、重开与断网检查区分本地副本和远程封面，安排可验证的出行阅读清单。

    约 6 分钟

  5. 漫阅+ 下载管理：安排队列、处理失败，并确认本地副本

    区分排队、下载、完成与失败，逐项使用暂停恢复和重试，避免把清除任务记录当作删除或保留文件的保证。

    约 6 分钟

连接服务器书库

根据自己的服务器选择连接方式，检查目录、页面与本地副本。

  1. 漫阅+ 连接 WebDAV 漫画书库：从地址核对到下载检查

    用私人 WebDAV 服务访问自己的漫画，区分文件库与数据同步，检查目录权限、书库范围与离线副本。

    约 6 分钟

  2. 漫阅+ 连接 SMB：在局域网中浏览 NAS 漫画并保存离线副本

    核对 SMB 主机、共享名和账号权限，选择书库目录并验证访问；明确离开局域网后的可用范围。

    约 6 分钟

  3. 漫阅+ 连接 Komga：从账号权限到系列、章节和离线检查

    使用 Komga 服务地址与个人账号建立连接，理解系列和书籍的展示关系，分别验证目录、逐页阅读与下载。

    约 6 分钟

  4. 漫阅+ 连接 Kavita：使用账号登录并检查书库与阅读权限

    按 Kavita 服务类型填写地址和账号，核对共享书库、章节与下载权限，不把其他客户端的连接方式直接套用。

    约 6 分钟

  5. 漫阅+ 连接 OPDS：为什么能看到目录，却不能直接逐页阅读

    分清 OPDS 目录、整包获取链接和 OPDS-PSE 页面流，正确填写目录地址，并选择可验证的阅读或本地导入路径。

    约 6 分钟

同步、迁移与排查

遇到问题逐项检查；换设备或清理空间前，先分清数据与漫画文件。

  1. 漫阅+ 服务器连接排查：把网络、登录、目录和页面分开检查

    用一个已知样本定位 WebDAV、SMB、Komga、Kavita 或 OPDS 的失败阶段，整理可复查的错误信息。

    约 6 分钟

  2. 漫阅+ iCloud 同步：把阅读进度和书架带到另一台设备

    先确认来源设备的数据，再设置 iCloud 自动或手动同步，通过一条进度和一个分组检查两台设备是否一致。

    约 6 分钟

  3. 漫阅+ WebDAV 数据同步：建专用目录，选择首次上传或下载

    用自己的 WebDAV 目录同步阅读历史与收藏，明确初始方向，检查最近成功时间，并与漫画文件书库分开管理。

    约 6 分钟

  4. 漫阅+ 换设备指南：先恢复阅读状态，再补回漫画文件

    把迁移拆成应用数据、本地漫画、服务器连接和离线检查四部分，逐项核对后再决定是否清理旧设备。

    约 6 分钟

  5. 漫阅+ 手动备份与恢复：保留应用数据，单独保存漫画原件

    从导出 App 数据到恢复后检查，明确备份包含的状态、可能敏感的信息，以及漫画文件需要另存的范围。

    约 6 分钟

  6. 漫阅+ 存储清理：分清缓存、本地副本、下载任务与书架关系

    先确认要保留的离线内容和原件，再按对象清理缓存、任务记录或漫画副本，避免用删除文件代替整理书架。

    约 6 分钟