fix(已读/文档): 空 reader 报错（把约定变成做错会红）；P6 方案补分支声明与可验收性；"与 X 一致"入册

pi 2026-09-14 对 P6 方案的五条，逐条处理（都不改方向）。

1. **§4 已读按读者的强制点** —— 他说得对，但实际情况比他担心的更靠前也更靠后：
   HTTP 层取的是 `user.Username`（**不是请求参数**，所以根本不可能"省略 reader"），
   但 **repo 函数本身接受空串**：`MarkMailRead(ctx, id, reader)` 会照写一行
   `reader_name=''` —— 不属于任何人，却会让"未读"统计出偏差，而且没有任何东西会红。
   已加守卫（空/纯空白 → 报错，不兜底）＋判据（不仅"不许插垃圾行"，且**必须返回错误**；
   另含正例，防止把守卫写成"一律拒绝"）。变异验证：撤掉守卫 → `空 reader（""）必须报错`。
   顺带一条给他的更正：同一个函数结尾还有 `UPDATE mails SET status='read'`（**行级**全局写），
   所以"按读者"这个性质只对**用 `mail_reads` 派生的数据**成立（`CountUnread`/`ListInbox` 是），
   读 `mails.status` 的客户端仍然是邮件级语义 —— 两件事在同一个函数里，容易被看漏。

2. **§2 手势阈值**：核实结果 —— **WebUI 侧没有被任何判据钉住**（`CalendarView.tsx:204`
   裸字面量 `Math.abs(dx) < 40 || Math.abs(dx) < Math.abs(dy) * 1.5 || !fast(600ms)`）。
   所以撤掉"与 WebUI 一致"的写法，改标 **「待两边对齐」**（文档两处），并把他给的推广写成
   规范 `CRITERIA.md` §12：**凡"与 X 一致"的判据，前置条件是 X 侧那个值自己有判据钉住**，
   否则测的是"我抄的那一份" —— 与"两张表各缺一半时必须按 id 联接"同一族。

3. **§1 分支声明（最要紧的一条）**：写进 P6 分期段 —— 本步实现的是**窄屏那条**
   （**容器自身带圆角 + 那一层能裁剪**）；宽屏那条（起始侧/结束侧分开给）**不适用**，
   因为它的理由是"中间是分隔线、四角全给会露底色"，而手机是单栏、中间没有分隔线。
   并写死这句：**"给对边"是跟着"中间有没有分隔线"来的，不是无条件的三件套。**
   同时核实并写清现状：鸿蒙侧**还没有日历页**（全 ets 树无任何 calendar 提及）⇒ P6 是整页新建。

4. **§3 可验收性**：P6 三步各加一列 —— 第 1、2 步**本工作区可验收**（读 `.ets` 层结构），
   并明确"**第 2 步不需要设备，不许登记成 `static` 欠账**"（那会虚增余额）；第 3 步
   **必然进欠账**（要设备：能装、能点），到期前提见探针表。

5. **§5 路由**：不再把 WebUI 改动挂成"等 pi"（他这条链上没有 shell）。按他给的三级路由执行：
   优先在鸿蒙侧引用**已有令牌**解决；必须动 WebUI 时找 gui-lab 或按先例自己改。

docs/HARMONY-ALIGN-PLAN.md

@@ -80,8 +80,32 @@ WebUI 侧踩过这个坑，见 `gateway/handler/permission.go` 的 Note 传递
 取代系统 TabBar。**注意**：视觉验收需要设备或签名 HAP，
 本机 `hdc list targets` 为空 ⇒ 只能保证编译与结构，观感要人眼确认。
 
-**P6 日历**：网格 + 事件读写 + 左右滑动翻页（复用 WebUI 的手势阈值：
-水平 ≥40px、≥1.5× 垂直、<600ms）。这一块最大，单独排。
+**P6 日历**：网格 + 事件读写 + 左右滑动翻页。这一块最大，单独排。
+
+**现状（2026-09-14 核实）**：鸿蒙侧**还没有日历页** —— 全 `ets` 树里没有任何文件提到 calendar。
+所以 P6 是**整页新建**，不是"修形状"；`narrow-layout` 那套口径是用来定"新建时别犯同一个错"的。
+
+**分支声明（pi 2026-09-14 要求先声明，否则会重现上一轮的失败）**：
+本步实现的是**窄屏那条规则** —— **容器自身带圆角 + 那一层能裁剪**（`clip(true)`）。
+宽屏那条（`.cal-panes > :first-child/:last-child` **起始侧/结束侧分开给**）**不适用**：
+它的理由是"两块面板中间是**分隔线**，四角全给会在分隔线两边露底色"，
+而手机是单栏、**中间没有分隔线** ⇒ 照抄会做出"既非窄屏也非宽屏"的形状。
+**一句话："给对边"是跟着"中间有没有分隔线"来的，不是无条件的三件套。**
+（若将来做平板/横屏两栏，那时再引入宽屏那条，并在判据里区分两种形态。）
+
+**每一步"能不能在本工作区验收"（pi 要求逐条标注，避免交付时那句话变成"已记录未验"）**：
+
+| 步骤 | 内容 | 本工作区可验收？ |
+| --- | --- | --- |
+| 第 1 步 | 页面/网格结构（哪些层存在、谁有底色） | ✅ 可验收（读 `.ets` 的层结构与类名联接） |
+| 第 2 步 | **圆角 + 能裁剪 + 给对边** | ✅ **可验收，且不需要设备** —— 只读 `.ets` 的层结构。**不许登记成 `static` 欠账**（那会虚增余额，而它本来就能判） |
+| 第 3 步 | 交互：点某天/翻页/滑动阈值/ics | ⚠️ **必然进 `static` 欠账**（要设备：能装、能点）。到期前提见套件的探针表 |
+
+**手势阈值（pi §2：先证明那个值在 WebUI 侧被钉着，否则"一致"只是当下的巧合）**：
+核实结果 —— **WebUI 侧没有被钉**：`client/electron/src/components/CalendarView.tsx:204`
+是裸字面量 `Math.abs(dx) < 40 || Math.abs(dx) < Math.abs(dy) * 1.5 || !fast`（`fast` = `<600ms`），
+没有任何判据引用这三个数。所以本步**不写"与 WebUI 一致"**：先取鸿蒙侧已合入的值，
+并在本节标 **「待两边对齐」**；要让"一致"成为契约，得先在**两边各自钉住数值本身**（下一步做）。
 
 ## 四、验收纪律（照 WebUI 那套）
 
@@ -176,7 +200,7 @@ WebUI 侧 `npm test` 在 **HEAD 上就是红的**（`test/background.test.mjs`
 | P3 ⚠️ 主体完成 | 授权页：`GET /permission/pending` + `POST /permission/decide` | 未决口径与 WebUI 一致（无 `permission_result`）✅；拒绝可填备注且备注送出 ✅；`expired` 当场说清"这次批准不会恢复原调用" ✅。**未验**：真机上点同意/拒绝后状态是否"立刻变"（判据只钉到"决策后重新拉列表"这一层） |
 | P4 ✅（P4c 上传除外） | 主题/壁纸（`/me/appearance`） | 换账号外观跟随 ✅（缓存键带账号）；服务端无记录时以本地为准 ✅（§7.16）；**预设 6 档都能画出来** ✅、图片壁纸渲染 ✅（§7.17 —— 这一版补的，第一版只有数据没有画面）。**未做**：P4c 上传入口。**未验**：真机观感（配色/对比） |
 | P5 ✅ 主体完成 | 悬浮玻璃导航（取代系统 TabBar） | **已换**：自绘浮动玻璃条 `NavBar`（留白 + 胶囊圆角 + 系统材质），内容按 `currentIndex` 挂载；命中区 ≥44vp（数值在 `NavItems.ts`，判据直接 import）；内容底部让出 76vp（不让位则最后一行压在条底下：看得见、点不到）—— §7.21。判据 6 条全绿、4 种变异都能红。**未验**：玻璃条在真机上的观感（材质浓度/圆角/阴影）、深色主题下的表现、字形图标渲染 —— **原因是环境硬约束**（模拟器要写工作区外 + 审批无人可送 + 许可协议不接受代签），见 §7.21 末节的「视觉验收的实测阻塞」 |
-| P6 ⬜ 未做 | 日历（`/calendar/events`，含 ics 导入导出） | 手势阈值与 WebUI 一致（水平 ≥40px、≥1.5× 垂直、<600ms）。**有意排序**：入口与内容一起上，不留空页签（§7.15） |
+| P6 ⬜ 未做 | 日历（`/calendar/events`，含 ics 导入导出） | 手势阈值**待两边对齐**（水平 ≥40px、≥1.5× 垂直、<600ms 目前只在鸿蒙侧与 WebUI 源码里各写一份，**WebUI 侧没有被判据钉住** ⇒ 现在写"一致"是把巧合当契约）。**有意排序**：入口与内容一起上，不留空页签（§7.15） |
 
 **视觉/交互怎么验**：本机有 `harmony-emu`（实例 `HarmonyPhone`，hdc 在
 `/opt/harmonyos/ohos-sdk/linux/toolchains`），能起来就能截图 + 真点，