FamilyBook

laoyang/FamilyBook

Fork 0

Commit Graph

Author	SHA1	Message	Date
laoyang	c8839fa728	v26 第 26 批（5 条）：财务多选按集合取图 / 首页全天置顶与红线定位 / 任务复选框去提示与看板颜色 / 导航搜索引擎切换与站点复用 / 详情页去复选框 - 财务：勾选多个标签时上面那张「总金额」图按选中集合统计（新增 ledger/total_chart 路由 + 单一容器 data-ck-total-host，按集合现取并缓存； Ledger::timeline 第二参数放宽为 string\|array） - 首页日程：全天日程移出滚动容器固定置顶；进场把当前时刻红线居中（scrollTop 计算，不用 scrollIntoView），触发条件不绑 $showNow - 任务：复选框去除 title 提示；看板可设颜色（Task::boardColor/updateBoard），首页任务行用该颜色显示所属看板 - 导航：展示页补回 id=engine-tabs（切换搜索引擎无效的根因）；补内置引擎；新增站点输 URL 可复用他人已加过的站点（sharedByUrl/copyIconFile/adoptSite） - 任务详情页页头去掉复选框（已有「标记完成」按钮）	2026-10-07 15:31:26 +08:00
laoyang	a5e559b2b3	v25 第 25 批（9 条）：名册分组不刷页 / 纪念日多人 / 首页等高 / 移出不回流 / 名册点击看详情拖动才排序 / 任务复选框与状态 / 财务标签多选 / 微信读书同步与统计 / 导航线上数据与图标用户本轮 9 条需求（原话见 templates/ 与 app/ 内的逐条注释）： 1. 名册：列表里给某人分组改为 AJAX 就地挪卡片（不再整页刷新）。 2. 纪念日：关联人改多选（复用 _person_picker，字段 person_ids[]）；自建纪念日的按钮与其它模块统一（改=蓝 .btn、删=黄 .btn-warn）；列表新增「关联人」列并给人名前加头像。 3. 首页：日程/任务两块完全等高（align-items:stretch + 固定总高 + flex 子项 min-height:0）；修「0 件待办」——数字与右侧列表同源（原来各算各的）。 4. 🔴 名册里被移出的人过一阵又回来：根因是 PersonRoster::seedFromPersons() 每次 Schema::ensure() 都无条件重灌（线上实测每跑一次 +1 行）。修：给它加自守卫（只有在 persons 还留着 group_id/sort_order 的老库才跑）。 5. 名册：点击=看详情、只有拖 ⠿ 手柄才是排序（原来整行既能点又能拖，语义混乱）。 6. 任务：所有任务前加复选框，任何位置点勾即完成；状态语义照业界整理为 To Do / Doing / Done 并写出说明（用户要求参考别人的做法）。 7. 财务：类别标签改多选非互斥（再点一次取消该类别），上下两图 + 图例 + 表格全部按同一个集合联动；高亮条刻意不给「合计」（多选下各类金额不能相加）。 8. 微信读书：新增懒同步（访问时顺手做，6h TTL，只补空字段不覆盖用户填的）、封面图拉下来存本站存储（原来只存外链 → 看不到）、接官方 /readdata/detail 统计。 9. 导航：线上数据只搬了一半（5 板块 29 站 → 7 板块 67 站 + 67 图标）、展示页头像不显示 / 搜索按钮错位 / 点登录 404。三个真根因： · 相对地址在 /nav/ 下全 404 → 新增 Nav::abs()； · 搜索容器丢了 id="search"（CSS 是 #search button.submit 绝对定位）； · Nav::iconKey() 与 SimpleNav 的 icon_key() 算法不一致（少一次 md5 归一化） → 搬来的图标文件名对不上；且 uploads/ 整目录 Require all denied。新增两个免登录公开出口 nav_icon.php / nav_avatar.php。顺带修掉一个「数据损坏级」的真 bug（做第 4 条线上反证时发现的，之前一直没人注意）： app/Region.php 三处用中文标点当 trim/ltrim 的 charlist，而 PHP 的 charlist 是按字节匹配的 —— 「。」= E3 80 82 → 字节 82 进了可剥集合 → 「层」= E5 B1 82 被切掉尾字节 → 非法 UTF-8 → backfillAddress 的 UPDATE 报 `1366 Incorrect string value` → 地址拆分升级从上线起一直在失败被跳过（每请求报一次）。改成字符级 preg_replace('/…/u')；线上实测 ensure() 现在无报错、待拆行数真的在下降。验证战绩： - e2e 1289/0（新增 Region 字节级用例等） - 真机探针：选人 19/0 · 首页/导航 24/0 · 导航模块 34/0 · b18 暂存+确定 10/0 · 第23批 52/0 - 桌面几何 428/0 · 移动端几何 680/0 · 交互 92/0 · 窄屏 24/0 - 老库升级 153/0（含 anniversary_people 迁移 + 「再跑 ensure() 名册行数不变」） - 部署静态断言 180 OK / 0 FAIL · 反向验证 3/3 + Region 三变体各被两条断言同时抓住 - 线上 26 个文件与本地逐字节一致；展示页 200、图标 66/66 200、登录 200、越权/不存在均 404、签发短语后 ensure() 不再报错。	2026-10-07 11:35:31 +08:00
laoyang	09e30d27d4	v24 第 24 批：选人冲掉已有成员 / 首页改版 / 个人导航 / 微信读书 / 财务图用户 6 条原话（要点）： ①「选择名册里面人员的那个弹出框有个问题，就是会把页面里面已有的人员给冲掉。比方说电影里面的观影人或者是旅程里面的参与人…这是一个 bug 应该通篇检查。」并按「输入拼音 → 空格选中第一个 → 输入框清空回焦 → 再输下一个 → 回车=确定」重做交互。 ② 首页简要信息改成：问候 + 姓名 + 日期 + 星期 + 农历 + 节气/节日/纪念日/生日，下面「今天几条日程 / 几件待办」，天气彩色图标放最右侧，温度风力，最下面地址。 ③「家里的镜框这里呃全部不要了」→ 删模块卡片墙 + 未来七天；日程与任务左右各半、高度固定、内部滚动且不显滚动条；日程掐头去尾 + 当前时刻红线；任务显示标题+状态+所在看板名；最下面往年的今天。 ④「把个人导航项目完整搬过来，放在读书后面」；免登录展示页 `/nav/?<短语>`；右上角给登录入口；展示页头像用用户自己的头像。 ⑤ 读书加笔记 + 导入微信读书笔记（用户明确「用微信读书 api key」）。 ⑥ 财务页第二张多线图不随类别标签筛选。用户拍板（AskUserQuestion）：① 首页删「模块卡片墙 + 未来七天」两块； ② 微信读书用官方 API Key；③ 导航短语「自己起名 + 可一键换随机码」都做； ④ 6 条一次做完再上线。 ════ 一、 🔴 第 1 条：复现出的真 bug（全站性）════ 根因：选人清单是打开弹框时才建 DOM（懒建，为性能），而承载"已选"的 checkbox 就在那份清单里 → 没打开过弹框就提交时表单里一个值都没有 → 后端把"表单里没有 attendees"理解成"用户要把人全删掉" → 静默清空。实测复现：库里同行人 `2,3,4` → 只改标题保存后变成 NULL。修法：模板加承运字段（`.pp-carry` 隐藏 input，承载当前已选）； JS 建清单时撤掉它（否则同一个 name 会带两份值）。 ⚠️ 裸 POST（完全不带 attendees）本来就该清空 —— 那是显式地"不选任何人"，所以断言也必须照着"浏览器实际提交的样子"（带承运字段）来测。键盘流程（用户第 1 条后半）：空格 = 选当前可见列表里第一个还没选的（⚠️ 必须跳过已选中的 —— 否则会把它取消，与"我要选人"正好相反，本轮真机跑出来的缺陷）；选中后清空输入框 + 光标回输入框；回车 = 确定。空格必须 `preventDefault` （否则输入框里多一个空格字符）。覆盖范围：4 个多选（`attendees[]` / `members[]` / `shares[]` / 修订 `members[]`） + 全部单选（归属人 / 负责人 / 纪念日人等）。 ════ 二、首页改版（第 2、3 条）════ 自上而下只有三块： ① 信息面板：问候（早/中/晚 + 姓名）→ 日期 / 星期 / 农历 → 日子标记（法定节假日 / 节气 / 传统节日 / 纪念日 / 生日，各一色） → 今日数字（今天几条日程、几件待办）｜最右：彩色天气图标 + 温度 + 风力 + 地址 ② 日程 / 任务左右各半（各 360px 固定高、内部滚动、不显滚动条三套写法）日程是日视图形式的刻度、掐头去尾（首末日程前后各 1h）、当前时刻红线任务是标题 + 状态 + 看板名 + 截止 ③ 往年的今天新增 `Home::todayMarks()`（把五类来源合成一句话："今天是国庆节 · 大暑"）与天气的 `tone` 色调档（彩色图标靠 CSS 上色，不用 emoji —— 避免旧系统豆腐块）。删掉：`mod-cards` 模块卡片墙、`未来七天`。 ════ 三、个人导航（第 4 条，SimpleNav 完整搬运）════ `app/Nav.php`（4 张 `nav_` 表 + 稀疏排序 + 短语）· `app/NavFetch.php` （抓取与图标生成，27KB，从原项目 functions.php 机械搬运，原文那批"线上实测"注释全部保留） · `nav_show.php`（全站唯一免登录页）· `nav_suggest.php`（联想代理，凭短语门禁） · `templates/nav/index.php`（管理页：板块/站点/引擎/设置 + 拖拽排序）。搬运只改两处（不改会坏）：① 独立 SQLite → 家书的 MySQL；② 所有查询加 `person_id`* （原项目是单用户系统，不加这一维全家人会共用同一份导航）。免登录展示页：`/nav/?<短语>`（也认 `/nav/?<短语>` 不带参数名）；短语用户自起名（4~32 位字母数字`_-`，全局唯一、保留词拦截）或一键换随机码；右上角登录入口（进家书登录页）；头像用他自己的头像；空态给一句话。路由三处同步（`router.php` / `.htaccess` / 部署脚本 5c 独立标记块）—— 这是本仓库第三次复用这条规律：每加一个"站根上的独立入口"，就必须是自己的标记块。 ⚠️ 线上重写规则顺序有语义：`^nav/suggest\.php$` 必须在 `^nav/?$` 之前（后者会把前者吞掉）。 ════ 四、微信读书（第 5 条）════ 用户提示「用微信读书 api key」是对的 —— 我的知识过时了：2026 年官方已开放（网关 `POST https://i.weread.qq.com/api/agent/gateway`、`Bearer wrk-` 认证、接口 `/user/notebooks`（游标 lastSort 分页）、`/book/bookmarklist`、 `/review/list/mine`、`/book/chapterinfo`）。 `app/WeRead.php`：Key 用 `Crypto::encrypt` 加密落库、界面只回显掩码（官方原话：这串 Key 等价于账号凭据）；导入走「拉预览 → 勾选 → 导入」，落 `book_notes`（去重 = kind + 内容 + 位置）。 ⚠️ 业务参数必须平铺在顶层，不能包进 `params`（官方文档专门列了这个反例）。另一条路「手动粘贴」保留（`books/notes_import`，早已有）。 ════ 五、财务第二张图（第 6 条，上一批我引入的 bug）════ `g.hidden = true` 对 SVG 的 `<g>` 无效（它没有 `hidden` 属性）→ 线条一条都没被藏；而我的探针也读同一个属性 → 两边一起绿（假绿）。改为 `style.display`（恢复用 `''` 而不是 `'block'`）；探针改读 `getComputedStyle(el).display !== 'none'`（落在渲染结果上）。 ⚠️ "探针与实现读同一个属性"是互相掩盖的典型，比单纯写错断言更危险。 ════ 六、验证 ════ e2e 1218/0（本批新增 102 条）· 真机探针 19/0（选人）+ 24/0（首页/导航） + 34/0（导航模块）· 桌面几何 0 失败 · 移动端几何 674/0 · 老库升级 149/0 · 部署静态断言空跑 310/0 · 反向验证 13/13（逐条改回旧行为，点名断言都变红） · 线上验收：9 个新文件全在、4 张 nav 表建好（schema_version=24）、三条重写规则顺序正确、免登录页 / 空短语 / 错短语 / 联想门禁全部响应正确。 ════ 七、本批的"夹具与断言"教训（都写进注释了）════ · `calendar_events.all_day` 默认值是 1 → 插夹具不写它就成了全天事件 → `time` 被抹成 `''` → "刻度掐头去尾"看着像没做（白查三轮）。 · 日历本要挑 `kind='custom'`（我原以为"普通本没有 kind"，实际普通本就是 custom）。 · 量"同高/同排"要拿内容区（去 padding）比，不能拿 border-box（`.topline` 有 14px 上内边距）。 · 判据不能把边界上的正确行为当 bug（22 点有日程时末刻度就是 23:00）。 · 「HTML 写了、CSS 没写」e2e 永远查不出来 —— 导航展示页的登录按钮就落到了左边（实测按钮右 116px / 整行右 1210px），只有真机量几何才抓得到。 · 反向验证里 e2e 会重铺副本把注入覆盖掉 → 给 e2e 加了 `FB_PATCH_FILE` 钩子（重铺完自动打补丁），13 例里 8 例"没牙齿"其实是这个假象。 ════ 八、新增/改动文件 ════ 新增：`app/Nav.php` · `app/NavFetch.php` · `app/WeRead.php` · `nav_show.php` · `nav_suggest.php` · `templates/nav/index.php` · `templates/books/weread.php` · `assets/css/nav-show.css` · `assets/js/nav-show.js` 改动：`app/Schema.php`（v24 + 4 张 nav 表）· `app/Module.php`（+nav）· `app/Home.php` · `index.php` · `templates/_person_picker.php` · `assets/js/person_picker.js` · `templates/home.php` · `templates/ledger/index.php` · `templates/books/_settings_menu.php` · `assets/css/app.css` · `router.php` · `.htaccess`	2026-10-07 05:52:40 +08:00

Author

SHA1

Message

Date

laoyang

c8839fa728

v26 第 26 批（5 条）：财务多选按集合取图 / 首页全天置顶与红线定位 / 任务复选框去提示与看板颜色 / 导航搜索引擎切换与站点复用 / 详情页去复选框

- 财务：勾选多个标签时上面那张「总金额」图按**选中集合**统计（新增
  ledger/total_chart 路由 + 单一容器 data-ck-total-host，按集合现取并缓存；
  Ledger::timeline 第二参数放宽为 string|array）
- 首页日程：全天日程移出滚动容器固定置顶；进场把当前时刻红线居中
  （scrollTop 计算，不用 scrollIntoView），触发条件不绑 $showNow
- 任务：复选框去除 title 提示；看板可设颜色（Task::boardColor/updateBoard），
  首页任务行用该颜色显示所属看板
- 导航：展示页补回 id=engine-tabs（切换搜索引擎无效的根因）；补内置引擎；
  新增站点输 URL 可复用他人已加过的站点（sharedByUrl/copyIconFile/adoptSite）
- 任务详情页页头去掉复选框（已有「标记完成」按钮）

2026-10-07 15:31:26 +08:00

laoyang

a5e559b2b3

v25 第 25 批（9 条）：名册分组不刷页 / 纪念日多人 / 首页等高 / 移出不回流 /

名册点击看详情拖动才排序 / 任务复选框与状态 / 财务标签多选 / 微信读书同步与统计 /
导航线上数据与图标

用户本轮 9 条需求（原话见 templates/ 与 app/ 内的逐条注释）：

1. 名册：列表里给某人分组改为 AJAX 就地挪卡片（不再整页刷新）。
2. 纪念日：关联人改**多选**（复用 _person_picker，字段 person_ids[]）；
   自建纪念日的按钮与其它模块统一（改=蓝 .btn、删=黄 .btn-warn）；
   列表新增「关联人」列并给人名前加头像。
3. 首页：日程/任务两块**完全等高**（align-items:stretch + 固定总高 + flex 子项
   min-height:0）；修「0 件待办」——数字与右侧列表同源（原来各算各的）。
4. 🔴 名册里被移出的人过一阵又回来：根因是 PersonRoster::seedFromPersons()
   **每次 Schema::ensure() 都无条件重灌**（线上实测每跑一次 +1 行）。
   修：给它加自守卫（只有在 persons 还留着 group_id/sort_order 的**老库**才跑）。
5. 名册：点击=看详情、**只有拖 ⠿ 手柄**才是排序（原来整行既能点又能拖，语义混乱）。
6. 任务：所有任务前加复选框，任何位置点勾即完成；
   状态语义照业界整理为 To Do / Doing / Done 并写出说明（用户要求参考别人的做法）。
7. 财务：类别标签改**多选非互斥**（再点一次取消该类别），上下两图 + 图例 + 表格
   全部按同一个集合联动；高亮条刻意不给「合计」（多选下各类金额不能相加）。
8. 微信读书：新增**懒同步**（访问时顺手做，6h TTL，只补空字段不覆盖用户填的）、
   封面图**拉下来存本站存储**（原来只存外链 → 看不到）、接官方 /readdata/detail 统计。
9. 导航：线上数据只搬了一半（5 板块 29 站 → 7 板块 67 站 + 67 图标）、
   展示页头像不显示 / 搜索按钮错位 / 点登录 404。三个真根因：
   · 相对地址在 /nav/ 下全 404 → 新增 Nav::abs()；
   · 搜索容器丢了 id="search"（CSS 是 #search button.submit 绝对定位）；
   · Nav::iconKey() 与 SimpleNav 的 icon_key() **算法不一致**（少一次 md5 归一化）
     → 搬来的图标文件名对不上；且 uploads/ 整目录 Require all denied。
   新增两个**免登录公开出口** nav_icon.php / nav_avatar.php。

顺带修掉一个「数据损坏级」的真 bug（做第 4 条线上反证时发现的，之前一直没人注意）：
app/Region.php 三处用中文标点当 trim/ltrim 的 charlist，而 PHP 的 charlist 是
**按字节**匹配的 —— 「。」= E3 80 **82** → 字节 82 进了可剥集合 →
「层」= E5 B1 **82** 被切掉尾字节 → 非法 UTF-8 → backfillAddress 的 UPDATE 报
`1366 Incorrect string value` → **地址拆分升级从上线起一直在失败被跳过**（每请求报一次）。
改成字符级 preg_replace('/…/u')；线上实测 ensure() 现在无报错、待拆行数真的在下降。

验证战绩：
- e2e 1289/0（新增 Region 字节级用例等）
- 真机探针：选人 19/0 · 首页/导航 24/0 · 导航模块 34/0 · b18 暂存+确定 10/0 ·
  第23批 52/0
- 桌面几何 428/0 · 移动端几何 680/0 · 交互 92/0 · 窄屏 24/0
- 老库升级 153/0（含 anniversary_people 迁移 + 「再跑 ensure() 名册行数不变」）
- 部署静态断言 180 OK / 0 FAIL · 反向验证 3/3 + Region 三变体各被两条断言同时抓住
- 线上 26 个文件与本地**逐字节一致**；展示页 200、图标 66/66 200、登录 200、
  越权/不存在均 404、签发短语后 ensure() 不再报错。

2026-10-07 11:35:31 +08:00

laoyang

09e30d27d4

v24 第 24 批：选人冲掉已有成员 / 首页改版 / 个人导航 / 微信读书 / 财务图

用户 6 条原话（要点）：
  ①「选择名册里面人员的那个弹出框有个问题，就是会把页面里面已有的人员给冲掉。
     比方说电影里面的观影人或者是旅程里面的参与人…这是一个 bug 应该通篇检查。」
    并按「输入拼音 → 空格选中第一个 → 输入框清空回焦 → 再输下一个 → 回车=确定」重做交互。
  ② 首页简要信息改成：问候 + 姓名 + 日期 + 星期 + 农历 + 节气/节日/纪念日/生日，
     下面「今天几条日程 / 几件待办」，天气**彩色图标**放**最右侧**，温度风力，最下面地址。
  ③「家里的镜框这里呃全部不要了」→ 删模块卡片墙 + 未来七天；日程与任务**左右各半**、
     高度固定、内部滚动且**不显滚动条**；日程**掐头去尾** + 当前时刻**红线**；
     任务显示标题+状态+**所在看板名**；最下面往年的今天。
  ④「把个人导航项目完整搬过来，放在读书后面」；免登录展示页 `/nav/?<短语>`；
     右上角给**登录**入口；展示页头像用**用户自己的头像**。
  ⑤ 读书加笔记 + 导入微信读书笔记（用户明确「**用微信读书 api key**」）。
  ⑥ 财务页第二张多线图不随类别标签筛选。

用户拍板（AskUserQuestion）：① 首页删「模块卡片墙 + 未来七天」两块；
② 微信读书用官方 API Key；③ 导航短语「自己起名 + 可一键换随机码」都做；
④ 6 条一次做完再上线。

════ 一、 🔴 第 1 条：复现出的真 bug（全站性）════
**根因**：选人清单是**打开弹框时才建 DOM**（懒建，为性能），而承载"已选"的
checkbox 就在那份清单里 → **没打开过弹框就提交**时表单里一个值都没有 →
后端把"表单里没有 attendees"理解成"用户要把人全删掉" → **静默清空**。
实测复现：库里同行人 `2,3,4` → 只改标题保存后变成 **NULL**。

修法：模板加**承运字段**（`.pp-carry` 隐藏 input，承载当前已选）；
JS 建清单时**撤掉**它（否则同一个 name 会带两份值）。
⚠️ 裸 POST（完全不带 attendees）**本来就该清空** —— 那是显式地"不选任何人"，
所以断言也必须照着"浏览器实际提交的样子"（带承运字段）来测。

**键盘流程**（用户第 1 条后半）：空格 = 选**当前可见列表里第一个还没选的**
（⚠️ 必须跳过已选中的 —— 否则会把它**取消**，与"我要选人"正好相反，本轮真机跑出来的缺陷）；
选中后清空输入框 + 光标回输入框；回车 = 确定。空格必须 `preventDefault`
（否则输入框里多一个空格字符）。

覆盖范围：4 个多选（`attendees[]` / `members[]` / `shares[]` / 修订 `members[]`）
+ 全部单选（归属人 / 负责人 / 纪念日人等）。

════ 二、 首页改版（第 2、3 条）════
自上而下只有三块：
  ① 信息面板：问候（早/中/晚 + 姓名）→ 日期 / 星期 / 农历 → 日子标记
     （法定节假日 / 节气 / 传统节日 / 纪念日 / 生日，各一色）
     → 今日数字（今天几条日程、几件待办）｜ **最右**：彩色天气图标 + 温度 + 风力 + 地址
  ② 日程 / 任务 **左右各半**（各 360px 固定高、内部滚动、**不显滚动条**三套写法）
     日程是**日视图形式的刻度**、**掐头去尾**（首末日程前后各 1h）、**当前时刻红线**
     任务是标题 + **状态** + **看板名** + 截止
  ③ 往年的今天

新增 `Home::todayMarks()`（把五类来源合成一句话："今天是国庆节 · 大暑"）与
天气的 `tone` 色调档（彩色图标靠 CSS 上色，**不用 emoji** —— 避免旧系统豆腐块）。
删掉：`mod-cards` 模块卡片墙、`未来七天`。

════ 三、 个人导航（第 4 条，SimpleNav 完整搬运）════
`app/Nav.php`（4 张 `nav_*` 表 + 稀疏排序 + 短语）· `app/NavFetch.php`
（抓取与图标生成，27KB，从原项目 functions.php 机械搬运，**原文那批"线上实测"注释全部保留**）
· `nav_show.php`（**全站唯一免登录页**）· `nav_suggest.php`（联想代理，凭短语门禁）
· `templates/nav/index.php`（管理页：板块/站点/引擎/设置 + 拖拽排序）。

搬运只改两处（不改会坏）：① 独立 SQLite → 家书的 MySQL；② **所有查询加 `person_id`**
（原项目是单用户系统，不加这一维全家人会共用同一份导航）。

免登录展示页：`/nav/?<短语>`（也认 `/nav/?<短语>` 不带参数名）；
短语用户自起名（4~32 位字母数字`_-`，全局唯一、保留词拦截）或一键换随机码；
右上角**登录**入口（进家书登录页）；头像用**他自己**的头像；空态给一句话。

路由三处同步（`router.php` / `.htaccess` / 部署脚本 5c **独立标记块**）——
这是本仓库第三次复用这条规律：**每加一个"站根上的独立入口"，就必须是自己的标记块**。
⚠️ 线上重写规则**顺序有语义**：`^nav/suggest\.php$` 必须在 `^nav/?$` 之前
（后者会把前者吞掉）。

════ 四、 微信读书（第 5 条）════
用户提示「用微信读书 api key」是对的 —— **我的知识过时了**：2026 年官方已开放
（网关 `POST https://i.weread.qq.com/api/agent/gateway`、`Bearer wrk-` 认证、
接口 `/user/notebooks`（游标 lastSort 分页）、`/book/bookmarklist`、
`/review/list/mine`、`/book/chapterinfo`）。

`app/WeRead.php`：Key 用 `Crypto::encrypt` **加密落库**、界面只回显掩码
（官方原话：这串 Key 等价于账号凭据）；导入走「拉预览 → 勾选 → 导入」，
落 `book_notes`（去重 = kind + 内容 + 位置）。
⚠️ 业务参数必须**平铺在顶层**，不能包进 `params`（官方文档专门列了这个反例）。
另一条路「手动粘贴」保留（`books/notes_import`，早已有）。

════ 五、 财务第二张图（第 6 条，**上一批我引入的 bug**）════
`g.hidden = true` 对 **SVG 的 `<g>` 无效**（它没有 `hidden` 属性）→ 线条一条都没被藏；
**而我的探针也读同一个属性** → 两边一起绿（假绿）。
改为 `style.display`（恢复用 `''` 而不是 `'block'`）；探针改读
`getComputedStyle(el).display !== 'none'`（落在**渲染结果**上）。
⚠️ "探针与实现读同一个属性"是**互相掩盖**的典型，比单纯写错断言更危险。

════ 六、 验证 ════
e2e **1218/0**（本批新增 102 条）· 真机探针 **19/0**（选人）+ **24/0**（首页/导航）
+ **34/0**（导航模块）· 桌面几何 0 失败 · 移动端几何 674/0 · 老库升级 149/0
· 部署静态断言空跑 **310/0** · **反向验证 13/13**（逐条改回旧行为，点名断言都变红）
· 线上验收：9 个新文件全在、4 张 nav 表建好（schema_version=24）、
  三条重写规则顺序正确、免登录页 / 空短语 / 错短语 / 联想门禁 全部响应正确。

════ 七、 本批的"夹具与断言"教训（都写进注释了）════
· `calendar_events.all_day` **默认值是 1** → 插夹具不写它就成了全天事件 →
  `time` 被抹成 `''` → "刻度掐头去尾"看着像没做（白查三轮）。
· 日历本要挑 `kind='custom'`（我原以为"普通本没有 kind"，实际**普通本就是 custom**）。
· 量"同高/同排"要拿**内容区**（去 padding）比，不能拿 border-box（`.topline` 有 14px 上内边距）。
· 判据不能把**边界上的正确行为**当 bug（22 点有日程时末刻度**就是** 23:00）。
· 「HTML 写了、CSS 没写」e2e 永远查不出来 —— 导航展示页的登录按钮就落到了左边
  （实测按钮右 116px / 整行右 1210px），只有真机量几何才抓得到。
· 反向验证里 e2e 会**重铺副本**把注入覆盖掉 → 给 e2e 加了 `FB_PATCH_FILE` 钩子
  （重铺完自动打补丁），13 例里 8 例"没牙齿"其实是这个假象。

════ 八、 新增/改动文件 ════
新增：`app/Nav.php` · `app/NavFetch.php` · `app/WeRead.php` · `nav_show.php` ·
`nav_suggest.php` · `templates/nav/index.php` · `templates/books/weread.php` ·
`assets/css/nav-show.css` · `assets/js/nav-show.js`
改动：`app/Schema.php`（v24 + 4 张 nav 表）· `app/Module.php`（+nav）· `app/Home.php` ·
`index.php` · `templates/_person_picker.php` · `assets/js/person_picker.js` ·
`templates/home.php` · `templates/ledger/index.php` · `templates/books/_settings_menu.php` ·
`assets/css/app.css` · `router.php` · `.htaccess`

2026-10-07 05:52:40 +08:00