docs(agent): 记录 auth_user 血泪教训 + 客户端隧道前置 + 验收须真连接

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-24 07:39:39 +08:00
parent 2abe4d0816
commit 344dfe9a82
3 changed files with 22 additions and 7 deletions
@@ -19,6 +19,8 @@
 - 每个 Task 结束必须 `cd server && go build ./... && go test ./internal/agentd/...` 全绿再提交。
 - Commit message 前缀用 `feat(agent):` / `test(agent):` / `refactor(agent):`。

+> **执行后修订（2026-07-23，提交 `2abe4d0`）· 血泪教训**：放行规则匹配凭证必须用 **`auth_user`** 而非本计划各处写的 `user`。`sing-box check` 对两者都语法通过,但 `user` 字段对 VLESS/REALITY 入站**运行时不匹配**,导致放行规则永不命中、**连白名单用户也被兜底拒绝**(全员进不去)。生产上线时踩中,本地起真 VLESS 连接实测才定位。**凡本计划(Task 2 `rules()`、Task 3 测试)出现 `r["user"] = uuids` 或断言 `r["user"]` 之处,一律应为 `auth_user`。** 且验收不能只跑 `sing-box check`——必须真连接跑一次(节点端「白名单 uuid 一进一出」即可)。
+
 ---

 ### Task 1: ACL 配置类型、加载与 fail-closed 的 active()