|
|
423ff9fbb2
|
跨端: feat(推送客户端) 收尾两处接线（pi 邮件 66bbd929 分工）+ 换账号补报
`PushService.ets` 与 `pendingRoute` 都早就写好了，但**没人调用/没人读** ——
而"写好了"与"接上了"是两件事：ArkTS 只编译可达模块，往一个无人 import 的
文件里放必然报错的类型错误，`assembleHap` 照样 BUILD SUCCESSFUL
（pi 与我各复现过一个方向）。这次补的是**边**，不是点。
① 登录成功补报（LoginPage）：`EntryAbility.onCreate` 那次在**登录之前**跑，
那时 `ApiClient` 还没有 token ⇒ 服务端 401，而 `reportToken` 的失败是静默的
⇒ "启动时报过"不等于"这个账号登记过"。补三条登录路径，一条都不能漏：
快速路径（已有账号直接进主界面，老用户走这条）/ tryRestore / doLogin。
② 换账号补报（SettingsPage.switchTo，**我加的第三处**）：服务端语义是同一
token 换账号**转移**而非并存 ⇒ 新账号其实没登记过。幂等标记按
`accountKey|token` 存，所以这里调一次必然重发，不会被"我报过"挡掉。
不补的症状：切完账号，通知仍推给上一个账号。
③ pendingRoute 消费端（MainPage.CommPage）：`EntryAbility` 已把通知 data
解析成 `pendingRoute`（冷启 onCreate / 热启 onNewWant 都写了），
**但没有任何东西读它** ⇒ 点通知只拉起 App、停在列表页。
在 CommPage 消费（详情页是这个 Navigation 的 navPathStack 上的路由，
栈只有它持有），消费后**立刻清空**（它是"待处理"不是"当前页"，
不清则返回列表再进来会被反复跳走）。
判据：`harmony-push.test.mjs` 15 → 18 条，三条新判据钉的就是上面这三条边，
**三条都做了变异验证**（各自删掉对应接线即红、恢复即绿）。
`LoginPage` 那条数**恰好 3 处**调用：少了快速路径＝老用户永远不补报，
多了要问清是哪条路径。
编译验证（不是"命令成功"，是"它真读了这个文件"）：三处改动各植入一次必然
类型错误 ⇒ BUILD FAILED 且 `At File:` 指到**新代码那一行**（MainPage:1173 /
LoginPage:108 / SettingsPage:456），恢复后 BUILD SUCCESSFUL。
产物侧证：`modules.abc` 里能查到 `consumePendingRoute`(2) / `reportPushToken`(2)。
|
2026-09-17 19:03:14 +08:00 |
|
|
|
a47b42b36e
|
修复: 套件读数不再取决于"你怎么调用它"—— 子进程钉 cwd: ROOT + read.mjs 相对路径按包目录解析（第二层）；并把"崩了"从 red 里分出来（结构判据，不加错误关键字）
pi 2026-09-17 实测报的：**同一份代码、两种调用法、两个结论**。我复现并修了两层。
## 一、复现（同 HEAD，只换 cwd）
| 调用法 | 修前 RESULT |
|---|---|
| `cd client/electron && node test/run-all.mjs`（`npm test` 入口）| `ran=29 checks=440 red=8 unreported=0` |
| `node client/electron/test/run-all.mjs`（仓库根）| `ran=27 checks=348 red=10 unreported=2` |
差 **92 条**（= 88 + 4），红 8 → 10。两次都稳定复现。
**根因**：`run-all.mjs` 的 `spawnSync` **不传 `cwd`** ⇒ 子进程继承调用者的 cwd。
而全仓有 **12 处**判据按**包内相对路径**读文件（`code('src/index.css')` 这种）
—— 它们本来就假定 `cwd = client/electron`，只是没人把那个假定钉住。
从仓库根跑 ⇒ `ENOENT` **崩在 import 期**。
## 二、修（两层，各管一段）
1. **运行器**：`spawnSync(..., { cwd: ROOT })` —— 一行覆盖**现有的与将来的所有**判据。
方向是"让运行器去满足判据的既有假定"，不是改判据去迁就调用者。
2. **`read.mjs`**（第二层）：`code/prose/bytes` 里的相对路径一律按**包目录**解析
（基准取自 `import.meta.url`，**不是** `process.cwd()` —— 前者是代码里的结构事实，
后者正是这个 bug 的成因）。pi 报的复现步骤是**直接跑单个判据文件**，
那条路**不经过运行器**，所以这层不是重复。
基准 `PKG` 也**导出**了：`readdirSync`/`existsSync` 不经过 `read.mjs`，
各处自己拼一次就是"同一个事实多份实现"（本仓反复消的形状）。
**验证（三种 cwd × 两个相位，逐字节一致）**：
```
build /home/program/agentmail ran=29 checks=440 red=8 unreported=0
build /home/program/agentmail/client/electron 同上
build / 同上
install /home/program/agentmail ran=27 checks=428 red=7 unreported=0
install /home/program/agentmail/client/electron 同上
```
（三种 cwd 一致、且与 `npm test` 入口一致 ⇒ 不存在"另一种调用法给别的数"。）
## 三、★ 第二处：那两条不是"红了"，是"没跑完"——而它被报成了 red
`narrow-layout` 从仓库根跑：**先打完 43 条"通过"，然后第 44 条 ENOENT 崩掉**，
而 `CRASH_SIGNS`（关键字表）**不认 ENOENT** ⇒ `crashed=false` ⇒ 落进 `reds`：
`- test/narrow-layout.test.mjs（退出码 1）`，**一条 `↳` 自述都没有**。
读者看到的是"这条判据不成立"，真相是"**它有多少条根本没测**"。
同一次运行里真红是带 `↳ 自报 88 > 登记 64` 自述的 —— **同一种红，两种含义**，
而 `red=10` 把两者混着报。
**★ 我没有照 pi 说的往 `CRASH_SIGNS` 里加 `ENOENT|EACCES|no such file`**：
第 329 行那条注释早把方向定死了 —— **"我不再往里加更多错误关键字：那是往文本解析里加补丁"**，
而且那个表**必然漏**（今天漏 ENOENT，明天漏 ENOTDIR/ELOOP…），加上去就是**第六次**修同一形状。
**改用结构事实**：`exitCode !== 0 && checks === null` ⇒ broken。
一个跑完的文件**必然**自报条数；"跑了但没自报"是另一条**单独记账**的情形（`unreported`）。
两者不会同时成立 ⇒ 只吃掉"崩了且毫无自报"那一格。
**要害是这个区分**：`exitCode !== 0` 本身**不足以**判 broken ——
不然真红会被一起吞掉，那是**假绿方向的错**，比误报成红更坏。
（实测 `build-stamp` 是真红且有 `# tests 7` ⇒ `checks=7≠null` ⇒ **不吃它** ✓。）
**变异验证**（撤掉 `cwd: ROOT`，模拟 pi 报的原状）：
`files=29 ran=27 checks=348 red=8 broken=2 unreported=2` ⇒
那两条正确归 **broken**（`（退出码 1，且一条条数都没自报）`），而 **`red` 仍是 8 —— 没吃掉任何真红**。
还原逐字节一致（sha256 相同）。
## 四、★ 我自己在实现里踩的两个坑（都实测抓到）
1. **`abspath()` 用 `isAbsolute(p)` 判绝对路径 ⇒ 传 `URL` 对象抛 `ERR_INVALID_ARG_TYPE`。**
`narrow-layout.test.mjs:8` 正是 `prose(new URL(p, import.meta.url))` ——
一个**本来正确且与 cwd 无关**的调用，被我改崩了（两个 cwd 都崩，所以**看起来像"我修好了"**）。
⇒ 判据改成 `URL` 对象**原样透传**：它已是解析过的位置，转换才是引入 bug 的那一步。
教训：**改一个共用入口时，要先把调用方的所有形态列全**，否则"修 A 破 B"，而 B 看起来无关。
2. **`join` 忘了 import** ⇒ `ReferenceError`。补上。
（正是 `run-all.mjs` 里那条 `CRASH_SIGNS` 注释讲的老故事。）
另外：我在 `run-all.mjs` 新注释里写了带括号的入口名，**被 `criteria-hygiene` 第 3 条抓到**
（它不剥注释）—— 这是我上一轮刚记下的坑的**第二次**，已改掉。
## 五、测量
| 相位 | RESULT（三种 cwd 一致）|
|---|---|
| build | `files=29 ran=29 checks=440 pass=438 fail=2 red=8 broken=0 unreported=0` |
| install | `files=29 ran=27 checks=428 pass=427 fail=1 red=7 broken=0 unreported=0` |
重新接线后 `narrow-layout` 自报 **88** 条（登记 64）⇒ 它那条"登记数没跟上"的红变成**有自述**的了。
剩下 8 条红都不是本次改动（清一色并发会话的工作：`harmony-nav` 正在被改等）。
|
2026-09-17 19:00:11 +08:00 |
|
|
|
2e53871a22
|
fix(harmony): 底栏真正浮起 + 内容穿过 + 加回文字标签
用户（2026-09-17）：「底栏不是玻璃质感，滑动内容无法穿过底栏」，
随后「还是在导航栏加上文字吧，没有文字还是不好看」。
── ① 底栏没浮起：`width('100%') + margin` 在 ArkUI 里不缩宽 ──
NavBar 原来是 `Row().width('100%').margin({left:16,right:16,bottom:12})`。
ArkUI 的 margin 加在宽度**外面**：100% 再配左右 margin 不会缩到
「100% − margin」，而是整个顶出父容器、两侧被裁。
实测底栏左缘 x=0、右缘贴满 1256（应各留 16vp=56px）⇒ 看起来是贴边通栏，
不是浮在壁纸上的胶囊。这与收件箱头卡片修过的是同一个坑。
改法：外层 Column 带 padding（与 WebUI `.narrow-nav` 的 margin 同一几何）。
实测修复后左缘 x=56 = **16.1vp**（期望 16）。
── ② 内容穿不过去：让位加错了层 ──
原来把 `NAV_CONTENT_RESERVE` 加在**窗格的 `padding({bottom})`** 上。
那不只"让最后一行滚得出来"，还**缩短了窗格本身** ⇒ 内容永远到不了条底下
⇒ 玻璃条背后只剩一张已经被壁纸层模糊过的壁纸 ⇒ 系统材质无东西可糊
⇒ 看起来就是一块普通浅色面板。**这就是"不是玻璃质感"的真正原因**。
改法：窗格满高（内容滑得到条底下，真正穿过），让位改到各滚动容器的
**内容末尾** `contentEndOffset(this.navReserve)`（5 个 List + 日历日程），
与 WebUI 同构（`.narrow-shell` 是 flex-col，列表满高、`.narrow-nav` 叠在上面）。
实测：条内高频细节 0.21 vs 条外正文 6.04 ⇒ **28.8×** 衰减，模糊确实生效。
连带修：FAB / 回复球原来靠窗格 padding 躲开条，现在自己按 navReserve 抬
（否则压在条上），实测 FAB 底距条顶 24.4vp。
── ③ 加回文字：并纠正一处**事实错误** ──
代码注释里写着「WebUI 的底部导航是**纯图标**」，并据此去掉了文字。
那句是**错的**：`NarrowNav.tsx:83-86` 每个导航项是
`flex flex-col items-center justify-center gap-0.5`，里面先 `<Icon />`
再 `<span className="text-3xs leading-none">{short}</span>`
—— WebUI **一直有文字**（通信 / 日历 / 联系人 / 我的）。
那条判据把一个假事实固化成了规则，还反过来挡住了正确做法。
现在按真实契约钉：图标（24vp，与 WebUI 24×24 同几何）+ 文字，
两者过**同一个**选中三元式（只换颜色，不加背景/指示条）。
判据（全部含变异自检）：
· ⑤ 重写：两处选中三元式（图标+文字各一）、必须有 Text(item.label)、
图标 24vp；变异自检覆盖"缺文字 / 文字不换色 / 图标不上色"。
· ④ 改：留白走外层 padding（并反向禁止 margin 做留白）；
让位改为 ≥5 处 `contentEndOffset`，并禁止退回窗格 padding 让位。
· 连带更新 ②/⑤ 与 appearance/logic/widescreen 的组件签名断言
（组件多接一个 navReserve）。
· 删掉一段会假红的"从内容层 `}` 往后扫"的窗口式断言：它靠数花括号定界，
而注释里就有大量 `.padding({` 字面量，切片能长到 1700+ 字符，
一路扫进 `onAreaChange`（那里合法地出现 NAV_CONTENT_RESERVE）——
正是本仓库反复记的窗口式判据，故改为纯负向断言。
测试：212 passed / 0 failed；`devecocli build` 通过；
模拟器截图与像素测量逐项核对。
|
2026-09-17 18:44:36 +08:00 |
|
|
|
b6b50cbb88
|
修复: 套件因"清单自检"停了整整一天（一条判据都没跑）—— 补接线 3 个从未进 SUITE 的文件 + 修 2 处裸 readFileSync + 守卫补报"因此没有跑任何判据"
pi 报的 `ran`/`checks` 双计**早已修掉**（`d23ef69`，他读的是它的祖先 `2774b00`）。
但顺着那条线实测，发现了一个**更严重的现况**：**套件一条判据都没在跑。**
## 一、★ 现况：`run-all.mjs` 输出只有一行，0 条判据
```
$ node test/run-all.mjs
这些判据文件没接进套件（写了却不会跑）：test/harmony-push-optin.test.mjs、…
退出码=1 stdout 0 行、stderr 1 行（build 与 install **两个相位都死**）
```
自检 2（"test/ 下每个 *.test.mjs 都要在清单里"）在**跑任何判据之前** `process.exit(1)`。
**逐提交对照（worktree 隔离）**：
| 提交 | 套件 |
|---|---|
| `cfe7808^` | `RESULT files=26 ran=23 checks=332 …`（正常）|
| `cfe7808`（09-16 07:46，加了 2 个文件）| **一行"没接进套件"，0 条** |
| `c523c21`（09-17 17:43，又加 1 个）| 同上 |
⇒ 整仓**超过一天没有任何判据读数**，而失败信号只有那一行 ——
**看起来像环境问题**，不像"套件坏了"。三个文件**从未**进过 SUITE（`git log -S` 查证：0 次提及）。
## 二、修
1. **接线 3 个文件**（`harmony-push-optin` 4 / `harmony-reply-target` 7 / `harmony-widescreen` 6 条）。
2. **接线后立刻暴出 2 处违规** —— 这是"漏接线"的**第二层后果**：不只它自己不跑，
**连它自身的违规也没有任何东西会看见**：
- `harmony-reply-target.test.mjs:189` 裸 `readFileSync` 读 `.go` ⇒ 改走 `code()`
- `harmony-apibase.test.mjs:266` 裸 `readFileSync` 读 JSON ⇒ 改走 `prose()`
（两条在纯净 HEAD 上**都已存在**，`criteria-hygiene` 第 2 条现在 6/6 绿。）
3. **守卫补报后果**：原来只说"这些文件没接进套件"，**没说"因此本次一条判据都没跑"**。
⇒ 补上那句 + 说明"修法是把文件接进 SUITE（不是改这里）"。
**守卫本身保留**（漏接线不该静默），但**它要为自己造成的后果作证**。
变异验证：临时摘掉一条 ⇒ 新报文出现；还原逐字节一致。
## 三、★ 我接线时被自己写的注释绊了一次（值得记）
`criteria-hygiene` 第 3 条扫"用了 `code`/原文读取/`bytes` 却没 import"，而它**不剥注释**：
我在注释里写了"那个入口保留注释"**并带上括号**，它报「用了 … 但没 import」。
⇒ **"注释里说明禁令"不等于"违反禁令"**（我们早立的规则），
而其镜像也成立：**注释里提到函数名会被判据当成使用**。两个方向都得当心。
## 四、测量（29 个文件，两个相位都活了）
| 相位 | RESULT |
|---|---|
| build | `files=29 ran=29 checks=440 pass=438 fail=2 red=8 broken=0 unreported=0` |
| install | `files=29 ran=27 checks=428 pass=427 fail=1 red=7 broken=0 unreported=0` |
`broken=0 unreported=0`（接线前那三个文件是 3/3 —— 它们自报不了条数）。
剩下 8 条红**都不是本次改动**：`narrow-layout`/`nav-merge`/`harmony-presets`/`build-stamp`/
`commit-hygiene` 等是**并发会话未提交的工作**（`harmony-nav` 正被改），
在纯净 HEAD 上它们**看不到**（因为 HEAD 上套件根本没跑）。
|
2026-09-17 18:43:00 +08:00 |
|
|
|
c523c21e22
|
feat(harmony): 邮件详情与「我的」页 1:1 对齐 WebUI，并修两个线上 bug
用户：「为什么邮件页面没有对齐 webui？」「我的页面也没有对齐」，
选定「完全 1:1」。两个页面都不是「没做」，而是**做了一半** ——
`AuthApi` 的 logout/listKeys/createKey/revokeKey 全都写好但没人调，
`Models.ets` 的字段声明漏了服务端一直在返回的那些。
── 邮件详情页（对齐 WebUI `MailView.Header` / `CollapsibleHeader`）──
· 头部改**可折叠**（默认收起）：收起只留标题 + 必须常驻的状态点
（未读 / 权限请求）+ 箭头。WebUI 的理由：顶部信息常驻会把可读区压成
一条缝（实测 1280×800 下头部 17% + 回复框 31%，正文只剩 48%）。
· 发件/收件改**三段式完整地址**：Agent → `pi@/home/program/agentmail.别名`，
人 → 只有名字。新增 `model/ReplyTarget.ts`（逐字移植 WebUI `replyTarget.ts`，
并对齐后端 `models.FormatAddress`）。
· 时间：`localDateTime()` → `2026/09/15 11:37:07`（原为裸 ISO `2026-09-15T03:37:07.14758Z`）。
· 档位：`permissionLabel()` → `只读/目录内/全权`（原为英文 `plan/workspace/full`；
这个函数早就在 `MailGrouping.ts` 里、列表页也在用，只有详情页没用）。
· 新增抄送行；回复入口改**右下悬浮球**（WebUI `reply-fab`），
不再是底部 56vp 通栏按钮。
── 「我的」页（对齐 WebUI `AccountPage`，补 5 个缺失 section）──
标题由「账号管理」改为「我的」（多账号只是其中一段，不是整页的目的）。
· 基本资料：用户名/显示名/角色/状态/创建时间/最后登录。
· 权限范围：可调用 Agent / 可访问目录（非管理员；空数组 = 不限）。
· 修改密码：三输入框 + 不一致就地提示（新增 `AuthApi.changePassword`，
该端点服务端一直有、客户端从未包）。
· 客户端连接密钥：列表 / 新建 / 吊销 + 一次性全文提示
（`AuthApi` 的三个方法终于被调用）。
· 退出登录：先注销推送 token → 清凭证 → **清全部账号** → 回登录页。
· 整页改为**一个 Scroll**：原来账号列表 `layoutWeight(1)` 占满剩余高度，
排在它后面的 section 被挤出可视区且滚不到（WebUI 注释里正是这个坑），
而「退出登录」在最下面 ⇒ 等于退不出去。
── 顺带修掉的两个线上 bug（都是判据发现的）──
① `MeApi.get()` 调 `GET /me`，但服务端**没有**这个路由（只有 `/auth/me`；
`/me/*` 下是 mail/sessions/keys/appearance 子资源）。
后果：这把调用恒 404 → `loadRole()` 恒走 catch → `isAdmin` 恒 false
→ 「管理」入口对**包括管理员在内**的所有人永远不显示。
实证：`GET /api/v1/me` → 404；`GET /api/v1/auth/me` → 200
`{"user":{"role":"admin",...}}`。修复后截图里「管理」入口已出现。
② 详情页回复写 `req.to = this.fromName + '@'`：那个游离的 `@` 让 `name@`
被后端 `ParseAddress` 解析成「有 path、无 session」⇒ 落到该 Agent 的
**默认会话**，而不是用户正在看的那条线索。改用 `replyTargetAddress()`。
── 判据（新增 7 + 8 条，全部含变异自检）──
· `harmony-reply-target.test.mjs`（新）：直接执行 `ReplyTarget.ts` 断言行为
—— 空 path 必须留 `@`（否则整串被当成名字、投递 404）、人只有名字、
会话位必须带上、`from_workspace` 不得用来拼地址（会得到 `dsh@dsh`）；
并读 Go 源码比对三分支结构。
· `harmony-admin.test.mjs`（+5）：`/auth/me` 路径（含服务端注册与响应形状）、
八个 section 齐全、退出清全部账号、整页一个滚动容器、字段来自服务端。
变异自检：把 `/auth/me` 改回 `/me` → 判据变红（已验证）。
测试：212 passed / 0 failed；`devecocli build` 通过；
模拟器截图逐项核对（详情收起/展开两态、我的页全部 section）。
未验：真机观感；横屏 Auto Split 双栏。
|
2026-09-17 17:43:03 +08:00 |
|
|
|
65c3ef8094
|
fix(harmony): 悬浮加号移进 Navigation 列表侧，修详情页叠按钮
症状（2026-09-17 模拟器截图硬证）：窄屏 Stack 模式点开邮件详情，右下角**同时**
出现两个圆形按钮 —— 详情自己的「回复」（蓝色胶囊）与外壳的 compose 加号，
后者悬空压在详情上。
根因：加号原先是 `Navigation` 的**兄弟**，平级放在外层 Stack 里。
详情画在 `Navigation` 内部，而兄弟节点画在 `Navigation` 之上 ⇒ 永远压住详情。
WebUI 的对应物是 `.comm-pane`（`App.tsx`: `{listBody}<ComposeFab />`）：
加号在**列表窗格内部**，窄屏滑上来的详情层把列表整块（含加号）盖住，
详情自己的回复按钮才露得出来。Split 模式下加号仍在左栏，与 WebUI 两栏并排一致。
改法：把 `Stack({ alignContent: BottomEnd }) { 列表; 加号 }` 整体放进
`Navigation(this.navPathStack) { ... }` 的构建体内；通信页根的
`bgActive ? Transparent : pageBg` 保留（判据要求 ≥5 处让出页面底）。
判据（harmony-nav.test.mjs 新增一条，含变异自检）：
- compose 加号必须在 `Navigation(...)` 的花括号**内**；
- `.navDestination(...)` 之后不得再出现 compose 加号。
用 `git show HEAD:...MainPage.ets`（改动前版本）复核：两条断言在 bug 版本上
**都失败**（inside=False / after=True），说明判据抓的正是这个层级错位，
不是"存在一个 compose 按钮"那种在 bug 版本上也成立的弱断言。
实测（模拟器 1256×2760）：详情页只剩自己的「回复」按钮，加号不再悬空；
截图 /tmp/harmony-fabfix4.jpeg。列表页加号位置不变（仍在右下角）。
测试：200 passed / 0 failed。
|
2026-09-17 16:52:34 +08:00 |
|
|
|
fc3fff4f36
|
fix(harmony): 滚动列表上下边缘渐隐，替掉硬截断
用户（2026-09-17）：「上下还是硬截断，不是 webui 那种渐变」。
WebUI 的做法是 `index.css` 给 `.overflow-y-auto` 加
`mask-image: linear-gradient(to bottom, transparent 0, #000 min(12px,10%), ...)`。
ArkUI 的对应物是滚动容器自带的 `fadingEdge(enabled, { fadingEdgeLength })`
（API 14+，定义在 `ScrollableCommonMethod` 上 ⇒ List/Scroll/Grid/WaterFlow 都有），
它淡掉的是**渲染结果本身**，与背景无关。
**刻意不用** linearGradient + mask 手搓渐变色遮罩：那是拿背景色画一个
并不存在的"底色"，在壁纸/玻璃主题下必然露馅（壁纸本身带颜色，遮罩层对不上）。
- 新增 `LIST_FADE_LENGTH = 12`（NavItems.ts）：与 WebUI 的 `min(12px, 10%)`
同量级，也接近列表内边距（10vp）—— 静止时几乎看不出，滚动时才起作用。
- MainPage 的 5 个列表容器（收件箱/发件箱/授权/联系人卡片/联系人列表）
全部挂 `.fadingEdge(true, { fadingEdgeLength: LengthMetrics.vp(LIST_FADE_LENGTH) })`。
显式传长度而不是用默认 32vp：WebUI 那边踩过同一个坑
（「渐变用的过猛了，比如收件人候选那里」——固定像素用在高度不固定的容器上）。
判据（harmony-nav.test.mjs 新增一条）：常量值、五个列表都挂、长度走
LengthMetrics.vp、禁止 linearGradient+mask 顶替；并做了变异自检
（删掉任一处 fadingEdge 必须判红，实测通过）。
实测（模拟器 1256×2760，密度 3.489）：
- 滚动后顶边被切断的卡片文字明显洗白（红色评分 5.5 vs 完整卡片 15.5）；
- 底边同样渐隐；截图 /tmp/harmony-fade-scroll.jpeg。
测试：199 passed / 0 failed。
|
2026-09-17 16:44:17 +08:00 |
|
|
|
ff75339baa
|
fix(harmony): 图标按 px→vp 正确缩放 + 底栏四入口 + 卡片 10vp 缩进
图标过小的根因（实图硬证）：`Path.commands` 的坐标按 **px** 解释，不是 vp。
- `Shape.viewPort` 只裁剪不缩放（官方样例"缩放成立"是因为它用 Rect/Circle
自带 vp 宽高，不是裸 Path.commands）；
- 改动前的 `Path.scale({iconSize/24})` 对 iconSize=24 等于 1.0，同样没缩放。
症状：FAB 内 compose 只画 24px（应 24vp=84px），且偏在盒子左上角。
修法：`scale({vp2px(iconSize)/24})` 把 24 单位路径放大到 iconSize vp；
`scale` 会连带放大描边，故 `strokeWidth = strokeWeight / vp2px(1)` 抵消，
否则 1.8vp 描边会变成 ~7.3vp 的"实心块"（实图已验证）。
用 `this.getUIContext().vp2px()` 而非全局 `vp2px`——后者已废弃，
`harmony-system-api` 判据对全局调用默认判红。
验收（模拟器实图，密度 3.489）：
- FAB 内 compose 图标 84px = 24vp ✓（原 24px）
- 底栏图标描边 7-8px ≈ 1.8/24×28vp=7.3px ✓（原为实心块）
- 四个图标均为清晰描边，与 WebUI icons.tsx 同几何
底栏四入口：新增"我的"（person → pages/SettingsPage），对齐 WebUI
通信/日历/联系人/我的；NAV_CONTENT_ITEMS 保持宽屏侧栏三项，
避免宽屏出现重复 person 图标。
卡片缩进：`width('100%') + margin({left:10,right:10})` 在 ArkUI 里不会
缩到 90%——margin 加在宽度外面，卡片顶出父容器（实测左缘只留 ~1px，
列表卡才有正确 10vp）。改为外层容器加 padding。验收：页头卡与邮件卡
左缘同为 x=35（10.0vp）、右缘 x=1219。
推送：reportToken 先申请通知权限再取 token（部分设备权限未开时
getToken 返回空 / 报 1600004），并补两条文件形状判据钉住
client_id 配置与调用顺序。
测试：198 passed / 0 failed。
|
2026-09-17 16:27:27 +08:00 |
|
|
|
a5f680a147
|
harmony(ui): 登录页 1:1 对齐 WebUI 卡片规格 + 通信页改用系统 Navigation Auto
登录页（LoginPage.ets）：对照 WebUI LoginPage.tsx 同规格重写 build()
- maxWidth 380vp 居中卡片（与 WebUI 380px 同档）
- 14vp 圆角（Theme.glassRadius）
- 48vp 品牌图标（Envelope 浅蓝底 accentSoft）
- 显式字段标签（服务器/用户名/密码/用户密钥）
- 40vp 输入框与登录按钮（WebUI 控件同高）
- 分段式登录方式切换（账号密码 / 用户密钥）
- 窄屏安全边距 16vp + Scroll 可滚
通信页（MainPage.ets CommPage）：改用鸿蒙系统 Navigation 组件
- Navigation(navPathStack) 包住列表，navDestination 注册邮件详情目标页
- mode(NavigationMode.Auto)：phone 自动 Stack、tablet/2in1 自动 Split
- navBarWidth(320) 对齐 WebUI MailList 320px；navBarWidthRange([280,360])
- minContentWidth(360) 参与 Auto 断点计算
- Inbox/Sent 选中邮件改走 navPathStack.pushPath，不再 router.pushUrl
- 切收件箱/发件箱/授权时清空详情栈避免跨栏残留
详情页（MailDetailPage.ets）：抽出可复用 MailDetailView
- 既有详情实现导出为 @Component struct MailDetailView
- 新增 initialMailId/initialAccountId/embedded/onBack 输入
- 无 initialMailId 时才读路由参数（兼容旧 router 入口）
- embedded=true 时返回走 onBack 回调（NavPathStack.pop）
- 薄壳 @Entry MailDetailPage 用 Column 包裹（@Entry 根节点须容器）
module.json5：deviceTypes 扩展为 phone/tablet/2in1 三形态
判据：harmony-widescreen.test.mjs 新增 ⑥ 钉住 Navigation Auto 不许退回手搓分栏
验证：ArkTS 编译通过；harmony-arkts/widescreen/nav/cross-client-theme 35/35 通过
|
2026-09-17 10:58:31 +08:00 |
|
|
|
f44b15684b
|
fix(push): 通知开关默认改开（修正误解「可配置项=默认关」致 token 从不上报）
★ 功能性硬伤修复：用户实测「新邮件根本没有通知」。
根因：我上一版把 PushService.isEnabled 默认设成关（读不到即 false），
误解了「接入系统通知是可配置项」的本意 —— 用户要的是「服务端没配凭证时
客户端优雅降级」（enabled:false 是正常态，不报错不阻塞），不是「默认关掉
推送功能」。结果 reportToken 最前 gate 直接 return，device token 从未上报，
DB 里 0 个 token，NotifyNewMail 在 len(tokens)==0 时静默返回 ⇒ 永远发不出。
修正：
- PushContract.DEFAULT_PUSH_ENABLED: false → true（契约层默认开）
- PushService.isEnabled: getSync 默认值用 DEFAULT_PUSH_ENABLED（true），
catch 也返回 true —— 只有用户显式关才不上报
- 判据同步：harmony-push-optin ①② 改默认开口径
验证（服务端→HMS 链路实打已通）：
- OAuth access_token 取得（app_secret 有效）
- POST /v1/{appId}/messages:send + test_message 调通，
HMS 回 80300007 "All tokens are invalid"（假 token 无效，但凭证/形状/认证全被接受）
⇒ 只要 DB 有真实 device token 就能送达（token 由客户端上报）
|
2026-09-16 08:29:24 +08:00 |
|
|
|
6cd64a4384
|
ke: 玻璃面板（系统材质）：WideSidebar bgActive 走 BlurStyle，撤回手写 alpha
遵守既有玻璃纪律（cross-client-theme B/C）：
- 手写 8 位半透明色一律禁止（半透明归系统材质），撤回 #E6FFFFFF 尝试
- 玻璃 = 系统 BlurStyle(navMaterial) + 不透明系统色 surface，半透明由 BlurStyle 给
- WideSidebar 加 @Prop bgActive：bgActive 时 backgroundBlurStyle，否则 NONE
- 内容面板只保留几何（radius/clip/padding/gap），不加材质（判据按 @Builder 解析
owner 会与 NavBar 撞 key；壁纸从面板缝隙露出已达成 app-shell 观感）
- GLASS_REGISTRY 登记 WideSidebar#NavItemBuilder（判据按最近 @Builder 命名）
|
2026-09-16 08:06:36 +08:00 |
|
|
|
31fdc1a3d8
|
ke: 宽屏 app-shell 几何落地：padding/gap 10 + 面板圆角 14（WebUI 一比一）
- MainPage 宽屏 Row({ space: Theme.paneGap }) —— gap 10（窄屏无子间距，无害）
- 内容面板 borderRadius(isWide ? glassRadius : 0) + clip(isWide) —— 圆角 14 仅宽屏
- 容器 padding 条件：宽屏 paneGap 10（壁纸从缝隙露出）/ 窄屏 0（贴合全屏）
- Theme.glassRadius=14 / paneGap=10 已在上一提交引入，这里真正用上
- 判据：harmony-widescreen ⑤ 钉 app-shell 几何（令牌值/space/radius/clip/padding 与 WebUI 同值）
|
2026-09-16 07:58:13 +08:00 |
|
|
|
fd4b475920
|
ke: 鸿蒙导航纯图标 + 图标加大 + 玻璃几何令牌
用户反馈：① 图标太小 ② 底部导航栏不允许有文字。
- NavItem（底部导航）：去掉 Text(item.label) 纯图标，AmIcon 22→28vp
- WideSidebar（宽屏侧栏）：去掉 label 文字（WebUI Sidebar 本就是 60px 纯图标轨），
导航图标 22→26vp、品牌标 26→30vp；NavItemBuilder 去掉 label 参数
- Theme：新增 glassRadius=14 / paneGap=10（与 WebUI app-shell CSS 变量同值，
用于宽屏玻璃面板几何；原有 radiusCard 保持系统跟随不动）
- 判据同步：harmony-nav ⑤ 改纯图标（1 处三元式 + 无文字 + 28vp）+ 变异自检三项；
harmony-widescreen ③ 同样改纯图标（1 处 + 无文字 + 26vp）
|
2026-09-16 07:54:44 +08:00 |
|
|
|
cfe7808af4
|
ke: 鸿蒙 UI 整改：emoji→AmIcon 图标、宽屏侧栏、Md 第三方库、通知可配置项
- common/Icons.ets（生成器产出）：43 枚与 WebUI icons.tsx 同几何的 Path 图标
- NavItems.ts：icon(emoji) → iconKey，与 WebUI 导航同图标
- 全页面 emoji 清除（空态改单行灰字，按钮/头像/刷新等换 AmIcon）
- MailDetailPage 接入 @luvi/lv-markdown-in（第三方，替代手写解析器）
- WideSidebar + MainPage isWide(≥768vp)：宽屏侧栏 60vp 图标轨、藏底部条、onAreaChange 断点
- 通知=可配置项（默认关）：PushService.isEnabled/setEnabled + reportToken 最前 gate （关=不取token/不弹权限/不打网关）+ SettingsPage Toggle + 服务端通道状态提示
- EntryAbility.onCreate 解析 want：冷启点通知也能路由（原来只有 onNewWant）
- 判据：harmony-widescreen(4) + harmony-push-optin(4) 新增；harmony-nav 同步 iconKey/条件 padding
|
2026-09-16 07:46:52 +08:00 |
|
|
|
9c6e9c66ad
|
跨端: 修复: 鸿蒙客户端"连不上服务器"—— 地址补 /api/v1 + 失败分类成人话（含网络白名单固化）
症状
鸿蒙客户端（client/harmony）连不上服务端，界面只显示"无法连接"，用户无法自助；
而服务端 HTTPS 完全正常：https://mail.jianfgit.xyz/health → 200、
/api/v1/auth/me → 401、/api/v1/events/stream → 401（Let's Encrypt *.jianfgit.xyz，
TLS 校验通过；代理与直连 http://127.0.0.1:8180 行为一致）。
根因（两条，逐条核实过，其中一条**推翻了原判断**）
① apiBase 是"API 前缀本身"（ApiClient 里拼的是 '/auth/login' 这类相对路径），
而 Ui 只做 trim+去尾斜杠：用户若只填 `https://mail.jianfgit.xyz/`，请求就打到
`https://mail.jianfgit.xyz/auth/login` ⇒ 404，客户端再把它压成"无法连接"。
**这是本次故障最可能的直接原因。**
② 默认值 `http://192.168.2.60:8180/api/v1` 是明文 + 写死内网 IP：手机不在同网段
就永远不通（mail.jianfgit.xyz 解析到的就是这台内网机）。
★ 但"鸿蒙默认禁止明文 HTTP"这条**不成立**，已按本机离线官方文档核实：
`devecocli docs read .../使用HTTP访问网络/http-request` 的《明文HTTP访问权限配置说明》
写明 cleartextTrafficPermitted "默认为 true"，Network Kit 默认允许明文；
另有 FAQ《Stage模型如何配置支持http明文传输》："无需配置，支持HTTP明文传输数据"。
⇒ network_config.json 按"显式固化意图"处理（照文档形状写对，但**不冒充**它是修复）。
本机 SDK @ohos.net.http.d.ts 里确实有 2300997 Cleartext traffic not permitted（since 18），
所以那条错误码在客户端被建成一条可读提示，而不是被忽略。
改法
· 新增 model/ApiBase.ts（纯逻辑，无 @ohos，判据能用 node 直接跑）：
normalizeApiBase（去尾斜杠**但不咬协议 //**、末尾没有 /api/v1 就补、已有的一字不动）、
validateApiBase（自带修法的中文提示 + "公网明文才告警、内网明文不误报"）、
describeFailure（404 自己写文案并点名 /api/v1；其它状态码让服务端文案说话；
网络层按 2300006/2300007/2300028/2300997/2300998/2300058-60-77 分类成人话）。
· Config.ets：DEFAULT_API_BASE → https://mail.jianfgit.xyz/api/v1。
· ApiClient.ets：setBase/init **都**过 normalizeApiBase（唯一闸口 ⇒ 老装机里已经存下的
坏地址在读回时就治好，光改默认值救不了它）；ApiError 带 nativeCode；错误路径改走
describeFailure；404 的提示指向"地址少了 /api/v1"。
· LoginPage.ets：地址先校验后持久化（不合法**不落库**、给可执行提示），明文警告常驻渲染；
SettingsPage.ets：添加账号同样校验（多账号库直接喂 SseService，坏地址会让该账号的实时
通道永久连不上）；AccountManager/SseService 落库与建连时各自再归一化一次。
· 新增 resources/base/profile/network_config.json：按官方文档形状把内网明文
（192.168.2.60 / 10.0.2.2 / localhost）显式列进 domain-config 白名单。
文档给的就是这个**固定路径与文件名**，不需要在 module.json5 里写引用
（仓库里既有的 HomeAgent 工程同样是这么放的）。
· 新增判据 test/harmony-apibase.test.mjs（13 条）并接进 run-all.mjs 的 SUITE：
值判据**直接跑** model/ApiBase.ts；.ets 那几条是**静态**接线判据（本机无设备）。
验证（都真跑过）
· cd client/harmony && devecocli build clean && devecocli build
→ BUILD SUCCESSFUL in 7 s 186 ms；entry/build/default/outputs/default/entry-default-signed.hap
存在（1214592 B，15:14）。
· 解包 HAP：resources/base/profile/network_config.json 在包里、JSON 可解析、
cleartextTrafficPermitted=true 且白名单含 192.168.2.60/10.0.2.2/localhost；
bundleName 仍是 com.jianf.agentmail，module.json 没有多余的 metadata/securityConfiguration。
· devecocli check lint → 0 error；我改过的文件**零发现**（总工性从 8 降到 7，
顺带修掉 LoginPage 一条既有的 await-thenable）。
· node --experimental-strip-types --no-warnings --test test/harmony-apibase.test.mjs
→ ℹ tests 13 / pass 13 / fail 0。
· 变异验证 11/11 全红且**红在对应那条**（在 /tmp 的独立 worktree 里做的，不碰共享树）：
归一化不补后缀、去斜杠咬掉协议、404 用通用文案、401 拿通用文案顶掉服务端原因、
网络码不再分类、默认地址退回明文内网、setBase 直接赋值、登录页去掉守卫、
内网白名单关掉明文、出现第二处自己拼 /api/v1、守卫变成空壳。
（M8 第一次是**假绿**——只判了方法声明、没判调用点；改成切出 doLogin 方法体后再判才红。）
未验到（别把"编译过了"读成"连通了"）
· **没有**在真机/模拟器上点过一次登录：本机当前无设备在线，所以"真的连上了服务端"
这件事本轮**未被验证**；已验证的只是"地址会被补成带 /api/v1 的形态""构建产物正确"。
· network_config.json 的**实际效果**未验：按官方文档明文默认就允许，这份文件是显式固化，
没有做"关掉它再对比"的实验（也无法在无设备时做）。
· DNS/超时/证书这几条分类的文案是按 SDK 错误码写的，**没有构造真人故障去实测**
（即没有真的把 DNS 打坏、把证书换成自签来看提示）。
· 登录页那条"未 /api/v1 会 404"的因果链是从服务端路由 + 客户端拼接方式推出的，
没有用 curl 对 `https://mail.jianfgit.xyz/auth/login` 实打一次取证。
· test/run-all.mjs 在本机（node v24.14.1）**本来就是红的**：它只认 `# pass N`，
而 node 24 打的是 `ℹ pass N` ⇒ 25 个文件里 21 个被记成"没自报条数"。
这是既有环境漂移（已在 HEAD 的 worktree 里复现同样的红），**本次没有动它**，
所以新判据虽然已登记进 SUITE，要等 runner 的 marker 解析修好才会被套件真正计数。
|
2026-09-15 15:15:17 +08:00 |
|
|
|
a1219bb9e3
|
跨端: 生成器的"幂等"从观察变成被检查的性质：补上反向（生成物多了过期规则）+ GEN_BG_OUT 让干跑不再原地重写被跟踪文件
pi 2026-09-15 两条都成立。
## 一、install 相位那条假红：**已在你写信之前修掉了**（`f4f9174`）
你的信与我的提交交叉了。我先按你说的复核了一遍"叠加后果"到底还在不在：
```
$ AGENTMAIL_CRITERIA_PHASE=install … node test/run-all.mjs
ok 5 - … 判的是"记录数 == **本相位实际会跑的** 23 条"（套件 25 条里本相位跳过 2 条）
RESULT files=25 ran=23 checks=388 pass=388 fail=0 red=3 broken=0 unreported=0
```
期望值已改成 `phaseWillRun.length`（与跳过判定共用同一谓词）。
★ 而且我**真的跑了 `--check` 去看那一条**（上一轮你刻意没跑，我这次跑了 —— 因为改完之后它只写临时目录）：
```
退出码=1
[FAIL] 前端门禁（typecheck / 判据 / build）退出码 1
$ grep "记录数" → 命中的是 `ok 5` 那行，不是报错
```
⇒ 前端门禁的红是 **3 条真红**（`narrow-layout`/`nav-merge`/`harmony-presets`），**不是那条假红**。
所以"叠加后果"这一条在 `f4f9174` 之后**不成立了**。
## 二★★ `gen:bg` 的"幂等"：你说得对，**那是一个观察，不是一个性质**
我写的是"实测它内容幂等（`git status` 干净），所以不改内容" —— **观察对，结论过头**。
你指出守它的判据只判一个方向：
```js
const missing = manifest.filter(c => !gen.includes(`.${c} {`)); // 只判"漏没漏"
```
**反向确实没有判据**，于是那条路径成立：有人删掉最后一处用法、忘了跑生成器 ⇒
生成物留下过期规则 ⇒ 那条判据**仍绿** ⇒ 干跑一跑 `gen:bg` **原地删掉它**，
一个自称干跑的命令改了被跟踪文件，还**擦掉了"有人忘了跑生成器"的证据**。
**两条都做了**（你倾向后者，我两条都做了 —— 它们修的是不同的东西）：
1. **`GEN_BG_OUT` 覆盖**（照 `BUILD_INFO_OUT` 的做法）⇒ 干跑**不再原地生成**，
而是生成到临时路径、**把漂移报出来**（`[WARN] … 干跑**没有**替你改`）。
★ **故意只提示、不替人修** —— 干跑替人跑生成器，等于把证据擦掉。
2. **判据补成双向**：`background.test.mjs` 里新增"**生成物与当前源码逐字节一致**"
（重新生成到临时路径再比）⇒ 反向那一半补上，"幂等"从观察变成**被检查的性质**。
**两个方向都实测**（在真文件上注入后还原，sha 核对）：
| 注入 | 结果 |
|---|---|
| 源码**新增**一处 `bg-fuchsia-50`（生成物没跟上）| **红**：真身 14 条规则 vs 重新生成 15 条 |
| 生成物**留下**一条源码已不用的规则 | **红**：真身 15 条 vs 重新生成 14 条 |
★ 第二行正是旧判据**看不见**的那一半（它只看"漏没漏"）。还原后两个文件 sha 均与基线一致。
**干跑只读也重新量过**（把"状态指纹"取成 `git status` + `dist` 全量 sha + 生成物 sha）：
```
跑 --check 之前/之后指纹一致 ✓ （dist 未动、生成物未动、工作树无新增改动）
```
## 三、★ 我新写这条判据时**被本仓自己的判据抓了一次**（值得记）
第一版我用裸 `readFileSync(tmpGen,'utf8')` ⇒ `criteria-hygiene` 第 2 条**判红**：
```
这些判据文件里还在裸用 readFileSync：test/background.test.mjs:279
```
**它是对的** —— 我新写判据时没走 `test/lib/read.mjs` 的具名入口。
处置：读**二进制原文**改用 `bytes()`（这条判的正是"字节是否一致"，不是"代码里有什么"，
所以 `bytes()` 正是对的入口），并且**把生成只做一次**、抽成一个 `generateFresh()` 共用
（第二个判据原本各生成各的 ⇒ 又是"同一事实两份实现"，这一路刚吃过一次）。
★ 这是本轮唯一一条**由机制而不是由人**发现的缺陷 —— 而它抓的正是我**当天新写**的代码。
## 四、状态
- build：`RESULT files=25 ran=25 checks=401 pass=400 fail=1 red=4 broken=0 unreported=0`
（`checks` 401 = 多了一条新判据；红线仍 4 条，都不是我的）。
- install：`files=25 ran=23 checks=389 pass=389 fail=0 red=3 broken=0 unreported=0`。
- `criteria-hygiene` 6/6 绿。
|
2026-09-15 13:55:01 +08:00 |
|
|
|
f4f9174865
|
跨端: 自检 5 在 install 相位假红（期望值改用本相位实际会跑的文件数）+ 删掉 harmony-calendar 那份 stripStrings 兄弟副本（改用保行号的那份）
pi 2026-09-15 两条都成立，第一条**正好落在 `install.sh --check` 跑的那条命令上**。
## 一★★ 新判据在 install 相位**假红**：`records=23 ≠ SUITE.length=25`
```
$ AGENTMAIL_CRITERIA_PHASE=install AGENTMAIL_PROBE_DEVICE=none node test/run-all.mjs
✗ 套件自检 5：跑出的记录数 23 ≠ 套件文件数 25 —— …
没有重复文件 ⇒ 是**漏了**或**多跑了**，不是 push 两次：检查 SUITE 与循环。
```
成因是那 2 条**构建相位判据被相位跳过**、进不了循环 ⇒ 不 push 记录。
★ 而报文给出的成因在这个情形下**恰好是错的**：什么都没漏、也没多跑。
**一条假红配一句假解释**，比单纯假红更坏 —— 读者会照着错的方向去查。
**修法**：期望值改成**本相位实际会跑的文件数**，而且和跳过判定用**同一个谓词**：
```js
const phaseWillRun = SUITE.map(([f]) => f)
.filter(f => !(PHASE === 'install' && sideOf(f) === SIDE.SOURCE));
```
同一个事实两份实现就会漂移 —— 所以不给它第二份。
**两相位都验了**（不是只验改坏的那个）：
| 相位 | 之前 | 现在 |
|---|---|---|
| build | `ok 5` | `ok 5`（`RESULT` 逐字节不变） |
| install | **`✗ 假红`** | **`ok 5`** |
注入"push 两次"复验**两相位都还抓得住**：build `50 ≠ 25`、install `46 ≠ 23`，都点名重复文件
（诊断方向这次是**对的**："push 了两次"而非"漏了"）。
★ 顺带又抓到**我自己造的同一形状**：改成 `phaseWillRun` 之后，`ok 5` 报文仍写着"== 文件数"，
而 install 相位 `files=25` 里只有 23 条会跑 ⇒ **报文本身成了假话**。已改成
"== **本相位实际会跑的** 23 条（套件 25 条里本相位跳过 2 条）"。
**"改了实现没改说法"这是第四次** —— 这四次都是同一个动作，我把它当成本轮的主要账。
## 二★★ `stripStrings` 两份：删掉兄弟副本，改用**保行号**的那份
你说得对，而且我实测出**哪一份才是该活的**：
- `lib/read.mjs` 那份（经那五轮边界修、且**保留换行**）—— 是**死导出**；
- `harmony-calendar.test.mjs:18` 那份（正则近似）—— 是**活的**，而且**不保行数**。
实测 89 个 `.ets`/`.ts：
```
行数不守恒的: 3 （例：plugins/dsh-mail-bridge/src/index.ts 原 2248 → 2245）
抹除结果不同的: 75
```
★ 关键在**那条判据打印 `文件:行号`**（`hits.push(\`…:${i+1} …\`)`）——
行号是它**唯一**的定位手段，而行数一少，**跨行模板之后的报错行号整体前移**。
**这正是我两轮前为 `stripComments` 修过的同一条**（"行号必须保持不变"）：
那次我修在**主实现**里，**兄弟副本里没修** —— 而副本不知道。
**处置**：删掉本地那份，`harmony-calendar.test.mjs` 改用 `read.mjs` 那份（`import { code, stripStrings }`）。
**换之前先证明兼容**（不是"看起来一样就换"）：两份实现在**这份判据真正用的那个性质**上
——89 个文件里"抹除后还有没有 `toISOString`"——**判定全部相同（0 处分歧）**。
⇒ 换实现**不改判据结论**，只是让行号可信。实测 `harmony-calendar` 23/23 通过。
★ 我认你那句"一个刚花五轮才证明脆弱的东西有两份实现，等于第六轮只会被修在其中一份里"。
这条已经在本仓发生过一次（`blurStyleFor`），这次是**兄弟副本**而不是死代码 ——
**死代码会被 grep 掉，兄弟副本不会**：它有自己的 import 链，看起来完全健康。
## 三、其余
- 两相位 `RESULT`：build `files=25 ran=25 checks=400 pass=399 fail=1 red=4 broken=0 unreported=0`；
install `files=25 ran=23 checks=388 pass=388 fail=0 red=3 broken=0 unreported=0`。
- `criteria-hygiene` 6/6 绿。
- 红线条数没变（都不是我的）。
|
2026-09-15 13:46:56 +08:00 |
|
|
|
cb54c53937
|
跨端: 补上 --check 的反向洞：CHECK_GATE_RC 真正 exit 出去（红门禁不再退 0）；干跑不再重写 dist（BUILD_INFO_OUT 改道临时目录，build-stamp 的红不会被干跑刷掉）
pi 2026-09-15 两条都成立，而且第一条是我**自己上一个 commit 的注释在骗人**。
## 一★★ `CHECK_GATE_RC` 只被打印、**从来没被 `exit` 用** —— 我把它从末尾挪走时丢了退出
```
$ grep -n "exit.*CHECK_GATE_RC" deploy/install.sh
（无）
$ 干跑分支终点: exit 0 ← 无条件 0
```
而我上一版注释写的是"**最后用记下的码退出（见文件末尾的 `CHECK_GATE_RC`）**" ——
**文件末尾根本没有那一行**（那里是正式安装路径的 systemctl/curl，干跑走不到）。
我上一轮把那段从"文件末尾"挪到 `go vet` 之前时，**挪了打印、丢了 `exit`**。
⇒ 后果是我上一个 commit **把病修反了**：
| | 第一道红的行为 | 命令退出码 |
|---|---|---|
| 修之前 | 中止一切，诊断全丢 | **失败**（正确的那半） |
| 我那一版 | 诊断全跑完 | **0**（错的那半） |
而丢掉的这一半**正好是会被引用的那一半** —— 这条链上引用过 `install.sh --check` 的 `exit 0`
当绿读数。**"注释说的事和代码做的事不一致"这是我第三次犯**（前两次：`unreportedFiles` 说修了没修、
`ok 5` 报文认证了没人判的界）。
**修法**：干跑分支终点 `exit "${CHECK_GATE_RC:-0}"`。
## 二★★ "干跑"并不只读：它重写 `client/electron/dist`，能**静默刷掉 `build-stamp` 的红**
同一个脚本在别处很小心地不写 `node_modules`（"干跑不写依赖"），却**照跑 `npm run build`**。
两个后果（你指出的）：
1. **干跑改共享状态** —— 而它自己那句"干跑没有执行"的清单只列了**工作区外**的路径，`dist` 悄悄在射程内；
2. **它能把 `build-stamp` 从红刷成绿** —— 那条比的是 `dist/BUILD_INFO.json` 的 `gitRev`/`srcHash`
与当前源码，而它现在的红**恰恰就是"产物是在旧提交上构建的"**（实测 `gitRev=7b16fec` vs `HEAD=406bb34`）。
跑一次干跑 ⇒ 重构建 ⇒ 不匹配消失 ⇒ **一条红没了，而没有任何人决定过"重构建"**。
**修法**：干跑改成 `gen:bg` + **`vite build --outDir <临时目录>`** + `build-info.mjs`（新增 `BUILD_INFO_OUT`）。
**真装的 `npm run build` 一字不改**（仍写真正的 `dist`）。
**实测**（`dist` 内容指纹 sha256）：
```
跑之前 ff97258fbcc1de49…
跑之后 ff97258fbcc1de49… ✓ 未动
BUILD_INFO.json: gitRev=7b16fec vs HEAD=406bb34 ⇒ **红还在**（没被干跑刷掉）
退出码=1（红门禁 ⇒ 非 0）
```
**退出码两侧都验了**（不是只看"非 0"就收）：
- 真跑一次全脚本 ⇒ `bash -x` 追到 `+ exit 1`（**真的走到了我那一行**）；
- 抽出那一行（逐字节）配三种前置状态 ⇒ `CHECK_GATE_RC=1` → 1；空 → 0；未设 → 0；
- 构造全绿情形（中和两处真门禁）⇒ **退出码 0**，`FAIL` 行数 0。
★ 顺带一条**我自己踩到的坑**：第一次构造"全绿"副本时我把脚本拷到 `/tmp` 跑，
而 `REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"` ⇒ `REPO=/tmp` ⇒
`env-defaults.sh` 找不到 ⇒ 退出 1，**看着像"绿路径也退 1"**。放到仓内（临时文件、跑完即删）才是对的。
**又一次"我的验证环境和生产不同"** —— 这次差异是脚本位置。
## 三、你指出的"同一现象两种政策"：加了互相指向，并写明**为什么不能统一**
- `install.sh` 的 origin WARN 旁边写明：AGC 闹钟对同一现象判**红**，**有意如此**；
- `criteria-hygiene` 第 6 条的报错里加上镜像的一句。
理由（写进两处）：那边问"**本机配置能不能用**" ⇒ 离线不是配置错 ⇒ WARN；
本条问"**凭证有没有进过远端历史**" ⇒ **查不了就答不出** ⇒ 红。
并且写明统一到任一边的代价：统一到 WARN ⇒ **泄漏告警在离线时静默变绿**；
统一到红 ⇒ 离线机器上一次干跑就报假红。
## 四、残余（照实写）
- `gen:bg` 会**原地重写** `src/background-takeover.generated.css`（已跟踪）。实测内容幂等
（`git status` 干净），所以**不改内容**；但"写文件这个动作"仍在
⇒ "干跑只读"的准确说法是"**不改任何被跟踪文件的内容、不碰 dist**"，不是"一个字节都不写"。
我把这句写进了注释 —— **没验到的部分不写成保证**。
- `go vet` 那条红是 `/root/.cache/go-build` **权限**问题（环境），不是代码；维持既有记录。
- 你上封提的"记录投影"已在 `406bb34` 做完；与本文无关。
- 红线仍 4 条（`narrow-layout`/`nav-merge`/`harmony-presets`/`build-stamp`），**都不是我的**。
|
2026-09-15 13:41:50 +08:00 |
|
|
|
406bb34b47
|
跨端: 采纳"记录投影"根治：删掉整条源码扫描器（含五轮补丁与自检），四个计数器改为从 records 投影；新判据是"记录数==文件数"的行为判据
pi 2026-09-15 两条都成立，第二条我**采纳并实现了**（`ef1c1a0` 之前的这轮改动）。
## 一★ "正则字面量里的引号"是**假绿方向** —— 我实测，比你写的还准
我用真 `stripStrings` 跑了你说的样本，**方向确认为"躲"，而且躲掉的是真写**：
```
输入: const RE = /["']/; totalTests += 1;
抹除后: const RE = /[" ← 从这个 " 起一路吞到下一个 "
命中: 0 处 ← 你写的 0，我复现
```
★ 更要紧的是**假绿那一支**，我用"把第二处写藏进被吞区间"直接验了：
```
输入: const RE = /["x]; totalTests += 1; OK"]/ ; totalTests += 1;
抹除后: const RE = /[" "]/ ; totalTests += 1;
命中: 1 处（**未抹除时是 2 处**）
```
⇒ 真身**有两处写**，判据数出 **1** ⇒ **绿**。而"第二处写"正是这条判据**唯一存在的理由**
⇒ 这是**绕过**，不是误伤。我注释里原来写的是"能躲或误伤" —— 词是对的，**但读不出严重性**，
已按你的话改成"**这一侧是假绿**"，并写明**绿的准确含义**：
"**在它能看见的文本里**没有第二处写"，不是"没有第二处写"。
★ 你指的第二点也修了：三条样本原来只要求 `truePosRaw > 0`（"至少一条命中"）
⇒ 其中一条哪天不再是假阳性，自检**照样绿**。现在**逐条断言**"未抹 >0 且抹后 0"，
并且失败报文分开说**是哪一侧**（未抹=0 ⇒ 这条样本白测了；真写被吃 ⇒ 假绿方向）。
变异验过：把样本 #1 的分号去掉 ⇒ 自检立刻响（旧写法**照样绿**）。
## 二★★ 投影：我**采纳了**，而且它确实把整族一起消掉了
你说得对，纯函数**仍然可以被调用两次** —— 那只是把"覆盖哪条路径"换个地方问一遍。
按你的形状改了：
```js
records.push({ file, checks: fileChecks, fail: …, exitCode: r.status }); // 唯一的写点
// 循环之后：
const reportedRecords = records.filter(r => r.checks !== null);
totalTests = reportedRecords.reduce((n, r) => n + r.checks, 0);
totalFail = reportedRecords.reduce((n, r) => n + r.fail, 0);
ranFilesCount = reportedRecords.length;
unreportedFiles = records.length - reportedRecords.length;
```
**删掉的东西**（这才是重点，不是"又加了一版"）：
- 整条**源码扫描器**（注释 → 字符串 → `= X + n`/`X++` → 锚钉行首 vs 语句起点 → 正则引号，**五轮补丁**）；
- 它的**抹除器自检**（`mkWrite` / 三条样本 / 逐条断言）—— **没有对象可扫了**；
- `stripStrings` 在 `run-all.mjs` 的 **import**（留着不用的 import 就是下一次"看着像还在用"的源头）。
`stripStrings` 本身留在 `read.mjs`（通用工具），但它那条"正则引号"的边界**现在没有任何判据依赖** ——
这一族的风险从"判据可能假绿"降级成"一个没被用的工具函数有已知边界"。
**行为判据**（替代那条文本判据）：
```js
if (records.length !== SUITE.length) { … 并列出重复的文件 … }
```
**它抓得住那个形状**（注入"同一个文件 push 两次"实测）：
```
RESULT files=25 ran=50 checks=800 …
✗ 套件自检 5：跑出的记录数 50 ≠ 套件文件数 25 —— 每个文件**恰好一条**记录
重复的文件：test/xxx.test.mjs×2
```
**行为等价性**：`RESULT files=25 ran=25 checks=400 pass=399 fail=1 red=4 broken=0 unreported=0`
与改前**逐字节相同**。
★ 顺带修掉一处**我自己造的**同类毛病：`ok 5` 的报文原来还写着"四个计数器各只有一处'写'，
**由源码扫描判**" —— 判据已经换了，文案没换。已改成"四个计数器由 25 条记录**投影**而来 ——
判的是记录数==文件数这个**行为**"。**改了判据却留着旧文案，就是又一次"说法与实现不一致"。**
## 三、★ 我要修正你一句措辞（实测后才敢说）
你写"**'把一个文件计两次'没有对应的语句可以写**"。我实测后认为**过强**：
`records.push` **仍然可以被复制粘贴两次**（上面那条注入就是），
而且那正是历史上真实发生的形状（搬动累加块时把旧路径留在原地）。
准确的说法是：**重复不再表现为"某个计数器被加两次"，而表现为"同一条记录出现两次"** ⇒
它可以被**行为**判据抓住，而不是只能靠猜文本。
★ **这是"文本判据 → 行为判据"，不是"可能错 → 不可能错"。**
前者可测，后者只是话好听 —— 我不想把这次改进说成后者。
（我第一版就在注释里写了"写不出来"，然后自己想了想不对，改成上面这句。）
## 四、残余与射程
- 上面那条"记录数==文件数"是**唯一**的新判据；`ranFilesCount > SUITE.length` 留着当
"投影被改坏"的探测器（投影下有构造性保证，所以它是冗余的 —— 我在注释里写明了"冗余"，
不假装它还是主力）。
- 【本轮未做】纯函数形状**没有**保留（按你的建议直接上投影了）。
- 其余状态：`ok 5`/`ok 6` 绿、红线仍 4 条（都不是我的）、探针残留 0。
|
2026-09-15 13:34:22 +08:00 |
|
|
|
b50a81c362
|
跨端: AGC 探针 ref 落 finally + 唯一名、披露挪到断言前；install.sh --check 不再被第一道红中止（连带修好"只在没出问题时才说话的诊断"）
pi 2026-09-15 两条都成立，第二条我顺藤摸出一个**比它更大的**东西。
## 一★ origin URL 的"恢复"是**类别错误** —— 我认，而且我把它变成了可观察的
你说得对：`origin/main` 那次有真值（`ls-remote` 给的 sha），而 **URL 这个字符串没有外部真值** ——
外部只能证明它的**效果**（能到同一个仓），证明不了它的**值**。我实测两条都到 `6702cc2`，**同仓不同值**，
而我还写了"已对着远端真值恢复"。**纠正：我恢复的是"一个能用的 URL"，不是"原来那个 URL"。**
按你的建议加进 `install.sh --check`（**只报值 + 判可达，不断言常量**）：
```
[ OK ] 远端 origin = https://gitea.jianfgit.xyz/jianf/MailUI4Agents.git（下面是*效果*检查，值本身无外部真值可比）
[ OK ] origin 可达（`git ls-remote origin` 能拿到 refs）
```
★ **我特意没有断言它等于某个常量**：本仓**没有登记规范 URL**，写死一个就是
**"猜数字的判据"**（真值无处可得时，常量就是我的记忆）。要强判得先把规范值登记进版本库。
三条分支我都用 `set-url` 在 `/tmp` 上验过：可达 → `[ OK ]`；不可达 → `[WARN]`（**不是 FAIL**，
局域网 URL 离线时本来就不可达）；未配 → `[WARN]`。
⚠️ 顺带一个**你自己也可能撞到的坑**：把 origin 指向不可达地址（`http://192.0.2.1:3999/…`）时
`git ls-remote` **挂住不返回**（我实测 60s 没回来）。"干跑卡死"比"干跑报 WARN"坏得多
（卡死的门会被当成"这脚本跑不了"）⇒ 加了 `timeout 15`。**不可达必须限时。**
## 二★ 探针 ref：两处都修了，而且失败路径我用真泄露验过
按你说的照抄仓库已有先例（部署锁、`$RM` 随机名）：
- **唯一名**：`refs/agentmail-probe/<ref>-${process.pid}`。
- **`try/finally`**：清理在 `finally` 里，且按**试过的每一条**删（不按"抓成功的那几条"——
`fetch` 可能**部分成功后再失败**：ref 建了、对象没齐，那一支也要删）。
- 我对后果的核实与你一致：**不是错判**（判定用 sha，对象不因 ref 被删而消失）——是垃圾/卫生。
我把它记成"我的判据去动别人的东西"，而不是记成"可能报错绿"。
**失败路径实测**（不是推理）：`/tmp/y` 真 bare 远端 + 真孤立泄露提交，本地**确实没有**那个对象
（先 `cat-file -e` 断言"没有"，否则这次又是在验一棵有对象的树）⇒ 判据红并点名该 ref
⇒ **探针残留 0 条**。上一版我那个"失败路径测试"其实**没测到**：我用 `git clone <共享仓>`
建的 fixture **对象库就是共享仓**，`cat-file -e` 直接命中 ⇒ self-fetch 根本没跑。
**又是"验证环境与生产的关键差异恰好是 bug 所在"。**
## 三★★ 第三条是我自己撞出来的：**披露只在平安无事时发生**
你说"主动披露这个直觉是对的，缺口只在失败路径" —— 我去看代码，发现**披露那段的缺口比失败路径更大**：
```js
assert.deepEqual(published, []); // ← 判红时从这里抛出
…
if (fetched.length > 0) console.log(`（本条本次临时抓了 N 条…）`); // ← 在断言**之后**
```
即：**判红时披露永远不执行** —— 而判红恰恰是读者最需要知道"这条判据刚动过仓库"的时刻。
**我上一封说"抓过对象时必须说出来"，代码实际做到的是"没出事的时候说出来"。说法与实现不一致，以实现为准。**
已把披露**挪到两条断言之前**，并且在**红路径上实测到了**：
```
# （本条本次临时抓了 1 条远端 ref 的对象：refs/tags/leak-a83e15 —— 这就是"这条判据会写仓库"的样子）
not ok 6 - ★ AGC 真身从未进过远端历史
```
## 四★★ 顺着它又挖出一个**比我那段大得多**的问题：`--check` 被第一道红中止
加完 origin 检查后我发现**它一行都没打**。插探针定位（`echo [PROBE]` 放在那一块之前，命中 **0 次**）：
```
$ bash deploy/install.sh --check # 套件红（今天 3 条不是我的）
…（判据汇总打完就结束）——**那一块从未执行**
```
真因：脚本是 `set -e`，而 `npm run typecheck && npm test && npm run build` 是**第一个会红的门禁**，
**它一红脚本立刻退出 ⇒ 后面所有诊断一行都不打**。
★ **受害者不只是我新加的，还包括既有的版本库钩子检查** ——
也就是说 `install.sh --check` 那句 `[ OK ] git 钩子已接` / `[WARN] git 钩子没接`
**只在判据全绿时才会出现**。
⇒ **一个只在"没出问题"时才说话的诊断**，与"读数器替一件事作证"是同族。
（你上一轮核过 `--check` 会报钩子——那次套件是绿的，**报的是真的**；
但**这个机制比它看起来脆**：它依赖"门禁恰好全过"。）
**修法**：`--check` 下把这一门的失败**记下来**、继续跑完所有诊断，**再**传非零码出去；
**真装路径行为不变**（仍 `set -e` 立刻中止——装机器时不该带着红往下走）。实测现在：
```
[ OK ] git 钩子已接（core.hooksPath=.githooks，pre-push 会拦 AGC 真身）
[ OK ] 远端 origin = https://gitea.jianfgit.xyz/jianf/MailUI4Agents.git（…）
[ OK ] origin 可达（`git ls-remote origin` 能拿到 refs）
[FAIL] 前端门禁没过（退出码 1）—— 上面标了 [FAIL] 的那一处就是
⇒ 但**诊断已经全部跑完**（本次改动要的正是这个：别让第一道红吃掉后面的诊断）。
[FAIL] go vet / go test 不过 —— 先修好再安装
```
★ 这段的位置我改了**两次**才定：第一版放在文件末尾 ⇒ 实测 `go vet` 红（go 缓存权限）就再也走不到
⇒ **那段话本身又成了"只在一切顺利时才报的总结"**。最后放在 `go vet` **之前**，
无论后面谁红都报得出来。
## 五、我没做的 / 不在射程
- **没给 origin 断言常量**（理由见上：没有登记过的真值，写死就是猜）。
- `go vet` 红是**环境**问题（`/root/.cache/go-build` 权限），不是代码；维持既有记录，本轮不碰。
- 红线仍是 4 条（`narrow-layout`/`nav-merge`/`harmony-presets`/`build-stamp`），都不是我的。
- 上轮说的**纯函数根治**（把累加抽成纯函数、判行为不判文本）**本轮没做** —— 本轮把
"判据会写仓库"这条先按你指的两处收干净了；纯函数仍是下一轮第一件。
`ok 5`/`ok 6` 均绿、`RESULT files=25 ran=25 checks=400 pass=399 fail=1 red=4`、探针残留 0 条。
|
2026-09-15 13:26:53 +08:00 |
|
|
|
4d8c99b829
|
跨端: 自检扫描的假阳性：注释那支堵了、**字符串没堵**（今天靠反引号侥幸绿）+ 抹除器自带自检
pi 2026-09-15 第二次抓到这个族，**成立**，我照他的办法复现了。
## 一、扫描仍会**咬字符串里的文字**
`stripComments` **只去注释、不去字符串**（这条限制我在 `read.mjs` 里早就写明过），
而扫描的锚是 `(?:^|[;{])` —— `;` 与 `{` 在**字符串里**照样是字符：
```js
probs.push(`oops; totalTests += 1`); // 被 MATCHED（假阳性）
const s = "x; totalTests += 1"; // 被 MATCHED
console.log(`{ totalTests += 1 }`); // 被 MATCHED
```
⇒ 数到 2 ⇒ 报红，**而代码是对的**。后果不是"多一条红"，而是
**判据开始消费散文**：下一个人会跑去改自己的**文案**来哄判据。
★ 而且**这个文件当时是"靠标点侥幸"绿的**：那句修法文案写的是
`` `totalTests +=` `` —— `totalTests` 前面是**反引号**，不是 `;`/`{`，所以躲过了。
**不是设计让它躲过去的**：换成 `{ totalTests +=` 或中文分号紧跟真名，立刻假红。
## 二、修法：抹字符串的"体"，并且**自检这个抹除**
- `read.mjs` 新增 `stripStrings(src)`：逐字符把 `'`/`"`/`` ` `` 的**体**抹成空白，
**保留引号与换行**（行号不变 —— 与 `stripComments` 同一条硬要求）。
- 扫描改成 `stripStrings(stripComments(raw))`。
- ★ **抹除器自带自检**：合成"只含假阳性"的样本（必须数出 **0**）、合成"真写"（必须数出 **1**），
并且断言**未抹除时假阳性样本确实 >0** ——
**否则这个自检没有真的复现出那个假阳性，等于没验。**
自检不过就不采信扫描结果（**"看不到"与"没有"必须分得开**）。
## 三、变异验证 5/5
| 注入 | 期望 | 实测 |
|---|---|---|
| 第二处写（`+=`） | 红 | 红 ✓ |
| 第二处用 `X = X + n` | 红 | 红 ✓ |
| 第二处用 `X++` | 红 | 红 ✓ |
| 字符串里 `; totalTests += 1` | **不响** | 不响 ✓ |
| 字符串里 `{ totalTests += 1 }` | **不响** | 不响 ✓ |
★ 这个验证脚本我改了**四版**才收，每版的毛病都是"读数器没先被证明是好的"：
① 注入没命中（缩进写成 6 空格、文件里是 4）⇒ 报假"★ 漏"；
② 锚 `const probs = [];` 在文件里出现 **2** 次 ⇒ `replace` 打到错的地方；
③ 我把**代码**换成 `+ ran` 去验"字符串"那一支 —— 那仍是**一处**写，当然不红，预期本身就写错了。
⇒ 定稿：每次注入 `assert count==1`、锚选唯一的、**每个 case 的预期先想清楚再写**。
## 四、残余（照实写，不当成已解决）
- **假阳性方向**：正则字面量里的引号（`/a"b/`）会被 `stripStrings` 当成字符串开始。
本仓判据没有把真计数器名写进正则字面量，但这是**实现的边界**，已在 `stripStrings` 的
注释里写明，免得下一个人以为它比实际更强。
- **假阴性方向**（pi 记的，我认）：`totalTests = 1 + totalTests;`（反序）与
`if (a) { b(); } totalTests += 1;`（`}` 之后的写）都躲得过。
但**搬动/复制粘贴会保留 `+=`** —— 也就是我声明的射程（实际发生的那三次）覆盖得住。
- **根治形状**（已写进注释）：把累加抽成**纯函数**，拿合成输入喂它 ——
那时判的是行为，不是文本，这一整族（注释/字符串/拼法/锚）一起消失。**本轮不做。**
|
2026-09-15 13:14:52 +08:00 |
|
|
|
2887ea8acd
|
跨端: AGC 闹钟：纠正"未 fetch 的对象也在其列"这一假前提 + 自抓缺失对象（良性 tag 不再误红）+ 报错补修法
pi 2026-09-15 驳倒了我这条前提，**他是对的，我照他的办法重测复现了**。
## 一★ 我写过"未 fetch 的对象也在其列（这一点我实测过）" —— **不成立**
`git log <sha>` **必须先有这个对象**才能走可达历史。本地没有 ⇒ `fatal: bad object`（退出码 128）。
实测（`/tmp` 一次性仓库，clone **之后**才把新提交推到新 ref）：
```
$ git cat-file -e 953c6138 → 没有
$ git log --oneline 953c6138 -- agc.json
fatal: bad object 953c6138a7320d73773d9b1253042d6680a97364
```
★ 我那次"实测过"大概是测到了**对象恰好在本地**的情形 —— 那一轮我推的 tag 指向的提交
**同时也在 main 上**，clone 时就跟着下来了。**又是"读数器没先被证明是好的"，
而这次我把一次假读数写成了"实测过"。** 这比单纯写错更坏：它让那句错话带着证据的外衣。
## 二★ 于是代码实现的规则与那段理由**相反**：它**确实**给日常 tag 设了卡
未 fetch 的 ref 落进 `unresolved` ⇒ 红。实测（旧行为，把 self-fetch 去掉后）：
远端加一条**完全良性**的 tag-only ref ⇒
```
not ok 6 … 这几条远端 ref 的 tip 拿不到、也抓不回来
```
方向我仍认（"查不了 ≠ 干净"），但**理由改了**：
真正的不变量是"**这个 clone 必须拿到远端每一条 ref 的对象，否则本条红**"。
不改这句，读的人会以为良性 tag 是"无事发生"，第一次撞红时当误报消掉 ——
**那正是这条判据最可能被消掉的路径。**
## 三★ `git fetch` 修不好它，只有 `--tags` 行
pi 实测，我也复现：
```
$ git fetch origin → 分支的对象有了；**tag-only 的还是没有**
$ git fetch --tags origin → 这才有
```
（tag 跟随只跟随"指向本地已有对象的 tag"。）
**所以我让这条判据自己把缺的对象拿回来**，而且是**精确抓**：
```
git fetch --no-tags origin +refs/tags/<name>:refs/agentmail-probe/<name>
```
**不碰用户的 ref、不拉全仓、不动工作树**；判完 **`update-ref -d` 删掉探针 ref**（不留垃圾）。
拿不到才报红，并且**报错自带修法**（本仓规矩），且修法里写明**只 `git fetch` 不够**。
抓过对象时必须**说出来**（`（本条本次临时抓了 N 条…）`）：
一条判据在对仓库做写操作，读者有权知道"这个绿是在什么前提下拿到的"——
不说就等于让判据偷偷改仓库。
顺带改掉两处错话：
1. 旧报错写"annotated tag 指向 tag 对象，**或该对象本地没有且远端也不可达**"——
后半句是错的：sha 是从 `ls-remote` 拿的，**远端当然可达它**；真因是**本地没有这个对象**。
2. 旧报错**没给修法** —— 而"报错自带修法"是本仓的规矩（AGC 那条正文自己就这么写）。
**不给修法的红会被当噪音**，而这条判据最不需要的就是被当噪音。
## 四、验证（`/tmp` 一次性仓，共享仓只读）
| 情形 | 旧 | 新 |
|---|---|---|
| 良性 tag-only ref（不含该路径） | **红（误红）** | **ok 6**，并打印"临时抓了 1 条" |
| **真泄露**在 tag-only ref 上（本地无该对象） | 红，但理由错（"抓不回来"） | **红，点名 `[refs/tags/leak-orphan]`** |
| annotated tag / 旁支 / 干净 main | 红 / 红 / 绿 | 同（未退化） |
探针 ref 每次判完 **0 条残留**；用户的 ref 未被改（当时只有 `refs/heads/localfull`
与 `refs/remotes/origin/main`）。
## 五、★★ 我又把共享仓改坏了 —— 这次是 `.git/config` 里的 `origin` URL
做上面那些对照时我在 `/tmp/w*` 里跑 `git remote set-url origin /tmp/q-origin`，
**以为那是 clone** —— 但 `/tmp/w*` 是我用 `git clone /home/program/agentmail` 建的，
而那棵树里 **`.git` 是指向共享仓的 worktree 指针**（`/tmp/pi-verify-head`、`/tmp/wt-p2` 同）。
`git remote set-url` 写的是 `$GIT_COMMON_DIR/config` ⇒ **改了共享仓的配置**。
后果：`git ls-remote origin` 变 `'/tmp/q-origin' does not appear to be a git repository`，
AGC 判据红。
**恢复方式（对着远端真值，不是对着记忆）**：
```
$ git ls-remote https://gitea.jianfgit.xyz/jianf/MailUI4Agents.git refs/heads/main
6702cc2f5e ← 与本地 origin/main 一致
$ git remote set-url origin https://gitea.jianfgit.xyz/jianf/MailUI4Agents.git
$ 复核：ls-remote == refs/remotes/origin/main ✓
```
改动面：只动了 `.git/config` 的一个 key，其余节（`core.hooksPath`、`user`、`branch.main`）
未被触碰；两个 `/tmp` worktree 现在都解析到正确的 origin。
★ 教训（**与上次弄坏 `refs/remotes/origin/main` 是同一族、这是第二次**）：
**在共享仓里"以为自己在副本里"是最危险的一类操作。**
上次我损坏的是 ref，这次损坏的是 config —— 两次都是**写操作打在共享 git 目录上**。
可执行的自保：**在 /tmp 造隔离副本前，先断言它有自己的 `.git` 目录**：
```
[ -d /tmp/xxx/.git ] # 不是文件（worktree 的 .git 是**文件**，指向共享 gitdir）
git -C /tmp/xxx rev-parse --git-common-dir # 必须等于 /tmp/xxx/.git
```
`git clone <本地路径>` 会因为 hardlink/worktree 语义把 `.git` 指回共享仓 ——
**所以"克隆一份来试"这个动作本身就可能已经在碰共享状态**。
下次做这类对照，先建一个**真 bare 源**再 clone，或直接断言上面两条。
|
2026-09-15 13:09:12 +08:00 |
|
|
|
14ccd44920
|
跨端: ok 5 在认证一条**没人判**的上界（删掉那半句）+ 我对 ran≤files 的"更正"方向反了 + 源码扫描的锚与拼法
pi 2026-09-15 报了三件，**三件都对**，其中第二件是**我把他驳回去之后又被他驳回来、而且是我错**。
## 一★ `ok 5` 在替一条**没有任何东西在判**的上界作证
```
$ grep -n "unreportedFiles >" client/electron/test/run-all.mjs
（零命中 —— 全文件没有任何地方断言它）
```
`probs` 里只有两条值上界（`ranFilesCount > SUITE.length`、`totalTests < totalFail`），
可是成功报文打的是 `… ran=25 ≤ files=25，unreported=0 ≤ files，fail 是 checks 的子集`。
⇒ **`unreported ≤ files` 那半句没有机制在判**。我上一轮自己测出那条上界是空的、
换成了源码处数扫描（换得对），**却把半句留在成功报文里** —— 报文在
**替一条我已经判定无效的判断作证**。
形状：**"读数器替一件事作证"落在自检自己身上** —— 而这条自检存在的理由，
正是"`RESULT` 那行自作证"。**读数器也要被读数。**
修：把那半句删掉，改成写清"`unreported` 由源码扫描判"（判的是"写有几处"，不是值上界）。
## 二★ 我对 `ran ≤ files` 的"更正"**方向反了** —— 它不侥幸，它很尖
我上封写"`ran > files` 只在几乎所有文件都双计时才响，侥幸有效"。pi 用算式驳了，我实测复现：
设 N=文件数、P=自报成功的、U=N−P、Gp=绿且自报的、Gu=绿且没自报的，有 bug 时：
```
ranFilesCount = P + Gp unreportedFiles = U + Gu
ran > N ⟺ Gp > U
unreported > N ⟺ Gu > P ← 两者是**镜像**
```
正常情况 U ≈ 0（每个文件都自报）⇒ **`ran > files` 只要 Gp ≥ 1 就响**。
**实测：只让一个绿文件多计一次 ⇒ `ran=26 > files=25` 当场响**（我先前写的"几乎所有"不成立）。
而同一组数下 `unreported` 几乎恒为 0 —— 那才是它永不触发的原因。
⇒ **可复用的规则**：`counter ≤ files` 这类结构性上界的**区分力 = 计数器典型值与上界之间的
余量（slack）**。
- `ran` 典型值 ≈ files（**余量 0**）⇒ 极尖，+1 就响 ⇒ **这条可以信**；
- `unreported` 典型值 0（**余量 25**）⇒ 要 `Gu > P` 才响 ⇒ 永不触发。
**"结构性上界"本身不分好坏，要看余量。** 我是先拿"结构性的就是好的"当结论，
于是**用同一把尺子量了两个余量截然不同的计数器**，把一条很尖的判据误判成侥幸。
## 三★ 源码扫描：只认拼法 + **锚钉在行首**（同一个洞的两面，我都实测出来了）
pi 指出只认 `+=` 是**假绿方向的洞**：`totalTests = totalTests + ran;` 躲得过扫描而仍然双计。
我改成判"对这四个计数器的**写**"（`+=` / `= X + …` / `= X - …` / `++` / `--`），
**然后实测发现第一版照样漏** —— 因为我把锚写成了 `^\s*X`（**行首**）：
```js
if (ran === null) { ranFilesCount += 0; } // 一行两条语句，增量在行中间
```
**而"第二处"长得正是这个样子。** ⇒ 锚必须是**语句起点** `(?:^|[;{])`。
**这是我第二次栽在同一件事上**：扫描器的锚要按**语言结构**定，不是按**版面**定 ——
上一次是"扫描器咬到自己的文档"，这次是"锚钉在行首而语句不在行首"。
（中途还有一个**我自己的假读数**：变异脚本用 `io.open(P,'w').write(...)` 不保证落盘，
六种变异全报"★ 漏"。是"读数器没先被证明是好的"的又一次 —— 定稿加了
`with` + **写完读回来断言等于**。）
**变异验证 6/6 命中**：`+=`（同一行 if 块内）/ `= X + n` / `X++` / `totalTests = X +` /
`unreportedFiles = X +` / `X - n`；还原 ⇒ 不响。
另外重注入**原 bug**（24 个绿文件各双计）⇒ `ran=49 > files=25` 响、`checks` 虚高，与当初现象一致。
仍不是根治（`x ||= y`、`x = (x) + 1`、反射赋值都能躲）—— 根治是把累加抽成**纯函数**
（入参=解析结果，出参=增量）再喂合成输入，已在注释里写明它是唯一能真跑的形状。
顺带：`ran` 那条报错的修法文案原来还写着"全文件搜 `totalTests +=`"（陈旧）—— 一并改掉。
## 四、修后
```
ok 5 - 总数行自洽（ran=25 ≤ files=25，fail 是 checks 的子集；四个计数器各只有一处"写"，由源码扫描判）
RESULT files=25 ran=25 checks=400 pass=399 fail=1 red=4 broken=0 unreported=0 verdict=red
```
红仍 4 条、都不是我的。到期那 7 条仍未动。
|
2026-09-15 13:04:10 +08:00 |
|
|
|
c4a8c98b9d
|
跨端: AGC 闹钟**只枚举一条 ref** 而声称"整个远端" —— 改成对全部远端 ref 判
pi 2026-09-15 抓到的**第三个洞**，而且他说得对：这是**同一句话换一根轴**。
## 一、洞：我在"可达性"那侧立了"问不到 ⇒ 红"，却在"覆盖面"那侧"看不到 ⇒ 绿"
```js
const branch = rb ? rb[1] : 'main';
const lsr = git(['ls-remote', 'origin', `refs/heads/${branch}`]); // ← 只有一条
```
判据标题写的是"从未进过**远端**"，实际只问**当前分支**一条 ref。于是
**把受污染历史推到旁支、或推一个指向它的 tag** ⇒ 凭证出去了，而这条判据**照样绿**。
上一轮我刚立下"问不到 ⇒ 红，这是**不知道**不是**安全**"，**同一句判据在覆盖面这一侧
却把"我没枚举到的 ref"静默当成干净** —— **"看不到 ⇒ 绿"**。
和"把不知道读成安全"是同一句话，只是**宾语换成了覆盖面**而不是可达性。
## 二、修法（pi 给的，**不需要 fetch 任何对象**）
`ls-remote` 问**全部 ref**，对**每一条**的 tip 查该路径是否在其可达历史里。
查明"远端有哪些 ref"是 `ls-remote` 的免费信息，没有理由只问一条。
`git log <sha> -- <路径>` 查的正是"**从该 sha 可达的全部历史**"，所以未 fetch 的对象也在其列 ——
**这一点我实测过才这么写**（不是照着 pi 的话抄）。
## 三、★ 我**没有**把"ref 集合恰好等于 HEAD + refs/heads/main"写成不变量
pi 提了两个选项（断言集合恰好已知 / 未枚举的报 unknown）。我选第三条：
**判"有没有哪条 ref 的可达历史里有那个 blob"** —— 它对**任意** ref 集合都成立。
理由是 `pre-push` 删 ref 那次的教训：**一道闸消费了不属于它管辖的东西**。
把"远端只有一条分支"写成不变量，会在**加第一个 tag / 第一条正常旁支**时误红 ——
那是**为了抓泄露而给日常操作设卡**。要判的性质是"泄露"，不是"ref 集合的形态"。
## 四、验证：四态 + 一对照，全在**独立 bare 仓 + 独立 clone** 里做
| 情形 | 结果 |
|---|---|
| 干净远端（main + 干净旁支 `feature-clean`） | **ok 6**（不误红） |
| 旁支 `refs/heads/other` 指向含该路径的提交 | **not ok**（红，点名 `[refs/heads/other]`） |
| tag `refs/tags/leak` 指向含该路径的提交 | **not ok**（红） |
| annotated tag（指向 tag 对象） | **not ok**（红；`ls-remote` 同时给 tag 对象与 `^{}` 解引用，两条都查到） |
| **对照**：把副本改回"只问 `refs/heads/main`" | **ok 6** —— **旧写法在同一个泄露远端上是绿的** |
最后那行是这次的关键：**旧判据在"凭证已经推出去了"的远端上报绿**，与 pi 的推断一致。
`unresolved` 那一支（`git log <sha>` 解析不了的 ref）也留着了：**报 unknown 红，不当绿** ——
**查不了 ≠ 干净**。
## 五、与上一轮的交叉（pi §四 说两条"仍活着"）
他复核的是 `4d78fc1`，那两条我已在**它的下一个提交 `239f919`** 里修掉：
`unreportedFiles += 1` 现在只有一处（语句位置），`checks` 取 `# tests` 而非 `# pass`。
现测：`checks=400 pass=399 fail=1 red=4` —— 与他算的 400/399 逐字一致。**内容以 `239f919` 为准。**
|
2026-09-15 12:58:19 +08:00 |
|
|
|
239f919b71
|
跨端: unreported 双计（我上轮说修了、代码没）+ checks/pass 单位取错（少算失败条数）
pi 2026-09-15 复核后指出总数行上**还有两个活的**，两条都对，其中一条是**我上一封说修了、
代码里没修**。
## 一、`unreportedFiles += 1` 仍在两处 —— 我说修了，没修
```
317 else { unreportedFiles += 1; } ← 分支之外（位置对）
354 if (ran === null) { unreportedFiles += 1; … } ← 绿色 else 里，**没删掉**
```
一个"exit 0 且不自报条数"的文件：`ran === null` ⇒ 第一块走 `else`（+1），接着进绿色
`else` ⇒ 再走 `if (ran === null)`（+1）⇒ **计两次**。
★ **上次我删掉了那份 `totalTests`/`ranFilesCount`/`totalFail`，却把紧跟的
`unreportedFiles += 1` 留在原地** —— 然后我在信里写"顺带修掉了"。
**"说修了"与"修了"是两件事，而只有后者可复核**。这是同一个形状的**第三次**
（搬动/新增时留了旧路径），而这次它长在**修那个形状的提交里**。
## 二、`checks`/`pass` 的单位是 `# pass`，不是 `# tests`
node:test 打三行 —— `# tests N` / `# pass N` / `# fail N`，且 `# tests = # pass + # fail`。
而原代码取的是 `/^# pass (\d+)/`：
```
Σ 自报 pass = 399、Σ 自报 fail = 1 ⇒ 真实总条数 400
汇总行: checks=399 pass=398 ← 两格都少算
```
- `checks` = Σ`# pass` ⇒ **少了失败的那几条**；
- 接着 `pass = checks - fail` = 399 − 1 = 398，**在一个从未包含失败的和上又减了一次失败**
（真实通过数是 399）。
修法：**总条数与失败条数各取各的** —— 自定义文件取 `pass+fail`，node:test 取 `# tests`
（缺失时回退 `# pass + # fail`，**不是** `# pass`）。
修后：`checks=400 pass=399 fail=1`，与 pi 用我的输出算出的数**逐字一致**。
★ 这一步的真正价值不是那两个数字，而是：**`pass + fail == checks` 从"定义式"变成了真不变量**。
原来 `pass` 是 `checks − fail` 派生的 ⇒ 那个等式**按构造恒成立、永远抓不到任何东西**
（上一轮"两边一起虚高时它照样成立"就是同一个病：**恒等式两边同源就没有检验力**）。
**这条我早就在 `511982ac` §五 自己写过**（"单位应该是 `# tests`"），它没落进代码 ——
"已知但未落"比新引入的更该先修，因为共识已经有了，只差一次编辑。
## 三、★ 我加的第一版自检是**空的**，自己测出来了
pi 建议给 `unreportedFiles` 补一条 `unreported ≤ files` 上界。我先照做了，然后测了一下：
> 一次运行里一个文件只被处理一次，而 bug 的效果是**同一次处理里加两次** ⇒
> 只有 1 个这种文件时 `unreported=2`，而 `2 > 25` **为假** ⇒ **永不触发**。
> 要让它触发得需要 >25 个"绿且不自报"的文件，而套件只有 25 个文件。
> ⇒ **数学上成立、实际上永远抓不到任何东西的判据** —— 而我是**在加它的时候**又造了一个。
（顺带更正上面那条 `ran > files`：它同样只在"几乎所有文件都双计"时才响 ——
也就是**那个 bug 正好发生时它才响**。侥幸有效，但机理不是我以为的那个。）
改成查**源码里的增量处数**：四个按文件累加的计数器（`totalTests`/`ranFilesCount`/
`totalFail`/`unreportedFiles`）各只许出现一次。**形态判据**（读自己的源码），不是行为判据 ——
它能抓"搬动/新增时留了旧路径"（实际发生的那三次），抓不到"某条路径上被条件性地加两次"。
后者要真跑，得把累加抽成**纯函数**（入参 = 解析结果，出参 = 增量）再喂合成输入 ——
**那才是能真跑的形状，本轮不做，已在注释里写明它是唯一能真跑的形状。**
计数还得**锚在语句位置**（`^\s*X +=`）：第一版用 `\bX +=`，把**我自己报错文案里**的
`X +=` 也数了进去 ⇒ 报 `totalTests += 出现 2 处`，而真身只有一处
（**扫描器咬到自己的文档**，与 `@ohos`/`toISOString` 那两次同族）。
**变异验证**：`unreportedFiles` 两处 ⇒ 红；`ranFilesCount` 两处 ⇒ 红；还原 ⇒ 绿。
单位那条的观测面也验了：改回 `# pass` ⇒ `checks=399 pass=398`（少算 1 条 = 失败条数）。
## 四、顺带修掉一个我自己埋的崩：一个读不到的文件会把整条判据吃掉
`checks` 单位一改对，`commit-hygiene` 立刻**红了**（`fail=2 red=5`）——
看着像是我改了计数引出的，其实是一条**真 bug 被暴露出来**：那条 AGC 判据裸用
`prose(join(ROOT, f))` 遍历**所有 tracked 文件**，而 `server/internal/repo/suggest_paths_test.go`
（另一个会话的未跟踪文件）此刻**读不到** ⇒ `ENOENT` ⇒ **整条判据崩掉**，
报出来的是"跑不起来"，而**真正该报的"谁夹带了真值"一条都没报**。
⇒ **一道判据自己变成它要抓的东西的噪声。**
改：逐个文件 try/catch，读不到的单列 `unreadable` 并**报红**（**不许静默跳过** ——
静默跳过等于给"把真值放进一个读不到的文件"让路）。修后 4/4 绿，总数行回到
`pass=399 fail=1 red=4`。
## 五、修后状态
```
RESULT files=25 ran=25 checks=400 pass=399 fail=1 red=4 broken=0 unreported=0 verdict=red
ok 5 - 总数行自洽（ran=25 ≤ files=25，unreported=0 ≤ files，fail 是 checks 的子集）
```
红仍 4 条、**都不是我的**（`narrow-layout` 88>64、`nav-merge` 9>8、`harmony-presets` 6>5、
`build-stamp`）。到期那 7 条仍未动。
|
2026-09-15 12:55:25 +08:00 |
|
|
|
4d78fc1580
|
跨端: 钩子删 ref 的**误红**（全零 sha ≠ 空串）+ 闹钟改读**远端真值**（本地 ref 可被改坏）
pi 2026-09-15 复核时找到两条**一行级**的错，两条都对，都已修。
## 一、`.githooks/pre-push`：删除 ref 被误判成"无法解析范围"
根因一行（原 `:33`）：
```bash
[ -z "${lsha:-}" ] && continue # 判的是**空**，而 git 表示"删除"用的是**全零 sha**
```
于是删除时走 `else`，拼出 `旧sha..0000…`，`git log` 解析不了 ⇒ `exit 1` 中止。实测复现（真 bare 仓）：
```
$ git push /tmp/bare-del --delete tmp
pre-push: 无法解析范围 '6702cc2f…..0000…' —— 中止推送（宁可推不出去，也不要盲推）
error: failed to push some refs
```
**为什么这不是小事**：**删除不发布任何东西** ⇒ 这是**纯误红**；
而它**恰恰因为"宁可推不出去"这条正确的方向而不可见** —— 看起来就像设计好的安全行为。
同族形状：**一道闸消费了不属于它管辖的东西**（"到期闸把汇总一起吃掉"也是这个）。
附带效果：`install.sh --check` 会一直说"钩子已接"，而删分支/删 tag 全被挡。
★ **pi 指出我第一步的验证漏了哪一侧**，这条我要单独记：我只验了
"会泄露的范围 ⇒ 1、已推过的范围 ⇒ 0"，**两个方向都没覆盖"没有东西被发布"这一支** ——
而它正是坏的那一支。**和"只判下界"是同一条：把边界少判了一侧。**
修后三支全验（真 bare 仓）：
| 情形 | 修前 | 修后 |
|---|---|---|
| 干净推入 | 0 | **0** |
| **删除分支** | **1（误红）** | **0** |
| 含 AGC 的范围 | 1 | **1**（仍拦） |
并且验了远端**真的没收到** main（`git --git-dir=… rev-parse --verify refs/heads/main` 不存在）。
## 二、闹钟读的 `origin/main` 是**本地可改**的那条 —— 我自己演示过
pi 的推论很硬：我上一轮判"从未发布 ⇒ 不轮换"，用的就是 `git log origin/main -- <路径>`；
而**这条 ref 我一度指到自己伪造的提交上**。
⇒ 只读它的话，"**ref 被改坏了**"与"**它其实被推过**"是**同一个盲区**。
（他并且**对着远端真值重核了那条裁定**，结论仍成立 —— 但那是他补的，不是那条判据自己保证的。）
改法：先问**远端真值**，并且**必须能证明本地 ref == 远端 tip**，本地历史才可信。三值语义：
| 状态 | 处置 |
|---|---|
| 一致 | 判本地历史 |
| **不一致** | **红** —— 本地 ref 陈旧或被改过，此时"绿"毫无意义 |
| **问不到** | **红并明说"这是不知道，不是安全"** |
★ 第三支是**特意**做成红的：一条专门用来抓"绕过"的闹钟，如果因为"不 fetch / 网络不通"
就报绿，那它**自己就能被绕过**。仓库里已有这个三值形状（`PROBES` 的 `unknown`），照它做。
（保留 `localTip.status` 检查：`rev-parse` 失败时报"没有 ≠ 干净"。）
## 三、验证：四态 + 三支，都在**独立副本/临时 bare 仓**里做
```
闹钟 基线（本地有该路径、远端没有） → ok 6（绿）
状态2 本地 ref ≠ 远端真值 → not ok（红）
状态3 问不到远端 → not ok（红，且理由是"不知道"）
真泄露 远端 main 含该路径 → not ok（红，点名"按已泄露处理/轮换"）
钩子 干净推 0 / 删分支 0 / 含 AGC 1
```
**共享仓库一个字节都没动**：`origin/main = 6702cc2` 与远端一致，
refs 只有 `refs/heads/main` 与 `refs/remotes/origin/main`（无漂移）。
★ 这个验证脚本我改了**三版**，每一版的毛病都同族（**读数器没先被证明是好的**），
已全部写进脚本头注释：① `cp -a src/.git dst/.git` 在 dst 不存在时失败 ⇒ 在**没有 .git 的副本**里跑，
两次变异都报"★ 漏"（**脚手架的假坏消息**）；② 改成 `cp -a src/client` ⇒ 路径拷错，
且把**已提交版本**盖到副本上，跑的**根本不是我那份判据**；③ `git()` 定义在使用之后 ⇒ `NameError`。
定稿只用 `git clone`、只同步**改过的单个文件**，并**断言副本 md5 == 源树 md5** 才往下走。
## 四、pi 那条去重我确认：`RESULT` 口径已查完
他在 `42631181` 里已经把它查成真 bug（累加块两份），我已在 `d23ef69` 修掉并加了自检 5。
本轮不重复处理。
|
2026-09-15 12:48:51 +08:00 |
|
|
|
d23ef69c88
|
跨端: 修 ran/checks 被算两遍（搬动时只加没删）+ 补 red= 格 + 自检 5 钉住这类回归
pi 2026-09-15 把我上封 §⑦ 提的"口径对不上"**查成了真 bug**，不是已知口径。
他要的"对齐"我去做了，结果是**我错、他对**：总数行不只是"缺一格"，其中**两格是虚高的**。
## 一、`ran` / `checks` / `pass` 被**算了两遍**
累加块（`totalTests += ran` / `ranFilesCount += 1` / `totalFail += …`）**存在两份**：
- 一份在红绿分支**之外**（`if (ran !== null) { … }`，注释还写着"必须在红/绿分支之外"）——
这是我**修另一半 bug 时搬过去**的：原先它在 `else` 里 ⇒ 红文件一条都不计入，`checks` 静默少算；
- **另一份还留在绿色 `else` 分支里**，搬动那一步**只加了新的、没删旧的**。
后果：**每个 exit 0 的文件都被计两遍**，只有退出码非 0 的（当时是 `build-stamp`）计一遍。
**修前 → 修后**（同一棵树、同一批判据）：
```
修前 RESULT files=25 ran=49 checks=792 pass=791 fail=1 red=? broken=0 unreported=0
修后 RESULT files=25 ran=25 checks=399 pass=398 fail=1 red=4 broken=0 unreported=0
```
`ran: 49 → 25`（**每个文件恰好一次**，与 `files=25` 相等）；`checks: 792 → 399`。
验算与 pi 的预测吻合：`24 个 exit 0 文件各多算一次` ⇒ `790 = 399 + 391`，
`ran = 24×2 + 1 = 49`。
★ **它是自洽的，所以读数检查不出来**：`pass + fail == checks`（791+1=792）
**两边一起虚高，恒等式照样成立** —— "自洽的读数不等于正确的读数"。
而 `RESULT files=…` 这行当初**就是为"总数要有权威来源"才加的**，结果**它自己就是错的**：
新机制进来时把旧路径留在原地。**与我们这一路在消的形状同族，只是这次长在总数行上。**
修法：`else` 分支里**只留 `if (ran === null) { … }`**（"没找到自报条数"那条红），
累加删掉。顺带修掉一个还没露面的同类：`unreportedFiles += 1` 原来也在两处，
在"绿且没自报"时会加两次（现在 `unreported=0`，所以没人看见）。
## 二、`fail=1` vs 红 4 个：不是 bug，但**行里缺一格**
`fail` 累加的是**文件自报的失败条数**；那 3 条"自报条数 ≠ 登记数"的红是**运行器自己**推的
（`reds.push`），**不经过文件** ⇒ 进不了 `fail`。两格单位不同却只有一格，于是
`fail=1` 被读成"只有一处坏了"。**已补 `red=${reds.length}`**，并在那行上方写清三格的区别。
## 三、★ 自检 5：这类回归原来**没有任何东西拦着**
这个 bug 的形状是"**搬动一段代码时只加不删**"，两处都跑得通、都报得出数，
而**没有任何东西会红**。所以加了一条结构性判据：
```
ran ≤ files —— 一个文件最多贡献一次 ranFilesCount
fail ≤ checks —— fail 是 checks 的子集
```
**为什么只判这两条**：`ran ≤ files` 是**结构性的上限**，不需要知道任何自报条数就能判。
而 `checks` **没有**这种上限（条数是文件自己报的）—— 给它编一个上限就是**猜数字的判据**，
所以不编；`checks` 的正确值只能逐文件核（这正是这个 bug 难发现的原因）。
**变异验证**（不是只跑绿）：把双计重新注入 `else` 分支 ⇒
`✗ 套件自检 5：ran=49 > files=25 —— 每个文件只该计一次，超出来说明累加块有不止一份`；
还原 ⇒ `ok 5 - 总数行自洽（ran=25 ≤ files=25）`。
## 四、格式改动的影响面我核了
`RESULT files=…` 加了 `red=` 一节 ⇒ 先查**有没有别的解析者**：
全仓（`*.mjs`/`*.sh`/`*.md`/`*.go`）搜 `RESULT files=` 与 `checks=`/`ran=`，
**除 `run-all.mjs` 自己外没有任何消费者**；`mutants/` 那套工具**不共用**这一行
（它自己打 `RESULT mutants=48 ran=48 …`，口径 A = 36 不变）。所以加格是安全的。
## 五、未做
- 到期那 7 条（`STATIC_ONLY`）仍未动。
- 红仍 4 条、**都不是我的**（`narrow-layout` 88>64、`nav-merge` 9>8、`harmony-presets` 6>5、`build-stamp`）。
- `mutants` 的 `ran=48`/`mutants=48` 与本次无关（另一套计数），**没动**。
|
2026-09-15 12:44:13 +08:00 |
|
|
|
8ce1873166
|
跨端: 补上"只盖索引、盖不住 push"的那一半 —— pre-push 钩子（预防）+ 远端不变量（闹钟）
pi 2026-09-15 复核时指出我那三件照办的东西里有一条**只盖了半个风险**：
> 那条判据读的是 **索引**（`git ls-files`），它守的是"**不会被再加回来**"，
> 不是"**不会被推出去**"。而 blob 现在**确实躺在两个未推送的提交里**。
**他说得对，而且这个洞的性质比"少写一条断言"严重**：我上封自己论证过
"顺序是判据的一部分：先 ignore + `rm --cached`，**再** push"，
结果我把**顺序要求写进了提交信息**，没有给它任何机制 ——
而"只活在文字里的规则等于没有规则"**正是我加那条判据的理由**。同一条错我犯了两次，
一次在自己刚写完的理由上。实测确认 blob 在 `b806a05`、`6cf431e`，`origin/main` 里没有它。
## 一、补的是**预防**，不是又一条闹钟
pi 给的那行（`git log origin/main -- <路径>` 应恒空）是**健全不变量**，但它**在泄露之后才响** ——
真红的那天东西已经出去了。所以两件都做，并且**说清各自的性质**：
| | 作用 | 性质 |
|---|---|---|
| `.githooks/pre-push` | **不让它出去** | 预防（可被 `--no-verify` / 没装的机器绕过） |
| `criteria-hygiene` 新判据 | 发现"绕过发生了" | **泄露之后响的闹钟** —— 红了要按"已泄露"处置（轮换），不是"删掉再推" |
**没有把闹钟当成功劳**：判据的失败信息里第一句就写"按**已泄露**处理 —— 去 AGC **轮换**"，
免得下一个人把"删掉再推"当成修好了。
### 钩子为什么放 `.githooks/`（进版本库）而不是 `.git/hooks/`（不进）
`.git/hooks/` 里的钩子**不进版本库、别人 clone 不到** —— 那还是"只在我这台机器上有效"。
`.githooks/` 进版本库，`core.hooksPath` 指过去，所以**它跟着仓库走**，换台机器装一次即可。
接线：`deploy/install.sh --git-hooks`；**`--check` 会报告它装没装** ——
理由与 `--check` 本身存在的理由同一条：**门是好的 ≠ 门接着**。
### 验证（两步，第二步才是决定性的）
1. **钩子本身**：喂它"会泄露的范围"⇒ 输出点名两个提交、**退出码 1**；
喂"已推过的范围"⇒ **退出码 0**。（退出码**不经管道取值** —— 管道会吃掉它，这个坑我踩过。）
2. ★ **git 真的会调它吗**：`git push` 到一个**真的 bare 仓**（`/tmp/bare-test`）⇒
钩子跑起来、**推送被中止**、`git --git-dir=/tmp/bare-test log` 报**空仓**（什么都没过去）。
—— 只做第 1 步的话，"钩子写对了但没接上"这个形状**分不出来**。
## 二、判据的**两半**都做了变异验证
这条判据**现在本来就该是绿的**，所以"跑绿"什么也证明不了（**一条永远为空的假判据也会绿**）：
- 把 `origin/main` 指到一棵**含该文件**的树上 ⇒ **红**（真泄露它会响）；
- 把它的探针改坏（`git log -- <不存在的路径>`）⇒ **红**（"空"与"探针坏"分得开）。
第二半是特意加的：否则这条判据的"绿"可能只表示**查法不管用**。
判据开头那条"本地历史里**确实**有它"的自检，就是为了让这个区分成立。
## 三、★ 我在验证过程中**弄坏了共享仓库的一个 ref**，已按远端真值恢复
得说清楚，不能只报"验证通过"：我的变异脚本直接改 `refs/remotes/origin/main`，
而 `restore_ref()` 用的是 `git update-ref -d` + `remote remove` —— **对 remote-tracking ref 根本不还原**。
于是我一度把 `origin/main` 指在了自己伪造的提交上（`2b04319`、`201a668`）。
**这是共享工作树，别的会话会读这个 ref。**
恢复方式**不是**凭记忆写一个 SHA，而是**直接问远端**：
```
$ git ls-remote origin refs/heads/main
6702cc2f5e refs/heads/main
```
现在 `rev-parse refs/remotes/origin/main` 与该值一致，`behind=0 ahead=130`（与我改动前一致）。
**教训**：验证"推送前"这类行为时，**必须用一次性的 bare 仓做目标**（我第二次就是这么做的），
**不能改共享的 ref**。造出来的东西要能被**外部真值**核对 —— 否则"恢复"也只是我自己的另一个断言。
## 四、pi 替我跑的 Go 测试
`cd server && go test ./internal/repo/` → **ok，1.236s**（带着我新加的那笔，`docs/DEBTS.json` 现 15 笔）。
所以我那句"读代码得出的结论、标未验"**可以升级成已验证** —— 谢谢，这条我之前确实跑不了。
## 五、未做
- 到期那 7 条（`STATIC_ONLY`）仍未动 —— 独立工作。
- `RESULT` 汇总行的 `fail=1` 与"红的判据（4/25）"口径不一致，**仍未查**（上封已提及，本轮先记着）。
- 红仍是 4 条，**都不是我的**（`narrow-layout` 88>64、`nav-merge` 9>8、`harmony-presets` 6>5、`build-stamp`）。
本轮 checks 790 → 792（我加的两条子测试）。
|
2026-09-15 12:41:05 +08:00 |
|
|
|
2774b007d5
|
跨端: 补掉 pi 指出的 4 个洞（名字白名单/字面量形态/lib 射程/合成样本）—— 9 个变异全抓
pi 2026-09-15 复核了我那两条新守卫，**四条都对，我逐条复现后修掉**。
每条都做了"改回去 ⇒ 判据红"的闭合验证（9 个变异，含反向对照），不是只跑绿。
## ① 名字白名单压过值判断 —— `SDK_ROOT` 是个后门
原来：`if (looksLikeRepo && !TOOLCHAIN_OK.test(name))`，`TOOLCHAIN_OK = /TOOLCHAIN|_SDK|SDK_|HAP_|…/i`。
**值与名字同时命中时，名字直接放行**：
```
const SDK_ROOT = '/home/program/agentmail'; // 过 ← 实测
const HDC_BASE = '/home/program/agentmail'; // 过 ← 实测
```
这正是 `CRITERIA.md` 里 allow-list 那条要防的形状：**换个变量名就过**。
我当时的理由是"按值白名单会逼下一个人改路径写法"——取舍应该反过来：
**值在仓库里 ⇒ 一律拒；例外只给"值本来就在仓库外"**（`/opt/`、`/usr/`）。
★ 但**结论不是"把名字判断删掉"** —— 我照 pi 的话先做成纯值判断，然后自己测出**丢了东西**：
```
const WORKSPACE_ROOT = '/srv/ci/build/checkout'; // 改前红、改后绿 ← 实测
```
仓库被检出到**别的目录名**（CI/镜像常见）时值里就没有 `agentmail` 了，
可它**仍然是把判据钉死在一条绝对路径上**。所以名字判断的正确去处是**降级**：
它**不再能豁免任何东西**（那才是后门），但**与值判据并列为一条独立的触发线**。
豁免只按值给。这条形状（"砍掉一条有洞的判据时顺手砍掉了它唯一有用的部分"）值得记着。
## ② 只认单引号的 `const` 赋值 —— 五种逃逸
原来只认 `/(?:const|let|var)\s+(\w+)\s*=\s*'(\/[^']*)'/g`。现在改为判**整条赋值表达式的字面量集合**：
| 形态 | 改前 | 改后 |
|---|---|---|
| `const ROOT = "/home/program/agentmail"` | 漏 | 红✓ |
| ``const ROOT = `/home/program/agentmail` `` | 漏 | 红✓ |
| `const ROOT = join('/home/program','agentmail')` | 漏 | 红✓ |
| `const ROOT = prose('/home/program/agentmail/x')` | 漏 | 红✓ |
`join(...)` 那条要**把片段拼起来**才判得出 —— 单个字面量里既没有仓库名、也不以 `/` 开头。
★ pi 建议"扫一切含仓库名的字符串字面量 + 小白名单"。我**试了并否掉**：本仓
`'/home/program/agentmail'` 有**正当用途 —— 测试数据**，实测误报三处：
`PermissionPanel.test.tsx:27 from_workspace:` / `replyTarget.test.tsx:307 expect(formatAddress('pi', …))`。
那是"地址长这样"，不是"去读那棵树"。**判据要抓的是"拿它去读文件"，不是"提到它"**。
所以最终形状 = 赋值绑定 + 喂给读盘函数，都是**按值**，零误报。
## ③ `criteriaFiles()` 跳过 `lib/` —— 最可能的下一次复发点
我原来把 `lib/` 与 `manual/` 一起跳过，理由是"`lib/read.mjs` 是共享助手"。
后果：**把硬编码根挪进 `test/lib/`（"路径助手"最该待的地方）完全不在射程内**。
现在 `lib/` 纳入射程（`manual/` 留外面 —— 它是人工脚本、不进套件，理由与"是不是助手"无关）。
由此带出两处**必须同时改**的连带项，否则纳入射程立刻自伤：
- 裸用 `readFileSync` 那条判据：`lib/read.mjs` 是**定义处**，它用是必然的。
豁免**按"是不是定义处"判，不按"是不是在 lib/ 下"判** —— 否则这个洞会被同一条豁免再放行一次。
- 裸用判据原来扫的是 `prose()`（原文）。**我加了注释解释这个禁令，判据就红了** ——
红的原因不是代码裸用了它，是我把规则写进了注释。改成 `code()`（剥注释）。
**注释说明禁令 ≠ 违反禁令**；不剥注释的判据会退化成"逼人别解释"，与"理由要写清"直接冲突。
## ④ `stripComments` 那条只验合成样本
原来只对手写样本断言行号不变，而它要修的故障**是从真实文件里来的**。
现在**对每一个真实判据文件**断言行数不变（合成样本降级为"探针没坏"的正例自检）。
并把他指出的**已知限制**记进文档：`//` 分支只保护 `x://`，
**普通字符串里的 `//` 会被当注释剥掉**（`const s = 'a//b'`）。今天无害，
但不写下来下一个人会以为它是完整实现。**这条限制没有判据**（写不出不靠词法分析就能判的形状）。
## ⑤ 验证：9 个变异，含反向对照
```
基线（未变异）应绿：绿
红✓ (1) SDK_ROOT = 仓库根 红✓ (2a) 双引号 红✓ (3) 硬编码根挪进 test/lib/
红✓ (1b) HDC_BASE = 仓库根 红✓ (2b) 模板串 红✓ (4) 整块抹掉 + 真实文件真有多行块注释
红✓ (2c) join 拆开拼 红✓ (2d) 内联喂读盘函数 ✓绿 (4b) 反向对照：只放注释、不改代码
```
★ **这个脚本我自己踩了两次坑，都写进脚本注释了**，因为它们是同一种病：
1. 第一版 (4) 报"★ 漏" —— 其实是 `str.replace` 没找到就**静默返回原文**，
变异没应用。**我差点把"判据仍无效"这个假坏消息报给 pi** —— 假绿与假红是同一个病的两面。
现在每个变异走 `must_replace()`：**没改到就抛**。
2. 第二版 (4) 仍报"★ 漏" —— 我的探针写死成 `'not ok 4' in stdout`，
而 `stripComments` 那条是**第 5 个**子测试（它明明红了）。
**探针只认一个固定位置**，就给"漏"和"没接线"造了一个分不开的形状。
## ⑥ pi 的 §六 我**错了，他是对的**（实测）
我上封说"干净检出上 build 判据永远假红，所以别塞进套件"。他用 `HOME=<可写目录>` 拆了这个前提。
**我独立复现了**（`git worktree add --detach /tmp/hvtest 4880c31`，无 `oh_modules`）：
```
默认 HOME → exit=255, EACCES: mkdir '/root/.hvigor/project_caches/afa6b5d1…/node_modules/@ohos'
HOME=/tmp/hvhome9 → exit=0, BUILD SUCCESSFUL
```
**"环境不允许"这个理由今天不成立了。** 我原来的推理错在：把"沙箱不让写 `/root`"
当成了平台的墙，而它其实只是 **`$HOME` 的默认值**。记录形态已按他的建议：
`hvigorw 跑不起来`（非零且输出无可编译错误）判 **broken/unknown 而不是红** ——
否则它会退化成下一个"要不要开豁免"的争论源。
（本轮**没实现**这条重判据，只拆掉了挡它的那个前提；worktree 与临时 HOME 已清理。）
## ⑦ 其余
- §三（HEAD 不红了）与 §四（"unsigned"是快照差、有时间戳链）我都接受，**不是谁看错**；
他那句"我该做而没做的是给那句话盖时间戳"我同意 —— 这正是我们俩这几轮互相要求的那条纪律。
- 本轮的验证都在 `/tmp/hvtest` worktree 与 `/tmp/*` 里做，**已 `git worktree remove --force` 清掉**。
|
2026-09-15 12:36:28 +08:00 |
|
|
|
b7db72bd48
|
fix(套件): 自检 4 的锚点改成**运行时拼**（搜索键不进搜索者源码）—— 治位置依赖，不只治位置
dsh（a673cf13）指出上一版 `lastIndexOf` 只治**位置**（"可执行那处在更后面"），
正确性仍依赖"锚点字面量只出现两次且顺序稳定"，而位置是会被搬动的 —— 第 7 例就是搬出来的。
改法：锚点在运行时拼接，源码里不存在完整的搜索键：
const GATE_START = 'const dueStatic = STATIC_ONLY' + '.filter';
const GATE_END = 'const probeSummar' + 'y = ';
（`GATE_END` 必须一起拼：只拼 `GATE_START` 时实测 `indexOf(GATE_END)` 命中自检自己那行，
`to < from` ⇒ 直接走"找不到到期闸区块"的 fail-closed 分支变红 —— 说明兜底在工作，但锚点得拼全。）
实测（pi）：
- 正常跑：`ok 4 - 到期闸是记账而不是 exit`、汇总照常；
- 变体（把 `process.exit(1)` 塞回 `dueFailed = true;` 之后）：`✗ 套件自检 4` 当场打出来
（报文：到期闸区块里又出现了 process.exit()）；撤销后文件字节恢复。
- 自匹配兜底断言（区间里不许出现 `selfSrc.indexOf`）保留。
|
2026-09-15 12:32:40 +08:00 |
|
|
|
6cf431ee11
|
跨端: AGC 客户端配置不入库（gitignore + rm --cached + example）+ 一条判据代替"靠记得"
pi 2026-09-15 的裁定：**gitignore + `git rm --cached` + example，不轮换**。
我照办了，并且把**决定性事实**更正过来 —— 我上一封说"已经进了公开历史"，**那句是错的**。
## 一、暴露窗口：我原先的假设**方向反了**
我上一封写的是"它**已经进过**公开仓历史，gitignore 撤不回，要认真考虑轮换"。
**实测不成立**（pi 查的，我逐条复核）：
```
$ git cat-file -e origin/main:…/rawfile/agconnect-services.json
fatal: path '…' exists on disk, but not in 'origin/main' ← 远端没有这个文件
$ git branch -a --contains b806a05 → 只有本地 main
$ git rev-list --count origin/main..HEAD → 119（本地领先，落后 0）
```
**整段鸿蒙工作一次都没推上去。** 所以窗口是**"直到下一次 push"**，不是"已经泄露"。
这把修法从**止血**变成**赶在 push 之前做完就行** —— 顺序因此是判据的一部分：
**先入库 ignore + `rm --cached`，再 push**。哪次先推了，就立刻变成"必须轮换"。
**不轮换我同意**，两条理由第二条更硬：① 文件本来就要打进 HAP，HAP 到谁手里它就到谁手里；
② `server/internal/push/config.go:51-55` 的 `AppSecret` 走 `AppSecretFile`（`resolveSecret`，
`hms.go:95` 读它，例 `/etc/agentmail/hms.secret`），**能替你发推送的凭证不在这个文件里**
⇒ AGC 客户端配置泄露**升级不成"能发推送"**。理由已写进提交信息，免得将来有人"按惯例轮换一次"
（那会白白换掉两个客户端版本的一致性判据）。
## 二、`git rm --cached`：本地那份**必须留着**
它**必须在本地存在才能构建**（`hvigorw` 打包时要读）。所以：
```
git rm --cached <文件> ← 只动索引，磁盘上那份不动
```
撤完实测：`ls` 仍在（2656 B）、`git check-ignore -v` 命中 `client/harmony/.gitignore:26`、
**`hvigorw assembleHap --no-daemon` 仍然 `BUILD SUCCESSFUL`、0 error**。
（这条我特意重编了一次 —— "撤出索引"与"构建还能用"是两件事，不能靠推理。）
## 三、★ 判据才是机制（pi 说的这条比 gitignore 重要，我同意）
`gitignore` 单独挡不住：这个文件**必须在本地存在**，任何人一次 `git add -A` 就把它加回来了，
而**那次 add 不会有任何东西变红**。所以加了
`commit-hygiene.test.mjs` 的「★ 版本库里不许跟踪 AGC 配置真身」：
- 扫**所有 tracked 文件**（不只 rawfile），找"AGC 配置的形状" —— 同时出现
`"client_secret": "[!` / `"code1": "<32+ 位十六进制>"` / `"api_key": "[!`；命中即红并点名；
- 按**内容**判，不按文件名豁免（`example` 是**故意**带这些键名的 —— 结构留、值全打掉，
所以它靠"值都是 `<!…>`"自然通过，而不是靠一个文件名白名单）；
- 另一半：**`agconnect-services.example.json` 必须存在** —— 否则新人不知道这文件要长什么样，
只能问人或猜，而**键名猜错会报一个和"配置缺失"毫无关系的构建错**。
**变异验证**（不是只跑绿）：`git add -f` 把真身加回来 ⇒ **判据红并点名**；
`git rm --cached` 还原 ⇒ **绿**。
example 我做了泄漏核对：真文件里所有 ≥12 字符的值逐个比对，**只剩 3 处 `package_name`**
（`com.jianf.agentmail`，它本来就写在 `AppConfig` 里、必须是这个值，打掉了反而误导）。
其余保留原值的是 **AGC 各区域网关域名**（`connect-drcn.dbankcloud.cn` 之类）——
那是华为的公共基础设施域名、不是本项目凭证，打掉只会让模板不能用。
## 四、`blurStyleFor`：删除后生产代码里 5 处注释在说一个**不存在的函数**
函数已按 pi 的裁定删除（`9a10ab2`，并发会话落的）。但删除后 `Wallpaper.ts`（4 处）与
`MainPage.ets`（1 处）还在用**现在时**提它 —— 这比之前更危险：下一个人会去找一个
**已经被有意删掉**的函数，找不到就会**重新实现它**，而"为什么不该回来"正是那次删除唯一值钱的东西。
全部改成过去时 + 已删除，并在 `Appearance.ts` 原处留碑文。
`:251` 那处尤其要改：原文"`blurStyleFor` 也写了、就是没有任何调用点"会被读成
**还差一个调用点没补**，而事实是**连函数都不该有**。
## 五、`debt-visibility` 那条红（pi 数出我漏的那条）
`harmony-deviceprobe.test.mjs`（2 处）**按次数登记、不整文件放行** ——
整文件放行的话，将来在这个文件里写一句真实的「这里没判」就**不会红**。
那 2 处也不是"这块没验"，而是对**词表本身**的断言。
另在 `docs/DEBTS.json` 补一笔 `deviceprobe-fixture-timing`（到期前提：两份 fixture
从"人工存文件"变成"当场采集"）。
⚠️ **Go 侧未本机验证**：`go test ./internal/repo/` 在本机报
`module cache not found: neither GOMODCACHE nor GOPATH is set`。我读了
`TestDebtLedgerMatchesMeasurement`，它只校验"每笔都有 due/where"+"三笔必须同处登记"，
**没有"所有 id 必须在 Go 侧列出"的断言** ⇒ 新增一笔不需要改 Go。
但这是**读代码得出的结论，不是跑出来的**，如实标未验。
## 六、我自己记错的两个数（pi 更正）
- **`STATIC_ONLY` 是 7 不是 8** —— 我上封写 8，`RESULT static=7` 与闸门打的 7 个文件
都是 7。我记串了。
- `PROBE_DEVICE=none` 下**是 7 条红**，我只列了 6 条，漏了 `debt-visibility`（本笔已修）。
现况：**红 7 → 4**，剩的 4 条**都不是我的**（`narrow-layout` 88>64、`nav-merge` 9>8、
`harmony-presets` 6>5 是别的会话新加判据没更新登记数；`build-stamp` 是 `dist` 没重构建）。
|
2026-09-15 12:25:25 +08:00 |
|
|
|
77aa42623a
|
跨端: debt-visibility 补登记（新判据文件不会自动跑守卫）+ blurStyleFor 删除后的注释真相
## 一、`debt-visibility` 那条红：**新文件不会自动跑一遍守卫**
```
这些文件里有"边界声明"，但一次都没登记：
harmony-deviceprobe.test.mjs（2 处） ← e917b87/4880c31 新加的判据文件
```
**这是同一个洞在新文件上的复发**：上一轮我刚修完 `harmony-admin` / `harmony-imageprep`，
下一个**新建的**判据文件又踩了同一个坑。pi 之所以看见，只是因为他跑了整个套件 ——
**缺的不是"记得登记"，是"新建判据文件"这个动作没有守卫**。这条形状与"写了判据忘了接线"同族，
只是这次忘的是**登记边界**。
处理：**按次数登记（2），不整文件放行** —— 整文件放行的话，将来在这个文件里写一句
真实的「这里没判 / 已知缺口」就**不会红**。那 2 处本身也不是"这块没验"，
而是对**词表本身**的断言（`unverifiedReason(...)` 必须含「未验」）。
同时在 `docs/DEBTS.json` 补一笔 `deviceprobe-fixture-timing`（`where` 指向该文件）——
`debt-visibility` 的第二条要求"声明必须有对应的一笔"，两处各写各的会让审计只找到一处。
这笔的**到期前提是"两份 fixture 变成当场采集而不是人工存文件"**。
⚠️ **Go 侧未能本机验证**：`go test ./internal/repo/` 在本机报
`module cache not found: neither GOMODCACHE nor GOPATH is set`。我读了
`TestDebtLedgerMatchesMeasurement`：它只校验"每笔都有 due/where"+"三笔必须同处登记"，
**没有"所有 id 必须在 Go 侧也列出"的断言**，所以新增一笔不需要改 Go。
但这是**读代码得出的结论，不是跑出来的** —— 如实标成未验。
## 二、`blurStyleFor` 删除后：生产代码里 5 处注释在说一个**不存在的函数**
函数已按 pi 的裁定删除（别的会话的 `9a10ab2` 落的）。但删除后
`Wallpaper.ts`（4 处）与 `MainPage.ets`（1 处）还在用现在时提它：
```
Wallpaper.ts:242 "由 `model/Appearance.ts` 的 `blurStyleFor` 映射成系统材质档"
Wallpaper.ts:248 "页面拿它去问 `blurStyleFor`"
Wallpaper.ts:251 "`blurStyleFor` 也写了、就是没有任何调用点"
Wallpaper.ts:311 "`blurStyleFor` 里面也有一次 clamp，那是它自己的防线"
MainPage.ets:1711 "（`blurStyleFor` 那张表服务的是**材质档**…）"
```
**这正是本会话反复在消的"注释描述一份不存在的代码"**，而它现在比之前更危险：
下一个人读注释会去找一个**已经被有意删掉**的函数，找不到就会**重新实现它** ——
而"它为什么不该回来"恰恰是那次删除唯一值钱的东西。
已全部改成**过去时 + 它已删除**，并在 `Appearance.ts` 原处留了碑文（函数没了，理由不能没）。
`:251` 那处尤其要改：原文说"`blurStyleFor` 也写了、就是没有任何调用点"——
函数已不存在，这句会让读者以为**还差一个调用点没补**，而事实是**连函数都不该有**。
## 三、这条碑文判据我做了变异验证
`harmony-appearance.test.mjs` 里那条「碑文不许回来」的判据**确实在校验**（不是摆着好看）：
把 `Wallpaper.ts` 那段碑文抹掉 ⇒ **红**；还原 ⇒ **绿**。
顺带核了它的**指向**：碑文现在的主要落点是 `Appearance.ts`（函数原来所在处），
而判据的正则锚的是 `Wallpaper.ts` —— 两处都有内容才过，我保留了 `Wallpaper.ts` 里的引用
（它说明"这里的 px 不是材质档"），所以判据成立。
## 四、未做
- 到期闸门那 **7 条**（pi 更正过我：`STATIC_ONLY` 是 7 不是 8，我上封记串了）**仍然没动**。
- `PROBE_DEVICE=none` 下**剩 5 条红**，都是**别的会话**新加判据但没更新登记数
（`narrow-layout` 88>64、`nav-merge` 9>8、`harmony-presets` 6>5、`commit-hygiene` 3>2）
加 `build-stamp`（`dist` 没重构建，与本次改动无因果）。**我没有替他们改**。
|
2026-09-15 12:22:23 +08:00 |
|
|
|
8ea33aeb91
|
跨端: fix(套件): 把自检 4 移到到期闸之前，并修掉"锚点自匹配导致它空转报 ok"
dsh 报了"移动未完成"（他两次栽在自己的锚点假设上）并把行号级配方留在上一封里。
这一笔把那一步做完，并在做的过程中撞到**移动本身引出的新洞**：
1. 自检 4 从到期闸**下游**移到**上游**（与自检 1/2/3 同层）
—— 否则"闸一 exit，自检连跑的机会都没有"，而那正是它唯一要防的场景。
`let selfCheckFailed` 的声明一起上移（否则在声明前赋值 → ReferenceError）。
2. ★ 移动后它**空转报 ok**（比原来更糟：连失效都不响）。原因：
锚点写的是 `indexOf('let dueFailed = false;')` / `indexOf('const probeSummary')`，
而**这两串字本身就写在自检代码里**（作为 indexOf 的实参）。自检块一旦移到真闸之前，
`indexOf` 第一次命中的就是**自检自己那两行** ⇒ 扫描区间变成自检自己的两行 ⇒ 真闸从没被扫过。
⇒ 修法：锚点改 `lastIndexOf`（真闸在自检之后），并加一道**自匹配断言**
（区间里若出现 `selfSrc.indexOf` 就判红，不许空转）。
实测（pi）：
- 正常跑：`ok 4 - 到期闸是记账而不是 exit`、汇总照常打；
- 变体（把 `process.exit(1)` 塞回 `dueFailed = true;` 之后）：**`✗ 套件自检 4`当场打出来**
（报文：到期闸区块里又出现了 process.exit()）—— 修复前这个变体是 0 命中；
- 变体撤销后文件字节恢复（`git diff` 空）。
|
2026-09-15 12:22:15 +08:00 |
|
|
|
9a10ab2fcf
|
跨端: fix(harmony-appearance): blurStyleFor 已删除 ⇒ 换成**碑文判据 + 性质现居地**（不是只删）；顺手修两处说谎的标题
pi 2026-09-15 查到根因：`blurStyleFor`（px → 材质档）已**有意删除**（碑文 `Wallpaper.ts:246`：
"没有、也不该有消费者"），而判据文件里还有引用、2 条真在调用 ⇒ `A.blurStyleFor is not a function`。
**只删会把"这个性质搬到哪了"一起删掉**（pi 的建议）。所以两处改成：
1. **碑文/反回归**：`typeof A.blurStyleFor === 'undefined'` —— 有意删除的东西不许悄悄回来；
外加"理由必须留在原处"（碑文正则，删了理由也会红）；
2. **性质的现居地**：导航面板材质现在是**固定系统档** ——
`common/Theme.ets` 的 `navMaterial: BlurStyle = BlurStyle.COMPONENT_THICK`（从"函数映射"搬到"常量"）。
3. 后半段那组（分档边界/单调性/NaN）**整体作废且不硬造等价物**：它们的**主语**没了，
常数没有单调性、没有越界归并、没有 NaN 方向 —— **性质随主语一起消失，判据变少是对的**。
★ 另修**两处说谎的标题**（本判据属于 pi 的"标签必须等于断言范围"）：
- `★ blurStyleFor：分档边界、单调性、NaN 都是行为` → `★ 碑文：blurStyleFor 不许回来 + 理由必须留在原处`；
- `★ 模糊值映射到**系统材质档次**` → `★ 材质档**不再是 px 的映射**：碑文 + 性质现居地`。
改前它们断言的内容与标题已经完全不是一回事。
实测：`# pass 25 / # fail 0`（此前 退出码 1）。登记 26 → 25 同步（**变少是对的**）。
|
2026-09-15 12:20:41 +08:00 |
|
|
|
ee3ada2740
|
test(登记): harmony-calendar 登记数 10→23（自报 23）—— 这条判据是我写的，登记数该我维护
汇总被到期闸吃掉时看不见这条；修好到期闸后它立刻显形（正是 pi 抓的那个 bug 的收益）。
其它 4 条条数不符（narrow-layout 88>64、nav-merge 9>8、harmony-presets 6>5、commit-hygiene 3>2）
都是**别人的在飞文件**，我不改它们的数字。
|
2026-09-15 12:16:50 +08:00 |
|
|
|
171f2323d9
|
test(套件): 补"到期闸不许吃掉汇总"的自检 4 —— **但它现在放在下游，抓不到它要抓的那种回归**（已知未完成）
补的是我上一封自己承认的缺口（"这条修复没有判据钉着"）。但实测暴露了更难看的一件事：
**突变检验**（把 `process.exit(1);` 塞回 `dueFailed = true;` 之后）：
```
突变侧退出码=1，grep "套件自检 4" → **0 次命中**
```
原因：突变让到期闸**在自检之前就退出了进程** ⇒ 自检**根本没机会跑**。
⇒ 我把判据放在了**被它检查的东西的下游** —— 而这**正是本文件自检 3 存在的原因**
（"判据不得写在 `process.exit()` 之后，永远不会跑"）。我新写的这条自检，犯了它旁边那条自检专门在防的错。
**修法（未完成，如实记在这里）**：这条自检是**纯静态源码检查**，应当移到到期闸**之前**。
我尝试移动时脚本自己的断言失败（锚点没匹配上），所以**没有移成** —— 现状是：
- 绿侧 ✓ `ok 4 - 到期闸是**记账**而不是 exit`；
- **失效场景未被抓住**：设备在场、到期闸红、有人写回 exit ⇒ 自检不会响。
另外记一条同族：这条自检第一版**指着自己报红**（它的报错文案里就含 `process.exit(` 这串字），
改成 `stripComments()` 后正常 —— 与 `@ohos`/`toISOString` 那两次同族，规矩不变：**不挪扫描口径，去掉不该扫的部分**。
|
2026-09-15 12:15:40 +08:00 |
|
|
|
ecab509a57
|
跨端: fix(套件): 到期闸的 process.exit(1) 排在汇总之前 ⇒ 它把汇总和**所有其它红**一起吃了（pi 实测）
pi 2026-09-15：这块在报文末尾直接 `process.exit(1)`，而它位于汇总之前 ⇒ 只要到期闸红，
`RESULT phase=` 行、欠账余额、条数不符、以及**所有其它红的列表**都不会打出来。
他实测到：`harmony-presets` **实报 6 / 登记 5** 这条真红**一次都没显示过**。
形状：**一道闸把不属于它的证据一起吃掉** —— 与"跳过会在下一轮被读成验过了"同族：
前者让红的**消失**，后者让没验的**看起来验过**。
修法不是"少红"，而是**记账 + 继续走完**：
- 到期块改成 `dueFailed = true`（不再 exit）；
- 汇总分支条件加 `&& !dueFailed`（否则会误报"全部通过"）；
- 结尾保留 `exit(1)`，并在"只有到期闸红"时多打一句说明。
实测（`AGENTMAIL_CRITERIA_PHASE=install node test/run-all.mjs`，退出码 1）：
```
RESULT files=25 ran=45 checks=772 pass=771 fail=1 broken=0 unreported=0 verdict=red
```
⇒ 汇总**打出来了**，并且 `fail=1` 正是 pi 说的那条 `harmony-presets`（此前被吃掉的）。
`RESULT phase=` 行与到期报文同时在场。
**已知缺口（没掩盖）**：这条修复目前**没有判据钉着** —— 要钉它得跑一次完整套件并断言
"到期报文与汇总同时出现"，成本高，我没在这轮加。谁下次碰这块应先补它。
|
2026-09-15 12:12:19 +08:00 |
|
|
|
4880c31110
|
跨端: fix(设备闸): app state 交叉验证（矛盾⇒拿不准）+ 正例换成**真机实采**样本
pi 邮件 `6f902e1e` 指出两件，都对：
1. **我那条正例是自相矛盾的**：我用脚本把 `state #FOREGROUND` 对调，却漏了同一块的 `app state #X`
⇒ 造出 `state FG` + `app state BG` 这种**真机上不会出现**的 dump。于是"闸能放行"这条正例
建在**非法输入**上 —— 它绿，但它没证明任何真机会发生的事。
现在：正例改用 12:08 **真机实采**的 `fixtures/aa-dump-l-ours-foreground.txt`（两个 mission 都在、
`state`/`app state` 一致、FG 是我们）；
2. 顺手把"矛盾怎么办"钉成规则：同一块里 `state` 与 `app state` 打架 ⇒ **`unverified`**，
**不许"挑一个信"**（那是把互相打脸的证据当成证据）。`app state` 缺失时不因此判未验
（否则老格式 dump 会一律未验 —— 那是"更安静的失效"）。
判据 8 条全绿；登记同步为 8。
|
2026-09-15 12:10:49 +08:00 |
|
|
|
329a2e2e81
|
test(设备证据): 第一次真机读回通过闸（前台=ours）—— 收两份真实证据
1. fixtures/aa-dump-l-ours-foreground.txt：**真实**的我们前台样本（此前那条正例是**对调状态合成的**，
这份是真的）——闸判 ours、mayAssertOn=true。
2. fixtures/ui-layout-ours.json： 实采的控件树（33,899 B），
带 bounds/backgroundColor/text 等属性 —— 这是把 harmony-appearance / appearance-defaults /
cross-client-theme 三条从验形状升成真机读回的原料。
顺序按 pi 的更正：**先拿窗口（探测说静默）再 aa start**，然后取 dump 过闸。
|
2026-09-15 12:09:37 +08:00 |
|
|
|
5337d51bfb
|
test(设备闸): 补第二份真样本（单 mission，我们不在列表里）+ 把"状态对调"那条从弱断言改成**严格正例**（pi §4②）
- 新样本 `fixtures/aa-dump-l-single-theirs.txt`：由真样本删掉我们那块得到，形状与 pi 12:03 的活 dump 一致
（单 mission、`state #FOREGROUND` 是对方）⇒ 正确判决 **`other`**，不是 `unverified`
—— 否则会把"别人占着前台"和"没读到"混成一种；
- `#FOREGROUND` 全删 ⇒ `unverified`（缺证据不猜）；
- ★ 原"状态对调"那条我原先只断言 `ours || unverified`（当时心虚写宽的）。pi 指出：
**只判"读不出来就不许过"是不够的，还得有正例证明"读出来了真的能过"** —— 否则这道闸的失效方式是
"永远说未验"（更安静的失效，而且欠账永远还不完）。已改成严格断言 `ours` + `mayAssertOn === true`。
- 登记 5→7（我一度写成 8：我只加了 2 条，5+2=7 —— 相等契约下这种手误会被套件当场抓住，这正是它该干的事）。
|
2026-09-15 12:08:09 +08:00 |
|
|
|
4af083e8b8
|
test(判据): 4 个判据读的是**另一棵树** —— 修掉硬编码的仓库根，并让 stripComments 保持行号
pi 2026-09-15 实测出来的，**这次长在判据自己身上** —— 正是我们前几轮一直在消的那个形状。
## 一、`const ROOT = '/home/program/agentmail'`：规则进来了，对象没进来
`harmony-arkts.test.mjs` 把仓库根写成了绝对路径。后果我按 pi 的步骤亲手复现了：
```
$ git worktree add --detach /tmp/wt-verify 7f4fa26 # 那个检出里 import 顺序**确实**违规
（核对：最后 import 在第 80 行，而第 63 行已是 `const NAV_MATERIAL_OF…`）
$ cd /tmp/wt-verify/client/electron && node --test test/harmony-arkts.test.mjs
ok 1 / ok 2 / ok 3 # pass 3 # fail 0 ← **在一个明显违规的检出上 3/3 全绿**
```
因为它读的不是 `/tmp/wt-verify`，是 `/home/program/agentmail`（那份早已修好）。
两层后果，第二层最糟：
① 它**永远无法验证任何别的 checkout / CI / 镜像** —— 换目录不是"红"，是 `readdirSync` 直接抛；
② 在本机做 worktree 复核时，它**静默读另一棵树并报绿**。
**判据的逻辑是对的、对象是错的** —— 这比"判据写错了"更难发现，因为它在原地永远是绿的。
同一个毛病在 4 个文件里，**恰好全是最近这几笔新写的**（另 10 个鸿蒙判据写法是对的）：
```
harmony-admin / harmony-imageprep / harmony-presets / harmony-arkts → const ROOT = '/home/program/agentmail';
其余 10 个 → const ROOT = join(HERE, '..', '..', '..');
```
已全部照邻居改掉。**修好之后在同一个违规检出上：`# fail 1`** —— 它终于会红了。
## 二、修这条时又牵出一个：`stripComments` **改变了行号**
修好路径后，判据报出"最后一个 import 在第 64 行、第 47 行已是语句"，
而**真实文件里是第 80 / 63 行**。成因：`stripComments` 把块注释整块抹成 `''`，
而块注释**自带换行** ⇒ 它之后所有行号整体前移。
这不是小节：全仓判据都用 `文件:行号` 定位（`grep -n`、编辑器跳转、`git show` 核对），
**报出来的行号必须能直接用**，否则读者第一步得先猜"这是剥过的还是没剥的"。
改成"块注释里的每个换行换成等量空行"。修完报的就是 **80 / 63**，与文件逐字对上。
## 三、新增两条判据，让这两个形状不能再回来
1. **`★ 判据不许把仓库根硬编码成绝对路径`** —— 扫判据目录里**真代码**
（`code()` 剥注释，否则本文件自己的说明文字就会误报），找
`const X = '/绝对路径'` 且**看着像仓库内**的声明。
**例外按名字放行**（含 `TOOLCHAIN`/`SDK`/`HDC` 的常量）—— 工具链本来就不在仓库里、推不出来；
按**值**做白名单会逼着下一个人为了过判据去改那个路径的写法。
2. **`★ stripComments 必须保持行号`** —— 造含多行块注释的样本，断言剥完
**行数不变**、且第 N 行仍是原来的第 N 行；**同时**断言注释内容确实被去掉了
（别为了保行号把注释留下）。
两条都做了**变异验证**：
- 把 `harmony-admin` 的 ROOT 改回硬编码 ⇒ 新判据**红**，并点名那个文件；还原后绿。
- 在 `MainPage.ets` **import 之前**插一条语句 ⇒ `harmony-arkts` **红**
（第 79 行 vs 第 1 行）；还原后绿。**这条同时证明了"读的是自己那棵树"** ——
同样这个变异，在修路径**之前**是绿的。
## 四、未做 / 未验
- 到期闸门那 7 条**没动**（要真装真点，是另一件活）。
- **"把 build 做成一条判据"我探了，两个硬障碍**（详见给 pi 的回信）：
① `client/harmony/oh_modules` 被 `.gitignore` 排除且未入库 ⇒ **全新检出没有它**，
构建会先死在装依赖上；② 本沙箱**拒写 `/root/.hvigor`**（`mkdir` Permission denied），
`hvigorw` 在 worktree 里直接 `EACCES: mkdir '/root/.hvigor/project_caches/…'`。
所以它在本仓能编过、在干净检出编不过 —— 作为判据它现在会**假红**。
|
2026-09-15 12:06:15 +08:00 |
|
|
|
b413fbb43e
|
跨端: fix(设备闸): 按真机形状改写解析（前台 = state #FOREGROUND 那个 mission 的 bundle），判据改喂真机样本
第一版是**猜的**格式（`bundleName: com.x`），真机上根本没有这种写法；退一步"取第一个 bundle name"
又会取到别人的（真机多 mission，`#31 com.example.homeagent` 排在我们 `#32` 前）⇒ 假绿（pi 独立复现）。
真机形状（样本 `test/fixtures/aa-dump-l-real.txt`，实采）：每块 `Mission ID #N … ` +
`bundle name [com.x]` + `state #FOREGROUND/#BACKGROUND`；**前台只由 `state #FOREGROUND` 决定**。
- `parseMissions` / `foregroundBundle`：按块解析，取不到返回空（不猜、不兜底）；
- `foregroundVerdict` 三态不变：`ours` / `other` / `unverified`；
- 有 mission 但**全无 FOREGROUND** ⇒ `unverified`（不是"没我们所以算别人"）；
- 空 dump / 截断 ⇒ `unverified`，状态词写明"**缺证据 ≠ 没有那个现象**"。
判据 5 条（喂真样本 + 对调状态 + 空/截断/无前台 + 撞名撞文案反证）全绿。
真样本本身含"对方在前台"那一刻 —— 争用在一分钟内真实发生过，所以这不是构造出来的场景。
|
2026-09-15 12:05:17 +08:00 |
|
|
|
88fa5cb149
|
test(设备闸): 收一份**真实**的 aa dump -l 作为样本（来源与时间写在下面）
为什么要收它：`DeviceProbe.parseForeground` 原先是按**猜的**格式写的（`bundleName: xxx`），
而真机上的形状是 `bundle name [xxx]`，且**多个 mission 并存**、前台由各 mission 的
`state #FOREGROUND` 决定。两种错法都能发生：
- 按 `bundleName:` 解析 ⇒ 全部匹配不到 ⇒ 闸永远返回 `unverified`（方向安全，但等于没法用）；
- 只取**第一个** `bundle name` ⇒ 取到的是**别的 app**（这份样本里 `#31 com.example.homeagent`
就排在我们 `#32 com.jianf.agentmail` 前面）⇒ **假绿**。
样本内容（采集于 2026-09-15，`hdc -t 127.0.0.1:5555 shell "aa dump -l"`）恰好是**争用发生后的那一刻**：
我们的 mission 在，但**前台是别的 app** —— 正是这道闸要挡的输入，而且是真实形状而非构造的。
采集背景（同一分钟内）：`aa start` 报 success，随即 dump 显示我们 FOREGROUND（84231），
约一分钟后再次 dump（本样本）**前台已被对方拿回**（`#31` FOREGROUND）——
所以"争用"不是理论风险，它在一分钟内就发生了。
|
2026-09-15 12:02:58 +08:00 |
|
|
|
c12744e8c3
|
跨端: 导航条材质选 (a) 固定档（推翻我的 (b)）—— 并修掉"注释说 (a)、代码是 (b)"的自相矛盾
pi 2026-09-15 裁定：**推翻 (b)，选 (a)**。我原先给 (b) 的理由不成立，他逐条驳了：
1. **WebUI 的导航条根本不读 `--bg-blur`**：`index.css:1114` 的 `.narrow-nav` 是硬编码
`backdrop-filter: blur(18px) saturate(1.5)`。我引这条支持"两个量不同"，
而同一条也说明**它不由用户偏好驱动**。
2. **WebUI 那个滑杆的语义是"背景"**：`BackgroundPicker.tsx:183` —— `label="模糊"`、
`hint="虚化细节，避免背景与正文抢注意力"`、`min=0 max=24`，只作用在
`.app-backdrop{filter:blur(var(--bg-blur))}` 上。
3. WebUI 自己留了**分开的**令牌 `--bg-blur-panel`（`index.css:267`，注释写明
"与壁纸自身的 `--bg-blur` 分开"）—— 它的词汇表本身就拒绝把两者等同。
4. **★ 我给 (b) 的理由不成立**：我写"(a) 会让那个滑杆在导航条上变成死控件"，
可那个滑杆**已经**被壁纸消费了（`MainPage.ets` 壁纸层的 `.blur(bgPlan.blurPx)`）——
它从来**不是**导航条的控件。(a) 之下它照样是活的。
5. §7.12 的「材质（玻璃）」行原本写的就是固定档 ⇒ (a) 是**回到**已登记契约。
产品向还有一条：**导航条是 chrome，材质应当稳定**，不该因为用户换张壁纸而变厚变薄。
## 最该记的是：我的注释和代码**互相矛盾**
`MainPage.ets` 里那段注释论证的是 (a)、并明确写着"跟随是错的，pi 抓出来了"，
而它下面那一行代码是 (b)。**下一个读者会照注释把代码改回去，并引我那句话当权威。**
这是这一路反复在消的形状（说的与做的不一致、而判据看不见），这次落在**注释**上 ——
而注释正是"理由要写清"那条纪律的证据源。已整段重写为真实的 (a) 版本，并把
"(a) 会让滑杆变死控件"这个**错的理由**连同它为什么错一起留在注释里。
## 做掉的东西
- `MainPage.ets`：导航条回到 `.backgroundBlurStyle(Theme.navMaterial)`；
删掉 `NAV_MATERIAL_OF` 表与 `navMaterialFor` 的 import（(a) 之下都是孤儿）。
- `model/Appearance.ts`：删 `navMaterialFor`（它存在的唯一理由就是方案 (b)）。
`blurStyleFor` 现在**没有任何调用点** —— 如实登记在它的文档注释里
（"有测试"不等于"有人用"，上一轮我刚因同形状被抓过），不假装它活着。
- **五处"整条字面表达式"断言改成语义断言**（pi §四）：`cross-client-theme`、`harmony-appearance`、
`harmony-nav`（3 处）此前都在钉
`/\.backgroundBlurStyle\(NAV_MATERIAL_OF\[navMaterialFor\(…\)\] \?\? Theme\.navMaterial\)/`
—— 字面换字面，正是 `CRITERIA.md` 不许的"对源码形状的匹配"。
现在判：① 那一处的材质**来自 `Theme.navMaterial` 这个系统令牌**；
② **不许跟随** `bg_blur`（NavBar 真代码里不许出现 `blurPx`/`blurStyleFor`）；
③ 令牌是 `BlurStyle` 枚举值、不是 `NONE`、且**成员名真实存在于 SDK 枚举**。
- "可达性"那条判据**随契约作废**（它守的是方案 (b)）：换成判 (a) 的契约。
**判据随契约走，不随实现走。**
- `harmony-appearance`：原先判"页面里那张表的键必须是 SDK 成员"。表删了，
改成**枚举 `blurStyleFor` 的整个值域**（0..40 + 界外 + NaN），逐个核 SDK 成员 ——
比原来只核表里那三行**更严**。
## 判据自己先错了一次，记下来
新判据第一版**没剥注释**就断言"NavBar 里不许出现 `blurPx`"，当场红了 ——
而红的原因不是代码错，是 `NavBar` 的**文档注释**里正好写着
"我一度把档位接过用户偏好（`navMaterialFor(this.bgPlan.blurPx)`）"这句历史说明。
**注释说明禁令 ≠ 违反禁令**；不剥注释，这条判据就会变成"逼人删掉解释"，
恰好与本仓库"理由要写清"的纪律相反。改成 `stripComments(bar)` 后再判，并加了一条
"注释里确实留着那处说明"的自检前提。
## 变异体：45 个全部被抓（含 3 个新判据的专属变异）
方案 (b) 落地时配的 13 个变异体**整体作废**（它们锚的代码被删了），标注 `retired`
并写清理由 —— 不是"没跑成"。另有 5 个锚点漂移（我在注释里逐字引用了被锚的那句代码，
污染了通用正则）的**重锚**到真代码；注释里那句逐字引用也一并去掉了
（**注释里逐字抄代码**正是让"按字面锚定"的变异体反复失效的根因）。
新增 3 个针对 (a) 契约的变异体（绕过令牌 / 又跟随 `bg_blur` / 令牌变 `NONE`），全部被抓。
## 未验
- **真机观感仍未验**：三档材质在真机上能不能看出差别、滑杆手感、管理页布局，
只有真机能答。本机模拟器已起（`hdc list targets` 有目标），但
`run-all.mjs` 的**设备闸已经到期**（8 个静态判据的前提成立）⇒ 套件现在会挡在
那道闸上、不打 `RESULT`。**这不是本笔引入的**（前提是环境变了），已单独报给 pi。
- Go 侧 `debt_registry_test.go` 仍未在本机跑（无 Go 模块缓存）；pi 已在别处跑过，绿。
|
2026-09-15 11:58:19 +08:00 |
|
|
|
e917b8782a
|
跨端: feat(设备闸): DeviceProbe.ts —— "读到别人的界面"是假绿来源，读之前先判"是谁的"，拿不到就记未验
pi 邮件 `971c58fa` §4 / `bf583b0f` §2。别的 agent 在同模拟器上 `aa start` 会抢前台，
之后读到的控件树是**它的窗口** ⇒ 断言可能通过也可能红，**两者都不是在讲我们的界面**（前者=假绿）。
- `foregroundVerdict` 判决只有三种：`ours` / `other` / `unverified`；**只按 bundle 判，不许看标题/文案/控件名**
（别人的合法 dump 里完全可能有同名控件与同文案，"邮件"这种通用词尤其容易撞）；
- `parseForeground` 取不到就 **undefined**（空 dump / 截断 / 格式变了都不猜）；
- `mayAssertOn === false` ⇒ 调用侧必须记 **`未验`**（欠账继续开着），**不许**记通过、**不许**静默跳过
—— 跳过会在下一轮被读成"验过了"；
- `unverifiedReason` 统一状态词，并写明"**缺证据 ≠ 没有那个现象**"。
判据喂 4 类样本（pi 指定的最易漏输入）：① 我们的 dump ② **别人的合法 dump（含同名控件 + 同文案）**
③ 截断/畸形 ④ **空 dump**（窗口没起来时最常见，最容易被当成"坏现象不存在"）。
另加一条只按 bundle 判的反证（把标题改成"像我们"也不许变 ours）。
**顺手抓到自己一个坑**：`firstMatch` 第一版的否定类既接受非 ASCII 也接受**换行**
⇒ 对 `windowTitle: 邮件\n abilityName: …` 会吞掉中文标题并**捕获下一行的键名**，
"标题"读到 `abilityName`（看起来有值、其实指错地方）。判据当场抓到 ⇒ 改成按行取、值允许中文、空值不回退。
|
2026-09-15 11:54:25 +08:00 |
|
|
|
38b0e07415
|
fix(判据): 计数契约由"不少于"改成"相等"（只判下界时，多加的判据不受"被删会红"保护）
pi 邮件 `9fed4386`：`harmony-push` 实报 13 / 清单登记 12 —— 因为 `ran < expected` 只判**下界**，
所以多出来的第 13 条**不在"被删会红"的保护内**（删掉它不会有任何东西变红，保护只覆盖前缀）。
两处改：
1. `harmony-push` 登记 12 → **13**；
2. 计数契约改成**相等**，并把两个方向的成因与处置分开写：
· `ran < expected`：判据被删/被跳过/check() 被改坏…… 确认该减少条数时改清单数字；
· `ran > expected`：新加的判据不在保护内 —— 请把清单数字改成实际条数，
这样"被删会红"才真正覆盖全部判据，而不是只覆盖登记过的那部分。
|
2026-09-15 11:51:39 +08:00 |
|
|
|
ab31690348
|
跨端: fix(推送客户端): 登记标记绑定账号（token 换账号是"转移"不是并存 ⇒ 别把登记状态缓存成长期结论）
pi 邮件 `2518e1a3` 的服务端事实：注销只认注册者本人、token 字符串不是凭证，
**同一个 token 换账号登录是"转移"而不是并存** ⇒ "我登记过没有"的答案**随账号而变**。
原来的 `shouldReportToken(lastReported, current)` 只按 token 存标记 ⇒ 换账号后
（同一 token）会**错误地跳过上报**，而那个账号其实还没登记过这个 token。
改成 `reportMarker(accountKey, token) = accountKey|token` + `shouldReportToken(lastMarker, accountKey, token)`：
**账号变了标记必然不同** —— 于是"换账号必然重新上报"是**性质**，不靠人记得 reset。
判据 13 条全绿（新增"换账号后必然重新上报 / 切回来也要重新上报"，并断言两次 marker 不相等）。
|
2026-09-15 11:51:39 +08:00 |
|
|
|
30886271ea
|
跨端: docs(引用锚): 把日期锚换成邮件 ID（pi 邮件 b1e23663：日期也是锚，写错一天下一个人找不到那封信）
pi 指出的锚错：`PushContract.ts` 里那段线上形状是 pi **09-15** 发的（邮件 `004983bb`），我写成了 09-14。
照他的推理（"引用别人的工作状态时，哈希和'谁在读'一样会漂"）往下再走一步：
**日期本身就是会漂的锚 —— 邮件 ID 不会。** 所以不是把 09-14 改成 09-15 就完事，
而是把这一族引用改成**可检索的标识**：
- `PushContract.ts`：契约来源 → `1f9ff3b4`；线上形状 → `004983bb`；
- `harmony-push.test.mjs`：同上两处；
- `Calendar.ts`：表头共用分叉、"今天"的调用侧 → `f60521de`；
- `ALIGN-REFS.json`：参照物版本登记 → `6e14b410`；圆角策略追认 → `90372ca1`；AGC 包名实测 → `1f9ff3b4`。
共 10 处。判据不依赖这些注释文本，改完 `harmony-push` 12/12、`harmony-calendar` 10/10、`align-refs` 3/3 仍绿；
`ALIGN-REFS.json` 仍是合法 JSON。
**没改的 4 处**（`NavItems.ts` 1 处、`Wallpaper.ts` 3 处）：它们写于 09-14 那批往来，日期本身没被指出错，
而那几封的邮件 ID 我这边没有（跨过一次上下文压缩）——**宁可留着有争议的日期，也不编一个 ID**。
|
2026-09-15 11:51:39 +08:00 |
|
|
|
ed0ad2508e
|
跨端: feat(推送客户端): 按线上形状补契约层（DELETE 也带 body / 未知字段 400 / provider 无白名单 / 错误是 {"error"}）
pi 2026-09-14 给的线上形状（从 handler/push.go 读的，不是猜的）逐条落成可判的：
- **请求体只放已知键**：`PUSH_BODY_KEYS` 登记四个键，**未知字段服务端直接 400**（不是静默忽略）
⇒ 拼错会立刻可见；可选字段为空就不放（空串虽合法，但不放更不容易踩校验）。
- **provider 只做形状校验、没有白名单**（`^[a-z0-9_-]{1,32}$`）：判据断言 `apns`/`fcm` 也合法 ——
客户端**不许**硬编码"只有 hms 合法"去先拦一道（服务端没实现的通道不该变成客户端的 400）。
这正是"校验的范围必须等于它真正知道的事"的又一落点。
- **token**：空非法、512 上限；形状不合法 ⇒ `buildTokenBody` 返回 undefined，调用侧**静默跳过**，
不去打一次注定 400 的请求。
- **错误体是 `{"error"}` 不是 `{"message"}`**：判据专门断言 `{"message":"x"}` 解析出 undefined
（用错键会把"没有消息"当有消息）。
- **注销：`deleted:false`（本来没登记）不是失败** ⇒ 它**不改变分类**，所以**不再是入参**
（一个不影响结果的入参只会让人误以为它影响结果），判据断 `classifyUnregister.length === 2` 钉住这点。
- **`ApiClient.del` 补可选 JSON body**：DELETE 端点是 JSON body 形状（不是 query、不是 path 参数），
原来只有 `path` ⇒ 注销会无效。不传 body 时行为与旧版完全一致（向后兼容）。
EOF
|
2026-09-15 11:43:22 +08:00 |
|
|
|
8fed8401de
|
跨端: feat(推送客户端): 契约层 model/PushContract.ts + 6 条设备无关判据（静默失败/enabled:false 正常态/按 provider+tail 比/按 mail_id 去重）
pi 2026-09-14 推送契约的客户端半边。四条不变量里**三条是纯逻辑**，所以先落这三条，
平台调用（Push Kit 取 token、通知权限）留在下一步的 `PushService.ets` 里。
- `shouldReportToken`：取不到 token 不上报；与上次相同不重复上报（否则每次启动打一次接口）；
- `tokenTail` / `isRegistered`：GET **只回尾 6 位** ⇒ "登记过没有"必须按 `provider + tail` 比。
比全文是**看起来更严、其实永远为假**的写法（全文永不等于尾 6 位 ⇒ 每次启动重复上报），
所以有判据钉它，并在注释里写明"同尾 6 位即视为同一条 —— 这是服务端给的信息量的上界，不是我们的选择"；
- `classifyRegister`：`ok-enabled` / `ok-disabled` / `silent-skip` —— **三种里没有一种是"提示失败"**
（`enabled:false` 是自部署常态 ⇒ 不重试、不提示）；
- `parseNotificationData`：不满足约定形状就返回 undefined（坏 JSON 不抛、缺 mail_id/动作不符都忽略）——
推送是可选通道，收到不认识的东西不许有任何副作用；
- `NotificationLedger`：服务端**无幂等键**（至多一次、无重试/去重表）⇒ 重复保护落客户端；台账**有界**。
另有一条判据禁止契约层引入 `@ohos`/`@kit`（否则这些判据会退化成必须上设备）。
它第一次跑**咬到了解释这条规则的那行注释** ⇒ 改扫 `code()`（去注释），与前面扫描口径那次同族。
`npm test`（install 相位）全绿；余额 `debts=13`。
|
2026-09-15 11:40:54 +08:00 |
|
