Bookshelf自定义文件夹图片:给作者、系列、合集换专属封面
Bookshelf自定义文件夹图片:给作者、系列、合集换专属封面
Bookshelf 是 KOReader 的电子书架主屏插件,帮你按系列、作者、类型或文件夹浏览书库并直接开读。它的 Custom images for folders and stacks(文件夹/堆栈自定义图片) 功能,允许你为文件夹、作者、系列、类型和合集换上专属封面图,替换默认的卡纸卡片,让书架更有个人风格。本文用 3 种方法讲透 Bookshelf 自定义文件夹图片的完整设置方法。
为什么需要 Bookshelf 自定义文件夹图片?
Bookshelf 中凡是"代表多本书"的条目——一个系列、一位作者、一个文件夹、一个合集——默认都渲染成文件夹卡片(folder tile):一张卡纸板加组名标签,上方探出第一本书的封面。
这个默认样式清晰,但缺少个性。给这些"堆栈(stack)"换上专属图片后:
- 📚 系列书架一眼认出《沙丘》《基地》各自的视觉形象,不用读字;
- ✍️ 作者书架可以放作者肖像,检索和浏览都更快;
- 🗂️ 文件夹可以用与文件夹内容匹配的主题图,书架立刻像"自己的";
- 🏷️ 合集(如"科幻精选")也能有自己的封面。
💡 提示:作者、系列、类型、合集的专属图片由 Bookshelf 的 bookshelf_image_source.lua 统一解析和加载,内置了尺寸探测与渲染缓存,大批量图片也不会拖慢翻页。
Bookshelf 自定义文件夹图片的 3 种设置方法
Bookshelf 提供了三种互补的方式,从"临时改一张"到"批量管理整库"。
方法一:长按卡片,快速指定一张图片(最常用)
适合"给眼前这一个系列/作者/文件夹换图":
- 在书架上找到目标卡片(文件夹卡、作者堆栈、系列堆栈等);
- 长按卡片,弹出组菜单;
- 选择 Set folder image… / Set author image… / Set series image…(按组类型不同而不同);
- 在文件选择器中挑一张图片(支持 jpg、jpeg、png、gif、bmp、tiff、webp);
- 保存后书架立即重绘——卡纸标签仍保留在最上层,组名依然可见,只是底图换成了你的图片。
想改回来?同样长按卡片,选 Clear … image 即可恢复默认卡纸样式。
方法二:往文件夹里丢一张图,自动识别
这是最"无感"的方式,沿用了 Plex / Jellyfin 的经典约定:
- 把图片放进目标文件夹内,命名为
cover.jpg、cover.png、folder.jpg或folder.png中的任意一个; - Bookshelf 扫描书库时会自动拾取,该文件夹卡片随即换上这张图;
- 不想让它出现在文件列表里?用隐藏文件同样有效:
.cover.jpg、.folder.png等点前缀变体也能被识别(同时存在时,可见文件优先)。
几个实用细节:
| 规则 | 说明 |
|---|---|
| 识别顺序 | cover.jpg → cover.png → folder.jpg → folder.png → 隐藏点文件变体 |
| 跟随移动 | 文件夹被移动时,自动检测到的图片会跟着走,无需重新设置 |
| 覆盖菜单设置 | 长按菜单手动指定的图片优先级更高,会盖过自动检测 |
💡 用 Calibre 或文件管理器整理书库时,顺手在每卷目录放一张
cover.jpg,等于一次性给整棵树配好封面。
方法三:图片库(Image Library)批量管理作者、系列、合集
作者、系列、类型、合集并不对应磁盘上的真实文件夹,方法二帮不上忙。这时用图片库:
默认位置在你的书库目录下:
<书库>/.bookshelf-images/
├── authors/
├── series/
├── genres/
└── collections/
规则很简单:
- 按组类型放入对应子文件夹,例如作者图放
authors/、系列图放series/; - 文件名用组名的精确拼写,如
authors/Asimov, Isaac.jpg; - 不想处理逗号和空格?用 slug 形式兜底——名称转小写、标点与空格压缩成单个短横线:
Asimov, Isaac→asimov-isaac.jpg,Sci-Fi/Fantasy→sci-fi-fantasy.jpg; - 扩展名按
jpg→jpeg→png→gif→bmp→webp→tiff的顺序尝试,找到第一个存在的文件即用。
精确文件名优先于 slug,所以能按精确名命名时优先精确名。这样你可以一次性为几十位作者配好肖像图,书架打开即生效——解析逻辑与测试见 tests/_test_stack_image_discovery.lua。
三种方式的优先级关系
Bookshelf 的解析优先级固定为:
- 长按菜单手动指定的图片(用户覆盖,最优先);
- 自动检测的图片(文件夹内的
cover.*/folder.*,或图片库中的同名/slug 文件); - 都找不到 → 回退默认的卡纸卡片渲染。
也就是说:手动设置会盖过自动检测;清空手动设置后,文件夹里丢的 cover.jpg 会继续生效,而不是直接回到默认样式。相关实现集中在 lib/bookshelf_image_source.lua,默认样式渲染在 lib/bookshelf_folder_card.lua。
进阶选项:移动图片库位置
如果不想把图片放在书库里,可以在 menu > Settings > Library & search > Image library 中把图片库指向任意其他文件夹(例如专门备份的 covers 目录)。清空该项则回到默认位置 <书库>/.bookshelf-images/。
常见问题
Q:换了图片没生效? 检查三点:文件名是否与组名完全一致(或 slug 是否正确);扩展名是否为支持的位图格式(SVG 不支持);如果是往文件夹丢图,下拉书架刷新一次书库扫描。
Q:自定义图片会被 Bookshelf 修改或删除吗? 不会。图片文件始终是你自己的文件,Bookshelf 只记录"哪个组用哪张图"的对应关系。移动文件夹时,手动设置的图片路径也会自动跟随重映射。
Q:默认文件夹样式(Divider card、Ribbon、Collage 等)和自定义图片冲突吗? 不冲突。自定义图片替换的是"底图",卡纸标签继续叠加显示,且组名始终可见。全局默认样式在 menu > Settings > Cover display > Default folder style 调整,单个书架可在长按编辑中通过 Folder style 单独覆盖。
小结
| 场景 | 推荐方式 |
|---|---|
| 给单个系列/作者换图 | 长按卡片 → Set … image… |
| 文件夹批量配封面 | 放入 cover.jpg / folder.jpg |
| 作者、系列、类型、合集批量管理 | .bookshelf-images/ 图片库 |
| 还原默认 | 长按卡片 → Clear … image |
Bookshelf 的自定义文件夹图片功能把"文件夹只是容器"变成"文件夹也有形象"。配合 README.md 中的 Folder styles(文件夹样式)一节,你可以给每一块书架都安排上专属封面——这是让 KOReader 主屏真正"像你"的低成本方式。


