v65/v66：六个空壳模块接线 + 桌面服务卡片

用户 2026-10-20：「做几个和 syncCalendar 差不多的卡片。另外其他的功能也逐步完成……旅程的新建旅程啊，车辆管理、出行方式、节点设置……资源也点不进去……任务也点不进去，也没法完成……纪念日、新增纪念日……财务的显示也有问题……笔记现在也点不进去，记笔记也记不了。」 v65 —— 六个模块（任务 / 资源 / 纪念日 / 笔记 / 账本 / 旅程）原本是**同一套空壳模板**复制出来的：`FbPrimaryButton` 没有 `onTap`、`ListItem` 没有 `onClick`、设置菜单的 `action` 全是空串。这一版把它们全部接上真实接口： · 任务：新建 / 编辑（`FbTaskEditSheet` + `FbTaskRepo`）、列表可点、勾完成（走 `/tasks/<id>/status` —— 服务端 `PATCH` **显式忽略** status，走 Patch 会得到"看起来成功的假成功"）、按看板筛选 · 资源：新增 / 查看 / 改 / 删（`FbResourceSheet` + `FbResourceRepo`）；过滤维度从**并不存在的**「证件 / 资料」改成按权限与归属（`resources` 表没有 category 列，那个筛选一直是筛空的） · 纪念日：新增 / 编辑（`FbDayEditSheet` + `FbDayRepo`）；派生生日（id=0、来自名册）只给提示不给编辑 —— 点开 `/days/0` 必然 404 · 笔记：记一条 / 打开 / 改（`FbNoteSheet` + `FbNoteRepo`），正文按 blocks 存 · 账本：记一笔（`FbLedgerEntrySheet` + `FbLedgerRepo`）；修掉财务显示自相矛盾 —— 资产/负债改回**服务端 summary**（原来端上按金额正负号重算，与服务端"负债取绝对值"的口径打架，会算出净资产 ≠ 资产 − 负债） · 旅程：题图卡片（封面 + 标题 + 城市）+ 行程 + 新建旅程 + 新建节点服务端同时修掉两处**静默数据丢失**（网页端因提交格式凑巧没暴露，只有走 API 的客户端会中招）： · 新建笔记传的是 `body`，而 `Note::create()` 只读 `blocks` ⇒ 新笔记只有标题 · 改笔记时 `blocks` 恒为空，而 `Note::update()` 是整组替换 ⇒ 只改标题就把正文全删光；另修 `annivPeopleOf()`（`find()` 的 SQL 不含 people，原来那个兜底恒为空 ⇒ 只改纪念日标题会清空关联人） v66 —— 桌面服务卡片（用户选了「桌面服务卡片」这一项）： · `FbFormAbility`（FormExtensionAbility）+ `form_config.json` 三块尺寸： 2×2 今日概览 / 2×4 左右分栏 / 4×4 今日全景 · `FbCardData` 只打 `/home` 一个接口（与网页首页同源），数据**扁平化**后由 `formBindingData` 推给卡片；断网时用上次成功的缓存并注明"离线" · 卡片是后台进程 ⇒ 请求带 `authProbe: true`：401 **不能**触发全局"踢回登录页"（那会顺手把正在用应用的人踢下线，v62 那次事故同一个坑） · 点卡片 → `postCardAction(router, fbModule)` → `EntryAbility` 读 Want 参数直接落到对应模块；补了 `onNewWant`（没有它，第二次点卡片"什么也没发生"） · 4×4 右上角 ↻ 走 `postAction(message)` → `onFormEvent` 重取数再推回验证：`hvigorw assembleHap` BUILD SUCCESSFUL；打包后的 hap 里确认 `FbFormAbility`（type=form）与 `$profile:form_config` 都在，卡片代码进了 `ets/widgets.abc`。静态守卫 730 条全绿，反向验证 110 条注入全部能让守卫变红。 ⚠️ 设备仍断连（`hdc list targets` 为空），真机尚未验收。
2026-10-20 15:27:32 +08:00
parent 3b7238a418
commit b3e1330244
32 changed files with 5572 additions and 227 deletions
@@ -0,0 +1,326 @@
+/**
+ * 家书 FamilyBook · 笔记浮层（新建 / 看 / 改 / 删）（鸿蒙端）
+ *
+ * 对应网页版 `templates/notes/`（网页是"卡片 + 详情页"，端上合成一个浮层：
+ * 卡片是一段短文，为它单开一屏不值当）。
+ *
+ * 🔴 用户 2026-10-20：「笔记现在也点不进去，记笔记也记不了。」
+ *    ⇒ 端上既没有新建、也没有详情：`FbPrimaryButton` 无 `onTap`、卡片无 `onClick`。
+ *
+ * ⚠️ 端上只支持**纯文本**（服务端 `body` → 一个 `text` 块）：
+ *    网页那边可以图文混排（`note_blocks` 有 image 块），端上先不做 ——
+ *    图片块的内容是附件 key，硬拼进文本框会变成一串乱码。
+ *    所以已有笔记里的图片块在端上显示成「[图片]」（见 `parseNotes` 的 `noteBodyOf`）。
+ *
+ * ⚠️ **只读**：别人共享给我的笔记能看不能改（服务端 `Note::canWrite` 那一套）。
+ *    端上按 `mine` 判断 —— 保守一点宁可少给编辑，也不能给个点了报 403 的按钮。
+ */
+
+import { FbColors, FbMetric, FB_MASK, fbAlpha } from '../common/Theme';
+import { FbSheetClose } from './FbSheetClose';
+import { FbSheetRing } from './FbSheetRing';
+import { FB_TOKEN_STORE } from '../data/FbTokenStore';
+import { createNote, updateNote, deleteNote } from '../data/FbNoteRepo';
+import { FbApiResult } from '../data/FbHttp';
+
+@ComponentV2
+export struct FbNoteSheet {
+  /** 模块主题色（笔记 = 褐灰） */
+  @Param accent: string = '#7A6A4F';
+  /** 正在看/改的笔记 id（0 = 新建） */
+  @Param editingId: number = 0;
+  @Param editingTitle: string = '';
+  @Param editingBody: string = '';
+  @Param editingTags: string = '';
+  /** 是不是我写的（不是就只能看） */
+  @Param mine: boolean = true;
+
+  @Event onClose: () => void = (): void => {};
+  @Event onSaved: () => void = (): void => {};
+  @Event onDeleted: () => void = (): void => {};
+
+  @Local title: string = '';
+  @Local body: string = '';
+  /** 标签输入（用空格或逗号分隔，服务端会自己归一） */
+  @Local tags: string = '';
+  @Local saving: boolean = false;
+  @Local confirmingDelete: boolean = false;
+  @Local note: string = '';
+
+  aboutToAppear(): void {
+    this.title = this.editingTitle;
+    this.body = this.editingBody;
+    this.tags = this.editingTags;
+  }
+
+  /** 能不能改：新建时当然能；已有笔记只有自己写的能改 */
+  private editOk(): boolean {
+    return this.editingId <= 0 || this.mine;
+  }
+
+  /** 标签串 → 数组（逗号 / 顿号 / 空格 / # 都当分隔） */
+  private tagList(): string[] {
+    const norm: string = this.tags.replace(new RegExp('#', 'g'), ' ')
+      .replace(new RegExp('，', 'g'), ' ')
+      .replace(new RegExp(',', 'g'), ' ')
+      .replace(new RegExp('、', 'g'), ' ');
+    const parts: string[] = norm.split(' ');
+    const out: string[] = [];
+    for (const p of parts) {
+      const t: string = p.trim();
+      if (t !== '' && out.indexOf(t) < 0) {
+        out.push(t);
+      }
+    }
+    return out;
+  }
+
+  build() {
+    /* 🔴🔴 根必须 `Stack`：遮罩与卡片要"叠"，不能当 `Column` 子项"排"
+       （排会把卡片挤出屏幕 —— 2026-10-20 真机事故，见 pitfalls.md） */
+    Stack({ alignContent: Alignment.Center }) {
+      Column()
+        .width('100%')
+        .height('100%')
+        .backgroundColor(FB_MASK)
+        .onClick((): void => {
+          this.onClose();
+        })
+
+      Column() {
+        FbSheetRing({ radius: FbMetric.radius, ringColor: this.accent }) {
+          Column({ space: 12 }) {
+            // ---- 标题栏 ----
+            Row({ space: 8 }) {
+              Column({ space: 2 }) {
+                Text(this.editingId > 0 ? (this.mine ? '笔记' : '别人共享的笔记') : '记一条')
+                  .fontSize(FbMetric.fontTitle)
+                  .fontWeight(FontWeight.Medium)
+                  .fontColor(FbColors.ink)
+                  .maxLines(1)
+                Text(this.editOk() ? '随手记点什么，按标签归类和检索' : '只读：只能看，改要作者来')
+                  .fontSize(FbMetric.fontTiny)
+                  .fontColor(this.accent)
+                  .maxLines(1)
+              }
+              .alignItems(HorizontalAlign.Start)
+              .layoutWeight(1)
+              .flexShrink(1)
+
+              FbSheetClose({
+                onClose: (): void => {
+                  this.onClose();
+                },
+                color: this.accent
+              })
+            }
+            .width('100%')
+            .alignItems(VerticalAlign.Center)
+
+            Scroll() {
+              Column({ space: 12 }) {
+                // ---- 标题 ----
+                Row({ space: 8 }) {
+                  Text('标题')
+                    .fontSize(FbMetric.fontTiny)
+                    .fontColor(FbColors.faint)
+                    .width(34)
+                  TextInput({ text: this.title, placeholder: '给这条起个名字' })
+                    .placeholderColor(FbColors.faint)
+                    .placeholderFont({ size: FbMetric.fontTiny })
+                    .fontSize(FbMetric.fontSmall)
+                    .fontColor(FbColors.ink)
+                    .backgroundColor(FbColors.inputBg)
+                    .borderRadius(FbMetric.radiusS)
+                    .height(42)
+                    .layoutWeight(1)
+                    .padding({ left: 10, right: 10 })
+                    .enabled(this.editOk())
+                    .onChange((v: string): void => {
+                      this.title = v;
+                      this.note = '';
+                    })
+                }
+                .width('100%')
+                .alignItems(VerticalAlign.Center)
+
+                // ---- 正文 ----
+                Row({ space: 8 }) {
+                  Text('正文')
+                    .fontSize(FbMetric.fontTiny)
+                    .fontColor(FbColors.faint)
+                    .width(34)
+                  TextArea({ text: this.body, placeholder: '想记的都写在这儿' })
+                    .placeholderColor(FbColors.faint)
+                    .placeholderFont({ size: FbMetric.fontTiny })
+                    .fontSize(FbMetric.fontSmall)
+                    .fontColor(FbColors.ink)
+                    .backgroundColor(FbColors.inputBg)
+                    .borderRadius(FbMetric.radiusS)
+                    .height(200)
+                    .layoutWeight(1)
+                    .padding({ left: 10, right: 10, top: 8, bottom: 8 })
+                    .enabled(this.editOk())
+                    .onChange((v: string): void => {
+                      this.body = v;
+                    })
+                }
+                .width('100%')
+                .alignItems(VerticalAlign.Top)
+
+                // ---- 标签 ----
+                Row({ space: 8 }) {
+                  Text('标签')
+                    .fontSize(FbMetric.fontTiny)
+                    .fontColor(FbColors.faint)
+                    .width(34)
+                  TextInput({ text: this.tags, placeholder: '空格或逗号分隔，如：读书 摘抄' })
+                    .placeholderColor(FbColors.faint)
+                    .placeholderFont({ size: FbMetric.fontTiny })
+                    .fontSize(FbMetric.fontSmall)
+                    .fontColor(FbColors.ink)
+                    .backgroundColor(FbColors.inputBg)
+                    .borderRadius(FbMetric.radiusS)
+                    .height(42)
+                    .layoutWeight(1)
+                    .padding({ left: 10, right: 10 })
+                    .enabled(this.editOk())
+                    .onChange((v: string): void => {
+                      this.tags = v;
+                    })
+                }
+                .width('100%')
+                .alignItems(VerticalAlign.Center)
+
+                // 图片块在端上只能显示成「[图片]」—— 说清楚，别让人以为内容丢了
+                if (this.editingId > 0 && this.body.indexOf('[图片]') >= 0) {
+                  Text('这条笔记里的图片在网页端看；App 这边先显示成「[图片]」。')
+                    .fontSize(FbMetric.fontTiny)
+                    .fontColor(FbColors.faint)
+                    .width('100%')
+                    .maxLines(2)
+                }
+              }
+              .width('100%')
+              .alignItems(HorizontalAlign.Start)
+            }
+            .constraintSize({ maxHeight: 420 })
+            .width('100%')
+            .scrollBar(BarState.Off)
+            .align(Alignment.TopStart)
+
+            if (this.note !== '') {
+              Text(this.note)
+                .fontSize(FbMetric.fontTiny)
+                .fontColor(FbColors.red)
+                .width('100%')
+                .maxLines(3)
+            }
+
+            // ---- 底部：删除（左，只对自己写的）+ 保存 ----
+            Row({ space: 10 }) {
+              if (this.editingId > 0 && this.mine) {
+                Text(this.confirmingDelete ? '真的删掉？' : '删除')
+                  .fontSize(FbMetric.fontBody)
+                  .fontWeight(FontWeight.Medium)
+                  .fontColor('#FFFFFF')
+                  .textAlign(TextAlign.Center)
+                  .height(44)
+                  .padding({ left: 16, right: 16 })
+                  .borderRadius(FbMetric.radiusS)
+                  /* 🔴 v61：删除按钮统一红底白字。红值取自 color.json 的 `red` */
+                  .backgroundColor(this.confirmingDelete ? '#C0533F' : fbAlpha('#C0533F', 0.86))
+                  .onClick((): void => {
+                    if (this.confirmingDelete) {
+                      this.doDelete();
+                    } else {
+                      this.confirmingDelete = true;
+                    }
+                  })
+              }
+              if (this.editOk()) {
+                Text(this.saving ? '保存中…' : (this.editingId > 0 ? '保存修改' : '记下来'))
+                  .fontSize(FbMetric.fontBody)
+                  .fontWeight(FontWeight.Medium)
+                  .fontColor(this.saving ? FbColors.faint : '#FFFFFF')
+                  .textAlign(TextAlign.Center)
+                  .layoutWeight(1)
+                  .height(44)
+                  .borderRadius(FbMetric.radiusS)
+                  .backgroundColor(fbAlpha(this.accent, this.saving ? 0.35 : 0.98))
+                  .onClick((): void => {
+                    this.save();
+                  })
+              } else {
+                Text('知道了')
+                  .fontSize(FbMetric.fontBody)
+                  .fontWeight(FontWeight.Medium)
+                  .fontColor('#FFFFFF')
+                  .textAlign(TextAlign.Center)
+                  .layoutWeight(1)
+                  .height(44)
+                  .borderRadius(FbMetric.radiusS)
+                  .backgroundColor(fbAlpha(this.accent, 0.9))
+                  .onClick((): void => {
+                    this.onClose();
+                  })
+              }
+            }
+            .width('100%')
+            .alignItems(VerticalAlign.Center)
+          }
+          .width('100%')
+          .padding({ left: 18, right: 18, top: 18, bottom: 18 })
+          .alignItems(HorizontalAlign.Start)
+        }
+      }
+      .width('92%')
+    }
+    .width('100%')
+    .height('100%')
+    .hitTestBehavior(HitTestMode.Transparent)
+  }
+
+  private async save(): Promise<void> {
+    if (this.saving) {
+      return;
+    }
+    const t: string = this.title.trim();
+    const b: string = this.body.trim();
+    if (t === '' && b === '') {
+      this.note = '标题和正文至少写一样（服务端不允许存一条空笔记）。';
+      return;
+    }
+    this.saving = true;
+    this.note = '';
+    /* ⚠️ 标题空着也能存（服务端允许纯正文笔记），但列表卡片上没标题会很难认
+       ⇒ 用正文首行兜个标题（只影响显示，不改变用户输入）。 */
+    const useTitle: string = t !== '' ? t : b.substring(0, 20);
+    const token: string = FB_TOKEN_STORE.get();
+    const res: FbApiResult = this.editingId > 0
+      ? await updateNote(token, this.editingId, useTitle, b, this.tagList())
+      : await createNote(token, useTitle, b, this.tagList());
+    this.saving = false;
+    if (!res.ok) {
+      this.note = res.error !== '' ? res.error : '保存失败，请稍后再试。';
+      return;
+    }
+    this.onSaved();
+  }
+
+  private async doDelete(): Promise<void> {
+    if (this.saving) {
+      return;
+    }
+    this.saving = true;
+    this.note = '';
+    const res: FbApiResult = await deleteNote(FB_TOKEN_STORE.get(), this.editingId);
+    this.saving = false;
+    this.confirmingDelete = false;
+    if (!res.ok) {
+      this.note = res.error !== '' ? res.error : '删除失败，请稍后再试。';
+      return;
+    }
+    this.onDeleted();
+  }
+}