Local library
导入本地漫画
将自己有权保存的 ZIP、CBZ、RAR、CBR 或 PDF 加入书库。无需搭建服务器：选择一个文件后，KiokuYomi 会在设备上复制、整理页面并保存阅读进度。
选择导入方式
两种入口都会使用同一套本地导入与安全检查。常规文件适合从“文件”App、iCloud Drive、AirDrop 或其他文件提供方选取；电脑上的归档可通过同一局域网直接传入。
从本地文件导入
打开书库，点按添加来源，然后选择本地文件。系统文件选择器一次导入一个归档，适合已经保存在 iPhone 或 iPad 上的文件。
通过 Wi‑Fi 传输
在添加来源中打开Wi‑Fi 传输，让电脑与设备连接同一网络，在电脑浏览器打开 App 显示的地址并上传归档。离开此页面后传输地址会关闭。
本地导入只处理你选中的文件。KiokuYomi 不提供、镜像或托管第三方漫画文件。
开始前准备
先把一个可独立阅读的作品、单行本或章节整理为一个文件。文件名会成为书库标题（下划线会显示为空格），第一张有效页面会用作封面。
- 1
按作品拆分文件
建议一个归档只放一部作品或一册内容。导入后它会成为书库中的一部漫画，并带有一个离线章节；不要把不同作品混在同一归档内。
- 2
留出设备空间
App 会保留归档副本，并解压或渲染可阅读的页面，因此导入后的占用通常大于原文件。导入前请确保设备有充足可用空间。
- 3
使用清晰、连续的页码
将页面命名为
0001.jpg、0002.jpg、0010.jpg一类的格式。KiokuYomi 会按自然顺序排列页面，补零可避免10排在2前面。
支持格式
归档格式用于漫画页面，PDF 会在导入时逐页转换为阅读器可显示的图片。扩展名应与实际文件格式一致。
| 文件类型 | 适用场景 | 导入时的处理 |
|---|---|---|
| ZIP / CBZ | 图片页面打包的常用漫画归档 | 提取有效图片，按路径自然排序 |
| RAR / CBR | 已有 RAR 格式漫画归档 | 提取有效图片；不支持密码保护或分卷文件 |
| 扫描版或排版完成的单册文件 | 逐页渲染为图片，再加入阅读器 |
归档内可识别的页面格式为 JPG、JPEG、PNG、WebP、GIF、HEIC 和 HEIF。文本、封面说明等非图片文件会被忽略。
归档内部结构
ZIP、CBZ、RAR 和 CBR 的内容可以放在根目录或子文件夹中。App 只读取有效图片路径；macOS 自动生成的 __MACOSX 文件夹和隐藏文件不会成为页面。
- 01-cover.webp可作为导入封面
- 0001.webp第 1 页
- 0002.webp第 2 页
- …继续使用连续页码
如果页面位于子文件夹，文件夹名称同样会参与排序。为了在不同打包工具中得到最稳定的顺序，仍建议只保留一层页面目录，并使用连续的补零页码。
导入后的结果
成功后，作品会立刻出现在书库中，第一页用作封面，阅读位置与书库数据保存于设备。原文件完成复制后可以继续由你在“文件”App 中管理，不会影响已导入的副本。
离线可读
本地导入完成后不依赖网络；在飞行模式或网络不稳定时仍可阅读。
一份归档，一部作品
每次导入会建立一个书库条目和一个本地离线章节，便于后续加标签与管理进度。
导入本身不会把归档上传到公共网站。若你主动启用同步，请以 App 内显示的同步设置为准，并为重要书库保留自己的备份。
限制与安全检查
为防止单个文件耗尽存储或内存，当前版本会在导入前后检查文件大小、页数和解压比例。超过限制时，请将内容拆分为更小的单册或章节后重新导入。
- 源文件大小
- 最多 512 MiB
- 归档条目
- 最多 1,000 个
- 可读页面
- 最多 500 页
- 单张图片
- 最多 32 MiB
- 解压后图片总量
- 最多 512 MiB
- 压缩比
- 不高于 100:1
PDF 同样最多 500 页；单页和整份 PDF 还会有渲染像素限制。密码保护的 RAR/CBR 与多分卷 RAR/CBR 不支持。若 ZIP 使用了密码，请先在电脑上解密后再导入。
常见问题排查
先确认文件能在电脑上正常打开，再根据提示处理。下面的检查顺序与 App 的导入流程一致：先看格式，再看页面，最后看空间和限制。
文件没有出现在选择器中
检查扩展名是否为 ZIP、CBZ、RAR、CBR 或 PDF。请先把文件完整下载到“文件”App 可访问的位置；单次文件选择只处理一个文件。
提示文件无法读取或没有可读图片
确认归档没有损坏，并且内部至少有一张 JPG、JPEG、PNG、WebP、GIF、HEIC 或 HEIF 图片。解压后重新打包时，不要只放文本、缩略图或隐藏文件。
提示加密或不支持分卷
RAR/CBR 不能使用密码，也不能是由多个分卷组成的归档。请在电脑上解密、合并为单个文件，或重新导出为普通 ZIP/CBZ。
提示文件、页面或图片过大
将长篇作品拆成单卷或若干章节；对于超大扫描图，可在保留可读性的前提下缩小像素尺寸或重新压缩。不要为了减小文件而创建异常高压缩比的归档。
Wi‑Fi 传输无法打开地址
确认电脑与 iPhone 或 iPad 在同一局域网，并保持 Wi‑Fi 传输页面打开。地址只在该页面显示期间可用；若网络切换或页面退出，请重新打开传输页面获取新地址。