v0.7.0 接上真实服务器：登录 / 设备会话 / 全量同步与各模块真实数据

从「演示数据壳子」走到「真的能连家里的服务器用」。

登录（用户 2026-10-17「完整的登录功能」）
  · 首次启动先填服务器地址 → /api/v1/ping 自报门户（认得出"这地址上真是家书"）
  · 手机号或用户名 + 密码 → 拿令牌；失败提示统一，不泄露账号是否存在
  · FbDeviceStore：首次启动生成并持久化设备 UUID（三方应用拿不到 UDID），
    设备名取机型（marketName），并上报 platform / app_version

设备会话（v57，用户 2026-10-17）
  · 一把令牌 = 一台设备的一条会话；每次启动打一次 /me（有网就验）
  · 两种锁分开：need_login（401/被踢 → 清令牌）与 offline_expired
    （离线超 24h → 只锁界面、不清数据、联网自动恢复）——
    混成一种就会违背用户要的"一直联网就不用每天输密码"
  · 运行期任何请求 401 → 网络层全局回调立刻锁定跳登录页（FbHttp 的 authProbe
    让登录/校验类请求跳过，避免"两个地方同时跳登录页"）
  · 退出登录：先清本地令牌（主防线），再尽力通知服务端
  · 设置页显示版本号与「这台设备」

数据层
  · FbDb / FbSchema / FbParse / 各 Repo（日程 / 名册 / 观影 / 模块）+ FbSyncAll
  · 首页改为服务端 /home（农历/节气/纪念日/生日/天气/统计/往年的今天）
  · 日程页用 FbDayEventPanel，与网页端显示方式/红线/并排三处一致

验证：ArkTS 静态守卫 231/0；hvigor 编译 BUILD SUCCESSFUL（entry-default-signed.hap）。

entry/src/main/ets/pages/books/FbBooksPage.ets

@@ -11,9 +11,14 @@
 import { FbColors, FbMetric } from '../../common/Theme';
 import { FbAppState, fbAppState } from '../../common/Store';
 import { FbBookItem, FbGroup } from '../../model/Types';
-import { FB_DEMO_BOOKS, fbGroupBook } from '../../model/DemoData';
+import { fbGroupBook } from '../../model/DemoData';
+import { parseBooks } from '../../data/FbParse';
+import { loadModule } from '../../data/FbModuleLoad';
 import { FbEmptyBox, FbIconButton, FbProgressLine, FbRating, FbTag } from '../../components/Widgets';
 import { FB_DOCK_RESERVE } from '../../components/FloatDock';
+import { fbOnScroll, fbOnTouch } from '../../common/FbScroll';
+import { FbModuleSettingsSheet } from '../../components/FbModuleSettingsSheet';
+import { FB_SET_BOOKS } from '../../model/FbSettingsMenus';
 
 @ComponentV2
 export struct FbBooksPage {
@@ -27,71 +32,157 @@ export struct FbBooksPage {
 
   /** 模块主题色（读书 = 藕紫） */
   private accent: string = '#6B5B95';
-  private all: FbBookItem[] = FB_DEMO_BOOKS;
+  /**
+   * 模块设置浮层是否打开（右上角三条横线点开的那个）。
+   *
+   * 🔴 用户 2026-10-16：「所有页面的设置按钮全部都改成和网页版一致，
+   *    就是**三个横线**那种设置按钮。」
+   *    网页版的做法：动作区最右一个 ☰ → 点开是**这个模块的设置菜单**。
+   */
+  @Local settingsOpen: boolean = false;
+
+  @Local all: FbBookItem[] = [];
+
+  /**
+   * 页面出现：先读缓存、再拉接口（本地优先，见 FbModuleRepo 的说明）。
+   *
+   * ⚠️ 不在这里打开本地库 —— `EntryAbility.onCreate` 已统一打开。
+   */
+  aboutToAppear(): void {
+    this.load();
+  }
+
+  private async load(): Promise<void> {
+    await loadModule<FbBookItem[]>('books', parseBooks,
+      (rows: FbBookItem[]): void => {
+        this.all = rows;
+      },
+      (note: string): void => {
+        this.syncNote = note;
+      });
+  }
+
+  /** 顶部提示（同步失败 / 未登录时显示一行小字） */
+  @Local syncNote: string = '';
+
+
+  /**
+   * 设置浮层开着 ⇒ 让底部悬浮快捷栏让位。
+   *
+   * 🔴 悬浮栏在**更外层 Index 的 Stack** 里，层级比本页高 ⇒
+   *    浮层底部的按钮会被它盖住、点击被抢走（名册/日程页都踩过）。
+   */
+  @Monitor('settingsOpen')
+  onSettingsChanged(): void {
+    fbAppState().sheetCount = this.settingsOpen ? 1 : 0;
+  }
 
   build() {
-    Scroll() {
-      Column() {
-        this.topBar()
+    // 🔴 外层 Stack：**模块设置浮层**要浮在页面之上
+    //    （本页原来是 Scroll 直接作根，没有 Stack，这里补一层）
+    Stack({ alignContent: Alignment.Bottom }) {
 
-        // ---- 页头 ----
-        Row({ space: 8 }) {
-          Column({ space: 2 }) {
-            Text('书架')
-              .fontSize(FbMetric.fontTitle)
-              .fontWeight(FontWeight.Medium)
-              .fontColor(FbColors.ink)
-            Text(this.all.length.toString() + ' 本 · '
-              + this.readingCount().toString() + ' 本在读 · '
-              + this.noteCount().toString() + ' 条笔记')
-              .fontSize(FbMetric.fontTiny)
-              .fontColor(FbColors.faint)
-          }
-          .alignItems(HorizontalAlign.Start)
-          .layoutWeight(1)
+      Scroll() {
+        Column() {
+          this.topBar()
 
-          // 上传 / 统计（Web 端在设置菜单里）
-          FbIconButton({ icon: $r('app.media.fb_ic_chart'), tint: FbColors.muted })
-          FbIconButton({ icon: $r('app.media.fb_ic_gear'), tint: FbColors.muted })
-        }
-        .width('100%')
-        .padding({ left: FbMetric.pagePad, right: FbMetric.pagePad, top: 12, bottom: 8 })
-        .alignItems(VerticalAlign.Center)
+          // ---- 页头 ----
+          Row({ space: 8 }) {
+            Column({ space: 2 }) {
+              Text('书架')
+                .fontSize(FbMetric.fontTitle)
+                .fontWeight(FontWeight.Medium)
+                .fontColor(FbColors.ink)
+              Text(this.all.length.toString() + ' 本 · '
+                + this.readingCount().toString() + ' 本在读 · '
+                + this.noteCount().toString() + ' 条笔记')
+                .fontSize(FbMetric.fontTiny)
+                .fontColor(FbColors.faint)
+            }
+            .alignItems(HorizontalAlign.Start)
+            .layoutWeight(1)
 
-        // ---- 分组列表 ----
-        if (this.all.length === 0) {
-          FbEmptyBox({
-            title: '书架还是空的',
-            hint: '传一本进来，或先记下想读的书',
-            icon: $r('app.media.fb_ic_books')
-          })
-        } else {
-          List({ space: 0 }) {
-            ForEach(this.groups(), (g: FbGroup<FbBookItem>) => {
-              ListItemGroup({ header: this.groupHeader(g.title, g.count) }) {
-                ForEach(g.items, (b: FbBookItem) => {
-                  ListItem() {
-                    this.bookRow(b)
-                  }
-                }, (b: FbBookItem): string => 'bk_' + b.id.toString())
+            // 上传 / 统计（Web 端在设置菜单里）
+            FbIconButton({ icon: $r('app.media.fb_ic_chart'), tint: FbColors.muted })
+            // 🔴 设置按钮 = 网页版那种**三条横线**（☰）—— 用户 2026-10-16。
+            //    点开是本模块的设置菜单（条目照网页版 `templates/<模块>/_settings_menu.php`）。
+            FbIconButton({
+              icon: $r('app.media.fb_ic_menu'),
+              tint: FbColors.muted,
+              onTap: (): void => {
+                this.settingsOpen = true;
               }
-            }, (g: FbGroup<FbBookItem>): string => 'bg_' + g.key)
+            })
           }
           .width('100%')
-          .padding({ left: FbMetric.pagePad, right: FbMetric.pagePad, bottom: 24 })
-          .scrollBar(BarState.Off)
-          .edgeEffect(EdgeEffect.Spring)
+          .padding({ left: FbMetric.pagePad, right: FbMetric.pagePad, top: 12, bottom: 8 })
+          .alignItems(VerticalAlign.Center)
+
+          // ---- 分组列表 ----
+          if (this.all.length === 0) {
+            FbEmptyBox({
+              title: '书架还是空的',
+              hint: '传一本进来，或先记下想读的书',
+              icon: $r('app.media.fb_ic_books')
+            })
+          } else {
+            List({ space: 0 }) {
+              ForEach(this.groups(), (g: FbGroup<FbBookItem>) => {
+                ListItemGroup({ header: this.groupHeader(g.title, g.count) }) {
+                  ForEach(g.items, (b: FbBookItem) => {
+                    ListItem() {
+                      this.bookRow(b)
+                    }
+                  }, (b: FbBookItem): string => 'bk_' + b.id.toString())
+                }
+              }, (g: FbGroup<FbBookItem>): string => 'bg_' + g.key)
+            }
+            .width('100%')
+            .padding({ left: FbMetric.pagePad, right: FbMetric.pagePad, bottom: 24 })
+            .scrollBar(BarState.Off)
+            .edgeEffect(EdgeEffect.Spring)
+          }
         }
+        .width('100%')
+        // 底部悬浮快捷栏的预留：它浮在内容之上，不留白会压住最后一屏
+        .padding({ bottom: FB_DOCK_RESERVE })
       }
       .width('100%')
-      // 底部悬浮快捷栏的预留：它浮在内容之上，不留白会压住最后一屏
-      .padding({ bottom: FB_DOCK_RESERVE })
+      .height('100%')
+      .scrollBar(BarState.Off)
+      .edgeEffect(EdgeEffect.Spring)
+      // 🔴 滚动方向上报（驱动底部悬浮栏随滚收起 / 唤回）—— 见 common/FbScroll.ets
+      .onDidScroll(fbOnScroll)
+
+      // 🔴 触摸方向兜底（内容不足一屏的页面滚不动，只能靠手指位移判断）
+      //    与上面的 `onDidScroll` 互补、互不冲突 —— 见 common/FbScroll.ets
+      .onTouch(fbOnTouch)
+      .align(Alignment.TopStart)
+      // ---- 模块设置浮层（右上角三条横线点开的那个）----
+      if (this.settingsOpen) {
+        Column()
+          .width('100%')
+          .height('100%')
+          .backgroundColor('#00000066')
+          .onClick((): void => {
+            this.settingsOpen = false;
+          })
+
+        FbModuleSettingsSheet({
+          title: '读书设置',
+          items: FB_SET_BOOKS,
+          onClose: (): void => {
+            this.settingsOpen = false;
+          },
+          onPick: (action: string): void => {
+            // 条目里 `action === ''` 的是「暂未开放」（组件里已画灰、点了不响应）
+            // ⇒ 这里只需处理已实现的；目前都还没有，保持浮层开着即可。
+          }
+        })
+      }
     }
     .width('100%')
     .height('100%')
-    .scrollBar(BarState.Off)
-    .edgeEffect(EdgeEffect.Spring)
-    .align(Alignment.TopStart)
   }
 
   /** 一本书：书脊色块（代替封面）+ 书名/作者 + 评分/笔记/进度 */