下载分类+自定义目录：zlibrary.koplugin让你的电子书库从此井井有条

zlibrary.koplugin 是一款 KOReader 电子阅读器的 Z-library 下载插件。借助「下载分类 + 自定义下载目录」两大功能，你在书库里下载的每一本书都能自动归位到对应文件夹——书再多，也一目了然。

痛点：下载的书堆在一个文件夹里

用 KOReader 配合 Z-library 插件下载电子书，最舒服的当然是"边看边下"。但书一多就有一个绕不开的问题：所有下载文件全堆在同一个目录里。

小说、技术书、漫画、杂志混在一起，想找某本书只能靠翻文件名。尤其是下载了几十本书之后，整理起来相当头疼。

zlibrary.koplugin 的解法是两个功能组合：

一键设置：指定自定义下载目录

设置入口很简单：

1. 打开 KOReader 顶部菜单，进入Menu → Z-library → Settings
2. 选择Set download directory（设置下载目录）
3. 在弹出的目录浏览器里选一个文件夹，确认后屏幕会提示Download directory set to: <路径>

该选项对应的入口在 main.lua，目录选择对话框实现在 zlibrary/ui.lua。

💡 建议选一个专门的文件夹（例如Documents/ZLibrary），这样分类文件夹都建在它下面，库和别的文件天然隔离。

搭建分类树：两级文件夹结构就够用

在同一个 Settings 菜单下选择Download categories（下载分类），即可管理你的分类列表：

• Add category…：新增一个顶级分类
• 点进某个分类，还可以Add sub-category…添加子分类（仅支持一级）
• 支持Rename和Remove，删除有二次确认

以Fiction（小说）为例，给它加上Romance和Sci-Fi两个子分类后，实际落盘的文件夹就是：

<下载目录>/Fiction/Romance <下载目录>/Fiction/Sci-Fi

几个值得注意的细节：

• 文件夹会在第一次有书被归入时自动创建，无需手动建目录
• 分类名会做安全处理，非法字符（如/ \ ? : *等）自动替换为_
• 重命名或删除分类只影响以后的下载，已经归位好的书不会被移动
• 分类列表在菜单中按字母排序显示

分类的存储与校验逻辑在 zlibrary/config.lua，分类管理菜单（增删改的交互）在 zlibrary/ui.lua。

下载完成后：用 "Move to" 把书归位

分类建好只是第一步，真正的"自动化"发生在下载完成的那一刻。

下载成功后，插件会弹出确认对话框（打开/关闭），此时多出一个Move to选项：

1. 默认显示Download folder（书留在下载目录，不做任何移动）
2. 点开后列出你的所有分类，按字母顺序排列，子分类以父级 › 子级形式缩进显示
3. 顶部还有New category…，可以当场新建分类（可带子分类）并直接把这本书归入，省去回设置里操作的步骤
4. 无论选Open book还是Close，书都会被归到所选文件夹——归位与否和"现在读不读"无关

这套选择器实现在 zlibrary/ui.lua。

安全性也不打折扣（见 zlibrary/download.lua）：

• 目标文件夹里已有同名书？新文件自动加(2)后缀，两本都保留，绝不覆盖
• 文件夹创建失败或移动失败？书原样留在下载目录并给出提示——归类尝试永远不会丢书

⚠️ 一个小前提：分类选择是在"下载后询问是否打开"的对话框里提供的，所以请先确保 Settings 里的Ask to open after download保持开启（默认开启）。关闭它后，Download categories 选项会被置灰。

三步整理你的电子书库：最佳实践

按下面的顺序操作，几分钟就能搭好一套可持续的收纳体系：

1. 定目录：Set download directory 指定一个专用文件夹
2. 建分类：按你自己的阅读习惯建 3~5 个顶级分类（如 Fiction / Technical / Comics），常用主题再加子分类
3. 养成习惯：每次下载完成后顺手点一下 Move to，选个分类

坚持几周，你会发现书库文件夹的结构完全贴合自己的阅读口味，找书从"翻文件"变成"进目录"。

给开发者：功能源码在哪里

如果你想读源码或贡献改进，可以从这些文件入手：

• 分类存储、命名校验与增删改 API：zlibrary/config.lua
• 分类管理菜单与下载后归类对话框：zlibrary/ui.lua
• 文件夹映射、同名冲突处理与安全移动（跨文件系统回退）：zlibrary/download.lua
• 菜单入口（Set download directory / Download categories）：main.lua
• 功能发布说明：CHANGELOG.md 1.0.45 版本条目
• 中文安装与配置指南：README.zh-CN.md

下载分类 + 自定义目录，是 zlibrary.koplugin 里成本最低、收益最立竿见影的两个功能。花三分钟搭好分类，从此让每一本下载的书都有家可归。