Wenku8_Flutter 触觉反馈系统设计：为什么每个有效交互都有 65ms 节制的质感

Wenku8_Flutter 是一款面向轻小说文库的 Flutter 客户端，主打奶白玻璃、立体书架、离线阅读与在线听书（Android）。它的触觉反馈（振动/触感）系统让"打开书籍、点按卡片、切换选项、翻页、拖动刻度"这些有效交互都配有一次短促而克制的震动，并用一道全局 65ms 节流保证任何两次反馈都不会叠成一记"双震"。本文带你读懂这套触觉反馈设计的核心：为什么节制比多震更有质感、7 类场景如何分级、以及如何在设置中调整振动反馈。

💡 一句话概括：触感只属于"已确认的交互"，节奏由 65ms 底线守护，强度交给三档可选项。

一、什么是"有效交互"：触感只属于被确认的操作

这套触觉系统服务于 Wenku8_Flutter 的整个界面，与它克制、统一的视觉语言是一体的：

Wenku8_Flutter 的触觉反馈有一个明确原则：只给用户已确认的操作反馈。docs/HAPTICS.md 中列出了完整场景表，核心可以分成三组：

类型	例子	触感
✅ 会震	点按钮、选卡片、翻页、拖动刻度、长按、到达边界	一次短促的动作／刻度反馈
⚠️ 结果震	复制成功、收藏、导入完成、操作失败	原生成功／失败反馈，节奏不同
🚫 保持安静	页面加载、图标自动入场、预读、后台同步、禁用控件、被滚动取消的点击	不触发任何震动

也就是说，触感不是"动效彩蛋"，而是交互语义的一部分：手指按下的瞬间不震（避免误触噪声），结果确认后才震——比如复制、收藏、手动导入这类"有明确结果"的按钮，按下时保持安静，只在结果确认后反馈一次。

二、65ms 节流：一套 HapticGate 如何避免"双震"

这是整套系统的灵魂。在 lib/app_haptics.dart 中，所有震动请求都必须先通过一个叫 HapticGate 的"闸门"，它有两层防线：

1. 全局底线 65ms——任意两次反馈，哪怕来自不同类别，至少间隔 65ms；
2. 类别限频——同一类反馈还有各自的冷却时间：

反馈（Cue）	冷却间隔
书架刻度 shelfStep	65 ms
拖动刻度 detent	70 ms
选项选择 selection	80 ms
普通操作 action ／ 边界 boundary	100 ms
翻页 pageTurn	110 ms
长按 longPress	150 ms
成功 success ／ 警告 warning ／ 失败 error	350 ／ 400 ／ 450 ms

为什么要这样做？因为界面里常有嵌套控件——点一张玻璃卡片时，外层按钮、内层文本、弹层关闭可能同时想发震动。不加节流，一次点击就会被叠成"哒-哒"两下，廉价又混乱。65ms 让每次操作摸起来都是干脆的一下。

更关键的是：被节流的震动直接丢弃，不排队——快甩书架时跳过了几本书，也不会松手后补震几下。

三、7 类场景 × 3 档强度：每个开关都有名字

用户偏好定义在 lib/haptic_preferences.dart，分成 7 个可独立开关、独立调档的类别：

🎛️ 按钮与选择 · 书架滑动 · 阅读翻页 · 拖动刻度 · 长按 · 边界提示 · 结果提示

每个类别可选 轻 / 标准 / 强 三档强度。这里有三个值得注意的设计决定：

• 强度只改变"脉冲幅度"，不改变触发频率——调成"轻"不会漏掉某次交互；
• "全部强度"会一次性修改所有类别档位，且不与分类强度叠加，没有隐藏的二次衰减；
• 关闭某个类别会保留它的原档位，重新打开即恢复，设置不丢失。

还有一个有趣细节：书架使用独立的 shelfStep 反馈，不与密集进度条共用极轻预设——因为书架的"短刻度"是这款 App 的招牌手感，被统一化会毁掉它。

四、招牌手感：立体书架的"过格"震动

滑动立体书架时，触感不落在"选中边界"，而是落在下一本书接近中心（距中心 0.12 格）的瞬间，实现见 lib/archive_wave.dart。判定逻辑非常讲究：

• 比较的是"跨过"的中心区间，而不是依赖某一帧刚好落进 0.12 格窗口——快甩时即使一帧跨过两三本书，也不会漏掉刻度；
• 被 65ms 闸门拦下的刻度永远消费掉，快甩不补发、松手吸附不补震；
• 相邻中心之间的来回抖动不会反复敲击。

这就是标题里"65ms 节制"的最佳注脚：震动密度恰好跟得上手指，却永远不会吵。

五、在设置中调整振动反馈：改档即试振

入口在 设置 → 性能与动效 → 振动反馈，页面由 lib/haptic_settings_page.dart 实现，操作很简单：

1. 顶部总开关：关闭后保留各项设置，重新打开即恢复；
2. "全部强度"：一键统一所有类别的档位；
3. 每个类别独立开关 + 轻／标准／强三档；
4. 每改一档，系统立即用该类触感试振一次（AppHaptics.preview）——先摸到，再保存。

六、平台适配：同一语义，各自的母语

Flutter 层只传递语义（HapticCue），Android 与 iOS 的原生层各自翻译成设备最自然的振动：

• 📱 Android（AppHapticsPlugin.kt）：标准档沿用系统预设 CLOCK_TICK（短促、跨厂商一致）；轻／强档在 Android 12 及以上使用短促 TICK／CLICK 原语，缩放强度而不是拉长时长；成功与失败是两段不同节奏。全程尊重系统的"触感反馈"开关，原生拒绝播放后不追加备用振动。
• 🍎 iOS：标准档沿用选择、短触、长按与系统成功／警告／失败语义；轻／强档使用 impact intensity，实际手感随设备和系统设置自适应。

七、设计原则小结

📚 把 Wenku8_Flutter 触觉反馈的设计浓缩成四句话：

1. 语义优先——反馈只给"已确认的交互与可见结果"，加载、后台、恢复一律安静；
2. 节奏守恒——全局 65ms 底线 + 分类冷却，被节流者直接丢弃、绝不排队；
3. 强度与频率解耦——调轻不丢次数，统一档位不与分类档位叠加；
4. 平台母语——App 层只传语义，Android／iOS 各自选择最原生、最短促的表达。

想深入阅读，可以从 docs/HAPTICS.md 的全场景对照表、lib/app_haptics.dart 的闸门实现，以及 README.md 的整体介绍入手。