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 时转发本轮总结）

deploy/install.sh

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+#
+# 把 AgentMail Gateway 与 opencode serve 安装为 systemd 服务。
+#
+#   sudo ./deploy/install.sh
+#
+# 幂等：重复执行等价于「重新构建 + 重启」。已存在的 env 文件不会被覆盖，
+# 因为里面有管理员密码与 Agent secret，重装不该把它们冲掉。
+set -euo pipefail
+
+REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PREFIX=/opt/agentmail
+ETC=/etc/agentmail
+
+[[ $EUID -eq 0 ]] || { echo "需要 root：sudo $0" >&2; exit 1; }
+
+echo "==> 构建前端"
+( cd "$REPO/web" && npm ci --no-audit --no-fund 2>/dev/null || npm install --no-audit --no-fund )
+( cd "$REPO/web" && npm run typecheck && npm test && npm run build )
+
+echo "==> 前端产物嵌入 Gateway"
+rm -rf "$REPO/gateway/internal/static/static"
+cp -r "$REPO/web/dist" "$REPO/gateway/internal/static/static"
+
+echo "==> 构建 Gateway（单二进制，内含前端 + SQLite）"
+# 先删再建：go build -o 到已存在的路径时可能拿到 stale 二进制（此坑中过多次）
+rm -f "$REPO/gateway/agentmail-gateway"
+( cd "$REPO/gateway" && go vet ./... && go test ./... && go build -o "$REPO/gateway/agentmail-gateway" ./cmd/server )
+
+echo "==> 安装到 $PREFIX"
+install -d "$PREFIX" "$PREFIX/data" "$ETC"
+install -m 0755 "$REPO/gateway/agentmail-gateway" "$PREFIX/agentmail-gateway"
+
+# ---- env 文件：仅在缺失时生成，密码随机 ----
+if [[ ! -f "$ETC/gateway.env" ]]; then
+  ADMIN_PASS="$(head -c 18 /dev/urandom | base64 | tr -d '/+=' | head -c 20)"
+  cat > "$ETC/gateway.env" <<EOF
+# AgentMail Gateway 环境变量
+ADMIN_USER=admin
+ADMIN_PASSWORD=$ADMIN_PASS
+
+# 生产环境走 HTTPS 时置 true，Cookie 才会带 Secure 标记
+SECURE_COOKIE=false
+
+# 允许的前端跨域来源（逗号分隔）；单二进制自带前端时通常无需配置
+# CORS_ORIGINS=https://mail.example.com
+EOF
+  chmod 0600 "$ETC/gateway.env"
+  echo "    已生成 $ETC/gateway.env（管理员 admin / $ADMIN_PASS）"
+else
+  echo "    $ETC/gateway.env 已存在，保留不动"
+fi
+
+if [[ ! -f "$ETC/opencode.env" ]]; then
+  cat > "$ETC/opencode.env" <<EOF
+# opencode mail-bridge 插件配置
+AGENTMAIL_GATEWAY_URL=http://127.0.0.1:8180
+AGENTMAIL_AGENT_NAME=opencode
+
+# 接入密钥：留空时插件会在 \$AGENTMAIL_CONFIG_DIR/agent.key 本地生成一把并打印到日志，
+# 拿着它到 Web 后台「Agent 密钥」登记即可接入（journalctl -u opencode-serve | grep mail-bridge）。
+# 也可以先在后台签发密钥，再把它填在这里。
+AGENTMAIL_AGENT_KEY=
+AGENTMAIL_CONFIG_DIR=/opt/agentmail/agent-config
+
+# 处理来信时使用的模型
+AGENTMAIL_REPLY_PROVIDER=llmsproxy
+AGENTMAIL_REPLY_MODEL=AUTO
+
+# opencode serve 绑在 127.0.0.1，但同机任何进程都能调它开会话，
+# 因此仍然设置访问密码。
+OPENCODE_SERVER_PASSWORD=$(head -c 18 /dev/urandom | base64 | tr -d '/+=' | head -c 24)
+EOF
+  chmod 0600 "$ETC/opencode.env"
+  install -d -m 0700 "$PREFIX/agent-config"
+  echo "    已生成 $ETC/opencode.env（server password 为随机值；接入密钥首启时本地生成）"
+else
+  echo "    $ETC/opencode.env 已存在，保留不动"
+fi
+
+echo "==> 安装 systemd 单元"
+install -m 0644 "$REPO/deploy/agentmail-gateway.service" /etc/systemd/system/
+install -m 0644 "$REPO/deploy/opencode-serve.service"    /etc/systemd/system/
+systemctl daemon-reload
+
+echo "==> 启用并启动"
+systemctl enable --now agentmail-gateway.service
+if command -v opencode >/dev/null 2>&1; then
+  systemctl enable --now opencode-serve.service
+else
+  echo "    未找到 opencode，跳过 opencode-serve（装好后执行：systemctl enable --now opencode-serve）"
+fi
+
+sleep 3
+echo
+echo "==> 状态"
+systemctl --no-pager --lines=0 status agentmail-gateway.service || true
+curl -sf -m 5 http://127.0.0.1:8180/health && echo "  健康检查通过" || echo "  健康检查失败，查看：journalctl -u agentmail-gateway -n 50"