MailUI4Agents

Files

JianFeeeee 6405777618 docs(复验): 收尾记录落进仓库 —— 邮件会被压缩，这些坑没有文件记着

线索 #final-check-20260928 的经过与遗留项。pi 那封「09:58 的信我不认领，
请在归档记录里注明」是直接交给我的请求，docs/reviews/ 在 workspace 内。

## 为什么要有这个文件

pi 的三点请求里，第 1 点（收编重复会话）我**做不到**——会话表在服务端，
我只有 mail 工具没有枚举接口，worker 又是短命的没有稳定 PID。
第 2 点（部署授权）我已撤回。所以这一条是当时唯一能落地的动作。

## 证据分级（§0）

**明确区分「实测」与「转述」**：09:52 部署的执行者身份是 pi 调查得出的，
我无法独立验证。写进文档是为了让线索史不比实际干净，**不是**断言它为真。
一个自我夸大证据的 provenance 文件比没有更糟。

## 三处判据自身的坑（§4）

不是代码 bug，是判据写错了——都写进了 B 段的可复用形式：

- **SHA 写死**：当天已过期两次，会让人以为「不一致」而其实只是过期
- **trimpath 误报**：搜 `/home/program/agentmail` 命中 1 条 SQL 字面量
  （`&workspace=/home/program/agentmailINSERT INTO mails…`）⇒ 误判失效；
  正确是搜带斜杠的 `/home/program/agentmail/`，命中必须为 0
- **宽过滤假装绿**：`-run 'SSE|Client'` 跑出 `no tests to run`，
  看着绿其实一格没验。pi 第一轮也踩了并误报成「全绿」

## 遗留项（§5，这是本文件存在的原因）

1. 身份重复未处置——多余会话仍可能停不掉（平台侧动作，Agent 无权）。
   **在停掉之前任何线索都不应宣布收尾**
2. `vcs.modified=true` **有意保留**为已知 provenance 瑕疵：
   `87c55ac` + 脏 docs，Go 代码等价，② 已验在位
3. 09:58 那封信的归属——内容属实，发件人未认领

## 记录里的每条事实断言都复核过

`35557d4` 是 HEAD、`git diff 87c55ac..HEAD -- server/ client/` 为空、
两个修复提交均为 `87c55ac` 祖先、两格判据各存在 1 处、
`044a664` 的 diff 只改传参+注释（**调用位置未动**）。

2026-09-28 10:04:02 +08:00

electron-gui-review.md

docs(审查): 归档本轮四份代码审查报告

2026-09-28 08:46:02 +08:00

final-check-2026-09-28.md

docs(复验): 收尾记录落进仓库 —— 邮件会被压缩，这些坑没有文件记着

2026-09-28 10:04:02 +08:00

fix-report-2026-09-26.md

docs(审查): 归档本轮四份代码审查报告

2026-09-28 08:46:02 +08:00

harmony-client-review.md

docs(审查): 归档本轮四份代码审查报告