Wenku8_Flutter 立体书架使用指南:10 个技巧玩转循环轮播与批量整理

原创2026-10-25 10:01:391,909 阅读
文章标签:移动开发语音

Wenku8_Flutter 立体书架使用指南:10 个技巧玩转循环轮播与批量整理

Wenku8_Flutter 是一款面向 Android 的轻小说文库 Flutter 客户端,核心亮点是奶白玻璃质感、立体书架、循环轮播与批量整理。本篇教程面向新手,用 10 个可上手的技巧,带你玩转循环轮播与批量整理,几分钟就能把本地书库收拾得井井有条。

Wenku8_Flutter 轻小说文库客户端 App 图标

认识立体书架:循环轮播是怎么工作的

立体书架位于「发现」页底部,书籍像一列 3D 书脊一样排开,滑到哪本、哪本就居中展示封面。它的背后是一条以滚动位置为唯一时钟的连续抽取波(extraction wave):

  • 只有居中的那本书和左右相邻的两本会被真正挂载为图片组件,其余全部懒加载,滑再多书也不卡内存;
  • 书架两端是虚拟的、循环构建的,滑到尽头会自然接回开头,实现循环轮播;
  • 抬手后由自定义的 _ArchiveSnapPhysics 惯性物理接管,自动吸附到最近的一本书。

相关源码:archive_wave.dart(滚动时钟与轮播组件)、archive_shelf_geometry.dart(书架几何计算)。

10 个技巧玩转循环轮播与批量整理

1. 甩一下手,让惯性吸附替你"选书"

不要逐本慢慢拖。在书架上快速一甩,滚动物理会带着惯性滑行并吸附到最近一本书上,滑过每一本书时还能感到一次轻震(可在振动设置中单独关闭"书架滑动")。甩得越远,跳过的书越多,找书效率立刻翻倍。

2. 看准书脊标题,快速定位目标书

立体模式下每本书以"封面 + 书脊"呈现,书脊上带有书名,配合档案式排版一眼就能扫到目标。想确认来源时注意封面角的来源徽标——本地导入与在线书目会分开标识,避免在书架里混淆两类书。

3. 打开"平面轮播",低性能设备也能流畅循环

如果设备较弱或想省一点渲染开销,可以在性能偏好里关闭立体书架:它会退化为平面封面轮播(_FlatArchiveCarousel),仍然保留循环浏览能力,只是去掉 3D 透视与抽取层。

设置 → 性能偏好 → 立体书架(关闭后改为平面封面轮播,仍可循环浏览)

对应配置项:performance_preferences.dart

4. 切到列表视图,和立体书架各取所长

书架支持立体与列表两种视图。列表视图适合快速浏览书名、作者和阅读状态;立体视图适合"逛"书架。你可以按场景随时切换,两种视图共用同一套筛选条件。

5. 用分类 + 阅读状态 + 来源组合筛选

批量整理前先缩小范围:书架工具栏支持按分类、阅读状态、书籍来源组合筛选,先筛出"未读 + 本地导入",再做批量操作,一次只处理一小堆,不容易误伤。

6. 长按本地书,进入批量选择

本地书库的整理入口在长按一本书弹出的操作面板里,选择批量选择即可进入批量页;已选中的书会进入集合,还可以用页顶搜索框继续缩小范围。

7. 一键移动分类:N 本书归到同一个架

批量选中后点移动分类,会弹出自定义分类面板(可新建分类)。确认后,选中书籍整体移入目标分类,页面会提示"已将 N 本书移至「分类名」"。如果某本书分卷信息不完整,也可以在单书面板里先合并分卷,再统一归架。

8. 移出或彻底删除:两种移除方式不踩坑

批量页的移除提供两个选项,务必分清:

选项 效果
移出书架 只从书架移除,原文件保留,以后可以重新关联
删除本机文件 连同本地文件一起删除,进度和书签不可恢复

部分移除失败时,界面会保留你的选择并提示原因,可以重试。删除前建议先做一次本地备份。

9. 批量维护三件套:重建封面、升级排版、整理存储

在批量页可以进入本地维护页,勾选三项任务一次性处理所有选中书:

  1. 升级排版:补回原书注音、注释与样式,保留目录、书签和阅读位置;
  2. 重建封面:从原书恢复缺失封面,不会覆盖你手动换过的封面;
  3. 整理存储:压缩 TXT 阅读副本、清理 EPUB 重复资源,原书与阅读记录保留。

每个任务逐本执行、显示当前书名与总进度;即使中途某本失败,也不会破坏原书和阅读记录,可随时重试。

10. 调好振动与帧率,让轮播手感"跟手"

  • 振动:在振动偏好里可以单独控制书架滑动等分类开关,并调整强度、试振,找到最适合你的回馈力度(详见 docs/HAPTICS.md);

  • 帧率:在帧率偏好中降低玻璃折射、模糊等效果的渲染强度,轮播滑动会更顺滑;

  • 系统级:设置中支持强制竖屏,不影响其他应用旋转。

  • 振动分类:haptic_preferences.dart

  • 帧率偏好:frame_rate_settings.dart

常见问题

Q:滑动书架时跳过了几本书,为什么不会补播震动? A:这是刻意设计——快速甩动时不重放被跳过的书,避免连震,只在真正经过的每一本书时触发一次轻震(archive_wave.dart)。

Q:关掉立体书架后还能循环浏览吗? A:可以。平面封面轮播保留了发现页的封面导航与循环能力,只是去掉 3D 效果。

Q:批量操作失败了怎么办? A:分类保存或移除失败时,已做的选择会原样保留,界面会给出具体原因,直接重试即可;维护任务失败时原书与阅读记录不受影响。

小结

Wenku8_Flutter 的立体书架把"逛书架"做成了有惯性和触觉反馈的循环轮播体验,而本地书库则通过批量选择、移动分类、移除、重建封面与存储整理,把重复劳动压缩到几次点按。先筛、再选、后批量——掌握这条主线,你的书库整理效率会明显提升。

延伸阅读:

登录后查看全文
Wenku8_Flutter