 laoyang
|
719c68202b
|
v69：日程桌面卡片完全照 SyncCalendar 重做（四种尺寸 + 翻页 + 时间轴）
用户 2026-10-20：「跟日程有关的桌面服务卡片，你就完全按照 synccalendar 来做就行。」
上一版卡片是"首页概览"（今日日程 + 在做/待办/逾期 + 纪念日），
是照着首页数据自己设计的版式。这一批按用户要求换成 **SyncCalendar 那套日程卡**：
## 四块尺寸（与 SyncCalendar 一一对应）
- 2×2 日期 / 星期+农历 / 当天条数大数字 + ＋
- 2×4 左半同 2×2，右半「接下来两条」
- 4×4 `‹ 10月20日 / 九月初一 › [今|＋]` + 当天日程（时间轴 / 列表）
- 6×4 同 4×4，更宽（小时 40vp）
## 翻页（这是"照 SyncCalendar"的核心）
- 卡片按钮走 `postCardAction({action:'message', params:{pageAction}})`，
`FbFormAbility.onFormEvent` 改偏移 → 重新取数 → 推回卡片；
- **每张卡一份偏移量**，落 `preferences`（`data/FbCardForms.ets`）：
SyncCalendar 只放内存 Map，进程被回收就丢 ⇒ 系统每 30 分钟刷新一次，
会把用户翻到的"下周三"悄悄拽回今天。家书这边连 `updateDuration` 的定时刷新
也按各自偏移重建（`onUpdateForm` 先 `getOffset` 再 `push`）。
- 偏移夹取 ±366 天：message 是外部输入，算到离谱年份会 Invalid Date（白卡）。
## 点卡片要落到"卡片显示的那一天"
- 卡片 router 带 `openDate`（**毫秒字符串**，数字参数是 int32，13 位会溢出）
与 `widgetAction=add`（点的是＋）；
- `EntryAbility.applyWantModule` 解析后写 `FbAppState.calJumpIso/Create/Seq`；
- 日程页两条入口都接上：冷启动 `aboutToAppear`、热启动 `@Monitor('app.calJumpSeq')`
（应用开着时点卡片不会重建页面，只靠 aboutToAppear 会"点了没反应"）。
## 数据
- 换接口：`/api/v1/calendar?from=<那天>&to=<那天>`（原来打 `/home`）。
`authProbe: true` + 显式带 token 的硬要求不变（后台 401 不能把用户踢下线）。
- 农历行（`kind=lunar`）抽成抬头那一行小字，其余衍生条目（节气/节假日）照常进列表。
- 时间轴复用 `common/FbTimeline`（与日程页同一套算法），
卡片侧只做"比例 → vp"的换算（`fbCardTlLines`，纯函数、可断言）。
- 显示方式（时间轴/列表）跟「日程设置」联动；今天才画当前时间红线。
- 应用内改完日程 → `FB_CARD_FORMS.pushAll()` 立刻刷新桌面卡片
（不必等 30 分钟；推失败自动注销该 formId）。
## 验证
- `assembleHap` BUILD SUCCESSFUL；已装机（5NC0225B27004718）。
- `_fb_arkts_guard.js` **856 / 0**（v66 组按新契约重写：四尺寸登记、
字段名与数据类配对、数组必须 JSON 字符串、翻页三动作、
`onUpdateForm` 按偏移重建、冷/热启动两条入口）。
- `_fb_v59d_falsify.py` **146 / 0**（新增 6 条注入：定时刷新丢偏移、
偏移不落盘、4×4 少「下一天」、「热启动不响应」、不读 openDate、
字段名拼错、去 authProbe）。
⚠️ 其中"热启动"那条第一次注入**打偏了**：它先命中了文档注释里那半句
`@Monitor('app.calJumpSeq')` ⇒ 真正的装饰器没被改，守卫照样绿。
已把字面量从注释里去掉（本项目"注释里别抄字面标签"的老坑）。
- 真机跳转 `_fb_v69_card_jump.py`：
· `openDate=今天+3天` + `widgetAction=add` ⇒ 日程页落在 **10月23日**，
且「新建日程」浮层打开、日期就是 10月23日（dump 里 26 个浮层节点）；
· 只带 `openDate` ⇒ 同样落在 10月23日，**不**弹新建浮层。
|
2026-10-20 21:59:23 +08:00 |
|
|
laoyang
|
b3e1330244
|
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 |
|