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/models/address.go

@@ -0,0 +1,138 @@
+package models
+
+import (
+	"fmt"
+	"strings"
+)
+
+// Address 是三维寻址 name@path.session 的解析结果
+type Address struct {
+	Name    string `json:"name"`    // Agent 实例名（或人类用户名）
+	Path    string `json:"path"`    // 工作区路径（可含 /，可为空）
+	Session string `json:"session"` // 会话别名；"new" = 新建；"" = 默认会话
+	Raw     string `json:"raw"`     // 原始字符串
+}
+
+// SessionMode 是 session 位的三种语义
+type SessionMode int
+
+const (
+	// SessionDefault：session 位省略 → 投递到 name@path 的默认会话（不存在则建立）
+	SessionDefault SessionMode = iota
+	// SessionNew：session 位为 new → 强制新建一个会话
+	SessionNew
+	// SessionNamed：session 位为具体别名 → 必须已存在，否则无法送达
+	SessionNamed
+)
+
+// Mode 返回该地址 session 位的语义
+func (a Address) Mode() SessionMode {
+	switch a.Session {
+	case "":
+		return SessionDefault
+	case "new":
+		return SessionNew
+	default:
+		return SessionNamed
+	}
+}
+
+// IsNewSession 表示该地址要求新建会话（仅 session == "new"）。
+// 注意：session 位省略不等于 new，那是「默认会话」，见 Mode()。
+func (a Address) IsNewSession() bool {
+	return a.Mode() == SessionNew
+}
+
+// IsDefaultSession 表示该地址省略了 session 位，走默认会话
+func (a Address) IsDefaultSession() bool {
+	return a.Mode() == SessionDefault
+}
+
+func (a Address) String() string {
+	return a.Raw
+}
+
+// ParseAddress 解析 name@path.session 三维地址。
+//
+// 支持形态：
+//
+//	deepseekharness@/program.updatefeature  → name=deepseekharness path=/program session=updatefeature
+//	pi@root.new                             → name=pi            path=root     session=new（新建）
+//	builder@ModelRouter.fix-leak            → name=builder        path=ModelRouter session=fix-leak
+//	human@.new                              → name=human         path=""       session=new
+//	human                                   → name=human         path=""       session=""（默认会话）
+//
+// 规则：
+//   - 第一个 @ 之前是 name（必填）
+//   - @ 之后按【最后一个 .】切成 path 与 session，因此 path 内可以包含 . 与 /
+//   - 没有 . 时，整段视为 path，session 为空（默认会话）
+//
+// session 位三态语义见 Address.Mode()：省略=默认会话，new=新建，其他=必须已存在。
+func ParseAddress(s string) (Address, error) {
+	raw := strings.TrimSpace(s)
+	if raw == "" {
+		return Address{}, fmt.Errorf("empty address")
+	}
+
+	// 只有形如 "@name@path.session" 时才剥掉前导 @；
+	// "@ModelRouter.new" 缺少 name，应当报错而不是被当成名字。
+	trimmed := raw
+	if strings.HasPrefix(raw, "@") && strings.Contains(raw[1:], "@") {
+		trimmed = raw[1:]
+	}
+
+	at := strings.Index(trimmed, "@")
+	if at < 0 {
+		// 只有名字：human / builder
+		name := strings.TrimSpace(trimmed)
+		if name == "" {
+			return Address{}, fmt.Errorf("missing agent name in %q", raw)
+		}
+		return Address{Name: name, Raw: raw}, nil
+	}
+
+	name := strings.TrimSpace(trimmed[:at])
+	if name == "" {
+		return Address{}, fmt.Errorf("missing agent name in %q", raw)
+	}
+
+	rest := trimmed[at+1:]
+
+	// 按最后一个 . 切 path / session；path 内允许 / 与 .
+	var path, session string
+	if dot := strings.LastIndex(rest, "."); dot >= 0 {
+		path = rest[:dot]
+		session = rest[dot+1:]
+	} else {
+		path = rest
+	}
+
+	return Address{
+		Name:    name,
+		Path:    strings.TrimSpace(path),
+		Session: strings.TrimSpace(session),
+		Raw:     raw,
+	}, nil
+}
+
+// ParseAddressList 解析逗号/分号/空白分隔的多个地址（用于 CC）
+func ParseAddressList(s string) ([]Address, error) {
+	raw := strings.TrimSpace(s)
+	if raw == "" {
+		return nil, nil
+	}
+
+	fields := strings.FieldsFunc(raw, func(r rune) bool {
+		return r == ',' || r == ';' || r == '\n' || r == '\t' || r == ' '
+	})
+
+	out := make([]Address, 0, len(fields))
+	for _, f := range fields {
+		addr, err := ParseAddress(f)
+		if err != nil {
+			return nil, err
+		}
+		out = append(out, addr)
+	}
+	return out, nil
+}