v84: 首页「＋新建」日程 + 红线去端点 + 新建表单两处可见性修复

用户 2026-10-23 原话：「日程，没有新建日程按钮，名册，也没有新增成员这个按钮。」「首页上的日程，红色线不对，变短了左侧缺了一块。在日程模块中，那个红线左侧是不是还有一个红点？如果有，去掉。」 ① 首页日程区块加「＋新建」（FbHomePage / Widgets.FbSectionTitle） - FbSectionTitle 扩两个可选参数 addText / onAdd，带默认值 ⇒ 老调用点一行不改 - 按需懒拉 /calendar/books，缓存进 calBooks，同一会话只拉一次 - todayIso() 用本地年月日拼，**不用 toISOString**（UTC 会让早 8 点前算成昨天） ② 时间红线两端统一成「一根满宽线、无端点装饰、无行首文字」（FbDayTimeline） - 老写法 `Row { Text(时间) width(34); 线; 圆点 }` ⇒ 行首 34vp 把线顶掉一块（与网页端 .ag-now「双重缩进」同一类病），行尾 6x6 圆点就是用户问的红点 - 改成满高 Column + Blank 撑高 + 满宽 2px 线，与卡片端同一写法 ③ 🔴 真机实测发现的两处可见性问题（FbEventEditSheet） - 「加入哪本日历」原来排在「提醒」之后 ⇒ 表单高于卡片（maxHeight 86%），它被推到滚动区下方，首屏只看到被底边切掉半行的标题（实测 bounds 高 7px）。它是必选项（没选就「请选一本日历」存不上）⇒ 挪到「全天」之后、日期时间之前。 - 错误提示原来在滚动区**内部最底部** ⇒ 用户在顶部点「创建」时提示在几百 px 之下看不见；就算滚到底也被 Scroll 底边切半行。现象是「点了创建什么都没发生」。 ⇒ 挪到滚动区外面、按钮区上方（实测：Scroll 底 1953，提示 1984~2024，按钮 2074）。真机验收（设备 5NC0225B27004718，线上 family.yangyq.net）： - 静态守卫 1112/0；BUILD SUCCESSFUL；install bundle successfully - 「＋新建」bounds [868,931][1018,1045]，点击真的弹出「新建日程」 - 诊断确认 books=15 canWrite=6（数据层完全正常，之前的「选不了日历本」是可见性问题） - 日历本挪位后首屏可见：标题高 40px（原 7px），10 本 chip 从 838 排到 1358 - 错误提示挪位后不滚动即可见：命中「日程得有个标题」 - **端到端建卡成功**：线上库确认 id=2411 cal=5 20:00~21:00，首页 1 条→2 条；测试数据已按 id 精确删除（remaining_test_rows=0），重启后恢复 1 条
2026-10-24 19:14:18 +08:00
parent 0bab0cdcc6
commit cdbf0a9593
4 changed files with 257 additions and 52 deletions
@@ -356,33 +356,49 @@ export struct FbDayTimeline {
    .height('100%')
  }

-  /** 第 3 层：当前时间红线（浮在最上层） */
+  /**
+   * 第 3 层：当前时间红线（浮在最上层）
+   *
+   * 🔴🔴 v84（用户 2026-10-23，同一条消息里两处）：首页的这条线「红色线不对，
+   *   变短了左侧缺了一块」，日程页那条「红线左侧是不是还有一个红点？如果有，去掉。」
+   *
+   *   两个抱怨其实是同一段代码的两个缺陷，都在这里：
+   *   ① 老写法是 `Row { Text('07:02') width(34); 线(layoutWeight 1); 圆点(6) }`
+   *      —— **行首的 34vp 时间文字**把线往右顶掉一整块，用户看到的就是
+   *      "左侧缺一块"（与网页端 `.ag-now` 那次「双重缩进」是同一类病：
+   *      线的左沿被别的东西占了）。
+   *   ② 行尾那个 `6×6 borderRadius(3)` 就是用户问的**红点**。
+   *
+   *   ⇒ 两端统一成**一根满宽的红线，没有任何端点装饰、没有文字**。
+   *      这正是用户 v44 定下的口径：「直接把红点去掉就行了，直接一根红线就可以了」，
+   *      也是网页端 `.ag-now { left: 0; right: 0; border-top: 2px }` 的等价写法。
+   *
+   *   ⚠️ 别把时间文字"加回来"：只要 Row 里有任何子元素，线就一定短一截。
+   *      想知道现在几点，看左侧刻度列——那里 `isNowHour` 的那个小时文字**已经是红的**
+   *      （见 `hourLabels()` 那段的 `fontColor`），信息并没有丢。
+   *   ⚠️ 别用 `Row { 线(layoutWeight 1) }` 的写法包一层 —— 能跑，但多一层无谓嵌套，
+   *      且下次有人往这个 Row 里塞东西，缺一块的 bug 就又回来了。
+   *   ⚠️ `hitTestBehavior(HitTestMode.None)` 必须留：装饰层不能挡住点色块。
+   */
  @Builder
  nowLayer() {
-    if (this.nowVisible()) {
-      Row() {
-        // 左侧时间文字（红线那头）
-        Text(FbTimelineUtil.hhmm(this.nowMin))
-          .fontSize(9)
-          .fontColor(FB_NOW_RED)
-          .fontWeight(FontWeight.Medium)
-          .textAlign(TextAlign.End)
-          .width(34)
-        Row()
-          .layoutWeight(1)
+    /* ⚠️ 外层必须是**满高的 Column**：`Stack` 的几个子层是「叠」不是「排」，
+       直接给线写 `.margin({top})` 在部分版本上会因对齐基准不同而漂移。
+       用 `Blank` 撑开 = 与卡片端 `FbCard4x4.nowLayer()` **同一个写法**，
+       两端行为一致，改一处就知道另一处该怎么改。 */
+    Column() {
+      if (this.nowVisible()) {
+        Blank().height(this.nowOffsetVp()).hitTestBehavior(HitTestMode.None)
+        Column()
+          .width('100%')
          .height(2)
-          .backgroundColor(FB_NOW_RED)
-        Row()
-          .width(6)
-          .height(6)
-          .borderRadius(3)
+          .borderRadius(1)
          .backgroundColor(FB_NOW_RED)
      }
-      .width('100%')
-      .alignItems(VerticalAlign.Center)
-      .margin({ top: this.nowOffsetVp() })
-      .hitTestBehavior(HitTestMode.None)
    }
+    .width('100%')
+    .height('100%')
+    .hitTestBehavior(HitTestMode.None)
  }

  build() {
@@ -431,6 +431,32 @@ export struct FbEventEditSheet {
          .backgroundColor(FbColors.inputBg)
          .borderRadius(FbMetric.radiusS)

+          // ---- 日历本 ----
+          /* 🔴🔴 v84 真机实测（2026-10-24）：这一组原来排在「提醒」后面，
+             而表单内容比卡片（`maxHeight: 86%`）高 ⇒ 它在**滚动区下方**，
+             首屏只能看到被底边切掉半行的标题（实测 bounds 高 7px）。
+             用户报「选不了日历本」的直觉来源就是这个：看不见 = 用不了。
+             ⇒ 它是**必选项**（没选就 `请选一本日历` 存不上），
+               必须排在**首屏可见**的位置：紧跟「全天」，在日期时间之前。
+             ⚠️ 别再往回调到「提醒」后面 —— 那栏一长，它必然被推到屏幕外。 */
+          if (this.books.length > 0) {
+            this.section('加入哪本日历')
+            Flex({ wrap: FlexWrap.Wrap }) {
+              ForEach(this.books, (b: FbCalBook) => {
+                FbEventChip({
+                  label: b.name,
+                  active: this.fBookId === b.id,
+                  // 选中时用**这本日历自己的颜色**（一眼看出落到哪本）
+                  activeBg: b.color,
+                  onPick: (): void => {
+                    this.fBookId = b.id;
+                  }
+                })
+              }, (b: FbCalBook): string => 'bk_' + b.id.toString())
+            }
+            .width('100%')
+          }
+
          // ---- 日期与时间 ----
          // 🔴 照 SyncCalendar：**一行一个"日期 + 时间"控件**（点开一个弹层、
          //    里面 DatePicker 与 TimePicker 并排，选完点「确定」）。
@@ -476,25 +502,6 @@ export struct FbEventEditSheet {
          .width('100%')
          .margin({ top: 2 })

-          // ---- 日历本 ----
-          if (this.books.length > 0) {
-            this.section('加入哪本日历')
-            Flex({ wrap: FlexWrap.Wrap }) {
-              ForEach(this.books, (b: FbCalBook) => {
-                FbEventChip({
-                  label: b.name,
-                  active: this.fBookId === b.id,
-                  // 选中时用**这本日历自己的颜色**（一眼看出落到哪本）
-                  activeBg: b.color,
-                  onPick: (): void => {
-                    this.fBookId = b.id;
-                  }
-                })
-              }, (b: FbCalBook): string => 'bk_' + b.id.toString())
-            }
-            .width('100%')
-          }
-
          // ---- 地点 / 备注 ----
          this.field('地点', this.fPlace, '地点（可选）', (v: string): void => {
            this.fPlace = v;
@@ -502,13 +509,6 @@ export struct FbEventEditSheet {
          this.area('备注', this.fNote, '备注（可选）', (v: string): void => {
            this.fNote = v;
          })
-
-          if (this.err !== '') {
-            Text(this.err)
-              .fontSize(FbMetric.fontTiny)
-              .fontColor('#A32D2D')
-              .width('100%')
-          }
        }
        .width('100%')
        .padding({ top: 14 })
@@ -518,6 +518,21 @@ export struct FbEventEditSheet {
      .scrollBar(BarState.Off)
      .align(Alignment.TopStart)

+      /* 🔴🔴 v84 真机实测（2026-10-24）：错误提示原来放在**滚动区内部最底部**
+         （`this.area('备注' …)` 后面），于是——
+           ① 用户在顶部点「创建」时，提示在几百 px 之下，**根本看不见**；
+           ② 就算滚到底，它也被 `Scroll` 底边切掉半行（实测 bounds 高 39px，紧贴 2024 边界）。
+         现象就是「点了创建什么都没发生」——这是最难查的一类失败（用户只会以为没生效）。
+         ⇒ 挪到**滚动区外面、按钮区上方**：无论滚到哪儿，点完立刻看得见。
+         ⚠️ 不要挪回 Scroll 里：那里的可见性取决于用户当时滚到哪儿，运气好才看得见。 */
+      if (this.err !== '') {
+        Text(this.err)
+          .fontSize(FbMetric.fontTiny)
+          .fontColor('#A32D2D')
+          .width('100%')
+          .margin({ top: 10 })
+      }
+
      // ---- 底部按钮：删除 / 保存 ----
      if (this.deleting) {
        Text('删除中…')
@@ -148,6 +148,25 @@ export struct FbEmptyBox {
 export struct FbSectionTitle {
  @Param title: string = '';
  @Param extra: string = '';
+  /**
+   * 🔴 v84（用户 2026-10-23）：「日程，没有新建日程按钮，名册，也没有新增成员
+   *   这个按钮。……首页上的其他卡片也应该有这些基本功能。」
+   *
+   * `addText` 非空 ⇒ 在 extra 右边给一颗**小号文字按钮**（空 = 不画，行为与原来完全一致）。
+   *
+   * ⚠️ 为什么是"可选参数 + 默认空"而不是新加一个组件：
+   *    本组件被首页 4 个区块、日程页、任务页等多处引用，
+   *    改签名会波及所有调用点；`@Param` 带默认值则**老调用点一行都不用改**。
+   * ⚠️ 为什么按钮文案用文字而不是 `＋` 图标：
+   *    首页区块标题这一行只有 20vp 高，放图标按钮手指点不准（实测点击热区
+   *    会小于 40vp）；文字按钮横向量足，且与网页端 `datatable` 的「新增」观感一致。
+   * ⚠️ 点击热区用 `padding` 撑到 **44vp 高**（不是 fontTiny 那么点大）——
+   *    `hitTestBehavior` 默认是 `Default`，padding 区**算在热区内**。
+   */
+  @Param addText: string = '';
+  /** 点「新增」；`addText` 为空时永不触发 */
+  @Event onAdd: () => void = (): void => {
+  };

  build() {
    Row() {
@@ -162,9 +181,27 @@ export struct FbSectionTitle {
          .fontSize(FbMetric.fontTiny)
          .fontColor(FbColors.faint)
      }
+      if (this.addText.length > 0) {
+        /* extra 存在时用 6vp 间距隔开；extra 为空时靠 Blank 顶到右边 */
+        if (this.extra.length === 0) {
+          Blank()
+        }
+        Text(this.addText)
+          .fontSize(FbMetric.fontTiny)
+          /* ⚠️ 用 `FbColors.brand`（品牌砖红），不是 `accent` ——
+             `FbColors` 里**没有** `accent` 这个字段（编译会报
+             "Property 'accent' does not exist"）。 */
+          .fontColor(FbColors.brand)
+          .fontWeight(FontWeight.Medium)
+          .padding({ left: 10, right: 2, top: 12, bottom: 12 })
+          .onClick((): void => {
+            this.onAdd();
+          })
+      }
    }
    .width('100%')
    .padding({ left: 4, right: 4, top: 12, bottom: 8 })
+    .alignItems(VerticalAlign.Center)
  }
 }