feat: AgentMail —— 以邮件为统一范式的多智能体协作平台

Go 单二进制网关 + React 前端 + opencode 桥接插件。部署产物是
「一个二进制加一个 .db 文件」：前端经 go:embed 打进二进制，
数据库默认内置 SQLite，systemd 托管。

核心设计
- 三维寻址 name@path.session，按最后一个 . 切分；session 位三态：
  省略=默认会话 / new=强制新建 / 具体别名=必须已存在（否则 404 无法送达）
- 会话别名默认复用 Agent 平台自己的命名机制（opencode 的 slug 与模型生成的
  标题），不在本侧另造一套；人显式定过的别名不被平台同步覆盖
- 对话树不建 tree_nodes 表：parent_mail_id 已完整编码树结构，
  再维护一张表就是第二份真相。用递归 CTE 查，按方向分块加载
- 附件内容存磁盘、按 sha256 内容寻址，数据库只存元数据；天然去重，
  且路径与用户 filename 无关，杜绝 ../ 穿越
- 配额约束的是模型的自主发信，不是 harness 的转发：插件代劳的权限询问与
  最终总结走免配额通道，靠上游消息 id 做幂等键而非计数
- 往返预算下沉到会话（写信时给、对话页里改）+ Agent 全局配额，两层都要过

后端 gateway/
- models/repo/handler/middleware/sse/blob 分层；两方言（SQLite/PostgreSQL）
  共用一份 repo 层 SQL，差异集中在 internal/db
- 多用户认证（bcrypt cost12、登录限速、会话隔离、权限边界）
- 密钥体系：Agent 密钥与用户密钥分表，三种生命周期；登记式密钥让全文
  只从客户端流向服务器一次
- 所有「判断 + 自增」都在同一条 UPDATE 里（配额、预算、one_time 密钥、
  附件挂载），并发下不会刷穿

前端 web/
- 三栏布局、三段式地址补全、权限卡片、密钥面板、配额面板、对话树、附件
- 全站纯 SVG 图标，不使用 emoji
- api/ 即可复用的客户端 SDK：基地址与凭证集中在 api/config.ts

插件 plugins/opencode-mail-bridge/
- 六个工具 + 两类自动转发（permission.ask 钩子接管平台原生权限询问、
  session.idle 时转发本轮总结）

gateway/internal/handler/rename_proposal_test.go

@@ -0,0 +1,143 @@
+package handler
+
+import "testing"
+
+func TestExtractRenameProposal(t *testing.T) {
+	cases := []struct {
+		name       string
+		body       string
+		wantAlias  string
+		wantReason string
+		wantBody   string
+	}{
+		{
+			name:      "无标记时原样返回",
+			body:      "普通正文。",
+			wantAlias: "",
+			wantBody:  "普通正文。",
+		},
+		{
+			name:       "带理由",
+			body:       "已定位问题。\n\n<!-- agentmail:rename-session alias=\"fix-login-leak\" reason=\"是登录态泄漏\" -->",
+			wantAlias:  "fix-login-leak",
+			wantReason: "是登录态泄漏",
+			wantBody:   "已定位问题。",
+		},
+		{
+			name:      "无理由",
+			body:      "<!-- agentmail:rename-session alias=\"cache-eval\" -->\n\n正文在后。",
+			wantAlias: "cache-eval",
+			wantBody:  "正文在后。",
+		},
+		{
+			// Agent 在长回复里反复修正措辞，最后写下的才是它的结论
+			name:      "多条只取最后一条",
+			body:      "<!-- agentmail:rename-session alias=\"first\" -->\n中间\n<!-- agentmail:rename-session alias=\"second\" -->",
+			wantAlias: "second",
+			wantBody:  "中间",
+		},
+		{
+			// 别名含 . / @ 会让三维地址切分歧义，normalizeAlias 改写为 -
+			name:      "非法字符被规范化",
+			body:      "<!-- agentmail:rename-session alias=\"fix login.leak/now\" -->",
+			wantAlias: "fix-login-leak-now",
+			wantBody:  "",
+		},
+		{
+			// "new" 是寻址保留字
+			name:      "保留字被改写",
+			body:      "<!-- agentmail:rename-session alias=\"new\" -->",
+			wantAlias: "session-new",
+			wantBody:  "",
+		},
+		{
+			// 规范化后为空 → 视为无提议，但标记仍要剥掉
+			name:      "空别名视为无提议且剥掉标记",
+			body:      "正文\n<!-- agentmail:rename-session alias=\"\" -->",
+			wantAlias: "",
+			wantBody:  "正文",
+		},
+		{
+			name:      "多余空格容错",
+			body:      "<!--   agentmail:rename-session   alias=\"ok-name\"   -->",
+			wantAlias: "ok-name",
+			wantBody:  "",
+		},
+	}
+
+	for _, c := range cases {
+		t.Run(c.name, func(t *testing.T) {
+			p, body := extractRenameProposal(c.body)
+			gotAlias := ""
+			gotReason := ""
+			if p != nil {
+				gotAlias, gotReason = p.Alias, p.Reason
+			}
+			if gotAlias != c.wantAlias {
+				t.Errorf("alias = %q，期望 %q", gotAlias, c.wantAlias)
+			}
+			if gotReason != c.wantReason {
+				t.Errorf("reason = %q，期望 %q", gotReason, c.wantReason)
+			}
+			if body != c.wantBody {
+				t.Errorf("剥标记后正文 = %q，期望 %q", body, c.wantBody)
+			}
+		})
+	}
+}
+
+// 标记必须从入库正文里彻底消失：react-markdown 不解析 raw HTML，
+// 留着会被转义成一行可见的乱码文本，而不是被渲染器吞掉。
+func TestProposalMarkerNeverSurvivesInBody(t *testing.T) {
+	bodies := []string{
+		"<!-- agentmail:rename-session alias=\"a\" -->",
+		"前\n<!-- agentmail:rename-session alias=\"a\" reason=\"r\" -->\n后",
+		"<!-- agentmail:rename-session alias=\"\" -->", // 无效提议也要剥
+	}
+	for _, b := range bodies {
+		_, out := extractRenameProposal(b)
+		if renameProposalRe.MatchString(out) {
+			t.Errorf("正文里仍残留标记：%q", out)
+		}
+	}
+}
+
+// 提议出来的别名必须能直接通过 PUT alias 的校验，
+// 否则前端点「接受」时会拿到 400 —— 系统自己造出了自己拒绝的值。
+func TestProposedAliasPassesValidation(t *testing.T) {
+	inputs := []string{
+		"fix login.leak",
+		"new",
+		"a@b/c",
+		"  spaced  name  ",
+		"正常中文别名",
+	}
+	for _, in := range inputs {
+		p, _ := extractRenameProposal("<!-- agentmail:rename-session alias=\"" + in + "\" -->")
+		if p == nil {
+			continue // 规范化后为空，已按无提议处理
+		}
+		if err := validateSessionAlias(p.Alias); err != nil {
+			t.Errorf("提议 %q → %q 未通过 validateSessionAlias: %v", in, p.Alias, err)
+		}
+	}
+}
+
+func TestReasonTruncatedOnUTF8Boundary(t *testing.T) {
+	long := ""
+	for i := 0; i < 100; i++ {
+		long += "很长的理由"
+	}
+	p, _ := extractRenameProposal("<!-- agentmail:rename-session alias=\"x\" reason=\"" + long + "\" -->")
+	if p == nil {
+		t.Fatal("应当解析出提议")
+	}
+	if len(p.Reason) > 210 { // 200 + "..."
+		t.Errorf("理由未截断：%d 字节", len(p.Reason))
+	}
+	for _, r := range p.Reason {
+		if r == 0xFFFD {
+			t.Fatal("截断产生了替换符，说明切在多字节字符中间")
+		}
+	}
+}