MailUI4Agents

Files

JianFeeeee 5753169077 docs(test): 去掉 permission.go:112 这个**同一提交内就失效**的行号引用（pi 2026-09-25）

pi 那条"引用位置要用**唯一标识**，行号只作辅助"我收 —— 而它在**我自己的提交**里
就有一个现成的反例：

    34a15dc^  : permission.go **112** = Error(w, …, "Invalid session_id")   ← 引用写下时是对的
    34a15dc   : 同一提交给它**前面**插了 16 行注释 ⇒ 真调用移到 **128**
                （而新注释自己占了 113 行，所以 112 现在落在注释文本里）
    HEAD      : 112 = 注释文本；真调用 = 128、另一处提到它的注释 = 113

⇒ **引用与使它失效的改动在同一个提交里** —— 这不是"时间久了漂移"，
  是"写下时就错了"，而且**任何 review 都看不出来**（数字看着很具体、很像核过）。
  判据也抓不到：112/301/39 全都在文件行数界内（弱形式"越界检查"无效）。

改法（按 pi 的写法）：唯一标识用**函数名 + 错误字符串字面量**
（`RequestPermission` + `Error(w, http.StatusBadRequest, "Invalid session_id")`），
行号删除；并把"为什么故意不写行号"记在注释里，免得下一个人"顺手补回去"。

★ 顺带核实（**只核实、未改动**）另一处同类引用：
  `docs/HARMONY-ALIGN-PLAN.md:225` 引 `permission.go:301`，声称是 `DecidePermission`。
  实测: e07e3bf（引用写下时）301 = 该函数的文档注释、函数体在 302；
        现在函数体在 **318** ⇒ 该行号也已漂移 17 行，落在 `RequestPermission` 里。
  未改它（属于另一个 writer 的文档，且是否要改成"唯一标识"由那条线决定）。

验证: `go test ./internal/handler/` 通过。

2026-09-25 06:35:53 +08:00