Bookshelf自定义文件夹图片:给作者、系列、合集换专属封面

原创2026-10-16 20:49:101,367 阅读

Bookshelf自定义文件夹图片:给作者、系列、合集换专属封面

Bookshelf 是 KOReader 的电子书架主屏插件,帮你按系列、作者、类型或文件夹浏览书库并直接开读。它的 Custom images for folders and stacks(文件夹/堆栈自定义图片) 功能,允许你为文件夹、作者、系列、类型和合集换上专属封面图,替换默认的卡纸卡片,让书架更有个人风格。本文用 3 种方法讲透 Bookshelf 自定义文件夹图片的完整设置方法。

Bookshelf系列书架中的文件夹封面卡片,可替换为自定义封面

为什么需要 Bookshelf 自定义文件夹图片?

Bookshelf 中凡是"代表多本书"的条目——一个系列、一位作者、一个文件夹、一个合集——默认都渲染成文件夹卡片(folder tile):一张卡纸板加组名标签,上方探出第一本书的封面。

这个默认样式清晰,但缺少个性。给这些"堆栈(stack)"换上专属图片后:

  • 📚 系列书架一眼认出《沙丘》《基地》各自的视觉形象,不用读字;
  • ✍️ 作者书架可以放作者肖像,检索和浏览都更快;
  • 🗂️ 文件夹可以用与文件夹内容匹配的主题图,书架立刻像"自己的";
  • 🏷️ 合集(如"科幻精选")也能有自己的封面。

Bookshelf首页文件夹书架,文件夹卡片支持自定义封面图

💡 提示:作者、系列、类型、合集的专属图片由 Bookshelf 的 bookshelf_image_source.lua 统一解析和加载,内置了尺寸探测与渲染缓存,大批量图片也不会拖慢翻页。

Bookshelf 自定义文件夹图片的 3 种设置方法

Bookshelf 提供了三种互补的方式,从"临时改一张"到"批量管理整库"。

方法一:长按卡片,快速指定一张图片(最常用)

适合"给眼前这一个系列/作者/文件夹换图":

  1. 在书架上找到目标卡片(文件夹卡、作者堆栈、系列堆栈等);
  2. 长按卡片,弹出组菜单;
  3. 选择 Set folder image… / Set author image… / Set series image…(按组类型不同而不同);
  4. 在文件选择器中挑一张图片(支持 jpg、jpeg、png、gif、bmp、tiff、webp);
  5. 保存后书架立即重绘——卡纸标签仍保留在最上层,组名依然可见,只是底图换成了你的图片。

Bookshelf书架的Spines书脊视图,按系列分组并显示分组标签

想改回来?同样长按卡片,选 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/

规则很简单:

  1. 按组类型放入对应子文件夹,例如作者图放 authors/、系列图放 series/;
  2. 文件名用组名的精确拼写,如 authors/Asimov, Isaac.jpg;
  3. 不想处理逗号和空格?用 slug 形式兜底——名称转小写、标点与空格压缩成单个短横线:Asimov, Isaac → asimov-isaac.jpg,Sci-Fi/Fantasy → sci-fi-fantasy.jpg;
  4. 扩展名按 jpg → jpeg → png → gif → bmp → webp → tiff 的顺序尝试,找到第一个存在的文件即用。

精确文件名优先于 slug,所以能按精确名命名时优先精确名。这样你可以一次性为几十位作者配好肖像图,书架打开即生效——解析逻辑与测试见 tests/_test_stack_image_discovery.lua。

三种方式的优先级关系

Bookshelf 的解析优先级固定为:

  1. 长按菜单手动指定的图片(用户覆盖,最优先);
  2. 自动检测的图片(文件夹内的 cover.* / folder.*,或图片库中的同名/slug 文件);
  3. 都找不到 → 回退默认的卡纸卡片渲染。

也就是说:手动设置会盖过自动检测;清空手动设置后,文件夹里丢的 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 主屏真正"像你"的低成本方式。

登录后查看全文
bookshelf.koplugin