Wenku8_Flutter 立体书架使用指南:10 个技巧玩转循环轮播与批量整理
Wenku8_Flutter 立体书架使用指南:10 个技巧玩转循环轮播与批量整理
Wenku8_Flutter 是一款面向 Android 的轻小说文库 Flutter 客户端,核心亮点是奶白玻璃质感、立体书架、循环轮播与批量整理。本篇教程面向新手,用 10 个可上手的技巧,带你玩转循环轮播与批量整理,几分钟就能把本地书库收拾得井井有条。
认识立体书架:循环轮播是怎么工作的
立体书架位于「发现」页底部,书籍像一列 3D 书脊一样排开,滑到哪本、哪本就居中展示封面。它的背后是一条以滚动位置为唯一时钟的连续抽取波(extraction wave):
- 只有居中的那本书和左右相邻的两本会被真正挂载为图片组件,其余全部懒加载,滑再多书也不卡内存;
- 书架两端是虚拟的、循环构建的,滑到尽头会自然接回开头,实现循环轮播;
- 抬手后由自定义的
_ArchiveSnapPhysics惯性物理接管,自动吸附到最近的一本书。
相关源码:archive_wave.dart(滚动时钟与轮播组件)、archive_shelf_geometry.dart(书架几何计算)。
10 个技巧玩转循环轮播与批量整理
1. 甩一下手,让惯性吸附替你"选书"
不要逐本慢慢拖。在书架上快速一甩,滚动物理会带着惯性滑行并吸附到最近一本书上,滑过每一本书时还能感到一次轻震(可在振动设置中单独关闭"书架滑动")。甩得越远,跳过的书越多,找书效率立刻翻倍。
- 吸附物理实现:archive_wave.dart
- 书架振动开关:haptic_preferences.dart
2. 看准书脊标题,快速定位目标书
立体模式下每本书以"封面 + 书脊"呈现,书脊上带有书名,配合档案式排版一眼就能扫到目标。想确认来源时注意封面角的来源徽标——本地导入与在线书目会分开标识,避免在书架里混淆两类书。
- 书脊标题绘制:archive_spine_title.dart
- 来源徽标:book_source_badge.dart
3. 打开"平面轮播",低性能设备也能流畅循环
如果设备较弱或想省一点渲染开销,可以在性能偏好里关闭立体书架:它会退化为平面封面轮播(_FlatArchiveCarousel),仍然保留循环浏览能力,只是去掉 3D 透视与抽取层。
设置 → 性能偏好 → 立体书架(关闭后改为平面封面轮播,仍可循环浏览)
对应配置项:performance_preferences.dart
4. 切到列表视图,和立体书架各取所长
书架支持立体与列表两种视图。列表视图适合快速浏览书名、作者和阅读状态;立体视图适合"逛"书架。你可以按场景随时切换,两种视图共用同一套筛选条件。
5. 用分类 + 阅读状态 + 来源组合筛选
批量整理前先缩小范围:书架工具栏支持按分类、阅读状态、书籍来源组合筛选,先筛出"未读 + 本地导入",再做批量操作,一次只处理一小堆,不容易误伤。
- 分类数据与操作:book_categories.dart
- 搜索与筛选指南:docs/SEARCH.md
6. 长按本地书,进入批量选择
本地书库的整理入口在长按一本书弹出的操作面板里,选择批量选择即可进入批量页;已选中的书会进入集合,还可以用页顶搜索框继续缩小范围。
- 批量页入口:local_book_batch_page.dart
- 面板中的"批量选择"按钮:local_library_page.dart
7. 一键移动分类:N 本书归到同一个架
批量选中后点移动分类,会弹出自定义分类面板(可新建分类)。确认后,选中书籍整体移入目标分类,页面会提示"已将 N 本书移至「分类名」"。如果某本书分卷信息不完整,也可以在单书面板里先合并分卷,再统一归架。
- 批量移分类逻辑:local_book_batch_page.dart
8. 移出或彻底删除:两种移除方式不踩坑
批量页的移除提供两个选项,务必分清:
| 选项 | 效果 |
|---|---|
| 移出书架 | 只从书架移除,原文件保留,以后可以重新关联 |
| 删除本机文件 | 连同本地文件一起删除,进度和书签不可恢复 |
部分移除失败时,界面会保留你的选择并提示原因,可以重试。删除前建议先做一次本地备份。
- 移除选项实现:local_book_removal.dart
9. 批量维护三件套:重建封面、升级排版、整理存储
在批量页可以进入本地维护页,勾选三项任务一次性处理所有选中书:
- 升级排版:补回原书注音、注释与样式,保留目录、书签和阅读位置;
- 重建封面:从原书恢复缺失封面,不会覆盖你手动换过的封面;
- 整理存储:压缩 TXT 阅读副本、清理 EPUB 重复资源,原书与阅读记录保留。
每个任务逐本执行、显示当前书名与总进度;即使中途某本失败,也不会破坏原书和阅读记录,可随时重试。
- 任务定义与执行:local_maintenance_page.dart
- 排版升级底层逻辑:local_book_maintenance.dart
10. 调好振动与帧率,让轮播手感"跟手"
-
振动:在振动偏好里可以单独控制书架滑动等分类开关,并调整强度、试振,找到最适合你的回馈力度(详见 docs/HAPTICS.md);
-
帧率:在帧率偏好中降低玻璃折射、模糊等效果的渲染强度,轮播滑动会更顺滑;
-
系统级:设置中支持强制竖屏,不影响其他应用旋转。
常见问题
Q:滑动书架时跳过了几本书,为什么不会补播震动? A:这是刻意设计——快速甩动时不重放被跳过的书,避免连震,只在真正经过的每一本书时触发一次轻震(archive_wave.dart)。
Q:关掉立体书架后还能循环浏览吗? A:可以。平面封面轮播保留了发现页的封面导航与循环能力,只是去掉 3D 效果。
Q:批量操作失败了怎么办? A:分类保存或移除失败时,已做的选择会原样保留,界面会给出具体原因,直接重试即可;维护任务失败时原书与阅读记录不受影响。
小结
Wenku8_Flutter 的立体书架把"逛书架"做成了有惯性和触觉反馈的循环轮播体验,而本地书库则通过批量选择、移动分类、移除、重建封面与存储整理,把重复劳动压缩到几次点按。先筛、再选、后批量——掌握这条主线,你的书库整理效率会明显提升。
延伸阅读:
- 阅读指南:docs/READER.md
- 搜索指南:docs/SEARCH.md
- 网盘导入:docs/CLOUD_IMPORT.md
- 图标系统:docs/ICON_SYSTEM.md