Files
MailUI4Agents/server
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
..