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/middleware/auth.go

@@ -0,0 +1,98 @@
+package middleware
+
+import (
+	"context"
+	"errors"
+	"net/http"
+	"strings"
+
+	"github.com/agentmail/gateway/internal/repo"
+)
+
+type contextKey string
+
+const AgentNameKey contextKey = "agent_name"
+
+// bearerToken 从 Authorization: Bearer <token> 取出令牌，缺失时返回空串。
+func bearerToken(r *http.Request) string {
+	h := r.Header.Get("Authorization")
+	if h == "" {
+		return ""
+	}
+	const p = "Bearer "
+	if len(h) > len(p) && strings.EqualFold(h[:len(p)], p) {
+		return strings.TrimSpace(h[len(p):])
+	}
+	return ""
+}
+
+// BearerToken 导出给 handler 层用（注册接口不过中间件，需要自己取密钥）。
+func BearerToken(r *http.Request) string { return bearerToken(r) }
+
+// keyAuthError 把密钥校验错误翻译成对外文案。
+// 「不存在」与「已使用/已过期」区分开：前两者是拿错了密钥，后者是密钥生命周期到了，
+// 运维需要据此判断该重新签发还是该检查配置。
+func keyAuthError(err error) string {
+	switch {
+	case errors.Is(err, repo.ErrKeyUsed):
+		return `{"error":"密钥已使用（一次性密钥只能用一次）"}`
+	case errors.Is(err, repo.ErrKeyExpired):
+		return `{"error":"密钥已过期"}`
+	default:
+		return `{"error":"密钥无效"}`
+	}
+}
+
+// AgentAuth 验证 Agent 身份，支持两种凭证：
+//
+//	Authorization: Bearer <agent_key_token>   —— 密钥认证（推荐）
+//	X-Agent-Name + X-Agent-Secret             —— 旧的 name/secret 方式（兼容保留）
+//
+// 用户密钥（user_keys）不接受：两类密钥共享 token 命名空间但走各自的验证表，
+// 因此用用户密钥调 Agent 接口只会得到「密钥无效」。
+func AgentAuth(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if token := bearerToken(r); token != "" {
+			agentName, err := repo.VerifyAgentKey(r.Context(), token)
+			if err != nil {
+				http.Error(w, keyAuthError(err), http.StatusUnauthorized)
+				return
+			}
+			if agentName == "" {
+				// 密钥有效但尚未绑定 Agent：注册接口会用请求里的 name 落定它，
+				// 其余接口无法确定调用者身份，只能拒。
+				http.Error(w, `{"error":"密钥尚未绑定 Agent，请先调用 /agent/register 完成注册"}`, http.StatusForbidden)
+				return
+			}
+			repo.HeartbeatAgent(r.Context(), agentName)
+			ctx := context.WithValue(r.Context(), AgentNameKey, agentName)
+			next.ServeHTTP(w, r.WithContext(ctx))
+			return
+		}
+
+		agentName := r.Header.Get("X-Agent-Name")
+		agentSecret := r.Header.Get("X-Agent-Secret")
+		if agentName == "" || agentSecret == "" {
+			http.Error(w, `{"error":"Missing Authorization: Bearer <key> or X-Agent-Name/X-Agent-Secret header"}`, http.StatusUnauthorized)
+			return
+		}
+
+		agent, err := repo.VerifyAgent(r.Context(), agentName, agentSecret)
+		if err != nil {
+			http.Error(w, `{"error":"Invalid credentials"}`, http.StatusUnauthorized)
+			return
+		}
+
+		repo.HeartbeatAgent(r.Context(), agent.Name)
+		ctx := context.WithValue(r.Context(), AgentNameKey, agent.Name)
+		next.ServeHTTP(w, r.WithContext(ctx))
+	})
+}
+
+// GetAgentName 从 context 中获取 agent_name
+func GetAgentName(r *http.Request) string {
+	if v := r.Context().Value(AgentNameKey); v != nil {
+		return v.(string)
+	}
+	return ""
+}