laoyang/FamilyBook
1
0
Fork 0
Code Issues 29 Pull Requests Actions Packages Projects Releases Wiki Activity
166 Commits 1 Branch 0 Tags
69c47c3c434b603576be281a38f4e69bf1a9227f
Commit Graph
111 Commits
Author SHA1 Message Date
laoyang 69c47c3c43 网页端下拉框改成自绘浮层（照 FeedLite 的做法）(#85) 
用户 2026-11-05：「网页版的下拉框也太丑了。你参考一下那个反馈系统里面的
下拉框到底是怎么做的？按它的做法做，它也有主题颜色，我们这个也有主题颜色，
就按照一样的做法去做。」

看了 FeedLite（~/code/FeedLite）的实现，关键结论：
  **原生 <select> 收起时能改样式，但展开的选项列表由浏览器绘制，CSS 完全改不动**
  （只能改 option 底色，各平台还不统一）⇒ 想好看只有自绘这条路。

照它的做法移植：

① CSS（assets/css/app.css）
   .sel-native  原生 select 视觉隐藏（**不能 display:none**，那样不参与提交）
   .sel         外层 inline-flex
   .sel-btn     触发按钮 —— 外观与普通输入框完全一致（40 高、同圆角同边框）
   .sel-caret   自绘箭头（CSS mask + 内联 SVG），**打开时转 180° 并变主题色**
   .sel-panel   浮层，position:fixed 挂 body
   .sel-item    列表项：34 高、圆角 7
   .sel-item.on 选中项：深一档主题底色 + 主题色文字 + 右侧对勾

② 主题色三档浅色（照 FeedLite 的比例）
   helpers.php 新增 fb_color_tint()（把 hex 往白色混）。
   layout.php 在 <body> 的 style 里输出：
     --brand-tint-1（混 91% 白）→ hover
     --brand-tint-2（混 80% 白）→ 选中项
     --brand-tint-3（混 72% 白）→ 选中项 hover
   ⚠️ 在 PHP 里算好，**不用 CSS 的 color-mix()** —— FeedLite 实测过：
      `color-mix(in srgb, var(--brand) 9%, #fff)` 在 Chrome 里解析成透明。

③ JS（assets/js/app.js 新增 fbBindSelects()）
   遍历所有 select，在旁边生成按钮 + 浮层，原生 select 保留参与提交。
   · 派发原生 change → 兼容 onchange="this.form.submit()" 的内联写法
   · 浮层 fixed 定位（面板/浮层里大量 overflow:hidden，放旁边会被裁）
   · 下方空间不足且上方更宽裕时**向上翻**
   · 键盘：↑↓ / Home / End / Enter / Esc
   · 浮层 minWidth 跟随触发按钮 → "和输入框一样宽"
   · data-sel-enhanced 幂等标记

④ AJAX 路径也要增强
   task_panel.paint() 与 entry_popup.loadPanel() 里，紧跟 fbBootAntd() 之后
   调一次 window.fbBindSelects(document) —— 否则动态插入的 select 是裸的。

⚠️ app.js 整个是 IIFE 包裹的（结尾 `})();`），新函数必须插在闭包内部；
   直接追加到结尾会跑到全局作用域。

实测（Playwright + 站点真实 app.js/css）：
  增强：data-sel-enhanced=1、原生 select 已隐藏、按钮文字「工作相关」✅
  尺寸：按钮 648 x 40，行宽 648 → 占满整行 ✅
  浮层：宽 648（与按钮同宽）✅ 6 项、选中项有对勾 ✅
  打开态：底色 rgb(250,242,238)=tint-1、文字 rgb(168,74,40)=brand、
          箭头 rotate 180° ✅
  选「个人事务」→ select.value=3、按钮文字同步、浮层关闭 ✅
 2026-11-05 20:23:16 +08:00
laoyang 47a0027ef7 修：分类显示「未分类」—— Task::find 没 JOIN 分类表 (#84) 
用户 2026-11-05：「鸿蒙端的分类那个地方没带进来。明明是有分类的，
但是它却显示的是未分类。」

根因是**两个叠在一起**：

① `Task::find()` 的 SQL **没有 JOIN `task_categories`**
   `t.*` 里有 `category_id`，但没有 `category_name`；
   端上 `category: s(d.category_name)` 永远拿空串 ⇒ 显示「未分类」。
   同一个文件里 `doneList()` / 列表页那几条 SQL 都有这个 JOIN，
   只有 find() 漏了（写它不是同一时期，属于典型的"漏一处"）。
   ⇒ 补 `LEFT JOIN task_categories c ON c.id = t.category_id`、选 `c.name AS category_name`。
   实测（#49 海大信息中心评审费）：category_name = [工作相关] ✅

② `taskOut()` 里 `category_id => Api::int(category_id, ...)`
   `Api::int()` 是**读请求参数**的：先看 $_REQUEST 有没有该键，
   没有才用第二个参数当默认值。
   PATCH 时用户会传 ⇒ 值对；**GET 时没有请求参数** ⇒ 走默认值。
   这次默认值本身是从 `$t` 算的，所以"看起来是对的"，
   但这种写法极易被误读成"已经取到表里的值了"，后续改动容易出错。
   ⇒ 直接写 `(int)($t[category_id] ?? 0)`，不绕 Api::int。

注：`repeat_rule` 在 Task::find 里没被单独 SELECT ——
   但它在 `t.*` 里，`$t[repeat_rule]` 是有的（实测任务 #53 能正确读到/写入）。
 2026-11-05 20:19:36 +08:00
laoyang 50286e5327 服务端：panel_save / Task::setAttrs 支持 repeat_rule (#83) 
配合网页端与鸿蒙端把「循环」改成可编辑。

① Task::setAttrs() 新增 repeat_rule 分支
   只写 repeat_rule 一列（与 due_at / category_id / title / note 同一套
   按 `array_key_exists` 判"传没传"的逻辑）。
   ⚠️ 白名单校验：只接受 `self::REPEAT` 里有的键，其余一律存 NULL。
      不校验的话前端传个乱值就进库了，`repeatWord()` 会显示成空白，
      而且 `spawnNext` 那种"按规则生成下一次"的地方会静默不工作。
   ⚠️ 空串 = 不循环，存 NULL（与 `update()` 的 `?: null` 同口径）。

② index.php 的 tasks/panel_save 接收 repeat_rule
   同一套 `array_key_exists` 语义：表单没带就不动（保留原值），
   带了才更新 —— 这样"只改标题"的调用方不会把循环规则清掉。

实测：
  设 repeat_rule=week      => [week] ✅  标题未被破坏 ✅
  设非法值 hacked_value    => [NULL] ✅ 已拦下
  只改 due_at              => repeat_rule 不变 ✅ category_id 保留 ✅
 2026-11-05 20:15:18 +08:00
laoyang cb846d378f 评论附件支持拖拽 + 首页卡片同步标题 (#79) 
用户 2026-11-05：
  「评论框下面的附件也需要可以拖动添加。」
  「首页卡片没有刷新。」

① 评论附件拖拽
   给 `.cmt-attach-row` 挂 `data-cmt-drop`，由 task_panel.js 接管
   dragover / dragenter / dragleave / drop。

   🔴 核心技术点：`<input type=file>.files` 是**只读**的，
      不能直接 `input.files = event.dataTransfer.files`（某些内核静默失败）。
      必须用 DataTransfer 重建 FileList 再赋回去：
          var dt = new DataTransfer();
          dt.items.add(file);
          input.files = dt.files;      ← 这个赋值是允许的
      而且**必须真的赋给 input** —— 否则只是"看起来加上了"，
      表单提交时浏览器一个文件都不带。

   ⚠️ 累加语义：用户可能先拖一张再拖一张，所以每次把 input.files
      现有内容 + 新拖入的合并后写回。
   ⚠️ 去重：按 name+size+lastModified 判重，否则"只拖一次却传上去两张一样的"。
   ⚠️ dragover 必须 preventDefault（不拦的话浏览器把文件当"打开"，
      直接跳走、当前页面全丢）。
   ⚠️ 与「任务附件」那条 `[data-tk-drop-box]` 是**两条独立的路**：
      那个是"点了/拖了立刻上传"（任务已存在），
      这个是"挂到评论表单、点发表才一起提交"。

   实测（Playwright + 真实 DataTransfer）：
     拖入 a.txt+b.png => count=2 ✅
     再拖 c.jpg      => count=3 ✅ 累加
     重复拖 a.txt    => count=3 ✅ 去重
     FormData(form)  => ["a.txt","b.png","c.jpg"] ✅ 提交时真会传

② 首页卡片同步标题
   根因：`syncRow()` 原来**只管状态徽标和复选框**，代码第一行就是
   `if (!d || !d.status) return;`，压根不碰标题。
   而 #78 之后面板里能改标题了 ⇒ 改完点保存，卡片上还是旧标题。

   改两处：
   · `task_panel_json()` 返回值补 `title`（服务端直接给，不依赖 DOM 还在）
   · `syncRow()` 补标题同步：`.dash-what` 的文本 + `title` 属性
     （`title` 是悬停提示，不同步会出现"悬停是旧标题"的怪事），
     并把 `data-fb-entry` 里的 JSON title 一并改掉
     （否则"卡片上是新标题、再点开浮层显示旧标题"）。
     读不到 d.title 时兜底从 `#tkp-title` 输入框读。
 2026-11-05 18:32:40 +08:00
laoyang 11aa7c6ca5 任务面板五项细化：弹窗选人、协作人、保存关窗、去编辑、评论附件 (#78) 
用户 2026-11-05 五条：
  「选人的时候不能按列表，因为人太多了。参考观影模式里面选人的方式。」
  「任务其实可以共享给别人，也就是协作人，但编辑这里面没有这个选项。」
  「点击保存之后，按道理说应该直接把这个窗口关闭才对呀。」
  「现在在首页上点一个任务，直接就是编辑页面啊，所以不需要编辑按钮了。」
  「评论那个地方也需要可以添加附件。」

① 选人改弹窗
   负责人/协作人都换成 `_person_picker.php`（弹窗 + 拼音首字母联想），
   与观影表单、新建任务弹框同一套。
   负责人 single + allowEmpty（可选「不指定」）；协作人 multi。
   ⚠️ 关键修复：`entry_popup.js` 的 `loadPanel()` 一直漏了
      `fbInitPickers()` —— 组件不初始化，按钮点了没反应。
      `loadEdit()` 里有这一句，`loadPanel()` 没有，面板里塞选人就是这个下场。
      同时 `task_panel.js` 的 `paint()` 后也补一次（重画后是新节点）。

② 补协作人
   数据层其实**早就完整支持**：task_shares 表 + Task::setShare/dropShare
   + 新建弹框的「共享给」+ 详情页的共享展示。只有面板和编辑表单没给入口。
   现在面板里能看当前协作人、能加、能改。
   保存语义：以提交的列表为准同步（多了就 setShare、少了就 dropShare）。
   ⚠️ 带 `shares_submitted=1` 哨兵，区分"表单里没这个控件"（不动）
      和"用户全删了"（清空）—— 否则 PHP 收不到空数组的键，无法分辨。

③ 保存后关窗
   `act()` 加 `closeOnOk`，`send()` 支持它：成功后先 `syncRow()`
   （更新背后那张首页卡片，否则关掉浮层看到旧标题更迷惑）再 `fbEntryClose()`。
   ⚠️ 只给「保存」用 —— 改状态/挪看板/加子任务/发评论/传附件都还要继续操作。
   ⚠️ 失败时不关，让用户看到错误就地改。

④ 去掉「编辑」按钮 + 面板补标题/备注
   用户说得对：点开任务就是完整编辑面板了，再给编辑按钮是重复。
   但原来面板改不了标题和备注（只在 _edit_form.php 里）
   ⇒ 先在「更多信息」里补上这两个字段，再藏编辑按钮。
   `Task::setAttrs()` 扩展支持 title/note，走 title()/textOrNull() 清洗，
   与 update() 同一口径。
   ⚠️ 只对**任务**（带 data.panel）隐藏 —— 观影/旅程/日程/纪念日仍需要那颗按钮。

⑤ 评论可加附件
   服务端**早就支持**：tasks/comment_add 里一直有
   `attach_save_files(..., task_comment, ...)`，只是表单里没有 file input。
   补上 `<input type="file" name="attach[]" multiple>` +
   `enctype="multipart/form-data"`（少了它只提交文件名、文件本体丢失）。
   顺带允许「只发附件不写字」（原来 content 空会返回"留言是空的"）：
   有附件且没文字时用占位文案「（附件）」。

实测：
  setAttrs 标题/备注 => 都正确写入 ✅
  setShare / dropShare => 1 人 / 0 人 ✅
  面板渲染 => 标题框/备注框/两个选人组件(single+multi)/评论附件/
              multipart/save-attrs/antd 控件 全部在位 ✅
  选人模式 => single(allowEmpty=1), multi ✅

已知问题（另单处理）：家庭有 800 人，两个选人组件各 485KB，
面板渲染 997KB。服务端只要 11ms，但传输量对移动端不友好。
这是 _person_picker.php 的既有设计（观影那边也一样），
需要改成"弹窗打开时才渲染列表"或按需加载。
 2026-11-05 18:28:15 +08:00
laoyang 9ab7d40a3b 任务面板：加保存按钮，负责人和分类改为可编辑 (#76) 
用户 2026-11-05：「时间控件是对的，但是现在没有保存按钮，只有下面一个
评论的发表按钮。另外，负责人和分类都没法修改，按道理讲都应该可以修改才对。」

三处改动：

① 取消"立即保存"，改成显式「保存」按钮
   上一版（#74）做的是"选完截止时间就发请求"。用户不认可：他要的是
   "改完点一下保存"那种确定感。
   ⇒ 移除 bindDue() 的 change 监听，改成 save-attrs 动作一次性提交三项。

② 负责人 / 分类 从只读改成可编辑
   改前是只读 dl.kv 行，而且**值为空时整行不渲染**
   （if (!empty($tpT[assignee_name])) / if ($tpCatName !== )）
   ⇒ 用户不仅改不了，连"这一项存在"都看不出来。
   现在三项合成「更多信息」小节：
     截止   [ AntD 日期控件 ]
     负责人 [ 下拉 ]
     分类   [ 下拉 ]
            [ 保存 ]
   负责人用原生 select 而不是 _person_picker.php 的弹窗选人：
   面板已在浮层里，再弹一层模态 = 两层遮罩，手机上容易点错；
   且 picker 需要 fbInitPickers() 初始化，loadPanel() 目前没调它。
   家里 3~10 人 select 够用；人多了再换，那时记得把 fbInitPickers
   也补进 loadPanel()。

③ Task::setAttrs()（新增）
   只更新 due_at / assignee_id / category_id 三列。
   不复用 update()：那是全字段覆盖，面板只交三项的话
   title/note/status/repeat/parent/board 会被默认值抹空
   —— 与 setDue() 记的是同一个坑。
   用 array_key_exists 判"传没传"，这样可以只改其中一项
   （面板在"没有成员"等极端情况下可能不渲染负责人下拉，
   那时不该把它当成 0 去清掉原值）。

路由 tasks/panel_save：只把表单**真的提交了**的字段放进 $sd，
与 status/move 同一套约定（ajax_panel=1 回整块新面板）。

清理：bindDue / window.fbTaskPanelBindDue 全部移除
（entry_popup.js 里的调用、task_panel.js 里的定义与导出）
—— 留着会引用未定义函数，直接抛错。

实测：
  三项一起改     => due_at/assignee/category 全对 ✅
  标题/状态/备注/看板 均未被破坏 ✅
  只改 due_at    => 另两项保留、未被清空 ✅
  面板渲染       => save-url / 保存按钮 / 两个下拉 / AntD 控件 /
                    原有状态/附件/评论 全部在位 ✅
 2026-11-05 18:07:17 +08:00
laoyang 836f6f1d2f 首页任务面板：可直接改截止时间 (#74) 
用户 2026-11-05：「点开之后，就可以修改任务的所有信息，包括：
1. 上传附件；2. 添加评论；3. 添加子任务；4. 修改截止时间
（已有值要带进来）；5. 改状态、挪看板。这些操作全部都在这一个页面完成。」

盘点发现：附件 / 评论 / 子任务 / 状态 / 看板 **本来就有**（_panel.php 里
早就实现了），只有「截止时间」是只读的一行 dd。所以只补这一项。

四处改动：

① Task::setDue()（新增）
   不复用 update()：那是全字段覆盖（title/note/status/assignee/repeat/
   parent/board/category 一起写）。表单只交 due_at 的话，其余字段会被
   默认值抹成空 ——「只想改个日期，结果标题和备注没了」，不可恢复。
   ⇒ 单独一条只写 due_at 的 UPDATE。

② tasks/due 路由（新增，紧跟 tasks/status）
   与 status/move 同一套约定：ajax_panel=1 回整块新面板，否则 flash+302。
   空串 = 清掉截止时间。

③ _panel.php：只读「截止」行 → AntD 单点控件
   原来：
     <?php if ($tpDue !== ): ?>…<dd>截止 …</dd>…<?php endif; ?>
   **没有截止时间时整行都不显示** —— 用户根本不知道该去哪填。
   现在不管有没有值都画控件，$dtValue = $tpDue 自动带出已有值。
   有值且在逾期时，右侧补一行「还剩 N 天」小字（.tk-due-word）。

④ task_panel.js
   · paint() 后调 fbBootAntd()：面板是 AJAX 换进来的，bootAntd 首屏
     扫过一次 [data-dt-antd-single]，那时面板还不存在 ⇒ 必须补挂。
   · bindDue()：监听 .dt-input 的 change 立即保存。
     不用按钮式 data-tk-act（面板里其它动作都是"点一下/选完就生效"，
     再让用户点一次保存会与其它处不一致）。
     监听隐藏字段的 change 而不是 AntD 回调 ⇒ 覆盖 AntD 与原生下拉两种形态。
     data-fb-due-bound 幂等标记防止重复绑监听（否则改一次发好几条请求）。

⑤ CSS：.tk-sec-inline > .dt-input 加 flex/min-width/max-width ——
   .dt-input 是 flex-wrap，放进也是 flex-wrap 的 .tk-sec-inline 里
   会被当弹性项按内容撑，窄屏上可能把标签挤走或控件溢出。

实测：
  setDue 设值  => [2026-12-25 18:30:00] ✅
  标题仍为原值 ✅ 没被清空（证明没用 update()）
  setDue 清空  => NULL ✅
  面板渲染：data-tk-url-due / data-dt-antd-single / due_at_date 全在，
            带出的日期值 = [2026-10-22] ✅
            状态/附件/子任务/评论 均仍在
 2026-11-05 17:44:11 +08:00
laoyang 52946e9c35 日历本默认名：旅行 → 旅程 (#71) 
用户 2026-11-05：「旅程的日历本同步到日历本，它的日历本名字就叫"旅程"，
观影就叫"观影"。我看现在"旅程"叫"旅行"，这个不对，应该改过来。」

代码只改一处：app/Calendar.php 的 DEFAULT_BOOKS 常量
  trip => [旅行, ...] → [旅程, ...]

这段只影响**新家庭首次 seed**。已建好的家庭数据在库里，改常量不回溯
⇒ 另外跑了 UPDATE calendars SET name=旅程 WHERE kind=trip AND name=旅行
  （按值匹配，不无脑按 kind 覆盖：万一用户自己改过名，不该把他改的抹掉。
   虽然 trip 本在代码里是禁止改名的派生本，但按值匹配总是更稳）
实测改了 2 行（历史上 seedDefaults 重复跑过，有两套）。

movie 那条**没动** —— 用户明确说"观影就叫观影"，本来是对的。

顺带把文件头注释里的「旅行」也改成「旅程」，
否则注释说"名字就叫观影、旅行"，代码里却是"旅程"，后人又要被误导。

实测：
  Calendar::mine() → #1 [观影] kind=movie
                     #2 [旅程] kind=trip
  行程条目 calname = [旅程] ✓
  观影条目 calname = [观影] ✓
 2026-11-05 17:26:37 +08:00
laoyang e015181fa3 日程里的行程条目：图标按出行方式、去掉✓、带出出发地/目的地 (#67) 
用户 2026-11-05 三条：

1. 「图标应该来自里面具体的交通工具，如果是火车就应该显示火车」
   原来 Calendar::month() 的 trip 派生段用 Trip::typeIcon(node_type)，
   typeIcon(move) 恒为 🚗 ⇒「赶路」永远显示汽车，哪怕实际坐的是火车。
   改用 Trip::leadIcon(node_type, travel_mode, familyId) ——
   出行方式优先、节点类型兜底，与旅行详情页行程卡同一个方法。

2. 「后面这个对号是什么意思？表示它是一个实际行程吗？我感觉没必要，直接去掉」
   删掉标题拼装里的  ✓ （原来用来区分 stage=actual）。

3. 「如果行程里面有地址，也就是有出发地和目的地，应该像行程里显示的那样，
    把它显示在下面，这样一点就可以导航」
   这段 SQL 原来**完全没查** from_*/to_*，日历里只剩一个标题。
   补 n.from_place/to_place + 四个坐标字段，输出加 from_place/to_place/
   from_lng/from_lat/to_lng/to_lat。

端上：
- FbCalEvent 加 6 个字段（RawCalEvent / FbParse / FbCalStore / DemoData 同步）
- 坐标用 numStr() 转字符串（服务端 DECIMAL 可能给 number，s() 只收 string）
- FbDayEventPanel 列表卡片：时间行上面单独一行「出发地 → 目的地」，
  目的地带下划线 + 日历本色，点击调 fbOpenNavigation（有坐标带坐标，
  没有让 FbNav 自己地理编码）
- FbDayTimeline 全天块：一行文字「出发地 → 目的地」，不给点击
  （26vp 高的块切两个热区会点不准，导航入口在详情卡里）

网页端：
- fb_entry_json() 的 rows 补「出发地」「目的地」两行
- 日历网格里的条目太窄，只显示标题，不加这两行

实测（family 1 全年）：
  title = [✈️ 从青岛坐飞机去哈尔滨]
  from  = [青岛胶东国际机场]
  to    = [哈尔滨太平国际机场]
  to_lng= [126.241474]  to_lat=[45.611938]
  —— 飞机显示 ✈️、没有 ✓、地址坐标齐全
 2026-11-05 16:12:06 +08:00
laoyang bee1d077d8 严重修复：图片压缩参数被应用到了视频上，导致视频播不了 (#56) 
用户报（2026-11-05）：「你好像把 .mp4 后面也带上了问号，写成了 1600
这样的参数…你刚才没有进行图片压缩的时候，我自己播放好像还是好的。
是你更新了这个功能之后，出了这个问题。」

用户完全正确，这是我的错。

根因：media.php 只看 $imgW，没判是不是图片：
  Storage::read($familyId, $key, $imgW > 0 ? $OssSizes[$imgW] : );
⇒ 视频 URL 带 ?w=1600 后，给 .mp4 对象传了
  x-oss-process=image/resize,l_1600
⇒ OSS 图片处理服务对非图片返回错误内容
⇒ <video> 拿不到有效数据 ⇒ 播不了

三道防线：

1. _attachments.php（直接触发点）
   原来对所有附件都传 w=1600。改为 $attKind === image 才传。
   视频只传 v（版本号，破缓存用）。

2. media.php（核心防线）
   $imgW 与 $isImageKey 绑定，只有图片才允许压缩。
   $isImageKey 判定提前到 Storage::read 之前，
   并扩到扩展名兜底（jpg/png/webp...），
   视频/文档扩展名强制 false。

3. media_url()（前置防线）
   生成 URL 时按扩展名过滤：非图片自动去掉 w。
   这样即使调用方传错，URL 里也不会出现无效参数。

验证（模拟事故场景，URL 带 ?w=1600 请求 .mp4）：
  HTTP 206，Content-Type: video/mp4
  无 hvc1，含 avc1
  ffprobe: h264/yuv420p，2.19MB  ✅ 正常

  media_url 生成视频 URL：...mp4&v=2295119（无 w）
  media_url 生成图片 URL：...jpg&w=1600&v=609017（有 w）
 2026-11-05 13:14:51 +08:00
laoyang 2c44318a51 压缩只留 1600 档；视频缓存失效加版本号 (#56 #57) 
一、尺寸档位（用户：「400压缩的太多了。800也不够，只保留一个1600」）
   media.php 白名单从三档收到一档：
     1600 => image/resize,l_1600/quality,q_88
   400/800 删除。质量从 q_85 提到 q_88（只留一档就该偏清楚那侧）。
   照片墙跟随改 1600，缩略图与大图共用一份缓存。
   传旧 ?w=400 的链接会落到「非法值 ⇒ 原图」分支，不报错、只是不压缩。

二、视频仍显示 HEVC（用户：「他说是H.265，还是不让播呢？」）

   实测服务端 15 个视频**全部 h264**，无一个 HEVC：
     ffprobe 逐个查过，codec=h264，pix_fmt=yuv420p/yuvj420p
     media.php 返回 Content-Type: video/mp4，body 里无 hvc1/hev1
     ETag 与实际内容完全一致

   问题在浏览器缓存：
     Cache-Control: private, max-age=604800（7 天）
     浏览器对 <video> 有自己的媒体缓存策略，不完全遵守 ETag
     Range 分段缓存会把每段当独立资源
     src 不变时直接复用已有媒体对象

   修法：让 URL 变。media_url() 加第三个参数 $ver，
   用附件 size 当版本号 → media.php?k=...&v=2295119

   为什么用 size 而不是 mtime/md5：
     mtime —— 对象在 OSS 上，本地拿不到可靠时间
     md5   —— 要读整个文件，几百 MB 视频不可接受
     size  —— 转码前后必然不同（1.22MB→2.19MB），且本就在库里，零开销

   照片墙已接入。其余调用点可逐步铺开。
 2026-11-05 13:11:44 +08:00
laoyang d6af211a8e 图片走 OSS 实时压缩：取图带 x-oss-process，本地存储不受影响 (#56) 
用户 2026-11-05：「如果图片是放在本地服务器的…就不管它。
如果是传到 OSS 里面的…就用 OSS 的压缩就行了。」

查证：OSS 图片处理确实存在，取图 URL 加 x-oss-process 即可实时压缩，
原图不动、不占额外存储。

三处改动（缺一个都会出错）：

1. OssDriver
   - get() 新增 $process 参数
   - authorization() 新增 $subresource：x-oss-process 属于子资源，
     必须计入 CanonicalizedResource，否则 403 SignatureDoesNotMatch
   - URL 拼接带上 ?x-oss-process=...

2. Storage::read()
   - 新增 $process，仅当驱动是 oss 时透传
   - 本地驱动忽略（用户明确要求「本地不管它」）
   - 带 process 时跳过"本地优先"缓存（那个缓存里是原图，
     拿原图当压缩版返回等于压缩没生效）

3. media.php
   - 新增 ?w= 参数，白名单三档 400/800/1600
   - 按尺寸分档缓存到 _proc/<w>/<key>，避免互相覆盖
   - 无 w 时行为完全不变（300+ 处既有 img 不受影响）

白名单而非透传的理由：OSS 图片处理按次计费，
放任 ?w= 任意值会让 ?w=1、?w=9999 这类请求把处理次数打上去。

实测（一张 6602 KB 的图）：
  原图  6602 KB
  w=400    26 KB   省 99.6%
  w=800   108 KB   省 98%
  w=1600  468 KB   省 93%

应用位置（保守，先动最确定的）：
  _attachments.php 照片墙缩略图 → w=400
  trips/show.php   行程题图     → w=1600
  下载链接一律不加 w（用户要原文件，不能偷偷降质）
 2026-11-05 13:06:29 +08:00
laoyang 3c9fb22def 视频转码：上传时自动转 H.264，已有视频批量转换 (#57) 
用户 2026-11-05：「以后所有视频全部转成H.264」

新增 app/Video.php：

- isVideo / available / probe / needsTranscode / toH264
- 判据：编码不是 h264 或像素格式不是 yuv420p/nv12 就要转
  （10bit、4:2:2 的 h264 浏览器也不认，光看编码不够）
- 参数：libx264 veryfast crf23 + yuv420p + aac 128k + faststart
  + scale=min(1920,iw):-2（4K 缩到 1080p，-2 保证高度偶数）
- 转完自检编码与像素格式，不对就不采用

Attachment::save() 接入：

- needsTranscode() 先判，已合规的不重复转（不白等几十秒）
- 转码失败不阻断上传，原样保存 + error_log 记原因
- 转完改 mime/ext 为 video/mp4，否则前端判断不出来
- 转码产物是临时文件，必须清理（否则塞满 /tmp）

批量转换已有视频（15 个）：

- 13 个已是 h264 跳过，2 个 hevc 转成功
- 原地覆盖同 key，数据库引用全不断
- 原文件备份到 storage/_hevc_backup/

验证：4 个抽样全部 h264/yuv420p 或 yuvj420p，浏览器可播。
 2026-11-05 13:01:39 +08:00
laoyang f58a128816 行程：#47~#51 打包 —— 双轨状态、动态类型、动作按钮、去提示 (#51) 
#47 编辑浮层居中、类型换行、去掉手动状态选择、按钮改胶囊
#48 计划/实际双轨：完成即转实际行程，取消≠删除，记真实开始/结束时间
#50 类型点击无反应（@Builder 值传参不建立依赖）
#51 节点类型动态加载（服务端9种，原端上硬编码5种）+ 地址结构化回调

API 新增：GET /trips/<id>/node-types、PATCH /trips/<id>/nodes/action
DB 新增：trip_nodes.actual_started_at / actual_ended_at
 2026-11-05 12:40:57 +08:00
laoyang f92a98a3a3 子任务跟随父分类，修复父子跨本导致客户端无法显示层级 
用户问：「任务是带有子任务功能的，能否通过 caldav，把任务的子任务也同步给客户端？」

## 答案：能，但实测发现父子被分到了不同本

改前数据：

    父 #12「轻舟的幼儿园发票」  category_id = 1（家庭事务）→ tasks-1.ics
    子 #29「送财务报销」        category_id = NULL（收件箱） → tasks-inbox.ics

客户端渲染「家庭事务」时看不到子任务，渲染「收件箱」时又找不到父任务，
⇒ 不可能显示成层级，只能两条并列。

## 改法

### 1. 子任务跟随父分类（TaskDav::effectiveCat）

    有效分类 = 自己的 category_id
              ↓ 为空且是子任务时
              父任务的 category_id

⚠️ **不改数据库**，只在视图层算。
   改库等于篡改用户数据，而且单向不可逆。

边界：
| 情况 | 有效分类 |
|---|---|
| 自己无分类 + 父有分类 | 跟父（父子同本） |
| 自己无分类 + 父也无分类 | 都进收件箱（父子同本） |
| 自己有分类 | 用自己的（尊重用户明确设定） |

`tasksIn()` 改为 SQL 联查 `p.category_id`（一次到位，避免 N+1），
再在内存里按有效分类过滤。

### 2. SUMMARY 去掉硬加的「└ 」前缀

原来给子任务 SUMMARY 加「└ 」。这会**污染用户数据** ——
客户端把标题写回来（PUT）时前缀被存进库，用户的标题就多了一坨。

层级改由标准属性表达：
- `RELATED-TO:task-12` —— RFC 5545 §3.8.4.5 标准父子
- `X-FAMILYBOOK-PARENT:轻舟的幼儿园发票` —— 展示用补充，不支持的客户端无视

### 3. 跨本时的降级提示

用户明确给子任务设了别的分类时（尊重其选择），父子仍会跨本。
那种情况在 DESCRIPTION 尾部补一句人话说明，避免客户端把
「有 RELATED-TO 但找不到父」当成数据损坏而不显示这条。

## 验证

改后分布：

| 本 | 总数 | 父 | 子 |
|---|---|---|---|
| 家庭事务 | 7 | 6 | 1（#29） |
| 工作相关 | 19 | 19 | 0 |
| 个人事务 | 2 | 2 | 0 |
| 党支部工作 | 1 | 1 | 0 |
| 轻舟相关 | 1 | 1 | 0 |
| 收件箱 | 2 | 2 | 0 |

- 总数仍 32 条，没丢没重
- **所有父子都在同一本里**
- HTTP 端到端 39 项全过（含跨本隔离、鉴权、日历本回归）

## 客户端支持度说明（服务端无法改变）

| 客户端 | 层级显示 |
|---|---|
| DAVx⁵ + Tasks.org | 认 RELATED-TO，显示缩进子项 |
| 苹果提醒事项 | 有原生子任务 UI，对 RELATED-TO 支持有限 |
| Thunderbird | 不显示层级，两条并列 |

数据是正确的，显示成什么样取决于客户端能力。
想在所有客户端都看到层级，只能靠前端自己渲染 —— 那是网页端的事。
 2026-11-02 16:07:45 +08:00
laoyang 610d524e68 CalDAV 待办改为按分类拆成多本（对齐参照 DAViCal） 
用户提供参照服务器 nas.yangyq.net/caldav/synccalendartest（DAViCal 1.1.9）并指出
「应该可以直接显示那个家庭的待办分类」。

## 参照实测结果

那台服务器的待办本结构：

    /caldav/<user>/tfxnz/     家庭计划   VTODO
    /caldav/<user>/zlqlzm/    工作任务   VTODO
    /caldav/<user>/tdotbsnl/  个人成长   VTODO
    /caldav/<user>/home_todo/ Inbox     VTODO

⇒ 每个分类是**独立的 calendar 集合**，各自 supported-calendar-component-set
只含 VTODO，客户端里显示成并列的多个待办列表。

VTODO 正文还带 CREATED / LAST-MOD / DTSTAMP / SEQUENCE / PRIORITY /
PERCENT-COMPLETE / STATUS / DESCRIPTION / LOCATION / TRANSP。

## 上一版的问题

第一版做成「一个「家庭待办」本装全部任务」，所有分类混在一起，
客户端里只有一个列表 —— 用户要的是分类可见。

## 这一版

### 本的组织

    /dav/tasks-<categoryId>.ics/   每个 task_categories 一行 = 一本
    /dav/tasks-inbox.ics/          category_id 为空的任务（Inbox）

⚠️ 用 `tasks-<id>` 而不是裸 id：真实日历本是 `/dav/<id>.ics/`，
裸 id 会与它们撞号（calendar_events 与 task_categories 是两套独立序列）。

### 分类跟随「本」

客户端把资源 PUT 进哪一本，任务就归哪个分类。
这是「按分类拆本」的自然语义，也让「在客户端里移动任务到另一本」等价于改分类。

### 跨本隔离

GET/DELETE 单条时会校验「这条任务确实属于这个本」，
否则改一下 href 就能用 A 本读到 B 本的任务。

## 验证（39 项全过）

真实数据（5 个分类 / 32 条任务）：

| 本 | 条数 |
|---|---|
| 家庭事务 | 6 |
| 工作相关 | 19 |
| 个人事务 | 2 |
| 党支部工作 | 1 |
| 轻舟相关 | 1 |
| 收件箱 | 3 |

每本 supported-calendar-component-set 均只含 VTODO，无 VEVENT。
PUT 到 tasks-1.ics 后 Location 返回 /dav/tasks-1.ics/task-40.ics，
GET 读回、更新、完成、删除全部正常。

回归：原有日历本（观影等）PROPFIND/GET 正常，组件类型仍是 VEVENT。
鉴权：无口令 401、不存在的分类本 404、非法段 404。

测试数据已清理，tasks 仍为 32 条。

## 文件

- app/TaskDav.php     重写为多本模型
- app/Ics.php         VTODO 导出/解析（上一版已加，本版未改）
- dav.php             五处拦截改多本

## 已知限制

看板名（正在进行/等待反馈/等待结果）通过 CATEGORIES 输出给客户端，
但客户端改它不会反向改看板 —— 标准 VTODO 没有「看板列」概念。
分类则双向（由「在哪一本」决定）。
 2026-11-02 15:41:54 +08:00
laoyang c86658966c CalDAV 增加待办（VTODO）双向同步 
用户原话：「网页端的 caldav 功能，除了能够同步日程外，增加可以同步任务（待办）的功能」

## 三个设计选择（用户已定）

1. 存放位置：作为 /dav/ 内的一个日历本，不另开 /taskdav/ 入口
2. 同步方向：直接双向读写
3. 字段映射：标准映射

## 字段映射

| VTODO | tasks 列 | 说明 |
|---|---|---|
| UID | 派生 task-<id> | 与日历 UID 空间隔离 |
| SUMMARY | title | 子任务加「└ 」前缀（纯展示） |
| DESCRIPTION | note | |
| DUE | due_at | 零点视为整天，用 VALUE=DATE |
| STATUS | status | todo→NEEDS-ACTION，doing→IN-PROCESS，done→COMPLETED |
| COMPLETED | done_at | 仅 done 时输出 |
| PERCENT-COMPLETE | status | doing=50，done=100 |
| CATEGORIES | 看板名 | 让客户端能归类 |
| RELATED-TO | parent_id | 标准父子表达 |

## 改动

### app/Ics.php：并列增加 VTODO 能力

不改 parse()/export() 的任何行为（VEVENT 路径注释里记着多轮踩坑史），
新增 exportTodos() / vtodo() / parseTodos() / normalizeTodo()，复用底层工具。

### app/TaskDav.php（新建，约 380 行）

虚拟日历本：href 固定 /dav/tasks.ics/，BOOK_ID = -1
（calendar_events.calendar_id 是 INT UNSIGNED 恒 ≥1，负数永不撞）。

权限口径与网页端完全一致，复用 Task::visibleTo / Task::canWrite /
Task::create / Task::update / Task::destroy，不另写一套。

### dav.php：前置拦截，原有日历逻辑零改动

PROPFIND / REPORT / GET / PUT / DELETE 各分支开头判断是否待办本，
是则走 TaskDav 并 exit。另外在 /dav/ 的本清单里追加待办本
（否则客户端根本不知道有这一本）。

## 过程中修掉的 4 个真 bug

1. **Class "TaskDav" not found** → 缺 use App\TaskDav;
   autoload 要求带上命名空间前缀，漏了会让整个 dav.php 全线 500。

2. **PUT/GET单条/DELETE 全 404** → 原来全用 isTaskHref()，
   它只比「整条路径 == /dav/tasks.ics/」，带子资源时必然 false。
   新增 isTaskPath() 做前缀匹配（且要求前缀后必须是 / 或结束，
   避免 /dav/tasks.icsXXX 被误判）。

3. **PUT 到不存在的资源名返回 403** → 原实现直接抛「任务不存在」。
   按 RFC 4918 §9.7，PUT 到不存在的 URI 就是创建资源。
   改为：只有确实存在且有权访问时才走更新分支，否则新建。

4. **注释里的 markdown 加粗导致 PHP 语法错**
   `作为 **/dav/ 内的一个日历本**` 里 `**/` 形成 `*/`，提前闭合块注释。
   PHP 注释里不要写 markdown 加粗。

## 验证

### Ics 层（34 项全过）
生成 → 解析 → 归一往返，含三种客户端完成态表达
（STATUS:COMPLETED / 只有 COMPLETED 时间戳 / PERCENT-COMPLETE:100）。

### TaskDav 层（45 项全过，真实 32 条任务）
读写、ETag 稳定性、权限、事务回滚。
写操作全在事务里做并回滚，不污染真实数据。

### HTTP 端到端（37 项全过）
OPTIONS → PROPFIND 发现 → REPORT → GET 整本 → PUT 新建
→ GET 读回 → PUT 更新 → DELETE，另含回归与越权检查：
- 原有日历本 PROPFIND/GET 仍正常，组件类型仍是 VEVENT
- 无口令 401、错口令 401、不存在的任务 404

测试按 RFC 跟随 Location（新建时服务端分配 id 并告知真实 href），
这也是真实客户端的行为。

### 数据完整性
测试前后 tasks 均为 32 条，测试数据已清理。
测试用 DAV 口令已 revoke（不影响用户原有口令）。

## 部署

app/Ics.php、app/TaskDav.php、dav.php 三个文件已上传并验证。

⚠️ 服务端文件不在客户端仓库，以后改这些要先比对服务器 md5 再验
（本次踩过：改了没上传，拿旧代码验出假结果）。
 2026-11-02 15:29:36 +08:00
laoyang 821cfd1542 Holiday：去掉三处 400 天上限，农历/节日/节气在全量范围下不再丢失 
## 问题

lunarRange / traditionalRange 都有 `$i < 400` 硬上限。
2026-10-30 客户端改成全量同步（1970~2100，47846 天）后，
这个「防异常」的保险变成「削正常功能」：
- 只算前 400 天 ⇒ **今天的农历是空的**
- 传统节日同样只剩前 400 天 ⇒ 今年的春节/中秋全丢

solarTermRange 另有一个问题：只取首末两年，
130 年范围下只算 1970 和 2100 的节气，中间 128 年全丢。

## 修法

- 三处统一改为：夹到 Lunar::MIN_YEAR~MAX_YEAR，再按
  MAX_LUNAR_YEARS（30 年）截断，去掉按天计数上限
- solarTermRange 改为逐年遍历

## 实测（部署后）

今天 2026-11-02 → 廿四（修复前为空）
今年 11 个传统节日、24 个节气，齐全
2021~2031 农历 4017 条（修复前 400），节气 264 条（修复前 48）
1970~2100 农历 10958 条 / 0.47 秒（按 30 年上限截断，符合设计）

## 注意

本文件不在客户端仓库，需单独上传服务器。
验证前必须比对服务器 md5，否则会拿旧代码验出假结果（本次踩过）。
 2026-11-02 08:51:34 +08:00
laoyang 0b8012f5dd 品牌改名：家书 → 岁月家（网页端标题/logo/文案；首页标题改「某某某的家庭岁月」） 2026-11-01 19:55:40 +08:00
laoyang 01d5bc262f 跨天日程：周/日视图按列分段画成一条，不再拆成碎片 laoyang/FamilyBook#35 
用户 2026-10-30：「网页端，跨天日程显示还是有问题…如果一个日程跨了三天，
应该在日历本上怎么显示呢？在周视图和日视图，应该怎么显示？现在显示的有问题。」

## 修复前是什么样（实测，不是推断）

一个「11/10 20:00 → 11/12 02:00」的跨三天日程，服务端 month() 展开成三条
（首日带 time、中间天两者皆空、末日带 end_time），喂给 build_time_grid 后：

    全天行：11/11、11/12 各一条     ← 中间两天变成"全天日程"
    时间网格：11/10 一个小块，高度仅 2.08%（≈30 分钟）

三个问题叠加：
  · 开始日的结束时刻不在同一天 ⇒ 判成"没有结束" ⇒ 退化成 30 分钟
  · 中间/末日既无 time 又不是全天 ⇒ 被"按全天处理"的兜底塞进全天行
  · 三条互不相干，用户看不出"这是同一个日程"

## 方案（用户已确认）

  1. 周视图：跨列连续长条 —— 毎列各画一段，视觉连成一条
  2. 日视图：铺满当天并标延续
  3. 中间天归时间网格，不进全天行

## 改了什么

**app/Calendar.php** —— 服务端补两个字段
  · `span_days`：整条日程跨了几天（0 = 当天来回）
  · `seg`：start / mid / end / only
  同时修掉一个真 bug：原来 `$first` 是"窗口内遍历的第一个"，
  日视图只查一天时，中间天会变成 `$first` 被当开始日处理。
  ⇒ 一律用**真实日期**跟 `$base`/`$base+span` 比较，不看遍历顺序。

**index.php::build_time_grid** —— 核心重构
  · 先按 `kind:ref_id:occ` 归堆，把同一日程的逐天条目合成一条
    （带 occ 是因为重复日程不同次发生的 ref_id 相同；带 kind 是因为
     观影/旅程的 ref_id 是各自表里的 id，`custom:5` 和 `movie:5` 是两回事）
  · 跨度以服务端 `span_days` 为准，不再用"窗口内铺了几列"推断
    （日视图下那个推断必然不成立）
  · 跨天条目拆成每列一段，按 `seg` 决定纵坐标：
    start = 开始时刻→24:00，mid = 整列，end = 0→结束时刻
  · 跨天条目**不参与 conflictLanes** —— 它必然占满整列，
    拿去分列会把同一天所有日程都挤窄

**templates/calendar/index.php** —— 分段渲染
  · `is-seg-start/mid/end` 类；延续段前面加 `↳` 标记，不重复显示时间
  · 跨天段用 `left:0; width:100%`，单天块保持原来的 `calc(2px + N%)`

**assets/css/app.css** —— 让三段看着连成一条
  · start 下圆角归零、下边框透明；mid 上下都平；end 上圆角归零、上边框透明
  · 段与段之间原本有 1px 白边 + 左右内缩，实测缝隙 10.9px，看着像断成三段
    ⇒ 跨天段贴满整列后降到 1.0px（只剩列边框）

## 为什么在列内画段，不做跨列绝对定位层

`.tg-body` 左边有 56px 固定 gutter，窄屏还会横向滚动
（`.cal-tg-card{overflow:auto}` + 每列 min-width 92px），`.tg-col` 又是
`overflow:hidden`。跨列层要自己算 gutter 偏移、跟着横向滚动跑、还不能被裁 ——
每个都是新坑。在列内画段天然对齐，代价只是段间有 1px 列边框缝，用 CSS 糊掉。

## 验证

**逻辑层（PHP，用真实 build_time_grid）**
  · 周视图跨三天：3 段（start/mid/end），全天行为空 ✓
  · 日视图三个位置（起始/中间/结束天）各自正确 ✓
  · 回归：单天 + 真全天仍正常；冲突分列仍生效；跨天与普通日程共存正常 ✓
  · 反向验证：用修复前的代码跑同一判据**正确转红**
    （旧版 timed=1 all_day=2，高度只有 2.08%），证明判据非恒真 ✓

**视觉层（Playwright + 真实 CSS + include 真实模板）32 项全过**
  · 横向连续：start→mid 缝隙 1.0px，mid→end 1.0px（判据 ≤2.5px）✓
  · 纵向：start 底边贴列底 0px；mid 占满整列（顶 0 / 底 0）；
    end 顶边贴列顶 0px 且只占开头一小段 ✓
  · 样式：start 下圆角 0px + 下边框透明；mid 上下圆角 0；end 上圆角 0 +
    上边框透明 ✓
  · 无裁切：三段都落在列内 ✓
  · 回归：真全天仍在全天行；跨天不再出现在全天行；单天日程正常 ✓
  · 窄屏 375px：三段仍可见（w=91）✓

**反向验证 4/4 全部抓到**
  故意做坏四个变体（段留单天内缩 / 保留圆角 / 中间段只画 30% /
  下边框不透明），判据全部转红 —— 说明"32 项全过"不是因为判据恒真。

## 已知取舍

跨天段占满整列，同一天的普通日程与它在视觉上会重叠。
这是日历的固有取舍（Google 日历同样如此），用户确认的方案里也接受。
 2026-10-30 23:43:10 +08:00
laoyang 73c84c1910 geo：移除地址联想代理接口（端上改用鸿蒙自带 Map Kit）laoyang/FamilyBook#33 
用户指示「端侧不用高德，用鸿蒙自带的接口」。
端上已改用 @kit.MapKit 的 site.queryAutoComplete()，这个服务端代理随之无用：

- ApiHandler：删 case 'geo' 与 geo() 方法
- Geo：删 TIPS_URL 常量与 tips() 方法

网页端不受影响：它走浏览器端 JS API（AMap.AutoComplete），
从来不经过 /api/v1/geo/tips（已确认 addr_suggest.js 零引用）。

验证：接口返回 404（已删），calendar/books 等其它接口仍 401（正常鉴权）。
 2026-10-30 08:11:47 +08:00
laoyang 29b2ca0e3c geo：新增地址联想接口 /api/v1/geo/tips（高德 inputtips 代理）laoyang/FamilyBook#36 
鸿蒙端地点输入要「输入简单地址 → 下拉带详细地址」，但高德 Web 服务 key
不能进客户端（反编译/抓包即得，配额会被跑光、key 可能被封）。
网页端用的 JS API key + 安全密钥是域名白名单那套，原生端没有等价机制
⇒ 走服务端代理，与网页端 addr_suggest.js 同一个上游（/v3/assistant/inputtips）。

- Geo::tips()：调高德 inputtips，把三套不齐的字段归一成
  name / detail(省市区+门牌) / district / address / lng / lat
- 过滤公交地铁线路（typecode 15xx）—— 对填地点没用
- 只看 body 里的 status 而不是 HTTP 码（配额用完高德回 200 + status=0）
- 少于 2 字不查，返回空数组而不是报错（阈值与网页端一致）
- ApiHandler::geo()：GET only、要求登录（这是花配额的接口）

⚠️ 现有 key 是 JS API 类型，调 Web 服务接口返回 USERKEY_PLAT_NOMATCH(10009)，
   需另配 Web 服务 key 才能真正工作。同样原因，既有 Geo::regeo() 一直是失效的
   （cityFromPoint 在走离线兜底），此问题另行处理。

解析逻辑已用 4 组模拟高德响应验证（同名可区分/行政区划兜底/线路过滤/
空 name 跳过/失败返回空），19 项全通过，含源码一致性检查。
 2026-10-30 08:03:20 +08:00
laoyang 42aff02687 读书上传+在线阅读+笔记导入：补 books/{upload,chapters,chapter,import_notes} #28 
用户原话（2026-10-28）：「鸿蒙端对齐网页端」。读书端上只有书架（状态/评分/进度/
笔记），上传解析、在线读、笔记导入都在网页端。

补四个 API 端点（模型 BookParser / Book::chapters/chapter/replaceChapters /
BookNoteImport 早已齐，纯粹没暴露）：
· POST /books/upload       上传 EPUB/TXT 等 → 存文件 → BookParser 解析 →
                            建书 + replaceChapters + EPUB 自带封面
· GET  /books/<id>/chapters  章节列表（无正文）
· GET  /books/<id>/chapter?seq=N  单章正文
· POST /books/import_notes  粘贴读书笔记原文 → 解析 → 导入（不信前端结果）

判据：_i28_book_api.py 11/0（上传建书+落章节 · 章节列表 · 单章正文 ·
笔记导入），_i28_falsify.py 注掉 upload 分支变红。
 2026-10-28 22:47:38 +08:00
laoyang b6dc60452a 电影影评+评论：修半成品并补全 /movies/<id>/{reviews,review,comments} #27 
用户原话（2026-10-28）：「鸿蒙端对齐网页端」。观影详情只能看平均分，
不能写影评/评论。盘点发现服务端其实有份**半成品且带 bug**：

· comments GET 写死"只有我写过影评才返回" —— 错，改为独立 reviews 端点；
· comments POST 调 addComment 参数**完全错位**（parent_id 传给了 feelings、
  target_person 传给了 parentId）—— 评论实际存不进；
· 缺影评/评论的删除端点。

现在对齐 Web 端 reviews 四条路由：
· GET    /movies/<id>/reviews   全部影评（含评论树）+ 我的影评 + 统计 + 感受目录
· POST   /movies/<id>/review    写/改我的影评
· DELETE /movies/<id>/review    删我的影评
· POST   /movies/<id>/comments  评论/回复（review_id/content/parent_id）
· DELETE /movies/<id>/comments?comment_id=N  删我的评论

判据：_i27_movie_review_api.py 22/0（写/改影评 · 列表含 mine · 评论/回复 ·
删评论级联 · 删影评 · 越权删别人影评被拒），_i27_falsify.py 注掉写分支变红。
 2026-10-28 22:29:55 +08:00
laoyang ad71c80f48 任务共享：补 /tasks/<id>/shares API 端点 #26 
用户原话（2026-10-28）：「鸿蒙端对齐网页端」。任务端上无「共享给谁」入口，
Task::shares/setShare/dropShare 模型早就有（Web 端 tasks/share、tasks/unshare 在用），
只缺 API 子端点。

· GET/POST/DELETE /api/v1/tasks/<id>/shares —— 共享列表 / 加 / 取消
  （canWrite 才允许；Task::find 本来就带 shares 字段，详情一次就能拿到）

判据：_i26_task_share_api.py 13/0（共享增/列/删 · 越权被拒），
_i26_falsify.py 注掉 shares 分支变红。
 2026-10-28 22:10:15 +08:00
laoyang 47247e39b9 资源附件+共享：补 /resources/<id>/{attach,shares} API 端点 #25 
用户原话（2026-10-28）：「鸿蒙端对齐网页端」。资源端上明说「附件与共享
还在网页端」，根因是资源 API 只有 title/content，附件与共享没接口。

补两组子端点（模型 Resource::ATTACH=resource、shares/setShare/dropShare 早就有）：
· GET/POST/DELETE /api/v1/resources/<id>/attach —— 附件列表 / 传 / 删
  （删走 attachment_id query，与 tasks 同招；可写者才允许，别人家的 404）
· GET/POST/DELETE /api/v1/resources/<id>/shares —— 共享列表 / 加 / 取消
  （canWrite 才允许，越权 404 —— find 对看不到的资源返 null，不泄露存在性）

判据：_i25_resource_api.py 21/0（传/列/删附件 · 共享增/列/删 · 越权被拒且库里没变）
· _i25_falsify.py 注掉 attach 列表与 shares 分支各自变红。
 2026-10-28 22:00:14 +08:00
laoyang e44f37e902 财务折线：补 /ledger/<id>/timeline API 端点 #24 
用户原话（2026-10-28）：「鸿蒙端对齐网页端」。财务概览卡「净资产变化」在
端上是空占位，数据源 Web 端早有（Ledger::timeline + ledger/total_chart），
只缺一个 API 给端上。

· GET /api/v1/ledger/<id>/timeline —— 返回时序点数组（date/net/asset/debt）
  加当前汇总。与 Web 端 total_chart 用**同一份 Ledger::timeline($id)**，
  两端曲线必然一致。

判据：_i24_timeline_api.py 8/0（2xx · items 数组 · 每点 net=asset-debt ·
有数据源），_i24_falsify.py 注掉 timeline → ④ 变红。
 2026-10-28 21:47:27 +08:00
laoyang cd56a9d8fe 笔记图片块：补 API 上传子端点（图文混排的前半程）#23 
用户原话（2026-10-28）：「鸿蒙端对齐网页端」，笔记端上只支持纯文本，
图片块显示成「[图片]」，且编辑带图笔记会静默删光图片块。

这半程只改服务端、补一个缺口：
· POST /api/v1/notes/upload —— 笔记图片上传，返回附件 key。
  放在 notes() 的 $id>0 分支之前（上传是草稿态，不依赖笔记 id，
  新建笔记插图时还没有 id）。图片先挂 target_id=0，等 blocks 带
  key 提交时由 Note::claimUploads 认领（与 Web 端 notes/upload 同一套）。
  Attachment::save 只回 id 不回 key ⇒ 反查 Note::ATTACH=0 的 list 拿 key。
· dispatch 里 notes case 从 notes($id,$method) 改成 notes($id,$sub,$method)，
  否则 $sub='upload' 根本传不进去（405）。

判据：
· _i23_note_image_api.py  11/0（上传返 key · 带 blocks 新建后 text+image
  两块都在 · PATCH 后图片块不被删 —— 这是 P0 数据丢失修复的核心证据）
· _i23_falsify.py 注掉 upload 分支 → ①② 变红（命中 2/2）
 2026-10-28 21:34:43 +08:00
laoyang fc81347e8d fix(notes): 调过宽度的图片保存后变孤儿（#18） 
用户报「笔记功能，上传图片失败」。实际不是上传失败，是上传成功后
保存那一步把图片弄丢了。

根因：图片块 content 有两种形态
  - `photos/xxx.jpg`      —— 宽度 100% 时，前端不写后缀
  - `photos/xxx.jpg|50`   —— 宽度调到 20~99% 时，serialize() 加上宽度

但 Note::claimUploads() 与 Note::files() 直接拿 content 去匹配
attachments.key（`WHERE key IN (...)` / `isset($used[$key])`），
带后缀的那个**永远匹配不到**，于是：

  1. 草稿附件（target_id=0）认领失败 ⇒ 图片变孤儿，笔记里图没了
  2. files() 排除不掉已用作图片块的附件 ⇒ 同一张图既当图片块、
     又在底部附件区重复出现

默认 100% 不写后缀，所以表现为"有时好有时坏"，
极易被误判成上传环节的问题。

修法：新增 Note::imageKey() 统一剥 `|宽度` 后缀，
claimUploads() 与 files() 都先过它。

刻意修在**服务端**、而不是"前端别写后缀"：后者会把宽度功能废掉
—— 渲染时要按 content 里的宽度出图（见 templates/notes/form.php
的 $imgParts 与 templates/notes/index.php:98，那两处本来就剥了，
所以只有服务端这两处漏了，属于不对称实现）。

updateBlock() 走同一条 claimUploads()，自动被覆盖。

验证（本地 PHP 8.5 + MariaDB，真实 UI 操作，非手搓 DOM）：
- 主判据 _tooling/_b35_width_falsify.py：修复前 100%→1712 成功 /
  50%→target_id=0；修复后两条路径都认领成功，7 通过 0 失败，
  且 content 仍带 `|50`（宽度功能没被牺牲）
- 附件不重复 _tooling/_b35_dup_attach.py：阅读态底部附件 0 条、
  图片块 1 张、img 61px vs figure 990px（宽度真的生效），5 通过 0 失败
- 判据有牙齿：把 claimUploads() 注入回旧形态后立刻 2 条 FAIL，
  恢复后回到 7 通过 0 失败

工单 #18
 2026-10-28 16:03:36 +08:00
laoyang ff818a3deb feat(nav): 导航站点支持自定义图标上传（含两处连带修复） #16 
需求：网页版导航，新增/编辑导航地址时没有自定义图标功能。

## 功能
- 站点表单加 enctype=multipart/form-data，新增「自定义图标」控件：
  40px 预览 + 选择图片 + 清除自定义图标（仅编辑且有自定义图时出现）
- 选择文件后本地即时预览（URL.createObjectURL，用完 revoke，不落 base64）
- 按文件内容判类型（finfo + <svg 探测），不信任扩展名；上限 1MB
- icon_custom 三态语义：不选文件=不动 icon 列；选文件=icon_custom=1；
  勾清除=icon='' & icon_custom=0。普通改名不碰 icon 列，不会丢图
- saveUploaded() 改随机文件名。原实现按 md5(icon_key(url)) 命名，
  单用户系统没事、多用户会互相覆盖
- 新增 Nav::iconFileInUse()：图标文件按内容共享，删旧文件前先查还有没有
  别的记录在用
- 图标从 uploads/ 目录取不到（线上 403），走 /nav_icon.php?f= 公开出口

## 连带修复 1：ICON_STORE 常量从未定义
SimpleNav 搬迁时漏搬 define('ICON_STORE', 128)，NavFetch.php 第 667/739
行在用。PHP 8 抛 Error: Undefined constant "ICON_STORE"，只要走到 GD
位图分支就 500。因为 saveUploaded() 一直是死代码（有定义无调用点），
这个错一直没被触发过。现补进 app/bootstrap.php（带 if (!defined) 保护）。

## 连带修复 2：22 处裸函数调用缺 self::
搬迁时把自由函数改成了 NavFetch 的静态方法，但类内部调用点没跟着改。
PHP 报 Error: Call to undefined function App\http_get() @ NavFetch.php:171。
这既是「全部更新」按钮 500 的根因，也是「图标一直抓不到」的真相 ——
整条抓取链路（http_get / attr_value / absolutize / third_party_icon_urls /
default_icon_candidates / meta_content / parse_icon_links / manifest_icons /
is_third_party_icon / looks_generated_tile / grab_icon / ensure_utf8）
一处都没跑起来过。

修后 CLI 实测 NavFetch::meta('https://www.baidu.com') 返回
name=[百度一下，你就知道]、icons=3、图标落盘 3818 字节。

## 验证
- php -l 5 个文件全过
- 端到端 21/0：真实上传 PNG → 列表出 img.nav-ico → nav_icon.php 返 200
  + PNG 头 → 编辑换图 → 清除 → 只改简称不丢图标 → 清理
- 语义验收：带自定义图的站点点「全部更新」后 icon 文件名不变、custom=1；
  不传图的站点 custom=0（以服务端回报条数为证据，不看"未变"）
 2026-10-28 12:48:47 +08:00
laoyang a7fc7dcb0e 日程表单的日历本下拉只列可写 custom 本（#4） 
用户原话（2026-10-26）：「网页端，添加日程，如果日历本是只读的，例如别人
共享给我只读，或者系统自带日历、观影、纪念日等，就不要出现在日历本选框中，
只出现那些可写的。」

三条判据缺一不可（只做一条都修不好）：
  ① canWrite()         —— 挡「别人共享给我且只读」。
     实测：只有这一类能被 canWrite 拦住。
  ② !isReadonlyKind()  —— 挡系统只读本（农历/节假日/传统节日/二十四节气）。
     它们的 owner_id 就是我 ⇒ canWrite() 恒真，光靠 ① 一本也拦不住。
  ③ kind === 'custom'  —— 挡观影/旅行的派生本。
     这两本**确实可写**（往里加一条 = 建一条观影/旅程记录），
     但不是"放日程的地方"，放在新建日程下拉里只会让人建出别的东西。

- app/Calendar.php：新增 writableForEvent() / filterWritableForEvent()，
  作为**唯一口径**（日历页、首页卡片、API 都走它），
  避免 v82 那种"两个入口的下拉内容可以不一样"的老毛病。
  判据用 READONLY_KINDS 常量而不是 kind 白名单：新增系统本只要登记就自动生效。
- templates/calendar/index.php、index.php：改用上面的口径。
- templates/calendar/_add_modal.php：清掉恒假的 disabled 与「（自动生成）」
  死代码（前端已过滤，留着只会误导）；保留 data-kind 给探针当锚点；
  按钮色点与文案改成**服务端就带出来**（无 JS 时也看得见颜色和本名）。

验证：
- 浏览器探针 28/0：含自建夹具（只读共享 / 可写共享 / 自己的）三类，
  与 PHP 侧独立重算的期望集逐项比对，真保存一次，
  以及**绕过前端直接 POST** —— 只读共享回「这本日历你没有写权限。」且库无新增；
  观影/旅行回 ok:true 且真的落 events 表（不进 calendar_events）。
- 反向验证 6/6 全抓住：退回 canWrite / 只看 kind / 不管 custom / 全滤空 /
  只读共享漏进下拉 / 拆掉 event_add 的 canWrite 闸门。
  最后一条注入时**只有 ⑪ 变红**，证明它测的是服务端拦截而非前端下拉。
- 全量流水线（--all）退出码 0，已部署并确认线上 4 个文件 php -l 全通过。

工单：#4
 2026-10-26 14:59:57 +08:00
laoyang f1b09a2f41 v93: 首页日历本下拉能拉了 / 日程浮层只留编辑删除 / 重复日程三档 / Markdown 标题四级阶梯补齐 
用户两条：
① 「新建日程，日历本是拉不下来的，是空的，好像只有一个"工作"什么的」
② 「点日程后的详情跟原来的弹框几乎一模一样，这个详情就没有意义了」
   ⇒ 只显示「编辑」「删除」；重复日程的删除/编辑要有三档
   （当前 / 从现在到以后 / 全部）

【① 根因】`_add_modal.php` 被日程页与首页共用，HTML 一样，但自绘下拉的整套 JS
只内联在 `templates/calendar/index.php` 底部 ⇒ 首页那份没有交互，点了菜单不展开；
而按钮上是服务端渲染的默认本（"工作"），所以看着"只有一个工作"。
修法：抽 `assets/js/cs_picker.js`（全站 defer、按 `[data-cs-picker]` 初始化、
`data-cs-ready` 幂等）。不扫所有 `.cs` —— 观影表单的影院下拉有自己的内联绑定，
两边都绑会"点一次开两次"。

【②】浮层自定义日程不再显示「详情」（派生条目仍只有真链接「详情」）；
删除/编辑三档措辞按用户原话；`occ` 为空时只给「删除全部」，绝不让空串触发整条删除。
编辑三档的入口在 `fb_entry_json()` 把 `occ` 拼进 edit 地址（`?d=`）——
不带就只有"修改全部"一档。

【顺带修掉 v85 没做完的一半】全量套件在 v61 A9b 报红，查下去不是本轮改坏的：
CSS 只把 `##`（h4）调到 17px，`###`（h5）留在 15.5px（正文 15px，只差 0.5px）、
`####`（h6）留在 14.5px（比正文还小），而那段注释自己写的就是"三级都要调大"。
阶梯重排 h3/h4/h5/h6 = 22/20/18/17，四级两两不同号。
更值得记的是四条判据全部只盯 h4（v61 A9b、v85 B2/B2b 前身、静态断言、线上 A4），
而 h4 恰好是唯一修好的那一级 ⇒ 各加"每一级/最矮的一级"判据，并用
「只把 h6 打回 14.5px ⇒ A9b 仍绿、只有 A9b2 变红」证明新判据有独立价值。

【工具链】`_b61_falsify.py` 的 main_all 改成每个 case 起独立子进程 ——
原先同一进程连跑 10 遍探针，Playwright 的临时 profile 建/删会在同一轮里累计，
撞沙箱批量删除钩子被 SIGTERM（症状：输出戛然而止、退出码 1、一条 FAIL 都没有）。

验证：v93 正向 28/0 · v93 反向 3 处注入各自被抓 · v61 34/0 · v61 反向 9/9 ·
v85 md_heading 12/0 · v85 静态反向 8/0 · 全量流水线通过并已部署。
 2026-10-25 14:52:43 +08:00
laoyang 4b58fec796 v82: 首页卡片补「新建日程 / 新增成员」+ 两处红线 
用户原话：「日程，没有新建日程按钮，名册，也没有新增成员这个按钮。
另外，首页上的日程，红色线不对，变短了左侧缺了一块。在日程模块中，
那个红线左侧是不是还有一个红点？如果有，去掉。」

首页卡片就地操作（不用进模块）：
- HomeCards.php 的 agenda/contacts 补 add + add_modal 元数据
- templates/calendar/_add_modal.php：从 calendar/index.php 抽出的
  「新建日程」弹框片段（首页与日程页共用；片段自读变量一律加 cal 前缀，
  避免 require 共享作用域覆盖宿主变量）
- templates/people/form.php：加弹框形态（pfModalOnly / pfModal），
  弹框形态下「取消」走 data-fb-add-close
- index.php：首页 agenda/contacts 两个 $homeAddModals 分支；
  calendar/event_add 支持 back=home 白名单跳转（不采信任意 POST 字符串）

红线（左端缺一块 / 多余红点）：
- .ag-now 原来写 left: var(--ag-gutter,50px)，但 v80 起它已经在
  .ag-lines 内部（那层自己已有同样缩进）⇒ 左沿跑到 100px、比车道多
  出一整份刻度宽。改成 left: 0
- .tg-now::before 整条删除（日程模块页那个 8px 红点）

涉及共用件（HomeCards/index.php），已跑全量：e2e 1572/0、
v82 正向 20/0、v82 反向 15/0、流水线全绿并已部署。
 2026-10-24 04:25:02 +08:00
laoyang fd90e33d94 v81：首页卡片「新增电影」「新建纪念日」弹框（不离开首页就把事办了） 
用户 2026-10-22：
「首页上的其他卡片也应该有这些基本功能。比如电影观影，它有一个"新增电影"的功能；
  如果是纪念日，就有一个"新增纪念日"。实际上，就是把原来模块里弹的那个框，现在拿到
  这边来。目的就是为了在首页上就能快速完成一定工作，而不用进到模块里面。」

做法：复用模块页**同一份**表单，不另写。
- app/HomeCards.php：TYPES 每张卡多登记 add（按钮文案）/ add_modal（弹框容器 id）。
- templates/home.php：按登记表挂 data-fb-add-open="#<id>"（没登记的仍用 v78 的
  data-tk-add-open，两种写法并存但各有唯一来源）；页尾 require 模块的表单模板。
- assets/js/add_modal.js（新）：通用开关，只认 [data-fb-add-modal] /
  data-fb-add-open / data-fb-add-close；幂等闸门；Esc 先让 antd 收面板；
  打开那一刻才 boot 日期控件（hidden 时尺寸为 0，antd 会定位到屏幕左上角）。
- templates/{movies,days}/form.php：只在首页内嵌时（$fbAddModalAttr）挂通用属性
  并输出 back=home，模块页行为一字不变。
- index.php：days/save 与 movies/create 加 back=home 白名单（取 POST 再比字面量，
  不把 POST 当跳转地址）。

过程中修掉两个真问题：
- 登记表第一版写 anAddCard，而 days/form.php 实际是 anNewCard ⇒ 按钮属性写对了、
  DOM 也不报错，点下去毫无反应。已加「按钮指向的容器真的存在」判据与部署静态
  断言里的交叉校验（拿登记表 id 去 templates/ 里逐个找 id="..."）。
- 探针判「提交后回首页」原本读 pg.url，而 wait_for_load_state(networkidle) 在
  点击那一刻本就 idle 时立刻返回 ⇒ 读到提交前的地址，恒绿。改成拦那次 POST 的
  响应看 (状态码, Location)，拆成 ⑭a 提交真发生 / ⑭b 302 指向 home / ⑭c 浏览器停在 home。

验证：正向探针 23/0 · 反向验证 14/0（七注入各自变红）· e2e 1572/0 · 几何 428/0。
 2026-10-22 22:05:17 +08:00
laoyang f927d7fb23 v79 服务端：端上任务面板需要的三个口子 
配合鸿蒙端 v79（任务面板 / 任务模块功能补齐），服务端只补三处，
其余全部复用既有路由。

① GET /api/v1/tasks?view=boards —— 只回看板 + 分类元数据，**不带任务**。
   端上原来是从已加载任务里反推看板，那样只能看到"有任务的看板"：
   用户刚建好、还没放任务的看板在端上永远选不到（表现为"网页能建，
   端上挪不过去"）。

② POST /api/v1/tasks/<id>/attach（multipart 字段 file）与
   DELETE /api/v1/tasks/<id>/attach?attachment_id=<aid> —— 都要先
   requireWrite() 再 Task::canWrite()，两者都回整条任务（端上直接重画）。

③ ApiHandler::taskOut() —— Task::find() 只 SELECT t.*，不含看板名/色
   ⇒ 详情与各动作回包统一补 board_name / board_color_calc（7 个返回点）。

🔴 两条踩过的坑写进注释：
   · Api::dispatch() 只解析「资源/id/子动作」三段，附件 id 不能拼进路径；
   · DELETE 带 JSON body 时 Api::param 读不到（实测），id 必须走 query。

另新增 Attachment::removeFrom()：删附件前先确认它确实挂在这条任务上，
拿别条任务的附件 id 来删自己的 → 404（已由 _fb_v79_api.py 钉死）。

验证：php -l 全过、e2e 1558/0、_fb_v79_api.py 26/0、已部署并冒烟。
 2026-10-22 16:40:52 +08:00
laoyang 40fd6c501c v78 服务端：首页任务改成「就地处理」面板 + 新建任务搬到首页 
用户原话：
「网页端，首页点击一个任务后，除了展示信息，应该有相应的功能，可以修改状态：
  待办、进行中，可以挪动分组，可以拖动上传附件，可以添加评论，添加子任务等。
  其目地，是为了让用户不离开首页，就能对任务进行简单的处理。」
「另外，在全部任务旁边，放一个新建任务的功能，其实就是把任务中的新建和编辑功能，
  搬过来，用弹出框来处理。」

一、首页任务浮层由「只读信息」改成「可操作面板」
- 新增 templates/tasks/_panel.php：状态三段 / 看板 chips（带看板色）/
  子任务（复用 _task_check.php）/ 附件拖放框（复用 _attachments.php）/ 讨论
- 新增路由 tasks/panel：只吐一块 HTML（找不到 404）
- 既有七个动作路由各加一条 ajax_panel 回包分支（状态 / 挪分组 / 新建子任务 /
  评论增删 / 附件增删），没有新开写接口
- helpers.php 新增 task_panel_wanted() / task_panel_json()；
  fb_entry_json() 的 payload 增加 panel 字段（只有任务会给）
- 每次动作回**整块新面板**：一次动作会牵动子任务计数、附件张数、看板选中态，
  逐处同步 DOM 必然漏一处
- 拖进来的附件**立刻上传**（任务已存在，不该再让用户点一次保存），
  不复用 _stage_drop.php 那套「暂存 + 认领」

二、新建任务搬到首页
- 从 templates/tasks/index.php 抽出公共片段 templates/tasks/_add_modal.php
  （字段与原来一字未改），首页与任务页共用同一份
- 新增 assets/js/task_add.js 管开关（两页共用，幂等绑定）；
  打开那一刻才 fbUpgradeRange() + fbBootAntd()（hidden 时宽高为 0，antd 会定位错乱）
- App\HomeCards 登记表里加 add => 新建任务，首页卡头与「全部任务」并排
- tasks/create 支持 back=home（白名单），新建完回首页

三、其它
- assets/js/task_panel.js：事件委托；动作后整块换面板；
  顺手同步首页那张卡的状态徽标与复选框（关掉浮层不能还是旧状态）；
  传附件时保住用户写了一半的留言与子任务标题；取不到面板时退回只读信息
- app.css 追加面板样式（含 color-mix 的 @supports 兜底）与卡片窄到宽 2 时允许折行

验证：本地 e2e 1558/0、几何 428/0 + 660/0、v78 反向验证 11/0、
片段作用域体检 35/0、php -l 与 node --check 全过
 2026-10-22 12:40:14 +08:00
laoyang 036e208809 v77 服务端：旅程题图上传端点 + 修「PATCH 把题图清空」的真 bug 
新增 POST /api/v1/trips/<id>/cover（multipart 字段 cover），
槽位走 ImageSlot 的 cover（1920×1080 / 16:9），与网页版
trips/form.php 同一条 Upload::image 管线；换图顺手删旧对象。

修一个已经发生过的静默数据丢失：端上编辑旅程走
PATCH /api/v1/trips/<id>，那个分支的 $d 里没有 cover_key
⇒ saveDetails() 里 $d['cover_key'] ?? '' 得到空串 ⇒ 题图被写成
NULL。用户在手机上只改了个名字，题图就没了。
⇒ 语义改成「没传 = 不动」，要清空必须显式传空串。

另加 Trip::setCover()：换图只动 cover_key 一列，不复用
Trip::update()（那条要求 title 必填、还会重写 summary/is_public，
下次加字段漏一个就又静默清空一次）。

线上已部署并复核：ApiHandler.php / Trip.php 均含新代码、php -l 通过。
 2026-10-22 10:14:54 +08:00
laoyang b45cf671d1 v71c：首页「通知消息」改成正规卡片，样式直接复用通知页 
用户 2026-10-21：
「先把web端的首页修一下，通知消息这个，也是首页的卡片，可以调整顺序和大小。
 另外，这个样式也不好看，我看个人头像点击后，通知消息那个页面的样式就不错，
 直接复用就可以了。」

① 卡片化（HomeCards 注册表 + 默认布局 + 取数）
   · TYPES 新增 'notif'（w4/h4，route=notifications，more=全部通知）
   · DEFAULT_LAYOUT 钉在 brief 之后，与 days 并一行（宽 4）——
     若插在 brief 与 agenda 之间，agenda/tasks 会被挤成一上一下（实测 C13 顶边 407 vs 751）
   · data() 加 case 'notif' → 新增 notifData()：最新 10 条 + 未读数，
     与原来的取数口径一字不差；关掉卡片就不查这两条 SQL
   · templates/home.php 删掉网格前那块写死区块（v30 第 5 条「必须在往年的今天前面」
     这条约束作废 —— 那时还没有卡片体系）；index.php 不再单独传 notifs/notifUnread

② 样式复用 templates/notifications/index.php
   · 结构与通知页完全一致：头像在前 → 正文 → kind 图标在右（带 ntf-kind-{kind}）
     （旧首页那块是"图标在前、头像第二"，正是用户说不好看的那一版）
   · 新增 .hc-ntf 作用域只补"卡片比整页小"的三条差异：正文允许折两行（宽 2 时
     单行省略会把正文全吃掉）、时间挪到正文下一行、未读数做小注脚
   · 不带每条右侧「删除」按钮（4×4 的卡里塞两个按钮会把正文挤成两三个字），
     删除在通知页做，卡片右上角有「全部通知」

③ 顺带修掉 v63 A1 抓住的一处：'notif' 的 mod 给 'home' 而不是空串
   （通知不在 Module::LIST，但它是首页自己的卡片；空串会让「全部通知」成为
   一排同色模块按钮里唯一白底 ghost 的那个）
   ⇒ TYPES docstring 立规矩：route 非空就必须有 mod，认不出归哪个模块就归 home

验证（familybook_push.sh 第 6 轮全绿，PUSH_RC=0，2h11m）
   v62 首页卡片 56/0 · v62 反向验证 14/0（新增 M8–M12 五条注入）
   b30 通知 16/0 · b30 反向验证 18/0
   v63 40/0 · v63 反向验证 51/0 · e2e 1523/0 · 部署静态断言空跑 RC=0

同批带上上一轮 v70/v71 的日历修复（已单独验过，本轮流水线一并回归）：
   · v70 日历导入后条目不显示：+N 条从纯文本 span 改成真按钮，点开是当天全部
     条目浮层；AJAX 新建后就地插入与服务端同形（回 entry，不让前端自己拼）
   · v71 ICS 导入顺序：主事件 → 覆盖行 → EXDATE 由 Calendar::importIcs() 统一保证
 2026-10-21 13:22:37 +08:00
laoyang b2b103df0f v68：修好日程「地点」的高德联想（v54 起静默失效）+ 账本四条动作路由 
用户 2026-10-20：「网页端添加日程的时候，输入地点，应该调用高德接口，
获得准确的详细地址，现在这个功能不好用了，先修一下。」

## 根因不是 key、不是域名白名单 —— 是插件从来没被拉起来
`layout.php` 里 `fb-amap` meta 给的 SDK 地址**不带 `plugin`**，而加载器优先用它
⇒ `window.AMap.AutoComplete` **恒为 undefined** ⇒ 联想实例建不出来。
更糟的是 `addr_suggest.js` **一进函数就打 `data-addr-bound='1'`**，
于是"绑定失败"被记成"已经绑定过"，此后**再也不重试** —— 全链路静默，
界面上就是"输了字什么也不弹"。
（用真浏览器逐环量过才定位：key 有效、`inputtips` 真能返回 10 条候选，
  问题全在我们自己这一侧。）

修法（双保险）：
- `layout.php` 新增 `needAutoComplete()`：SDK 到位后 `AMap.plugin('AMap.AutoComplete', cb)`，
  超时也放行；启动顺序改成 **SDK → 插件 → 我们的脚本**。
- `addr_suggest.js` 就绪判据收紧成 `!!(AMap && AMap.AutoComplete)`；
  `data-addr-bound` 改为 **new 成功之后**才打；新增 `ensurePlugin()`
  并监听 `fb-amap-ready` 自愈（插件晚到也能接上）。

## 「准确的详细地址」
日程的地点**只有一栏**（`_event_fields.php` 只有 location），只把名字写回去，
回头要导航/找人还是查不到门牌。⇒ 地点框加 `data-addr-detail="1"`，
选中候选后写「名字 · 详细地址」（名字在前，人认的是名字），
并在这一行下面给一条「高德：省市区 · 门牌」提示。
⚠️ 提示行必须插在**整行之后**，塞进 `.mv-row` 会把 62px 标签列挤掉（v24 踩过）。
⚠️ 详细地址必须**延后一拍**写：AutoComplete 在 select 回调之后还会把 `poi.name`
   塞回输入框，同步写会被它覆盖（第一版就因此白写）。

## 账本：服务端补四条路由
`Ledger::rename / setShare / unshare / shares / updateEntry / removeEntry`
**模型一直都有**，`ApiHandler::ledger()` 却只开了「建账本 / 记一笔 / 删账本」
⇒ 端上只能把「共享给谁」「账本名字」画成灰条，账目也改不了删不掉。
新增：`PATCH /ledger/<id>`（改名）、`/ledger/<id>/shares`（GET/POST/DELETE）、
`PATCH|DELETE /ledger/<id>/entries`（id 走 `Api::int('id')` ——
`Api::dispatch()` 只解析 3 段，`/ledger/3/entries/17` 的第 4 段会被丢掉）。
`Ledger::mine/find` 补 `is_owner`（`my_perm` 只有 read/write，分不出主人）；
改共享只允许主人（422）。

## 验证
- `familybook_push.sh` 全量流水线跑到 v47 停在 1 条失败：
  「③ 选中候选后地点被换成规范地名」—— 因为这条旧契约是 `loc == '万象城 CGV'`，
  而我们现在**有意**写成「名字 · 详细地址」。
  ⇒ 断言**升级**（不是放宽）：既要求名字在前、又要求门牌进来，比原来更严。
- `_fb_v47_addr_sim.py` 复验 **16 / 0**；
  并做注入验证：把 `data-addr-detail="1"` 删掉 → ③ 立刻变红（证明断言真守着）。
- `_fb_v68_addr.py` 三模式 5/0（`--old` 拆掉两处时候选 0 条、`--one` 只拆 layout 仍 5/0）。
- 线上核对：`/api/v1/ledger/1/shares` 返回 **401**（不是 404，路由已生效）。
 2026-10-20 21:35:47 +08:00
laoyang 1bc313adc6 v65+v66 服务端：笔记/纪念日两处数据丢失 + 旅程车辆与节点类型 API 
## v65：两处**静默数据丢失**（网页端凑巧没暴露，走 API 的客户端全中）
1. 笔记：`Note::create()` / `Note::update()` 读的是 **`blocks`**，而 `notes()`
   传的是 `body` ⇒ 新建的笔记**只有标题、一个字都没有**；`PATCH` 只改标题时
   更是把**整条正文的块全删掉**（`update()` 是整组替换）。
   ⇒ 新增 `noteBlocksIn()`：请求给 `blocks`/`body` 就按请求替换，
      都没给（只想改标题/标签）就**沿用库里的块**。
2. 纪念日：`Anniversary::find()` 的 SQL 不含 people，原来那个兜底
   `$cur['people'] ?? []` 恒为空 ⇒ **只改标题的 PATCH 会把关联人全清掉**。
   ⇒ 新增 `annivPeopleOf()` 真去查一次。

## v66：旅程的三项设置接口（端上原来无 API 可调）
- `vehicles`：GET / POST / PATCH / DELETE（`/api/v1/vehicles[/<id>]`）
  · `vehicleUsedCount()`：还有行程在用就不让删
  · `vehicleInput($cur)`：请求优先、缺了沿用库里（部分更新不把别的字段清空）
- `nodeTypes`：同上；列表走 `NodeType::all()`（内部自愈补内置类型）
  · 内置类型不让删（`unprocessable` 422 + 服务端原话，不是 500）
- 两条路由**与 trips 平级**（`case 'vehicles':` / `case 'nodetypes':`）——
  `Api::dispatch()` 只解析 `/<res>/<id>/<sub>` **3 段**，写成 `trips/vehicles`
  会被当成列表请求
- `/ping` 的 features 加 `trips_vehicles` / `trips_nodetypes`（端上可探测老服务端）

## 验证
- `php -l app/ApiHandler.php` 无错
- `familybook_push.sh`：部署完成；线上核对 `vehicles: 1` / `nodetypes: 1`，
  无令牌打 `/vehicles` 回 **401**（不是 404 ⇒ 路由真的存在）
- local smoke：v43…v66 全部版本套件逐个绿（含几何/交互/DAV/vCard）
- ⚠️ 流水线最后三步因**工具问题**假红，已修工具并单独复跑全绿（与本次代码无关）：
  · `_fb_login_api.py` 收尾删自己的 273 文件副本，撞上执行环境的批量删除钩子
    ⇒ 进程被砍、退出码 1。`familybook_push.sh` 现在 `export FB_NO_PURGE=1`
    （副本改名挪走不真删）⇒ 复跑 **30 / 0**
  · `_fb_v57_falsify.py` 只拷 `ets/`，而守卫 v66 起要读 `resources/…/form_config.json`
    ⇒ 副本基线不绿。改成拷整个 `src/main` ⇒ 复跑 **12 / 0**
  · 另两条单独复跑：设备会话接口 **56 / 0**、设备管理网页渲染 **23 / 0**
 2026-10-20 18:32:06 +08:00
laoyang 3459eea8f3 v64：观影豆瓣自动获取 + 海报/多图上传（移动端 API） 
端上「记一场」要与网页端同步实现（用户 2026-10-19 六条），
服务端这一半只加**移动端入口**，网页端（index.php 那条路由）一行没动。

- ApiHandler：新增 `/movies/douban` 子路由（action=suggest / action=thumb /
  默认抓详情+海报落盘），逻辑与网页端 `movies/douban` 逐条对齐；
  新增 `/movies/<id>/poster` 与 `/movies/<id>/photos`（multipart 上传），
  字段名与端上一致（poster / photo）；
  新增 `normalizeFiles()` 把 `photo[]` 的多文件从"按字段竖切"转成"一行一个"；
  `movieData()` 认 `poster_key` 并**校验形态**（只接受 posters/xxx 形式）；
  features 声明 movies_douban / movie_media（端上可探测老服务端）。

- Douban：新增 `apiThumbUrl()` —— 端上打不到 `index.php?r=...`，
  把豆瓣图片代理换成 `/api/v1/...` 形式（拼法只此一处）；
  联想候选带上**过白名单后**的原始图片地址（未过白名单给空串，不下发 SSRF 跳板）。

- Movie：新增 `setPoster()`（单字段更新 —— 端上是"先建记录再传图"两段式，
  用 update() 要拼一份完整草稿，漏一个字段就静默覆盖用户刚填的内容）与
  `addPhotos()`（**追加**语义，与网页表单用的 savePhotos() 替换语义并存不混用）。

验证：接口 e2e 57/0（自带豆瓣 mock，离线可跑）· 反向验证 18/0 ·
本地全量 e2e 1521/0 · 线上部署 + 站点自检 19 条全过 +
`/api/v1/movies/douban` 401（路由通）· ping.features 已含两条新能力
 2026-10-19 23:41:15 +08:00
laoyang 2f7dc6ca23 v63：卡片配色 / 日历本靠右 / 地图题图 / 设置页清理 / 公共标签颜色 / 令牌下线 
- 卡片右上角按钮改用「来自哪个模块」的主题色：HomeCards 登记表新增 mod 字段
  与 module()，首页从登记表取色（原来是模板里硬编码 in_array(['agenda','tasks'])
  白名单，新加带按钮的卡片会默默变灰）
- 首页日程把日历本放到色块右侧：.ag-ev 改弹性行，「时间+标题」包进
  .ag-ev-main（flex:1 1 auto; min-width:0），日历本作右侧兄弟。
  原来 display:block 会把日历本顶到第二行，色块一矮就完全看不见
- 旅程地图显示题图：服务端把 media_url(cover_key) 塞进地图数据，
  地图卡片左侧 40x40 题图（object-fit:cover），没有题图不留灰框
- 系统设置第一块改叫「系统标语」；删掉「首页上那一行小字」提示、
  「不是全家的统一口号」说明、「上次结构升级有步骤失败了」整框；
  运行环境删「排错时看这一块」与「亲属连线」那一行（功能与数据未动）
- 公共标签：说明文字全删；列表与编辑合并成一行（色块+名字+N人+箭头+编辑）；
  person_groups 加 color 列（Schema addColumn，老库可升）；点「编辑」弹框
  改名字与颜色、点「完成」提交；下面那个独立编辑列表撤掉。删除挪进弹框
- 个人设置删掉「手动签发接口令牌」整块；settings/api_token 路由保留但挡下提交
  （只删界面会留下知道地址就能用的后门）；令牌只由登录后自动签发，
  设备管理卡保留。apiTokens/apiPlain/apiLabel/apiBase 四个变量一并撤掉
 2026-10-19 17:27:37 +08:00
laoyang 2e40133d8f v62：影院管理补齐接口（统计 / 年度报告 / 高级搜索）+ 名册带工作经历 
用户 2026-10-19：「设置里面的影院管理，这些功能都还没有，应该补充，
就是增加影院呢、修改影院呢、高级搜索、统计、年度报告，这些全部都应该补充进去。」

一、三个新子路由（都是**家族级**，必须在 `$id > 0` 分支之前处理）

  GET /api/v1/movies/stats   总览 + 按影院 / 按人 / 按月 / 按年
  GET /api/v1/movies/report  年度报告（以登录者为中心，?year= 可切年）
  GET /api/v1/movies/search  片名 / 影院 / 人 / 起止日期的组合搜索

⚠️ 全部复用**网页端那一份 `MovieStats`**（overview/byCinema/byPerson/byMonth/
   byYear/annual/years/search）—— 统计数字两边必须一致，否则用户会发现
   "网页 124 部、App 121 部"。
⚠️ 三个路由都做了 **`$id === 0` 守卫**：`/movies/stats` 不能被当成"id=0 的详情"。
⚠️ `search` 在条件全空时**不查全库**（返回 has_cond=0），与网页 `hasCond` 同行为 —
   否则"搜索"等于"列出全部观影"。

二、features 声明 movies_stats / movies_report / movies_search
    老端上据此隐藏入口（新端上不用探测，但让能力可发现是这套约定的一部分）。

三、名册带 `jobs`（用户：「名册的列表太空了，应该显示更多内容，例如工作单位、职务」）
    新增 `PersonJob::mapFor(array $personIds)` —— **一次 `IN (…)` 批量取回**。
    ⚠️ 不能在装饰循环里逐人 `PersonJob::list()`：名册上千人就是上千次查询（N+1）。
    ⚠️ 排序与 `list()` 逐字一致（当前段在前 → 开始时间倒序 → id 倒序），
       否则"列表显示的单位"和"详情里第一段"会是两个不同的单位。
    ⚠️ 端上列表实际用的是 `persons.org` / `persons.title`（本地库有那两列），
       `jobs` 是给"接口直出"的场景预备的 —— 两条链路都保留。

验证：_fb_v62_cinema_api.py 45/0（独立副本 + 真 MariaDB）；
      覆盖影院 CRUD 10 条 + 统计 8 + 年报 7 + 搜索 7 + 名册带 jobs 4；
      php -l 全量通过。
线上：本提交对应的代码**已在线上**（13:17 那次部署带上去的，非本次操作），
      真机实测统计页显示的是真实数据（横店电影城 4 / 上影影城 3…）。
 2026-10-19 15:27:08 +08:00
laoyang 9a66068c33 v62：纪念日列表修正 / 分类图标与设置菜单 / 首页卡片体系 
- 纪念日列表：display:flex 从 td 移到内层 div（写在 td 上会破坏表格列算法，
  表现为关联人列与其它列高度不一致）；行内列序按表头对齐；
  改完再点「新建」不再带出上次修改的数据；文案改为「与我相关」「来自名册」；
  别人记的、把我挂成关联人的条目一并显示（split() 返回 hiddenIds，
  路由层据此过滤「接下来的日子」，与两张表同一套可见性）
- 分类图标：新增 app/AnnivIcon.php（17 个行内 SVG 图标 + 同 key 的 emoji
  供日历纯文本处使用，内网无 CDN 不用 FontAwesome）；去掉「看日历」按钮；
  设置按钮改为菜单，第一项进 days/settings 独立页；分类可自选图标，
  列表徽标与日历条目都按分类显示
- 首页卡片：新增 app/HomeCards.php 与 templates/home_cards.php；
  8 格宽 × 高 2/4/6/8；首页拆成 templates/home/_card_*.php 共 8 个片段；
  home/cards 可改尺寸、调顺序、开关
 2026-10-19 12:51:17 +08:00
laoyang ad7f43af68 v61：新增账号自助接口（GET /account + POST /account/password） 
端上新增「个人设置」页要用：用户 2026-10-19 要求把抽屉里的
「通知消息 / 个人设置 / 修改密码 / 系统设置」都收进"点右上角头像"那一页，
所以端上必须能自己改密码，不能再指着用户去网页改。

  GET  /api/v1/account            → 我的资料 + 账号信息 + 当前设备
  POST /api/v1/account/password   → 改密码（old_password/password/password2）

规则与网页那条改密码路由逐条对齐（不能端上比网页松）：
  · 必须验旧密码；
  · 两次新密码一致；
  · 过 Account::validatePassword()（≥8 位 + 字母数字都要有）。
额外收紧一条：新密码不能与原密码相同（网页没拦，端上拦了没坏处）。

两处刻意为之：
  · 改密码**不查写权限**（网页那条路由只要求登录，guest 也能改自己的密码）
    —— 加了写权限检查就会出现"网页能改、App 不能改"的权限裂缝；
  · 改完**不动现有令牌** —— 用户在自己手机上改密码不该被踹下线。

features 声明补 account / account_password，端上可探测。

验证：_fb_v61_account_api.py 20/0（独立副本 + 自检 + 随机端口 + 真 MariaDB，
覆盖 5 种错误路径 + 改完旧密码登不进/新密码能登/原令牌仍有效）；
php -l 全量通过；线上部署已完成。
 2026-10-19 12:19:06 +08:00
laoyang 97e963e2ee v59 服务端：标语（个人→家庭→默认）/ 最近纪念日 / 真实头像 
配合端上「界面六条」，服务端只补三样数据：

① Family::slogan(fam, pid) —— 三层优先级
   用户：「如果这个用户自己有标语，他可以写一句自己的标语；如果他有自己的标语，
   这个地方就是用户自己自定义的标语。如果他没有标语，就用我们给他的这个标语。」
   优先级：persons.slogan → families.motto → Family::DEFAULT_SLOGAN。
   DEFAULT_SLOGAN = '一家人用岁月写成的一本书'（用户明确指定，别再改）。
   与网页端 templates/home.php 的 heroSlogan 同一套规则，两边永远一致。
   /login 与 /me 都返回 slogan —— 每次启动都会打 /me，所以网页端改了 slogan
   手机下次启动就跟上，不必为此另加接口。

② /home 新增 recent_days —— 首页「最近纪念日」
   用户：「未来最近的三个纪念日，包括每个人的生日，以及手动填写的各个纪念日。」
   = Anniversary::upcoming(fam, pid, 370) 取前 3。
   · 为什么是 370 天而不是网页端概述卡那样的 30 天：只取 30 天时，
     一个"刚过完生日"的家庭会**一个都取不到**，模块直接空着 ——
     而用户要的是一个永远的倒计时。取满一年保证"接下来的三个"一定有。
   · 数据源 all() = 派生生日 + 自建纪念日（正好覆盖用户说的两样，
     不必再去 Birthday:: 那套单独取一遍，否则迟早口径不一）。
   · 每条带 days（倒计天数）、source（custom / birthday_solar / birthday_lunar），
     顺序由服务端排好（最近的在前），端上不再排一遍。

③ 真实头像
   用户：「右上角的头像应该是真实的。」
   · /home 新增 me_avatar（当前登录者的 avatar_url()）；
   · /login 的 person 增加 avatar_url。
   avatar_url() 负责按线上存储驱动决定走 /uploads 还是 OSS 直链 ——
   端上不自己拼路径（拼错了就是永远破图）。

验证：_fb_home_api.py 60/0（新增 16 条：recent_days 真数据/天数/排序/≤3 条、
me_avatar、slogan 三层优先级实测 —— 给 persons#1 写一句个人 slogan，
必须优先返回他那句）；php -l 通过；部署脚本增「第59批形态」9 条。
真机实测：抽屉显示「修身，齐家」= 杨永全自己的 slogan（个人优先生效）。
 2026-10-18 20:14:50 +08:00
laoyang 9348dd3796 v58：变更指纹接口（端上增量同步的服务端一半） 
用户 2026-10-18：首次全量、之后增量同步；进来先展示本地数据，一边同步
服务器最新数据一边更新（附件走后台队列）。

服务端只补一件事：GET /api/v1/changes —— 每个模块返回一个变更指纹，
端上只做相等比较，不相同才拉。

指纹三件套 COUNT(*) : MAX(id) : MAX(updated_at)：
- 61 张表里只有 16 张有 updated_at，单用它抓不到新增与删除；
- 只有行数则抓不到"改已有行"（靠端上 24h 强制全量兜底，响应带 stale_after_ms）。

CHANGE_TABLES 里 home 故意不在（派生页，端上跟着别的模块重拉）；
kin 与 roster 同源（persons/relations/nicknames），名册一变家谱跟着拉。

必须带令牌（Api::me() 开头）：指纹本身不算机密，但没理由让匿名者试探
"家里有没有新数据"。

验证：_fb_changes_api.py 33/0（新增/修改/删除各自改变指纹、12 模块齐全、
无令牌 401、两设备拿到同一个 all、被踢令牌 401）；本地 e2e 1519/0；
部署静态断言补「第58批形态」8 条；全量流水线 PUSH_RC=0。
 2026-10-18 16:01:08 +08:00
laoyang f513703491 v61 修补：Markdown 引擎回退 7.4 兼容写法（str_contains 线上会白屏） 
部署后拿服务器 PHP 7.4 的 CLI 真跑了一次渲染，当场 Fatal：
`Call to undefined function App\str_contains()`。

- 全站基线是 **0 处 PHP8 函数**（项目一直兼容 7.4）；我新写的表格代码
  引入了 6 处（str_contains×4、str_starts_with、str_ends_with）。
- `php -l` 只查语法——"函数不存在"是运行时错误，部署脚本的"双版本语法检查"
  拦不住这类回归。已改成 strpos/substr 写法，并在部署脚本加了一段
  **74 运行时探针**（真渲染一次表格+任务清单+转义），把这条底线钉死。
- 反向验证的注入锚点跟着源码改写同步更新（case 1/3），基线 30/0、
  锚点注入照样变红。
 2026-10-18 11:35:13 +08:00
laoyang 4c63e42091 v61：笔记补齐成熟软件的块（Markdown 引擎加表格与任务清单，命令表扩全） 
用户反馈：「笔记应该增加更多的块：段落、清单、图片、代码……去查成熟笔记
软件都分哪些块，我们都应该支持。」

对照 Notion / flomo / 思源 / Logseq 的块清单逐项核对（块类型仍只有
段落/图片两种——v29 用户拍板"清单并入 Markdown"），补齐的是
**Markdown 引擎与编辑器到 GFM 关键子集**：

app/Markdown.php
- GFM 表格：表头+分隔行两行联合识别（正文里有竖线不会误判成表格）；
  `:---`/`---:`/`:-:` 左右中对齐；列数向表头看齐（多丢少补，格子不错位）；
  单元格走 inline()（先 htmlspecialchars，`<script>` 只会被画成字面文本）；
  段落收集遇到"紧跟正文的表格"会断开（GFM 不强制空行）
- GFM 任务清单：`- [ ]`/`- [x]` 渲染成**只读**勾选框（笔记不是任务系统，
  能点却不保存是假交互；要勾就改源码里的 x）
- 摘要清洗：表格分隔行/竖线/任务方括号不进列表卡片

assets/js/note_editor.js
- 命令表补齐：H1/H2/H3、有序列表、待办清单、删除线、行内代码、表格模板、
  分割线（工具条与斜线菜单仍是同一份表）
- 🔴 修真 no-op：v29 的"逐行套"写着逐行实际原样返回，选中三行点列表只给
  第一行挂前缀；现在行首记号型命令逐行套（空行跳过）
- 表格模板光标落在第一行数据的第一格，插完可直接打字

templates/notes/form.php：工具条 8→14 键（高频）；全部命令斜线 `/` 可调
assets/css/app.css：.md-table / .md-task 样式（跟主题变量，不写死色）

刻意不做：代码语法高亮（引库=几 MB，用户当年已拍板轻量）、折叠块
（与"逐段编辑"打架，flomo 也没有）、页内子页/数据库（家书没有那个形态）。

验证：_fb_v61_ui.py 真机 30/0（含 XSS 夹具、紧跟正文断段、实时预览同源、
逐段编辑接口、v28 老语法零回退、历史 list 块不丢）；
_b61_falsify.py 8 处注入 8/8 全红在预期断言；回归 b29 38/0、v55 30/0、v60 28/0。
 2026-10-18 11:22:34 +08:00
laoyang ebaed21920 v57：令牌升级为「设备会话」（24h 滑动续期 / 每账号 10 台 / 网页端远程退出） 
用户 2026-10-17 定的模型：
  · 一次登录 = 一台设备一条会话；同一台设备重登，旧令牌立即作废
  · 24 小时滑动续期（一直联网就不用每天输密码）；离线超 24h 只锁界面、不删数据
  · 网页端「个人设置 → 设备管理」能看见都有谁在登录，并能把丢了的那台踢掉
  · 每账号最多 10 台，超了让用户先踢旧的

服务端配套：
  · api_tokens 加 device_id / device_name / platform / app_version / last_ip
    + idx_api_device；历史令牌回填 legacy-<id>（不回填 = 踢不掉的幽灵会话）
  · ApiToken：issueDevice / listDevices / revokeDevice / revokeOthers / revokeCurrent
    + 滑动续期（剩余不足 4h 才写库）；verify 同时返回数字键与关联键（三处调用方在用）
  · 新增 /api/v1/logout、/api/v1/devices；ping 报 features.device_session
  · 登录不再读 days（0 = 永不过期会绕过 24h 这条线）；超限回 409 且**不动任何一行**
  · 老客户端兜底固定槽位 auto-unknown（随机设备号会撞满 10 台把账号锁死）
  · Schema 34 → 35

顺带：首页近期任务/往年的今天（Home::memories）、名册派生字段口径统一。

验证：设备会话探针 56/0、设备管理渲染 22/0、登录全链路 30/0、反向验证 12/0、
      e2e 1519/0、静态断言本地空跑 357/0、线上 /api/v1/{ping,devices,logout} 复核通过。
 2026-10-18 03:34:47 +08:00