laoyang
6ee5662854
用户 2026-10-14 三条。
① 日历本共享弹框「特别慢」—— 真根因 = 选人组件 ×日历本数
用户原话：「设置日历本共享的时候，弹出框特别慢，好像又是 bitwarden 的问题，
需要再彻查一下。」
线上门禁诊断页实测（真实登录态）：
cals=12, roster=800, pp_components=12, html_kb=5876.5,
json_attr_kb=1586.8, noscript_kb=4137.8, inputs=9657, labels=9593
服务端只花 ~70ms ⇒ **慢在浏览器侧**。本地夹具造出同规模复现：
首屏 4086ms / 整页 9.3MB / noscript 文本 6.7MB。
真根因：calendars.php **每本日历**都内联一整套 _person_picker，每个组件把
**全部 800 人**化成 1 份 data-pp-people JSON + 1 份 <noscript> 兜底 ⇒
12 本 = 12 份 ⇒ 近万个表单控件，浏览器/密码管理器逐个扫描。
⚠️ **不是 Bitwarden 独有**（用户怀疑它）——任何遍历 input / 读整页 HTML 的扩展都会中招。
修法：与账目页 #ledPanels / 名册 #rosterMenus 同一套（同类问题第 3 次）——
行上只留 [data-cal-share-open] 按钮，真表单全页唯一一份 #calSharePanel。
线上复验：html_kb 5876.5 → **526.6**、pp_components 12 → **1**、noscript 6.7MB → 0.34MB。
② 点日历带入开始时间失效 —— 真根因是 window.fbSetDT 被提前 return 吞掉
用户原话：「之前这个功能是有的，后来我们改了时间控件之后，这个功能就没有了。」
两层真根因（都在 assets/js/app.js）：
· fbSetDT 定义在 `if (!hasMonth) { … return; }` **之后**（IIFE 尾部）——
日程页首屏没有 input[type=month] ⇒ 直接 return ⇒ 尾部赋值**永不执行**
⇒ setStart() 里 typeof window.fbSetDT === 'function' 为假。（与 v42 修
fbBootAntd 是同一家族：对外接口写在提前 return 之后 ⇒ 静默失效。）
· bindParts() 初始化是"以三个下拉为准"（rebuildDays(true); sync();），而
__fbSyncParts 这个**赋值**写在它们之后 ⇒ 点击带入的 dt-date 被旧下拉盖回。
真浏览器调用栈实测：set date=2026-10-10（setStart）紧跟 set 2026-10-14（sync←bindParts）。
· 第三层：group.__fbRemount 是 v35 的空壳，且 fbSetDT 查找被 data-semi-range-done
门住 —— 日程「结束」默认隐藏 ⇒ upgradeRange 早退、永不设该标记 ⇒
**可见的 antd 控件永不重绘**（隐藏字段对了、用户看到的还是旧值）。
修法：① fbSetDT 提到所有 return 之前；② bindParts 初始化改成**以权威字段 date
为准**（box.__fbSyncParts(); sync();，且赋值顺序提前）；③ antd RangePicker/单点
控件改**受控**（value+状态）、__fbRemount 接成"重读原生值+重绘"、查找不再要求
data-semi-range-done。真浏览器实测：**可见控件**显示 2026-10-10 09:00 / 周视图 15:00。
③ 去掉十字光标
用户：「现在鼠标放在视图上时，变成了一个十字。我感觉这个没必要。」
删 app.css 的 cursor:crosshair 规则；`.rt-writable` 类名**保留**（它是"能不能写"
的 DOM 标记位，_fb_batch_e.py 断言依赖它）。点击建日程的能力**一字不动**。
验证（新增 3 个套件 + 1 个反向验证）：
· _fb_v48_cal.py（12 条，含"**可见的** antd 控件显示值"两条）
· _fb_v48_picker.py（9 条，造 12 本 + 800 人规模，量首屏耗时/整页体积/picker 数）
· _fb_v48_share_e2e.py（4 条，共享真落库 + 权限正确）
· _b48_falsify.py（**6 个注入 / 13 条断言全抓**，含"antd 改回非受控"、
"不接 __fbRemount"、"重现第二份选人组件"）
· 全量 e2e 1510/0、vCard 40/0、几何 428/0、v38/v39/v40/v47 反向验证全绿
· 全流水线 **PUSH_RC=0**；线上四文件 md5 与本地逐字节一致；
线上门禁诊断复验三条修复全部 YES，临时诊断页已删并复验 404
顺带修掉的**工具链自身缺陷**（详见 pitfalls.md）：
· familybook_deploy.sh 有 8 处 `_code_only … | grep -q`，在 `set -o pipefail` 下
会因 SIGPIPE(141) **假红**（本轮缩短了 calendars.php 上半段就触发）。
新增 `_code_has <file> <str>`（先落盘再 grep，不走管道）全部换掉。
· v40 那条"数据丢失级"静态守卫盯的是老字面量 `rebuildDays(true)` —— 改成
接受两种安全形式，行为层最终判据仍在 _fb_b40_movie.py（全绿）。
· 更新 4 个反向验证脚本里因本次重构而失配的锚点（b38/b39/b40 + 新增 b48）。
FamilyBook
家书，记录家庭的全部生活，一本用岁月写成的家谱。
把一个家的「人」「日子」「去过的地方、看过的电影」收进同一本书里。
它是什么
一个自托管的家庭生活系统。它不是又一个待办清单，而是这个家的长期档案 —— 十年之后还能翻出孩子第一次观影的票根、那年暑假走过的路线。
围绕三个圈展开：
- 人：家庭成员、亲友通讯录，以及他们之间的共享关系
- 时间：日历、日程、提醒，以及任务的期限
- 事件：观影、旅行、其他活动 —— 一切都落在同一条时间轴上
它在做什么
| 阶段 | 主题 | 内容 |
|---|---|---|
| 0 | 地基 | 名册、账号、登录、权限模型、安装向导 |
| 1 | 通信 | 通讯录、共享给某个成员、CardDAV 服务端 |
| 2 | 时间 | 日历本、重复日程、提醒、CalDAV 服务端 |
| 3 | 归一 | 观影与旅行迁入统一事件模型 |
| 4 | 任务 | 任务管理，期限自动映射成日历事件 |
| 5 | 回看 | 统计、年度家书、时间轴 |
当前进度：阶段 0 起步，仓库里只有图标与脚手架。
技术选型
- PHP 7.4+（无框架、无 Composer，上传到站点目录即可运行）
- MySQL 5.7+ / 8.0（
utf8mb4） - 前端为原生 HTML / CSS / JavaScript，无构建步骤
⚠️ 注意 CalDAV / CardDAV 是双向协议，和单纯的 .ics 文件导出不是一个量级的东西。
部署
- 把代码放到站点根目录；
- 复制
config.example.php为config.php，填写数据库与app_key； - 访问站点根，按引导页确认 PHP 版本、扩展、配置、数据库连接四项都通过。
config.php 不入库（已在 .gitignore 中忽略），其中包含数据库口令与加密密钥。
⚠️ app_key 一旦开始记录数据就不能再改（换掉即解不开已有数据），
并且它必须单独备份 —— 密钥丢失等同于数据永久丢失。
隐私
身份证号、手机号属于敏感个人信息，一律加密存储。 （就家庭自用而言，身份证号其实没有多少必须存的场景，启用前请三思。）
图标
见 assets/icons/。概念是「这本书就是家」：屋顶即一本摊开的书，
屋顶下纸做的墙上，三行横线是这个家写下的日子。